LIST(Builder)

CoffeeMUD
Administrator                                                  Builder                                                              Player

=CoffeeMUD Builder Information=
Basics	Praetor     Player Support     Commands     Zapper Masks	Advanced	Races     Classes     Abilities     Socials     Scripting
Building	Behaviors     Properties     Areas     Rooms     Exits     Items     Mobs	Systems	Achievements     Crafting     Help Info     Ships     Planes of Existence     Quests     Triumphs

===LIST===
Usage:	LIST ("SHOPKEEPER") (FOR "ITEMNAME")
Examples:	list list weaponsmith list shopkeeper for shield
Shorts:
Description:	The normal player version of this command will display the items which a particular shopkeeper MOB may be selling, along with the prices being offered to your characters. If more than one shopkeeper is in the room, you may have to specify the shopkeeper name in the parameters. You may add the key word FOR and an item name to the end to filter the results. See also BUY, SELL, DEPOSIT, WITHDRAW, VIEW, BID. The Admin version can also be qualified with UNLINKEDEXITS, ITEMS, ARMOR, ENVRESOURCES, WEAPONS, MOBS, ROOMS, AREA, LOCALES, BEHAVIORS, EXITS, RACES, CLASSES, STAFF, SPELLS, SONGS, PRAYERS, PROPERTIES, THIEFSKILLS, COMMON, JOURNALS, SKILLS, QUESTS, DISEASES, POISONS, TICKS, MAGIC ITEMS, TECH, CLANITEMS, COMMANDJOURNAL, TITLES, NOPURGE, BANNED, RACECATS, LOG, USERS, LINKAGES, REPORTS, THREADS, RESOURCES, ONEWAYDOORS, CHANTS, POWERS, SUPERPOWERS, CLANS, GOVERNMENTS, FACTIONS, MATERIALS, OBJCOUNTERS, POLLS, CONTENTS, BUGS, TYPOS, IDEAS, TASKS, NEWS, AREAS, SESSIONS, or ASSISTS depending upon the listers security. Additional help *may* be available ingame by entering HELP LIST [X] where X is one of the above.

