Megamud remote command guide

Started by Gardner Denver, Jul 27, 2009, 04:30 PM

Previous topic - Next topic

Gardner Denver

Remote Control

MegaMud has the ability to respond to commands telepathed, spoken or paged to the player. Depending on the command, this facility can be quite dangerous in the hands of an enemy player. Consequently, each of the commands can be individually allowed/disallowed per player.

This facility has been added for users who wish to control there own character (eg. someone starts scripting from home and wants to dial in on another account while at work and check their character's status). It can also be used for users who wish to allow other players to control their character for some reason (eg. because they are away from the keyboard for a period).

If the telepathed command is not allowed, MegaMud will simply ignore it and not respond to the sender. If the sender is allowed, then most commands will respond in some way. If the command cannot be executed, then a small failure message will be returned.

The following is a list of commands that may be used by other players (if they are setup to do so):

@version
Returns the version of MegaMud currently running on the receiver's computer.

@health

Returns the current health and mana/kai of the player. Any special player states (eg. Resting, Blinded, etc.) will also be returned.

@exp
Returns the amount of experience made since starting MegaMud, plus the current experience rate.

@level
Returns the player's current level.

@status
Returns the current task and action (the messages displayed in the user's status bar) to the sender.

@lives
Returns the character's number of lives remaining.

@where
Returns the current location (room name) of the player. The available room exits are also shown.

@path
Returns the name of the path file the character is currently using.

@seen <player>
Returns the whether or not the specified player has been seen, and if so, where they were last seen.

@who
Returns the list of players and monsters who are currently within the same room as you.

@what
Returns the list of items visible within the current room.

@wealth
Returns the wealth (in copper) being carried by the player.

@enc
Returns the current player encumberance.

@have <item>
Checks to see if the player has the named item. Note that you must send the full name of the item with correct spelling for this to work. If the player does have the item, the count of the items held is also returned.

@home <monster>
This command can be sent to mudop players who can check on the status of a monster.

@invite
Causes the MegaMud to invite the player to join your party. This allows you define friendly players who are allowed to join your party at any time.

@join
Causes MegaMud to join the player who sent the command.

@forget
Causes MegaMud to remove the player who sent the command from your current party.

@get-all
Makes the receiver pick up all items within the room.

@drop-all
Makes the receiver drop all items in their inventory.

@equip-all
Makes the receiver equip any items not already equiped.

@deposit-all
Makes the receiver deposit any excess cash they are carrying.

@do <cmd>
Executes the <cmd> as if it where typed by the player. The results of the command however are not returned.

@goto <room>
Sets the receiver's destination to be the specified room name. Note that the room name must be defined in the room list on the receiver's copy of MegaMud to work correctly.  You may also substitute the 4-character room code for <room> as well.

@loop <path-file>
Sets the receiver's loop destination to be the specified path file. Note that the file name must be defined in the path list on the receiver's copy of MegaMud to work correctly.

@looponce <path-file>
Tells the receiver to loop once around the specified destination. Once complete, the player will return to their original loop.

@roam [on | off]
Toggles or sets the player's auto-roaming mode.

@stop
Causes the player to stop moving.

@rego
Causes the player to start moving again. This will only work if they were originally roaming and they hit the stop button or were sent a @stop command.

@attack-last [on | off]
Toggles or sets the player's attack-last setting.

@auto-all [on | off]
Toggles or sets the player's all-off mode.

@auto-combat [on | off]
Toggles or sets the player's auto-combat setting.

@auto-nuke [on | off]
Toggles or sets the player's auto-nuke (room attacks) setting.

@auto-heal [on | off]
Toggles or sets the player's auto-heal setting.

@auto-bless [on | off]
Toggles or sets the player's auto-bless setting.

@auto-light [on | off]
Toggles or sets the player's auto-light setting.

@auto-cash [on | off]
Toggles or sets the player's auto-cash setting.

@auto-get [on | off]
Toggles or sets the player's auto-get setting.

@auto-sneak [on | off]
Toggles or sets the player's auto-sneak setting.

@auto-hide [on | off]
Toggles or sets the player's auto-hide setting.

@auto-search [on | off]
Toggles or sets the player's auto-search setting.

@settings
Returns a list of the player's auto settings which are currently enabled.

@reset
Resets all of MegaMud's internal flags and statistics.

@divert [on | off]
Signals that local conversations (eg. telepathes, pages, etc.) should be re-diverted to the sender. This allows the same player to simultaneously run two or more characters and not miss anyone trying to contact them. The person being diverted may also cancel this at any time by simply saying "@divert" themselves.

@hangup
Causes the player to hangup immediately. Be careful not to do this if hangup penalties are in place and the player is in the middle of combat. You can check via @status. A safer method may also be @do x.

Note also that there are other commands which MegaMud will respond to (any may even generate automatically), but are primarily designed for use with partying players who are both running MegaMud. Note also that MegaMud will also recognise MudWalk party commands such as "!wait" and "!ok" (if spoken by a follower).

@relog
Causes the player to issue their defined relog command and re-logon.

@wait
Telepathed by MegaMud to the party leader if it needs to rest. This is sent to inform the leader that it should stop moving and wait for the player to heal.

@ok
Telepathed by MegaMud to the party leader when it has finished resting. This is sent after a @wait command to inform the party leader it may recommence movement. MegaMud will keep track of multiple party members and will not restart movement until all of the followers have rested.

@comeback
If you are following in a party, and you get seperated from your leader because you can't move, MegaMud will send this command to the leader. The leader will respond to this by back-tracking up to 5 rooms to try and find you (after that, he/she will continue as normal). If the leader sees you and re-invites you, the leader will continue on as normal.

@heal
Spoken by a party member as a general request for aid. MegaMud will send this if your health falls below the 'Run' mark and you are within a party. Other party members who are running MegaMud will attempt to heal the player if they are capable.

@blind
Spoken by a party member as a general request for a blindness cure. MegaMud will send this if you become blinded while in a party. Other party members who are running MegaMud will attempt to cure the player if they are capable.

@diseased
Spoken by a party member as a general request for a disease cure. MegaMud will send this if you become diseased while in a party. Other party members who are running MegaMud will attempt to cure the player if they are capable.

@held
Spoken by a party member when they become held. MegaMud will send this if you become held while in a party. Other party members who are running MegaMud will attempt to free the player if they are capable.

@party <cmd>
Spoken by the party leader, all party followers will execute the specified command. This is used in situations where the party followers need to execute some command (eg. go hole) to keep up with the party leader. The leader will then re-check the party and re-invite members if needed.

@kill <player>
Used only by party members who have the 'Defend Party' option turned on. It is used to signal to other party members that a member is being attacked by another player, and that they should all join in to help defend the party.

@share
Used only by the party leader to signal all members should share any cash collected between the rest of the party.

@panic!
Sent by the party leader as they are about to teleport or hangup due to low HP's. Allows party followers to do the same (can be disabled in the party settings dialog).