Gumps - Reetus/ClassicAssist GitHub Wiki

ClassicAssist Macro Commands

Generated on 12/15/2024 3:30:41 AM
Version: 4.425.22+b9a337759d26b9d39ae8ccaac75a36c4255be94a

Gumps

CloseGump

Method Signature:

Void CloseGump(Int32)

Parameters

  • serial: An entity serial such as 0xf00ff00f.

Description:

Close a specified gump serial

Example:

CloseGump(0x454ddef)  

ConfirmPrompt

Method Signature:

Boolean ConfirmPrompt(System.String, Boolean)

Description:

Displays an ingame prompt with the specified message, returns True if Okay was pressed, False if not.

Example:

res = ConfirmPrompt("Play macro?")

if res:
 PlayMacro("Macro")  

GumpExists

Method Signature:

Boolean GumpExists(UInt32)

Description:

Checks if a gump id exists or not.

Example:

if GumpExists(0xff):  

InGump

Method Signature:

Boolean InGump(UInt32, System.String)

Parameters

  • gumpid: An entity serial in integer or hex format, or an alias string such as "self".
  • text: String value - See description for usage.

Description:

Check for a text in gump.

Example:

if InGump(0xf00f, "lethal darts"):  

ItemArrayGump

Method Signature:

Int32[] ItemArrayGump(System.Collections.Generic.IList`1[System.Object], Boolean, Int32, Int32, Boolean)

Description:

Displays a gump with the selected serials / aliases in a grid, similar to the UOSteam loot grid, returns array of serials selected

Example:

from Assistant import Engine

#single select, specified items
result = ItemArrayGump([0x462d3373, 0x462d6029])

if result.Length == 0:
 print 'Nothing was selected'
else:
 print 'Serial {} was selected'.format(result[0])

#showing backpack items, multi select, at coords 200, 200
items = Engine.Player.Backpack.Container.GetItems()
results = ItemArrayGump(items, True, 200, 200)

if results.Length == 0:
 print 'Nothing was selected'
else:
 print '{} item(s) were selected'.format(results.Length)
 
 for serial in results:
  print 'Serial {} was selected'.format(serial)
  

MessagePrompt

Method Signature:

System.ValueTuple`2[System.Boolean,System.String] MessagePrompt(System.String, System.String, Boolean)

Parameters

  • message: String value - See description for usage.
  • initialtext: String value - See description for usage. (Optional)
  • closable: True/False value, see description for usage. (Optional)

Description:

Displays an ingame gump prompting for a message

Example:

res, name = MessagePrompt("Enter Name?", "Whiskers")

if res:
 Rename(0xc1b, name)  

OpenGuildGump

Method Signature:

Void OpenGuildGump()

Description:

Opens the Guild gump

Example:

OpenGuildGump()  

OpenHelpGump

Method Signature:

Void OpenHelpGump()

Description:

Opens the Help gump

Example:

OpenHelpGump()  

OpenQuestsGump

Method Signature:

Void OpenQuestsGump()

Description:

Opens the Quests gump

Example:

OpenQuestsGump()  

OpenVirtueGump

Method Signature:

Void OpenVirtueGump(System.Object)

Parameters

  • obj: An entity serial in integer or hex format, or an alias string such as "self". (Optional)

Description:

Opens the Virtue gump of the given serial/alias (defaults to current player)

Example:

OpenVirtueGump("enemy")  

ReplyGump

Method Signature:

Void ReplyGump(UInt32, Int32, Int32[], System.Collections.Generic.Dictionary`2[System.Int32,System.String])

Parameters

  • gumpid: ItemID / Graphic such as 0x3db.
  • buttonid: Gump button ID.
  • switches: Integer value - See description for usage. (Optional)
  • textentries: Not specified - See description for usage. (Optional)

Description:

Sends a button reply to server gump, parameters are gumpID and buttonID.

Example:

ReplyGump(0xff, 0)  

SelectionPrompt

Method Signature:

System.ValueTuple2[System.Boolean,System.Int32] SelectionPrompt(System.Collections.Generic.IEnumerable1[System.String], System.String, Boolean)

Parameters

  • options: An array of strings.
  • message: String value - See description for usage. (Optional)
  • closable: True/False value, see description for usage. (Optional)

Description:

**Produces an in-game gump to choose from a list of options

Returns a tuple with a boolean signifying whether the OK button was pressed, and the index of the entry selected**

Example:

res, index = SelectionPrompt(['Sex', 'Drugs', 'Rock and Roll'])

if res:
 print 'Option {} was selected'.format(index)
else:
 print 'Cancel was pressed'  

WaitForGump

Method Signature:

Boolean WaitForGump(UInt32, Int32)

Parameters

  • gumpid: ItemID / Graphic such as 0x3db. (Optional)
  • timeout: Timeout specified in milliseconds. (Optional)

Description:

Pauses until incoming gump packet is received, optional paramters of gump ID and timeout

Example:

WaitForGump(0xff, 5000)