X-Git-Url: https://mudpy.org/gitweb?p=mudpy.git;a=blobdiff_plain;f=share%2Fcommand.yaml;h=fd78a03b80c99cdb50fd8572eec4e215c249396a;hp=cf3abec0ee4d0b61b081dd8017476c092d816fcc;hb=4973a481f1e367234ca0ff70a365b5ca3d0a34c7;hpb=56f918a8f40771b5fd7db125d301b8e50e9a7a32 diff --git a/share/command.yaml b/share/command.yaml index cf3abec..fd78a03 100644 --- a/share/command.yaml +++ b/share/command.yaml @@ -1,5 +1,5 @@ --- -_copy: Copyright (c) 2004-2019 mudpy authors. Permission to use, copy, +_copy: Copyright (c) 2004-2020 mudpy authors. Permission to use, copy, modify, and distribute this software is granted under terms provided in the LICENSE file distributed with this software. @@ -7,54 +7,61 @@ _desc: This is the standard library of command definitions. _lock: true -command.chat.action: mudpy.command.chat(actor) command.chat.description: Enter and leave chat mode. command.chat.help: The chat command toggles chat mode. When in chat mode, all input is passed as a parameter to the say command, unless prepended by an exclamation mark (!). For example, to leave chat mode, use:$(eol)$(eol) !chat -command.chat.see_also: say +command.chat.see_also: + - say -command.create.action: mudpy.command.create(actor, parameters) command.create.administrative: true command.create.description: Create a new element in the universe. command.create.help: Ways to create an element:$(eol)$(eol) create actor.avatar_fred_1$(eol) create other.garply foo/bar/baz -command.delete.action: mudpy.command.delete(actor, parameters) command.delete.administrative: true command.delete.description: Delete an existing facet from an element. command.delete.help: You can delete any facet of an element as follows:$(eol)$(eol) delete area.boardroom terrain -command.destroy.action: mudpy.command.destroy(actor, parameters) command.destroy.administrative: true command.destroy.description: Destroy an existing element in the universe. command.destroy.help: You can destroy any element in the universe as follows:$(eol)$(eol) destroy prop.dagger -command.halt.action: mudpy.command.halt(actor, parameters) +command.evaluate.debugging: true +command.evaluate.description: Evaluate a Python expression. +command.evaluate.help: For debugging purposes, you can use this to run certain + Python language expressions within the running engine's context, though for + safety reasons only a limited set of builtins are allowed, as well as + objects in the mudpy package namespace and the active universe object. + Expressions containing "__" or "lambda" are also prohobited for additional + safety. Everything following the word "evaluate" is assumed to be a Python + expression, and is passed to the eval() built-in, outputting a string + representation of whatever it returns. Any exceptions are caught in an + attempt to avoid accidentally crashing the engine. This command is mostly + useful for inspecting the contents of in-memory objects, for + example:$(eol)$(eol) evaluate universe.groups['actor'].keys() + command.halt.administrative: true command.halt.description: Shut down the world. command.halt.help: This will save all active accounts, disconnect all clients and stop the entire program. -command.help.action: mudpy.command.help(actor, parameters) command.help.description: List commands or get help on one. -command.help.help: This will list all comand words available to you along with +command.help.help: This will list all command words available to you along with a brief description or, alternatively, give you detailed information on one command. -command.look.action: mudpy.command.look(actor, parameters) command.look.description: Look around. command.look.help: With the look command, you can see where you are. -command.move.action: mudpy.command.move(actor, parameters) command.move.description: Move in a specific direction. -command.move.help: You move in a direction by entering:$(eol)$(eol) move - north +command.move.help: Move to another place by supplying the name of a + portal/direction or a suitable abbreviation for one, + like:$(eol)$(eol) move north$(eol) move s -command.preferences.action: mudpy.command.preferences(actor, parameters) command.preferences.description: View or change your preferences. command.preferences.help: If invoked with no parameters, all your current preferences and their values are listed. If one parameter is supplied, the @@ -64,18 +71,15 @@ command.preferences.help: If invoked with no parameters, all your current Examples:$(eol)$(eol) preferences$(eol) preferences prompt$(eol) preferences prompt $_(time)> -command.quit.action: mudpy.command.quit(actor) command.quit.description: Leave the World. command.quit.help: This will deactivate your avatar and return you to the main menu. -command.reload.action: mudpy.command.reload(actor) command.reload.administrative: true command.reload.description: Reload modules and data. command.reload.help: This will reload all python modules and read-only data files. -command.say.action: mudpy.command.say(actor, parameters) command.say.description: State something out loud. command.say.help: This allows you to speak to other characters within the same area. If you end your sentence with punctuation, the message displayed will @@ -86,16 +90,16 @@ command.say.help: This allows you to speak to other characters within the same ask, "You're sure I went the wrong way?"$(eol)$(eol)If necessary, enclose literal statements in quotation marks:$(eol)$(eol) > say "youre sure i went teh wrong way?"$(eol) You say, "youre sure i went teh wrong way?" -command.say.see_also: chat +command.say.see_also: + - chat -command.set.action: mudpy.command.c_set(actor, parameters) +command.set.action: command.c_set command.set.administrative: true command.set.description: Set a facet of an element. command.set.help: Invoke it like this:$(eol)$(eol) set actor.avatar_dominique_0 description You see nothing special. -command.show.action: mudpy.command.show(actor, parameters) command.show.administrative: true command.show.description: Show various data. command.show.help: Here are the possible incantations ( is required, @@ -105,6 +109,5 @@ command.show.help: Here are the possible incantations ( is required, data files)$(eol) show group (list the elements in a group)$(eol) show groups (list all element group names)$(eol) show log [level [start [stop]]] (list logs above level from start to - stop)$(eol) show result (evaluate a python - expression)$(eol) show time (return several current timer + stop)$(eol) show time (return several current timer values)$(eol) show version (display running version and dependencies)