Stolve at 15:59, 7 January 2021

2021-01-07T15:59:43Z

Stolve: Created page with "== Enabling GMCP == In Mudlet you can enable GMCP via the Settings for your session. Once a session is opened, open the Settings: File:Gmcp-mudlet-open-prefs.jpg|How to..."

2021-01-06T16:09:23Z

Created page with "== Enabling GMCP == In Mudlet you can enable GMCP via the Settings for your session. Once a session is opened, open the Settings: File:Gmcp-mudlet-open-prefs.jpg|How to..."

New page

== Enabling GMCP ==
In Mudlet you can enable [[GMCP]] via the Settings for your session.
Once a session is opened, open the Settings:

[[File:Gmcp-mudlet-open-prefs.jpg|How to open settings]]

In the settings, under the <code>Game Protocols</code> section, ensure the <code>Enable GMCP</code> checkbox is checked.

[[File:Gmcp-mudlet-enable.jpg|How to enable GMCP]]

== Receiving a GMCP message ==
Once GMCP is enabled, the MUD will begin broadcasting GMCP messages.
Mudlet automatically saves all data from GMCP messages in a global <code>gmcp</code> variable.

For example, if you wanted to read the area name from the prompt, you can do this at any time, from anywhere via the following variable:
gmcp.char.prompt.an

Sometimes you need to be able to trigger off of a GMCP message. This can be done by creating a GMCP script.

Create a new script (not a trigger) and give it a name. Enter the package name in the <code>Add User Defined Event Handler</code> field and hit the "plus" sign to add it. This package name must be prepended by <code>gmcp.</code>. For example, the <code>char.status</code> package would be added to the event handlers as <code>gmcp.char.status</code>. A full list of available packages can be found [[GMCP Packages|here]].

[[File:Gmcp-mudlet-trigger.jpg|Creating a GMCP trigger in Mudlet]]

You can also match partial packages to trigger on multiple GMCP messages.
For example, you can set the pattern to <code>gmcp.char</code> to trigger on ''any'' character related GMCP message.

== Sending a GMCP message ==
The MUD will not broadcast every message that is available. Some messages must be manually requested. Additionally, some broadcasted messages can also be requested if you need to refresh the data before the MUD would broadcast again.

The following script can be used to send a request to the MUD:
SendGMCP("char.prompt")

If you need to send additional parameters for the requested package, you can do so:
SendGMCP([[char.prompt {"additional": 1, "parameters": "hello"}]])

You can also use the following syntax:
SendGMCP("char.prompt"..yajl.to_string({"additional": 1, "parameters": "hello"})

Note that as of writing, none of the Legend packages take any parameters, required or optional.

@@ Line 10: / Line 10: @@
 == Receiving a GMCP message ==
-Once GMCP is enabled, the MUD will begin broadcasting GMCP messages.
+Once GMCP is enabled, the MUD will begin sending GMCP messages.
 Mudlet automatically saves all data from GMCP messages in a global <code>gmcp</code> variable.
 For example, if you wanted to read the area name from the prompt, you can do this at any time, from anywhere via the following variable:
   gmcp.char.prompt.an
 Sometimes you need to be able to trigger off of a GMCP message. This can be done by creating a GMCP script.
@@ Line 29: / Line 37: @@
 The following script can be used to send a request to the MUD:
-  SendGMCP("char.prompt")
+  sendGMCP("char.prompt")
 If you need to send additional parameters for the requested package, you can do so:
-  SendGMCP([[char.prompt {"additional": 1, "parameters": "hello"}]])
+  sendGMCP([[char.prompt {"additional": 1, "parameters": "hello"}]])
 You can also use the following syntax:
-  SendGMCP("char.prompt"..yajl.to_string({"additional": 1, "parameters": "hello"})
+  sendGMCP("char.prompt"..yajl.to_string({"additional": 1, "parameters": "hello"})
 Note that as of writing, none of the Legend packages take any parameters, required or optional.

GMCP Mudlet Tutorial - Revision history

Stolve at 15:59, 7 January 2021

Stolve: Created page with "== Enabling GMCP == In Mudlet you can enable GMCP via the Settings for your session. Once a session is opened, open the Settings: File:Gmcp-mudlet-open-prefs.jpg|How to..."