Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions _datafiles/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,8 @@ Server:
- print
- inbox check
- print
- mudletmap
- checkclient
# - Motd -
# Message of the day. This is displayed when the motd command is run.
Motd: '{{ t "Motd" }}'
Expand Down
23 changes: 23 additions & 0 deletions modules/gmcp/files/data-overlays/keywords.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Help keywords for Mudlet and client-related commands
# These will be merged with the main keywords.yaml by the help system

help:
command:
information:
- client
- checkclient
- mudletmap
- mudletui
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CONSIDER: A new category, instead of information, we can use interface or something - we can then put other stuff in there too, like the screenreader mode.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea. I'll set that up 👍


# Aliases for keywords when typing: help <keyword>
help-aliases:
mudletui: [mudlet, mudletgui, mudlet-ui, mudlet ui]
mudletmap: [mudlet-map, mudlet map]
checkclient: [client-check, clientcheck]
client: [clients, mud-client, mudclient]

# Command aliases for Mudlet-related commands
command-aliases:
mudletui: [mudlet, mgui]
mudletmap: [mudlet-map]
checkclient: [clientcheck]
13 changes: 13 additions & 0 deletions modules/gmcp/files/data-overlays/mudlet-config.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Mudlet client configuration

# Mapper configuration
mapper_version: "1"
mapper_url: "https://github.com/GoMudEngine/MudletMapper/releases/latest/download/GoMudMapper.mpackage"

# UI configuration
ui_version: "1"
ui_url: "https://github.com/GoMudEngine/MudletUI/releases/latest/download/GoMudUI.mpackage"

# Map data configuration
map_version: "1"
map_url: "https://github.com/GoMudEngine/MudletMapper/releases/latest/download/gomud.dat"
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<ansi fg="black-bold">.:</ansi> <ansi fg="magenta">Help for </ansi><ansi fg="command">checkclient</ansi>

The <ansi fg="command">checkclient</ansi> command displays information about client-specific features available to you.

<ansi fg="yellow">Usage: </ansi>

<ansi fg="command">checkclient</ansi> - Shows details about detected client features and available enhancements

<ansi fg="subtitle">NOTES:</ansi>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a custom ansi class - can you include afiles/data-overlays/ansi-aliases.yaml? See an example in auctions here: https://github.com/GoMudEngine/GoMud/blob/master/modules/auctions/files/data-overlays/ansi-aliases.yaml

Shouldn't require any code changes, just the datafile with the color class definition.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't even realize I left that in. I create a new one or use an existing one.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Create a new ansi-aliases.yaml within your module folder (in files/data-overlays/. This will allow you to either override or define new ansi alises that will be used by your module.

- This command is particularly useful for Mudlet users to see what special features are available
- It will detect if you're using Mudlet and show relevant package information
- The command runs automatically when you log in to provide helpful information

<ansi fg="magenta-bold">See also:</ansi> <ansi fg="command">help mudletui</ansi>, <ansi fg="command">mudletmap</ansi>
21 changes: 21 additions & 0 deletions modules/gmcp/files/datafiles/templates/help/client.template
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
<ansi fg="black-bold">.:</ansi> <ansi fg="magenta">Help for </ansi><ansi fg="command">client</ansi>

This game supports various MUD clients with special features to enhance your gameplay experience.

<ansi fg="yellow">Supported Clients: </ansi>

<ansi fg="white-bold">Mudlet</ansi> - Full support with custom UI, mapping, and GMCP features
Use <ansi fg="command">help mudletui</ansi> and <ansi fg="command">help mudletmap</ansi> for more information.

<ansi fg="white-bold">Other Clients</ansi> - Basic support with standard MUD protocol features
For the best experience, we recommend using a client that supports GMCP.

<ansi fg="subtitle">GMCP FEATURES:</ansi>
- Character information and status updates
- Room and environment data
- Communication channels
- Party information
- Custom UI elements (Mudlet only)
- Client Mapping support (Mudlet only)

<ansi fg="magenta-bold">See also:</ansi> <ansi fg="command">help mudletui</ansi>, <ansi fg="command">help mudletmap</ansi>, <ansi fg="command">checkclient</ansi>
15 changes: 15 additions & 0 deletions modules/gmcp/files/datafiles/templates/help/mudletmap.template
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
<ansi fg="black-bold">.:</ansi> <ansi fg="magenta">Help for </ansi><ansi fg="command">mudletmap</ansi>

The <ansi fg="command">mudletmap</ansi> command sends map data to Mudlet clients for enhanced navigation.

<ansi fg="yellow">Usage: </ansi>

<ansi fg="command">mudletmap</ansi> - Sends or refreshes map data to your Mudlet client

<ansi fg="subtitle">NOTES:</ansi>
- This command only works if you are using a Mudlet client
- The map data helps with navigation and visualization of the game world
- This command runs automatically when you log in with Mudlet
- If your map isn't displaying properly, you can run this command to refresh it

<ansi fg="magenta-bold">See also:</ansi> <ansi fg="command">help mudletui</ansi>, <ansi fg="command">checkclient</ansi>
23 changes: 23 additions & 0 deletions modules/gmcp/files/datafiles/templates/help/mudletui.template
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
<ansi fg="black-bold">.:</ansi> <ansi fg="magenta">Help for </ansi><ansi fg="command">mudletui</ansi>

The <ansi fg="command">mudletui</ansi> command allows Mudlet client users to manage UI packages that enhance the gameplay experience.

<ansi fg="yellow">Usage: </ansi>

<ansi fg="command">mudletui</ansi> - Shows status information and available commands
<ansi fg="command">mudletui install</ansi> - Installs the GoMud UI package in your Mudlet client
<ansi fg="command">mudletui remove</ansi> - Removes the GoMud UI package from your Mudlet client
<ansi fg="command">mudletui update</ansi> - Manually check for updates to the GoMud UI package
<ansi fg="command">mudletui hide</ansi> - Hides automatic Mudlet UI prompts when logging in
<ansi fg="command">mudletui show</ansi> - Re-enables automatic Mudlet UI prompts when logging in

<ansi fg="subtitle">NOTES:</ansi>
- These commands only work if you are using a Mudlet client
- The UI package enhances your gameplay experience with custom windows and controls
- If the installation doesn't work automatically, check for prompts in your Mudlet client
- You'll automatically see a message about this feature when you log in with Mudlet
- Using <ansi fg="command">mudletui hide</ansi> or <ansi fg="command">mudletui install</ansi> will hide the automatic prompts
- Using <ansi fg="command">mudletui show</ansi> will re-enable the automatic prompts
- Running <ansi fg="command">mudletui</ansi> without arguments shows current status and available commands

<ansi fg="magenta-bold">See also:</ansi> <ansi fg="command">help client</ansi>, <ansi fg="command">checkclient</ansi>
Loading
Loading