Item

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> [<new name>] - clones an existing prototype to a new one (also opens for editing) item rename <match regex> <replacement text> - bulk renames active item prototype names using case-sensitive .NET regex replacement syntax Quote regexes containing spaces. Replacement text may use numbered groups such as $1 or named groups such as ${name}. The command previews every matched Current, Pending Revision and Under Design revision, validates the final name set, and changes nothing if any name conflicts or is invalid. Example: item rename "^old_(?<name>.+)$" "new_${name}" item renameunique <match regex> <replacement text> - bulk renames active item prototype unique lookup names Use this command for stable builder and script references. It preserves the existing unique-name validation rules. Example: item renameunique "^antiquity_(?<name>.+)$" "historic_${name}" 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