[[#LIST BUGS|

Notes

This is a very powerful command with a ton of variations.

LIST ABILITIES

===LIST ABILITIES===
Usage:	LIST ABILITIES (DOMAIN_NAME) LIST ABILITIES (DOMAIN_NAME) WIKI LIST ABILITIES (DOMAIN_NAME) WIKIHELP
Examples:	LIST ABILITIES LIST ABILITIES WIKI LIST ABILITIES NATURE_LORE
Shorts:
Description:	Shows the list of java classes (ability ids) available to archons.

Notes

This use of the LIST command can also be extended to CHANTS, COMMON, DISEASES, POWERS, PRAYERS, PROPERTIES, SONGS, SKILLS, SPELLS, SUPERPOWERS, THIEFSKILLS, and TRAPS by replacing the ABILITY keyword with the more limited keyword.

• The WIKI parameter will output the list with special formatting for easily pasting the list into a wiki page.
• The WIKIHELP parameter will output each ABILITY into specific wiki templates for that ability type.
• If a domain name has a space in it, such as "Nature Lore", use an underscore for this command, as shown in the example above.

LIST UNLINKEDEXITS

===LIST UNLINKEDEXITS===
Usage:	LIST UNLINKEDEXITS (LOG)
Examples:	List unlinkedexits list unlinkedexits log
Shorts:
Description:	Lists all the rooms which have directions for which an exit has been defined, but does not link to any room. Adding the log parameter will dump all that stuff to your mud.log

LIST ITEMS

===LIST ITEMS===
Usage:	LIST ITEMS LIST MAGIC ITEMS LIST ARMOR LIST WEAPONS LIST CLANITEMS LIST TECH
Examples:	list items list weapons
Shorts:
Description:	Shows the item java classes (item ids, magic item ids, armor ids, weapon ids, clanitem ids, tech ids) available to archons.

Notes

• Each of these lists is a separate category of java classes. There is no master list for items of all types.

LIST ENVRESOURCES

===LIST ENVRESOURCES===
Usage:	LIST ENVRESOURCES (SHORT) (MASK)
Examples:	list envresources list envresources short list envresources vegetation
Shorts:
Description:	Lists all the raw material resources defined for your mud, along with its material type, money value, frequency of occurrence, strength, and what kinds of Locales the resource may be gathered from using the appropriate skill. Adding the short parameter just shows a raw list of resource names. Adding a mask will limit the list to those things that contain the mask.

Notes

• The SHORT parameter will display a comma delimited list of resource names.
• Without the SHORT parameter, this command will display the resource name, material, value, frequency, Str(Strength) and Locales.
  • Material is the basic material type of the resource. This often determines which crafting and gathering skills are used to acquire this resource.
  • Value is the base cost of a pound of that resource. This value often modifies crafted items made with this material, as well as determines how much the resource can be sold to (or bought from) at a resource vendor.
  • Frequency is a relative weight of finding the resource with a gathering skill. The frequency of all resources available within a particular locale are added up, and a random number is chosen amongst them to determine which resources are available after the periodic resource reset. So a resource with a frequency of 4 is twice as likely to be selected as a resource with a frequency of 2, and 4 times as likely to be selected as a resource with a frequency of 1.
  • Strength is the overall durability of the item. This affects the likelihood of the item being damaged or destroyed in combat.
  • Locales are the types of rooms in which the resource can be naturally gathered.
    • This can be overridden with the ResourceOverride behavior or altered with the CommonTwister property.

LIST MOBS

===LIST MOBS===
Usage:	LIST MOBS
Examples:	list mobs
Shorts:
Description:	Shows the mob java classes (mob ids) available to archons.

LIST ROOMS

===LIST ROOMS===
Usage:	LIST ROOMS
Examples:	list rooms
Shorts:
Description:	Lists all the rooms in the current area, along with the short display name of each room.

LIST AREA

===LIST AREA===
Usage:	LIST AREA (ROOM/MOB/ITEM/SHOPS/MOBMASK/ITEMMASK) ([MASK])
Examples:	list area list area mob creeper list area mobmask -race +elf
Shorts:
Description:	Lists all the rooms in the current area, along with the locale type of each room. Optionally, a specifier can be added to search for rooms, mobs, items by name, or mobs and items by zapper mask using the mobmask/itemmask parameters.

LIST LOCALES

===LIST LOCALES===
Usage:	LIST LOCALES
Examples:	list locales
Shorts:
Description:	Shows the list of room java classes (locale ids) available to archons.

LIST BEHAVIORS

===LIST BEHAVIORS===
Usage:	LIST BEHAVIORS (WIKI/WIKIHELP)
Examples:	list behaviors
Shorts:
Description:	Shows the list of behavior java classes (behavior ids) available to archons.

Notes

This information can also be found on the wiki at the Behaviors page.

• The WIKI parameter will output the list with special formatting for easily pasting the list into a wiki page.
• The WIKIHELP parameter will output each BEHAVIOR into specific wiki templates for Behaviors.

LIST EXITS

===LIST EXITS===
Usage:	LIST EXITS
Examples:	list exits
Shorts:
Description:	Shows the list of exit java classes (exit ids) available to archons.

LIST RACES

===LIST RACES===
Usage:	LIST RACES (SHORT) (MASK) (WIKI/WIKIHELP)
Examples:	list races list races short list races avian list races wiki list races avian wikihelp
Shorts:
Description:	Shows the list of race java classes (race ids) available to archons. Races will have their racial categories shown in () next to the ID. Races with an * next to them are Generic. Adding the short parameter will only show a simple list of race ids. Adding a mask will limit the list to races containing the word.

Notes

• The SHORT parameter will provide a comma delimited list of races (or races meeting a specified mask).
• The MASK parameter should be a racial category, the first few characters of the races name, or the first few characters of a race mix.
  • For example, LIST RACES BEHOLD will display a list of all BEHOLDER racial category races, all races that start with BEHOLD, or any race mixed with a race starting with BEHOLD, such as an AirElementalBeholder or a HalfBeholder.
• The WIKI parameter will output the list with special formatting for easily pasting the list into a wiki page.
• The WIKIHELP parameter will output each ABILITY into specific wiki templates for that ability type.

LIST CLASSES

===LIST CLASSES===
Usage:	LIST CLASSES (SHORT/WIKI/WIKIHELP)
Examples:	list classes list classes short list classes wiki
Shorts:
Description:	Shows the list of char class java classes (charclass ids) available to archons. Charclasses will have their base classes shown in () next to the ID. Charclasses with an * next to them are Generic. Adding the short parameter will only show a simple list of char class ids.

Notes

• The SHORT parameter will provide a comma delimited list of classes.
• The WIKI parameter will output the list with special formatting for easily pasting the list into a wiki page.
• The WIKIHELP parameter will output each CLASS into specific wiki templates for classes.

LIST STAFF

===LIST STAFF===
Usage:	LIST STAFF
Examples:	list staff
Shorts:
Description:	Lists all the areas, along with any Area SubOps defined for those areas.

LIST JOURNALS

===LIST JOURNALS===
Usage:	LIST JOURNALS
Examples:	list journals
Shorts:
Description:	Shows the list of all Journals (message/note areas) that exist in your database, along with the number of entries in each journal.

Notes

• You can use the LIST command on any SYSTEM_ journal. For example, you can do LIST BUGS on the SYSTEM_BUGS journal.

LIST QUESTS

===LIST QUESTS===
Usage:	LIST QUESTS
Examples:	list quests
Shorts:
Description:	Lists all the quests being managed by the quest manager, along with the current status of the quest (running, or not), and if it is time-delayed, how long until the quest will attempt to start again.

LIST TICKS

===LIST TICKS===
Usage:	LIST TICKS ([GROUP NUMBER]/ACTIVE/PROBLEMS/[MASK]) (COL)
Examples:	list ticks list ticks 7 list ticks active list ticks problems
Shorts:
Description:	Shows the list of ticking objects in the game. A ticking object is simply one that may get thread time at some point from the engine. By default, each entry consists of a group id, the name of the object that is ticking, the ID of the tick-type, and a status or ! if the object is not ticking. Valid parameters include a tick group number, the word "active" to only show ticks that are currently receiving thread time, "problems" to receive a list of the ticks that have consumed the most average thread time, or a string mask to filter by object name. The last column of each report may be replaced by adding a valid column name to the end of the list command. Valid columns include: tickername, tickerid, tickerstatus, tickerstatusstr, tickercodeword, tickertickdown, tickerretickdown, tickermillitotal, tickermilliavg, tickerlaststartmillis, tickerlaststopmillis,tickerlaststartdate, tickerlaststopdate, tickerlastduration, tickersuspended.

LIST COMMANDJOURNAL

======
Usage:
Examples:
Shorts:
Description:

LIST TITLES

======
Usage:
Examples:
Shorts:
Description:

LIST NOPURGE

======
Usage:
Examples:
Shorts:
Description:

LIST BANNED

======
Usage:
Examples:
Shorts:
Description:

LIST RACECAT

======
Usage:
Examples:
Shorts:
Description:

LIST LOG

======
Usage:
Examples:
Shorts:
Description:

LIST USERS

======
Usage:
Examples:
Shorts:
Description:

LIST LINKAGES

======
Usage:
Examples:
Shorts:
Description:

LIST REPORTS

======
Usage:
Examples:
Shorts:
Description:

LIST THREADS

======
Usage:
Examples:
Shorts:
Description:

LIST RESOURCES

======
Usage:
Examples:
Shorts:
Description:

LIST ONEWAYDOORS

======
Usage:
Examples:
Shorts:
Description:

LIST CLANS

===LIST CLANS===
Usage:	LIST CLANS
Examples:	list clans
Shorts:
Description:	Lists all the clans in your mud, along with the number of members each clan has.

LIST GOVERNMENTS

===LIST GOVERNMENTS===
Usage:	LIST GOVERNMENTS
Examples:	list governments
Shorts:
Description:	Lists all the clan governments that have been defined in your mud.

LIST FACTIONS

===LIST FACTIONS===
Usage:	LIST FACTIONS
Examples:	list faction
Shorts:
Description:	Lists the friendly names of all the factions defined in your game, along with the file/path that defines that faction.

LIST MATERIALS

===LIST MATERIALS===
Usage:	LIST MATERIALS
Examples:	list materials
Shorts:
Description:	Lists all the base material types. Use list ENVRESOURCES for what you probably want.

Notes

This provides a comma delimited list of material types, which is a useful way to limit list ENVRESOURCES queries.

LIST OBJCOUNTERS

===LIST OBJCOUNTERS===
Usage:	LIST OBJCOUNTERS
Examples:	list objcounters
Shorts:
Description:	Deprecated, but may be revived again in the future if I start seeing memory consumption issues.

Notes

DEPRECATED COMMAND.

LIST POLLS

===LIST POLLS===
Usage:	LIST POLLS
Examples:	list polls
Shorts:
Description:	Lists all the player polls currently defined in the game.

Notes

Use the POLL command to view the results of polls.

LIST CONTENTS

===LIST CONTENTS===
Usage:	LIST CONTENTS (AREA/[AREA NAME])
Examples:	list contents list contents area list contents Mud School
Shorts:
Description:	Lists all the mobs and items in the current room, along with their level and alignment. Adding an AREA parameter will do this for the whole current area, or you can enter the name of a particular area.

LIST BUGS

===LIST BUG===
Usage:	LIST (CMDJOURNAL NAME) (TO)
Examples:	LIST BUGS LIST BUGS LOKI LIST TYPO LIST TASK LIST IDEA LIST NEWS LIST ASSIST
Shorts:
Description:	Lists all the entries in the SYSTEM_(CMDJOURNAL NAME) journal. An optional name can be appended to show entries assign to that name.

Notes

This LIST command works with any SYSTEM_CMDJOURNAL. To edit the entries (including deleting, assigning or transferring), use the REVIEW command.

• In the Mud Grinder, you can only assign entries to players or entities that already have an entry assigned to them.
• In the Command Line, you can assign an entry to any player, or even a non-player.
  • It is recommended to use an underscore before a non-player entity name. For example _DueByJanuary would be a great name for an assigned entry.

LIST AREAS

===LIST AREAS===
Usage:	LIST AREAS (SORTBY [COLUMN]...) (COLS [COLUMN]...))
Examples:	list areas list areas sortby cols name population list areas sortby name
Shorts:
Description:	Lists all the standard areas in your game. By default, it also shows whether the area is Hidden, how many rooms are in the area, whether it is in a passive or active state, its current population, and the median level. If the sortby parameter is used, then you can follow it with the order of columns to sort by. Valid columns include: NAME, AUTHOR, DESCRIPTION , ROOMS, STATE, HIDDEN, POPULATION, MIN_LEVEL, MAX_LEVEL, AVG_LEVEL, MED_LEVEL, AVG_ALIGNMENT, MED_ALIGNMENT, TOTAL_LEVELS, TOTAL_INTELLIGENT_LEVELS, VISITABLE_ROOMS, INDOOR_ROOMS. If the columns parameter is used, then you can follow it with columns to substitute in the table.

LIST SESSIONS

===LIST SESSIONS===
Usage:	LIST SESSIONS (STATUS/VALID/NAME/IP/IDLE)
Examples:	list sessions list sessions name
Shorts:
Description:	Lists the players online, their idle time, status, and ip address. An optional parameter may be given to sort by one of the fields.

Other lists to be added

LIST AREATYPE, LIST REALESTATE