Command reference
Item
Command words: item
Permission: JuniorAdmin
The item command is used to edit, view and load item prototypes. The editing sub-commands are all done on whichever item prototype the builder currently has open for editing.
You should also see the related component command. Components are what give items their functionality (like being containers, being weapons etc).
The valid sub-commands and their syntaxes are as follows:
item list [<filters>] - lists all item prototypes. See below for filters.
all - includes obsolete and non-current revisions
mine - only shows items you personally created
by <account> - only shows items the nominated account created
reviewed <account> - only shows items the nominated account has approved
+<keyword> - only shows items with the nominated keyword, unique name or builder comment text
-<keyword> - excludes items with the nominated keyword, unique name or builder comment text
comment:<text> - shows only items whose builder comment contains the text
<type> - shows only items that have a component of the specified type
*<tag> - shows only items that 'are' the specified tag
item load [<quantity>] <id|unique name> [<extra args>] - loads an item into the game. See below for extra args:
variable=value|id - sets a specific variable
variable="value" - same as above, for variable values with spaces
*<skin name|id> - sets a skin for the item. Must be the first extra argument
item edit new - creates a new item prototype
item edit <id|unique name> - opens a prototype for editing
item edit - shows the currently open item. Equivalent to doing ITEM SHOW <ID> on it.
item edit submit - submits the open item for review
item edit close - closes the open item
item edit delete - deletes the open item prototype (only if not yet approved)
item edit obsolete - marks the item as obsolete, and no longer loadable
item show <ID> - shows info about prototype with ID
item review all|mine|<admin name>|<id> - opens the specified item prototypes for review and approval
item clone <id|unique name> - clones an existing prototype to a new one (also opens for editing)
item set add <id|name> - adds the specified component to this item
item set remove <id|name> - removes the specified component from this item
item set unique <name> - sets an optional unique lookup name for this item template
item set unique clear - clears the unique lookup name
item set comment <text> - overwrites the builder comment for this item template
item set comment append [<text>] - appends to the builder comment, using an editor if no text is supplied
item set comment edit - edits the builder comment in an editor
item set comment clear - clears the builder comment
item set noun <noun> - sets the primary noun for this item. Single word only.
item set sdesc <sdesc> - sets the short description (e.g. a solid iron sword)
item set ldesc <ldesc> - sets an overrided long description (in room) for this item
item set ldesc none - clears an overrided long description
item set desc - drops you into an editor to enter the full description (when looked at)
item set suggestdesc [<optional extra context>] - asks your GPT model to suggest a description
item set size <size> - sets the item size
item set weight <weight> - sets the item weight
item set material <material> - sets the item material
item set quality <quality> - sets the base item quality
item set cost <cost> - sets the base item cost
item set tag <tag> - adds the specified tag to this item
item set untag <tag> - removes the specified tag from this item
item set priority - toggles this item being high priority, which means appearing at the top of the item list in the room
item set colour <ansi colour> - overrides the default green colour for this item
item set colour none - resets the item colour to the default
item set onload <prog> - toggles a particular prog to run when the item is loaded
item set canskin - toggles whether players can make skins for this item
item set register <variable name> <default value> - sets a default value for a register variable for this item
item set register delete <variable name> - deletes a default value for a register variable
item set morph <item#|unique name|none> <seconds> [<emote>] - sets item morph information. The 'none' value makes the item disappear.
item set morph clear - clears any morph info for this item
item set group <id|name> - sets this item's item group (for in-room grouping)
item set group none - clears this item's item group
item set destroyed <id> - sets an item to load up in-place of this item when it is destroyed
item set destroyed none - clears a destroyed item setting
item set strategy <id|name> - sets a custom health strategy for this item
item set strategy none - sets the item to use the default item health strategy
item set extra add <prog> - adds a new extra description slot with a specified prog
item set extra remove <which#> - removes the specified numbered extra description
item set extra swap <first#> <second#> - swaps the evaluation order of two extra descriptions
item set extra <which#> sdesc <sdesc> - sets the short description for the extra description
item set extra <which#> clear sdesc - clears the short description for the extra description
item set extra <which#> desc <desc> - sets the full description for the extra description
item set extra <which#> clear desc - clears the full description for the extra description
item set extra <which#> addendum <text> - sets an addendum text for the full description
item set extra <which#> clear addendum - clears the addendum text for the full description
Permission: JuniorAdmin
The item command is used to edit, view and load item prototypes. The editing sub-commands are all done on whichever item prototype the builder currently has open for editing.
You should also see the related component command. Components are what give items their functionality (like being containers, being weapons etc).
The valid sub-commands and their syntaxes are as follows:
item list [<filters>] - lists all item prototypes. See below for filters.
all - includes obsolete and non-current revisions
mine - only shows items you personally created
by <account> - only shows items the nominated account created
reviewed <account> - only shows items the nominated account has approved
+<keyword> - only shows items with the nominated keyword, unique name or builder comment text
-<keyword> - excludes items with the nominated keyword, unique name or builder comment text
comment:<text> - shows only items whose builder comment contains the text
<type> - shows only items that have a component of the specified type
*<tag> - shows only items that 'are' the specified tag
item load [<quantity>] <id|unique name> [<extra args>] - loads an item into the game. See below for extra args:
variable=value|id - sets a specific variable
variable="value" - same as above, for variable values with spaces
*<skin name|id> - sets a skin for the item. Must be the first extra argument
item edit new - creates a new item prototype
item edit <id|unique name> - opens a prototype for editing
item edit - shows the currently open item. Equivalent to doing ITEM SHOW <ID> on it.
item edit submit - submits the open item for review
item edit close - closes the open item
item edit delete - deletes the open item prototype (only if not yet approved)
item edit obsolete - marks the item as obsolete, and no longer loadable
item show <ID> - shows info about prototype with ID
item review all|mine|<admin name>|<id> - opens the specified item prototypes for review and approval
item clone <id|unique name> - clones an existing prototype to a new one (also opens for editing)
item set add <id|name> - adds the specified component to this item
item set remove <id|name> - removes the specified component from this item
item set unique <name> - sets an optional unique lookup name for this item template
item set unique clear - clears the unique lookup name
item set comment <text> - overwrites the builder comment for this item template
item set comment append [<text>] - appends to the builder comment, using an editor if no text is supplied
item set comment edit - edits the builder comment in an editor
item set comment clear - clears the builder comment
item set noun <noun> - sets the primary noun for this item. Single word only.
item set sdesc <sdesc> - sets the short description (e.g. a solid iron sword)
item set ldesc <ldesc> - sets an overrided long description (in room) for this item
item set ldesc none - clears an overrided long description
item set desc - drops you into an editor to enter the full description (when looked at)
item set suggestdesc [<optional extra context>] - asks your GPT model to suggest a description
item set size <size> - sets the item size
item set weight <weight> - sets the item weight
item set material <material> - sets the item material
item set quality <quality> - sets the base item quality
item set cost <cost> - sets the base item cost
item set tag <tag> - adds the specified tag to this item
item set untag <tag> - removes the specified tag from this item
item set priority - toggles this item being high priority, which means appearing at the top of the item list in the room
item set colour <ansi colour> - overrides the default green colour for this item
item set colour none - resets the item colour to the default
item set onload <prog> - toggles a particular prog to run when the item is loaded
item set canskin - toggles whether players can make skins for this item
item set register <variable name> <default value> - sets a default value for a register variable for this item
item set register delete <variable name> - deletes a default value for a register variable
item set morph <item#|unique name|none> <seconds> [<emote>] - sets item morph information. The 'none' value makes the item disappear.
item set morph clear - clears any morph info for this item
item set group <id|name> - sets this item's item group (for in-room grouping)
item set group none - clears this item's item group
item set destroyed <id> - sets an item to load up in-place of this item when it is destroyed
item set destroyed none - clears a destroyed item setting
item set strategy <id|name> - sets a custom health strategy for this item
item set strategy none - sets the item to use the default item health strategy
item set extra add <prog> - adds a new extra description slot with a specified prog
item set extra remove <which#> - removes the specified numbered extra description
item set extra swap <first#> <second#> - swaps the evaluation order of two extra descriptions
item set extra <which#> sdesc <sdesc> - sets the short description for the extra description
item set extra <which#> clear sdesc - clears the short description for the extra description
item set extra <which#> desc <desc> - sets the full description for the extra description
item set extra <which#> clear desc - clears the full description for the extra description
item set extra <which#> addendum <text> - sets an addendum text for the full description
item set extra <which#> clear addendum - clears the addendum text for the full description