User Tools

Site Tools


player_commands

Player Commands

Much of this information is copied from the server files (server/lib/help). All commands can be issued by using the meta-command “'” from a client.

General

afk

Toggles the Away From Keyboard (AFK) status of the player.

When the command is typed, the final status is shown:

You are now AFK
You are no longer AFK

The AFK status affects the output of the 'who command. For example:

Total Players in The World. (2) -- WIZ(0) AFK(1) BOT(0)

FIXME - clarify documentation here and in the server help.

apply

Apply applies an object.

If no options are given, it applies to an object you are standing on.

If a name follows the command, an object of that name is affected. The name does not have to be complete as long as the text uniquely matches the first part of an item name.

Apply options:

  • -a: Always apply an object and never unapplies it when already applied.
  • -u: Always unapply an object and never apply it when already unapplied.
  • -o: Always open a container regardless of the previous state.
  • -b: Apply an item on the ground or in the active container, but not one in the character's main inventory.

As -a and -u do not toggle the applied status of an item, they are useful for making keybindings that work even when the current state of the object is unknown.

applymode

Applymode controls what happens when you are equipping something that would require something else to be unequipped.

The options are:

  • nochoice: In this case, if there is no choice for the item(s) being removed in order to equip your new item. An example of this is a wand - there can only be one other item needed to be unequipped for the new item to be equipped. Note that in the case of two handed objects, like bows, it can result in two (or more) items being unequipped to equip your new item.
  • never: In this case, it will never unequip something for you. It will instead tell you what you need to unequip - this can be a list of many objects.
  • always: This will unequip whatever is needed to equip your new item.

An example of how the above works:

If your character currently has two rings and tries to equip a third, the nochoice mode will print the two rings you currently have equipped. The always mode will unequip one of the rings in your inventory. The ring unequipped is fairly indeterminate - it depends on how the server has ordered your inventory (which is not the same as the order your window displays).

If your character is currently wearing a suit of armor, and you try to equip another suit, both nochoice and always will cause the new suit to get equipped.

See Also: apply

bind

The bind command is used to associate a skill or skills, action, command, alias, or shortcut to a keyboard key or key sequence (i.e., shift + F3).

Syntax:

bind [-nfregc] <command>

Flags (default -nrf):

  • n - used in normal-mode
  • f - used in fire-mode
  • r - used in run-mode
  • e - leave command in line edit
  • g - global key (not recommended)
  • c - Java client only: bind for this character only, this can be convenient if you play multiple characters

Multiple commands can be bound to the same key be separating them with semicolons.

Special bind's:
  • bind commandkey - sets commandkey
  • bind firekey1 - sets first firekey
  • bind firekey2 - sets second firekey
  • bind runkey1 - sets first runkey
  • bind runkey2 - sets second runkey
  • bind prevkey - shows last commandline command from history
  • bind nextkey - when have used prevkey, goes forward in commandline history
Examples:
bind -f cast paralyze (F3)

will typically mean that Shift-F3 is used to select that spell (Shift being the fire key)

bind use_skill sense curse; use_skill sense magic (f)

will bind those two commands to the f key.

The keybindings are stored in the keys file inside the hidden .crossfire directory of your HOME folder.
Sometimes it makes sense to edit that file in a simple text-editor,
especially when many keybindings are to be added,
instead of using the bind command in the commandline all the time.

See Also : unbind

body

Syntax:

body

Displays three columns of information about the character's body and notably slots where equipment may be applied.

The first column is the name of the body location. The second column is how many of those locations your body has. The third column is how many slots in that location are available in your range slot.

For example:

on your arm                        2     0
on your body                       1     0
on your head                       1     0
around your neck                   1     0
in your skill slot                 1     0
on your finger                     2     0
around your shoulders              1     0
on your feet                       2     2
on your hands                      2     0
around your wrists                 2     0
around your waist                  1     0
around your legs                   2     2

From the example above, this character is NOT wearing anything on their feet (i.e., no boots) and not wearing anything on their legs (i.e, no pants).

bowmode

Bowmode controls how you will fire arrows and bolts.

The options are:
  • Normal: As you would expect.
  • Threewide: Fires three arrows in parallel.
  • Spreadshot: Fires three arrows that spread out over a distance.
  • Fire<direction>: Locks in the direction the missiles will fire, specify by compas position: firenorth, firene, fireeast, firese, firesouth, firesw, firewest, firenw
  • Bestarrow: Selects and fires the probable best arrow from your inventory.

brace

When you enter the 'brace' command to brace your character, your character will no longer move. You can still attack adjoining spaces. Bracing can be useful to hold a location.

When you are braced, you lose your dex bonus and incur a 2 point ac penalty beyond that (if you have a negative dex bonus, you may in fact come out ahead.)

You also only get 20% of the normal experience for killing creatures, and incur a 4-point wc (to hit) penalty.

See also braced .

cast

You use the cast command to set your range-weapon to the spell you want.

Example:
'cast burning hands

sets your RANGE weapon to 'spell: burning hands'

If you don't know the spell, the command output will show which spells you do know.

It is helpful to bind strings like 'cast burning hands' to keys.

See Also: bind See Also: range See Also: invoke

chat

Sends a message to all players on the server.

NOTE: Dialog with NPCs, they will only use and respond to the say command, so make sure to reference that when interacting with them.

See Also: say See Also: tell See Also: shout

clearinfo

Usage: clearinfo

Cause all text (chat, shouts, attack and action information, et al.) displayed in the client to be removed or purged.

Client-specific command: gtk-v2

FIXME - clarify documentation?

death

Death is not the final end for your character!

When your character reaches -1 hit points or less, they experience death in the game.

The first effect of death is, they are automatically transported back to their last used savebed (bed to reality). Pretty much means they are safely removed from the danger of the attacking monster or trap. Careful of your own spells though!

Next, your character has lost some percentage of experience points in all skills. This amount will vary by server configuration. The only way to restore the lost experience is to regain it by slaying monsters, disarming traps, using spells to slay monsters, etc.

Your character has also lost stat (as in Str, Dex, Con, etc.) points. More stats are lost at higher character levels. But, this can vary based on server settings. Don't worry, this stat loss is not permanent. You can restore the lost stats in a couple of ways.

One way is to consume a Potion of Life which can be found in various shops (Such as House of Healing in Scorn), as quest rewards, or as random treasure. Which type of Potion of Life you need will depend on your character level.

High-level characters will need a Supreme Potion of Life while a low-level character will need a Minor Potion of Life. A single potion will restore any and all lost stats from any and all character deaths they accumulated.

Another way to restore lost stats is if you have the Praying skill, at a certain level in that skill, and follow a cult that grants Restoration. That means, having your character pray long enough on your cult's altar can eventually restore all the lost stats from all deaths.

delete

The delete command will permanently delete the active character (or, who you are logged in as) from the server.

Usage

delete

When the command is executed, you will be prompted with a yes or no response to confirm character deletion.

Hit 'y' to proceed with the character removal Hit 'n' to cancel the process Hit enter again to exit the process and you will see a message “OK, continuing to play.”

The JX Client will display a popup window to ask you to hit y or n. The GTKv2 Client asks y or n in the Messages window.

This will not delete your login account or any of your other characters associated with your player account, just the active character file along with any of their apartments and the content of those unique maps.

NOTE: On older servers, this command does not exist. The delete command was added to avoid confusion with the quit command which back then was used to purge the active character file in those older servers.

See also: quit

dip

Mark an item (such as an empty potion bottle) and then use the apply command while standing over a fountain for a chance to fill the bottle (or other objects) with water for drinking.

Lore

Travelers refilling their empty bottles at fountains around the world often claim that water from their hometown tastes the best. This apparent conundrum was settled by leading alchemists from Nurnberg, who found no material differences between bottles of water collected from various fountains around the world.

Still, this was not enough reason to sway the fanciful; some claim that fantastic things happen when they 'dip' their empty bottles or other belongings into fountains.

disarm

An alternative form of use_skill disarm traps.

server/trunk/server/c_object.c code comments suggest: These functions (command_search, command_disarm) are really just wrappers for things like 'use_skill …'. In fact, they should really be obsoleted and replaced with those.

dm

Usage:

'dm password

Become a dungeon master. The server must be configured to allow the player to become a dungeon master or else the message Sorry Pal, I don't think so. is displayed.

Upon success, the server responds:

The Dungeon Master has arrived!
Ok, you are the Dungeon Master!

All players see a The Dungeon Master has arrived! message.

dmhide

Usage:

'dmhide password

An alternative to the dm command. The server must be configured to allow the player to become a dungeon master or else the message Sorry Pal, I don't think so. is displayed.

Upon success, the system responds:

Ok, you are the Dungeon Master!
Other players will no longer see you.
//Player// leaves the game.
//Player// left the game.

It appears to other players that a player logged off rather than indicating that he is now a dungeon master.

drop

The “drop” removes objects from the player's inventory and puts them on the floor or in an opened container.

Multiple formats are possible.

drop [number] name

name is the name of the item(s) to drop. It may match multiple items. The name is matched against the start of the objects in your inventory. The name matching is case insensitive.

There are a few special name values:
  • all - matches any item.
  • unpaid - matches unpaid items
  • cursed - drops items known to be cursed or damned
  • unlocked - drops items not locked in your inventory

number is optional. This acts as the number of the object to drop. The object's number must be at least the number for it to be dropped. For example, if you do 'drop 10 scroll', only groupings of 10 or more scrolls will be dropped. A collection of 5 scrolls will not be dropped.

drop * <item type>

Drop all items of the specified type. Types are the same as the “pickup” command.

drop # <item index>

Drop the item at the specified index. Index 1 is the last item taken, and so on.

See also 'dropall' and mouse button control within client for dropping objects.

dropall

Syntax:

dropall [type]

The dropall command drops all items in your inventory to the ground, except locked items. The type parameter will also control what is dropped:

  • 'empty' (e.g., nothing specified): drops all objects except food, money, keys, and containers
  • weapons: drops weapons, bows, and arrows
  • armor (armor): drops armor, shield, and helmets
  • misc: drop horns, books, girdles, amulets, rings, cloaks, boots, gloves, bracers, scrolls, wands, rods, and potions
  • food: drops food and drink
  • flesh: drops all flesh

See also drop and mouse button control within the client for dropping objects

empty

Empty will put all contents of the specified container either on the ground or in your opened container.

Syntax: empty <item>

<item> should be a container.

If “all” is specified (i.e., empty all), all containers are emptied.

examine

Usage:

examine examine item

Show detailed information about an item

If the item name is not specified, the information will be about an item the character is standing on

If the item name is specified, information about one item is shown

The item name may be a partial match. For instance, examine scroll shows information about a scroll

explore

Usage:

explore

This command must be enabled by a crossfire server administrator. The default settings leave this command disabled such that the server responds Explore mode is disabled on this server, sorry..

face

Usage:

face <direction>

face <direction> changes the direction you are facing without taking any other action.

fire

Turns on fire mode. Normally this is done automatically when using the fire key + direction combination. However, it is possible to invoke it manually, in which case the character will commence firing as quickly as possible in whatever direction is specified after the command is issued, either by the arrow keys or by typing it out.

To fire only once you can use <direction command> f. For example: “fire 1” starts to fire northeast until “fire_stop”. The command “northeast f” fires once to the northeast.

Use “stay f” to target yourself.

You can turn off the fire command with fire_stop. To make a script or keybinding fire a single time in a particular direction, prefix the direction to the fire command. For instance, “east fire”

See Also: fire_stop

fire_stop

Usage:

fire_stop

Cancels fire mode. Normally this is done automatically when using the fire key+direction combination. However, if one's character becomes stuck in fire mode, issuing this command should return it to normal.

Especially useful when using the fire command in scripts, to fire a skill like punching onto a spot, then the fire command should be terminated by fire_stop immediately. When a script exits then the player is still firing and they are in a distressed situation, it is very uncomfortable to type in fire_stop in the command line.

See Also: fire

fix_me

Calls the object_sum_weight() and fix_object() server functions on the player's character.

FIXME - Add documentation here and in the server help.

follow

syntax: follow <player name>

Follow another player, including through exits and into permanent apartments. The player you are following must be in the same party as you. You can only start following another player if they are adjacent to you. To stop following, type 'follow' without any arguments.

forget_spell

The forget_spell command will cause your currently logged-in character to permanently lose knowledge of the specified spell.

Usage:

forget_spell <spell name>

Example:

forget_spell light
You lose knowledge of light.

get

A variant of the take command that allows an item count to be specified. For example:

get 10 platinum

Another useful count is `all' to act like pickup 4 and pickup 5:

get all

See Also: take See Also: pickup

give

FIXME - Add documentation here and in the server help. The give command is not listed by help commands.

golem

Golems are creatures that the player has some control over. Note that many summoned creatures are considered golems, even if they are not called golems.

If you have a golem in control your spell type will be listed as golem, with the creature name in parentheses.

To control your golem, just press the fire key in the direction you want your golem to move. Your golem will then start moving in that direction, and keep moving in that direction until you change its direction.

Note that once you leave the map that the golem is on, the golem will disappear. Also, once you select another spell to cast, or change your range type, your golem will disappear.

invoke

The invoke command is used to cast a spell immediately, or when it is necessary to give a parameter to the spell. Invoke will not set the range weapon.

Examples:
  • 'invoke restoration
  • 'invoke magic rune of large fireball
  • 'invoke reincarnation of Iamdead
  • 'invoke create food of waybread

It is very helpful to bind healing spells to keys like this:

'bind invoke medium healing
c

the c key now casts medium healing instantly

See Also: cast

killpets

Usage:

killpets
kippets <petname>

The killpets command is a quick and convenient way to get rid of all your pets when they are no longer useful or are getting in the way. Any equipment they had will be left behind, but you will get no experience for their death. However, it kills them instantaneously.

If a name is specified then only pets with that name will be killed, eg killpets bat will kill bats but not bees. If a number is specified, the pet corresponding to that number is killed.

knowledge

Displays known relevant information.

Without any parameter, displays this help text.

When using “knowledge list”, you can see all you know. An additional parameter can restrict the output to a specific knowledge type. The available types are:

  • alchemy
  • god
  • message
  • monster

With “knowledge show <number>”, displays details about the specified item.

With “knowledge search <text>”, displays things having <text> in summary or detail.

With “knowledge attempt <number>”, attempts to do alchemy or equivalent based on that recipe.

language

Lists the player's current language settings and the server-supported settings.

language
  Your current language is set to: English
  Available languages:
  en: English
  fr: Français
  nl: Nederlands
  it: Italiano
  de: Deutsch

To set the player's language, specify the language command with a two-letter language identifier after it.

language en
  Your language setting has been changed to: English

If translations for a particular language are missing or incomplete, English messages are output by default.

listen

Listen, sets the level of messages you will hear.

Adjust the listening level to determine the messages visible to the player. Set it to 1 for only important messages, like when a player shouts, or choose 15 for verbose mode, displaying every message.

If no parameters are set, the current listen level is shown:

listen
  Set listen to what (presently 10)?

If a numeric listen level is specified, the follow message is output:

listen 10
  Your verbose level is now 10.

FIXME: Document the meaningful listen levels and what they do.

lock

Toggle the lock status of an item inventory. Locked items cannot be accidentally dropped.

Usage:

lock <item name>

<item name> can be either all or part of an item's name. If multiple items could meet the partial name's criteria, the first one encountered will be selected. It should be noted that the first item encountered in inventory may not correspond to the first item listed in the inventory window.

Locked items need to be unlocked in order to be dropped. Using the locked command a second time on the same item name will unlock the item.

Locked items appear with an asterisk (*) next to the item in your inventory view.

shield * 

Specify the name of the item to lock or unlock as a parameter.

lock
  Lock what item?
lock rucksack
  Locked rucksack
lock rucksack
  Unlocked rucksack

It is also possible to lock or unlock items by holding down the shift key and left-clicking with your mouse on the item or items in your inventory.

mapedit

The 'mapedit' client command obtains the map the player is currently on using 'mapinfo' and launches the map editor given by the environment variable CF_MAP_EDITOR on the path.

This is intended to make launching the map editor easier.

This is a GTKv2 Client only command.

mapinfo

The command mapinfo gives information about the map you are currently on.

Output format:

<map name> (<map path>) in <map region>
Created: <date> <developer name> [<developer email>]
[Modified: <date> <developer name> [<developer email>]]

This information is predominantly used for bug reports and similar development operations.

maps

Use the maps command to check on whether or not a map or several maps are in use.

Usage:

maps
maps <region short name>
maps <partial file name>
maps <partial folder path name>

Examples:

'maps brest
'maps shop
'maps apart

The headers shown are:

Current time is = current real time on the server
Path = the map file path on the server
Reset In (HH:MM:SS) = real time on server when the map will reset
Pl = players
IM = in memory
TO = timeout until the map is saved to disk

mark

The command mark is used to mark items for items that apply to other items. Examples of these are flint & steel marked for applying torches, or a weapon marked for improve weapon scrolls.

Examples of use:

  mark sword +3
  mark three torches
  mark broadsword

mark will look for the best match first and then look for matches based on shortened name, object name, or archetype name. It prints the match it finds.

mark without options shows your currently marked item.

'mark
  broadsword (wielded) is marked

It is also possible to mark or unmark an item by holding down the shift key and middle-clicking with your mouse on the item in your inventory.

melee

You fight to kill monsters. You can either use magic or weapons.

To use weapons, simply wield a weapon (and wear armor!) and move into the monster you want to attack.

To use magic or bows, read

  'help spells

and

  'help range

and

  'help cast

and

  'help invoke
  

See Also: spells See Also: range See Also: cast See Also: invoke

mode

The mode commands are as follows:

  • applymode - adjusts how items are applied
  • bowmode - adjusts the way bows work
  • peaceful - sets how you react to other players
  • petmode - adjusts how your pets behave

See Also: applymode See Also: bowmode See Also: peaceful See Also: petmode

motd

The command motd displays the server's Message Of The Day file

mouse

The mouse is one possible way to move your character. But is primarily used to interface with objects and items in the game.

In the map view:

  • Left-click: shows what the distant object is by name (i.e., sign or monster name)
  • Middle-click: use an active range attack such as fire arrows or cast a spell in the direction you click relative to your character
  • Right click on the map view and a yellow square will appear on the map, your character will attempt to move to that location by taking the shortest possible path.
  • Right click on a monster and your character will attack that monster

Also, the mouse has the following inventory uses:

  • Left button: identify or examine the item
  • Middle button on item: apply or equip or consume the item (i.e., eat food item, read a scroll or book or spellbook)
  • Right button: drop the item(s) from your inventory to the ground or places the item(s) in an open or active container (i.e., pouch or chest or sack)

The mouse command can use use keyboard commands for special applications in the Inventory window:

  • Left button + shift key: lock or unlock a clicked inventory item, see lock
  • Middle button + shift key: mark a clicked item (i.e., mark a torch & then apply flint and steel to light the torch), see mark

The mouse has the following uses of items in the You see window:

  • Left button: identify or examine the item
  • Middle button: apply item (i.e., lever) if possible or applicable
  • Right button: picks up the item(s) and adds it to your inventory

See Also: lock See Also: mark See Also: apply See Also: drop See Also: get See Also: take

news

The news command will display the server news file.

See Also: motd See Also: rules

nextkey

This bound key allows you to move back through your previously used commands. This works best if you already have a key bound to the command called prevkey.

You can also edit the command from the prevkey command list before you run it.

This is just like the down arrow under most command-line interfaces (CLI).

Special note for GTKV2, one has to use the bind command (i.e., 'bind nextkey) as the the keybinding GUI does not work with this command.

See Also: prevkey See Also: bind

output

The output count and sync commands are obsoleted as of server commit to SVN on 2009-08-14. The output count and sync feature is now client-side. The gtk-v2 implementation went stable 2009-09-03. jxclient has a client-side implementation as well. The gtk-v2 uses a fully graphical configuration dialog - not a command-based interface.

As of version 0.91.7, new output handling was added. The behaviour is controlled with the output-sync and output-count commands.

  • output-sync controls how often information is sent to the screen. Each buffer has its own time value, and will be flushed independantly. The default value is 16 ticks (about 2 seconds).
  • output-count sets after how many messages of the same type, they are then printed out. If the value was 10, then after killing ten orcs, the message '10 times you kill orc' would be printed out. The default value is 1 - this means that all messages get printed out as they are requested - buffering is disabled in this regard.

output-count

see output

output-sync

see output

partial_commands

Control whether commands can match partially or not.

When disabled, a command must match exactly to be executed.

When enabled, the first letters of a command are enough if there is no ambiguity with other commands.

Usage: partial_commands <1 or on, or 0 or off>

Without any argument, the command displays the current status.

Example:

  • when disabled, pe and pet are unknown commands
  • when enabled, pe is an unknown command, because it can mean peaceful or petmode, but pet will be equivalent to petmode

party

The 'party' command enables the creation of adventurer groups.

A group of adventurers shares gained experience between members and has a private communication channel. You can't be a member of multiple parties. Note that a party is not a guild.

Party membership is not saved between sessions by default, but this behavior may be changed through the 'party_rejoin' command.

party join <partyname>

Puts you in a party, and prompts you for a password if there is one.

party form <partyname>

Forms a party and puts you as the leader, partyname has a maximum of 32 characters. At the moment, being a party leader does nothing. May be used in the future.

party list

Lists currently formed parties and their 'leader'.

party passwd <password>

Changes the password for the party you are a member of, 8 character max.

party who

List the members of the party you are in.

party say <message>

Sends the message to party members.

party leave

Takes you out of the current party.

party_rejoin

Controls whether to rejoin or not party at login.

Valid modes are:

  • no: don't rejoin party
  • if_exists: if the party exists when you login, and has the same password as when you logged off, you'll join it
  • always: if the party doesn't exist, create it with last password; else behaves like if_exists.

With no argument, displays the mode.

passwd

The passwd command allows you to change your server or game account password

Usage:

passwd

It prompts you for your current password, your new password, and a confirmation of your new password.

Leaving any of these prompts blank cancels the password change operation.

peaceful

The 'peaceful' command will switch you between peaceful and hostile attack modes.

Usage

peaceful

When peaceful is on you will not automatically attack other players when bumping into them and will do reduced damage against other players if you do attack them (friendly fire).

Having peaceful mode enabled only lowers damage against other players, it does not affect damage done to monsters or other NPCs, so it is generally advisable to remain in peaceful mode unless you are looking for trouble.

It is still entirely possible to kill other players when in peaceful mode so you should still be careful when interacting with other players.

Hostile mode (peaceful off) will enable melee combat when bumping into other players and does normal damage for other attacks as well.

Damage done by area effect attacks like cone spells, explosive detonations, fireballs, poisons, cloud or swarm attacks, runes, or disease is not modified by peaceful/hostile mode.

WARNING: Running around with hostile on means other players AUTOMATICALLY hit back when you bump them. If your low level character bumps into a high enough level melee character your character will die. Using hostile on servers that frown on player killing (PK) is just not smart and will likely result in your being banned from that server.

FIXME - Add a help file for hostile? It is not an actual command, but is often referenced so might be a good idea to have an explanation on that command?

petmode

Petmode controls how your pets (charmed monsters) will behave.

Usage

petmode normal
petmode sad
petmode defend
petmode arena
The options are:
  • Normal: As you would expect.
  • SAD (Search and Destroy): Pets will roam and seek out things to attack.
  • Defend: Pets will try to stay close and defend you.
  • Arena: As normal, except that pets will attack other players in the arena.

FIXME - improve summary of petmode normal

pickup

The pickup command changes how you pick up items when you step on them.

To pickup items manually, use the ',' (comma) key, or see the player commands get and take.

  • Mode 0: Don't pick up items.
  • Mode 1: Pick up one item
  • Mode 2: Pickup up one item and stop
  • Mode 3: Stop before picking up items
  • Mode 4: Pick up all items
  • Mode 5: Pick up all items and stop
  • Mode 6: Pick up all magical items
  • Mode 7: Pick up all coins and gems

Modes above 7: Pickup items with a value density greater than the pickup mode.

Value density is value in gold/weight in kilograms.

The value in gold is what the item is worth if you sold it in the shop.

Gold coins have a value density of 66,

Density 10 will pickup silver, gold, rings, wands, books, and scrolls. Artifacts are also picked up.

You can also use the syntax 'pickup +<type>' to just add the specified type to what you pickup.

Valid types are:

  1. debug: used in case of troubles only
  2. inhibit: if chosen, then no object is ever picked up
  3. stop: if chosen, you will stop moving instead of picking up items
  4. food
  5. drink
  6. valuables
  7. bow
  8. arrow
  9. helmet
  10. shield
  11. armour
  12. boots
  13. gloves
  14. cloak
  15. key
  16. missile
  17. allweapon
  18. magical
  19. potion
  20. spellbook
  21. skillscroll
  22. readables
  23. magicdevice
  24. notcursed
  25. jewels
  26. flesh
  27. cursed

Three options are possible for the first character: + will make you pick the item type, - will make you stop picking the item type and ! will toggle the pick mode.

See Also: get See Also: take

prepare

The prepare command is identical to the cast command.

You use the prepare command to set your range to the spell you want.

Example:
'prepare burning hands

sets your RANGE weapon to 'spell: burning hands'

If you don't know the spell, the command output will show which spells you do know.

It is helpful to bind strings like 'prepare burning hands' to keys.

See Also: cast See Also: bind See Also: range See Also: invoke

prevkey

Provides the last command input made and allows you to cycle through numerous previously entered commands.

So if you wanted to run the second to last command you just ran, just hit this bound key twice and then hit Enter.

You can also edit the command before you run it.

This is just like the up arrow under most command-line interfaces (CLI).

Special note for GTKV2, one has to use the bind command (i.e., 'bind prevkey) as the the keybinding GUI does not work with this command.

See Also: nextkey See Also: bind

printlos

Output shows a table that indicates Line-Of-Sight around the character.

The command shows a grid of map squares the character can see through (0) and cannot see through (1).

Example output:

    0 1 2 3 4 5 6 7 8 91011121314151617
 0: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
 1: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
 2: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
 3: 1 1 1 1 1 1 1 1 0 0 0 1 1 0 0 0 0 0
 4: 1 1 1 1 1 1 1 1 0 0 0 1 0 0 0 0 0 0
 5: 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0
 6: 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0
 7: 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0
 8: 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0
 9: 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0
10: 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0
11: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
12: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
13: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
14: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
15: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
16: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
17: 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1

The character is standing at row 10, column 8.

quest

The quest command displays quest-related information.

Usage:

  • quest list
  • quest list all
  • quest info

Available sub-commands:

  • list: displays quests you are currently doing
  • list all: displays quests you completed
  • info: displays information about the specified (by number) quest

quit

CRITICAL: If using a game client and/or server compiled or released before 2019-Dec-27, the quit command will permanently delete your game character!!

The quit command will exit or close out your game client session.

Usage:

  • quit

GTKv2 CLient Usage:

  • File → Quit

When the quit command is used when logging back in you can find your character back at their last used save bed (aka Bed to Reality) or in the game map where you left the game at. This depends on how long you logged out of the game.

WARNING: The map can reset while you were away and you may find yourself behind locked/closed doors, and/or surrounded by monsters.

To safely leave and log out of the game, you must use a 'Bed to Reality'.

Find a bed (probably in a building close to where you entered the game), place your character so they are “standing” on top of it, and apply the bed using the apply command or hitting the 'a“ (for apply) key.

See Also: apply See Also: delete

range

Your range weapon can be one of several weapons, a spell you cast, a bow-and-arrow, a rod, or a wand, to name a few.

Your range weapon is fired when you press SHIFT+direction and will be fired in that direction.

See Also: keys See Also: move See also: cast

ready_skill

The ready_skill command will make the specified skill active for your next set of actions. The specified skill will be set as your active skill.

Syntax:

  • ready_skill <skill name>

Example:

  • ready_skill punching

The skill must be used by firing in a direction; ready_skill does not directly activate the skill.

The result depends on the skill selected and what items are around you.

See Also: skills See Also: use_skill

rename

The rename command gives a custom name to the specified item in your inventory.

Syntax:

  rename <item name> to <new name>

(Note: <> are mandatory)

Example:

  • rename <shield> to <defense2>
  • Your shield will now be called defense2

If '<item name>' is omitted, the rename command defaults to the marked item.

Example:

  • (mark the recently renamed shield called defense2 in your inventory)
  • rename to <defense3>
  • Your shield will now be called defense3

If 'to <new name>' is omitted, the rename command clears the custom name.

Example:

  • rename <defense3>
  • You stop calling your shield with weird names.
  • (The item is now shown as shield in your inventory again)

Note: maximum allowed name length is for the new name is 127 characters.

See Also: mark

report

Report a bug or ask for help from a dungeon master.

Usage: report <description of issue>

If enabled, this command sends a bug report or request for help to the dungeon masters. The report contains your character name, current map location, and issue description.

If the command is not enabled, you will see:

'report' is not a valid command.

rotateshoottype

The command allows your character to cycle through all ranged attacks that are readied.

Usage:

  • rotateshoottype
  • rotateshoottype -
  • rotateshoottype +
  • rotateshoottype [number]

For instance, if a spell has been prepared (cast), a bow equipped, a rod readied, etc., then rotateshoottype cycles through them to select which one will will be used when the player fires an attack.

apply bow
  Readied skill: missile weapons.
  You ready bow (readied).
  You feel one with the powers of magic!
  You will now fire arrows with bow (readied).
apply rod
  You can no longer use the skill: missile weapons.
  Readied skill: use magic item.
  You ready rod of sunspear (lvl 57) * (readied).
cast magic missile
  You can no longer use the skill: use magic item.
  You ready talisman of sorcery *.
  You can now use the skill: sorcery.
  You ready the spell magic missile
rotateshoottype
  Switched to rod of sunspear (lvl 57).
rotateshoottype
  Switched to skill: talisman
rotateshoottype
  No ranged attack chosen.
rotateshoottype
  Switched to bow +1 (readied) and arrows.
rotateshoottype -
  No ranged attack chosen.

An optional parameter may be specified, such as - (minus) or + (plus).

For example, rotateshoottype - swaps the direction of the rotation.

rotateshoottype with no parameters is similar to rotateshoottype +.

Example:

rotateshoottype [number]

[number] will rotate through the shoot-types for the designated number of iterations.
[number] can be positive or negative to affect the direction of rotation.
If [number] is greater than the number of shoot-types available, it will rotate as if [number] was -1.
If no [number] is provided, 1 is used as a default.

rules

The rules command will display the server rules file.

See Also: news See Also: motd

run

The run command causes your character to run in a direction until instructed otherwise.

Run functions in two ways

  1. When the “run” command without any parameters is entered, the play enters run mode. The player will continually run in any direction pressed.
  2. When the “run” command is entered with a parameter of 1 through 8 (e.g. “run 1”) the player will begin running in the corresponding direction. See below.
8 1 2
 \|/
7- -3
 /|\
6 5 4

“run 1” for example will begin running north.

Alternatively, ”<direction command> r“ also can be used like the run command. For example, “northeast r” will cause you to run northeast until another direction is supplied.

If no direction is given, you will start to run in a direction starting with your next direction command.

Hitting a wall will not end run mode. To stop this run behavior use run_stop.

Additionally, depending on client implementation, you may stop running if you release the run key (default “control” key). See bind.

At the time of writing the JX Client seems to stop running when the run key is released but the GTK client does not.

See Also: bind See Also: run_stop

run_stop

The run_stop command will make your character stop running when using the run command.

See Also: run See Also: bind

save

The save command updates a character's status on the server disk.

Usage:

save

This can be useful for making sure your character's recent achievement (i.e., level up or learning a new spell) or item find (i.e., relic ring or weapon) is saved if you fear or worry that the server is about to crash.

WARNING – if you want to leave the game without losing progress or other accomplishments with your character, you must find a 'Bed to Reality' (probably in a building close to where you entered the game), place your character so they are “standing” on top of it, and apply the bed using the apply command or hitting the 'a” (for apply) key.

Doing 'save and then quitting the client or using the quit command (see warnings about using the quit command!) may very well result in lost experience, levels, items, and/or other character accomplishments and improvements. Still, see the warning about the quit command on older versions of the game.

See Also: apply See Also: quit

An alternative form of use_skill find traps. The default key for his command is 's'.

Searches for traps and other hidden objects in the tiles immediately surrounding the character and under the character. The odds of finding hidden traps are dependent upon the player's find traps skill.

See Also: skills See Also: disarm

search-items

Issuing the search-items command causes the character to examine the contents of every tile they enter and pick up any objects which match a specified item name or partial name.

Usage:

search-items <list-of-item-names> 

Example:

search-items ring

The character will now pick up any rings and ringmail armor they walk over.

Using this is a fast way to grab specific wanted items from large piles of junk, but it reduces movement speed significantly when active.

showpets

The showpets command displays a numbered list of charmed or summoned pets that are under the character's control.

If no pets are in use, the player will see the message: You have no pets.

Usage:

showpets

Example output:

Pets:
1  greater dwarven guard - level 20
2  greater dwarven guard - level 20
3  greater dwarven guard - level 20
4  dwarf priest - level 15
5  dwarf priest - level 15
6  dwarf priest - level 15
7  dwarf priest - level 15
8  dwarf priest - level 15

When a number is specified with the command, it instead shows a detailed printout about that pet

Usage:

showpets <number>

Example:

showpets 3

Example Output:

level 20 greater dwarven guard
600/600 HP, 9/9 SP
Str 30
Dex 14
Con 0
Int 9
Wis 0
Cha 0
Pow 43
wc 2  damage 35 ac -11

show

The show command toggles through the various inventory windows or activates a specific inventory tab.

NOTE: This is a gtkv2 client command only

Usage:

show
show <parameter>

Available parameters:

  • all - All Items
  • applied - Applied Items
  • unapplied - Unapplied Items
  • unpaid - Unpaid items
  • cursed - Cursed items
  • magical - Magical items
  • nonmagical - Nonmagical items
  • locked - Inventory locked items
  • unlocked - Inventory unlocked items
  • unidentified - Inventory unidentified items
  • icons - Quick icon view

See Also: apply See Also: lock

skills

Use the skills command to display your character's available skills and what level you are in each skill.

Usage

skills

The values shown are:

  • The name of the skill. You use this name for commands like use_skill or ready_skill.
  • The skill level.
  • The current experience.
  • The experience needed to level up.
  • The permanent experience ratio is relative to current experience. You'll never fall below permanent experience even if you die over and over.

Example output:

Player skills:
disarm traps        lvl: 15 (xp:3300556/4100000/50%)
find traps          lvl: 15 (xp:3300934/4100000/50%)
one handed weapons  lvl: 56 (xp:103300018/109100000/50%)
oratory             lvl:  1 (xp:0/2000/0%)
praying             lvl: 57 (xp:113301000/115200000/50%)
two handed weapons  lvl: 57 (xp:113350025/115200000/50%)

You can optionally add a parameter of '-l' for a longer display with more details on permanent experience.

Usage

skills -l

Example output:

Player skills (long format):
disarm traps        lvl: 15 (xp:3300556/4100000)     perm lvl: 12 (xp:1650278/2000000)
find traps          lvl: 15 (xp:3300934/4100000)     perm lvl: 12 (xp:1650467/2000000)
one handed weapons  lvl: 56 (xp:103300018/109100000) perm lvl: 43 (xp:51650009/52000000)
oratory             lvl:  1 (xp:0/2000)              perm lvl:  1 (xp:0/2000)
praying             lvl: 57 (xp:113301000/115200000) perm lvl: 45 (xp:56650500/58600000)
two handed weapons  lvl: 57 (xp:113350025/115200000) perm lvl: 45 (xp:56675012/58600000)

You can optionally add a search string to only show skills that include the matched text.

Usage

skills -l <string>

Example:

skills -l traps

Example output:

Player skills (long format): (matching 'traps')
disarm traps        lvl: 15 (xp:3300556/4100000)     perm lvl: 12 (xp:1650278/2000000)
find traps          lvl: 15 (xp:3300934/4100000)     perm lvl: 12 (xp:1650467/2000000)

sort_inventory

If sort_inventory is set, items will be inserted into your inventory in order by type than alphabetical. This, all scrolls will be grouped together, but in alphabetical order. Same for all weapons. This only applies to new items you pick up - items that you are already holding will not be sorted.

If sort_inventory is not set (default), items will be inserted via type, subtype and magic. This, all axes will be grouped together in magic order, all daggers by magic order, etc. Unforunately, for scrolls and rings, new ones just get inserted last.

If you have a lot of stuff that is not in alphabetical order but you would like it to be, the best method is to drop all of it and then pick it up.

FIXME - Is this command still valid?
Looks like the sort_inventory command, added in v0.92.6, is no longer a valid command. Both GTKv2 and JX Client show: 'sort_inventory' is not a valid command.

sound

Toggles sound on/off.

Usage sound

Example output:

The sounds are enabled.
Sounds are turned off.

spells

To cast a spell, you must first learn it.

To learn prayers:

  • The praying skill or a holy symbol in your inventory
  • A relatively high Wisdom score
  • A prayerbook with a prayer level relative to your skill level in praying.

To learn spells:

  • One of the wizardry based skills (i.e., summoning, invoker, pyromancy, etc.) or related talisman for one of the wizardry based skills
  • A relatively high Intelligence score
  • A spellbook (or flametome, grimoire, codex, etc.) relative to your skill level in your wizardry skill

Apply the spellbook or prayerbook for a chance to learn the spell.

To cast a spell, you can either use the cast or invoke commands.

See Also: apply See Also: cast See Also: invoke See Also: skills

FIXME - Make prayer references it's own help file entry?

statistics

The statistics command shows various useful information about your character.

Usage

statistics

The output displays:

  • How much experience your character has and what is needed for your next level
  • Shows natural, real, and maximum statistic values
    • Your natural stat is the stat without any items/spells applied
    • Real is what the current value is (same as in the stat window in the game client)
    • Maximum is the maximum value for your natural stat which is based on your character race
  • Attack mode, which is either peaceful or hostile
  • Dam/Sec is a calculation of your character's current Damage per Second (dps) that assumes every attack hits the target or foe and does *not* take into account partial resistance values, misses, or other protection such as Armor and Ac
  • The command will also display the total amount of time this particular character has been logged in to the server using the internal time tracking of the server (ticks) and also converting the ticks to hours and minutes.

Example output:

Experience: 150
Next Level: 2000
Stat       Nat/Real/Max
Str         24/  24/ 23
Dex         18/  18/ 18
Con         25/  25/ 24
Int         10/  10/ 18
Wis          2/   2/ 19
Pow          1/   1/ 18
Cha          1/   1/ 19
Attack Mode: Peaceful
Dam/Sec:   80
You have played this character for 327 ticks, which amounts to 0 hours and 0 minutes.

See Also: peaceful

take

The take commands take object(s) on the space the player is standing on, and inserts them into the players inventory.

If no parameter is given, take will get the top object that can be taken and put it in the players inventory. If no object can be taken, that will be stated.

A parameter can be given to take. In this case, all object that have names that match the parameter will be picked up. Thus, if there is a 'sword of WOE', and 'sword +1' and a 'sword -3' on the ground, 'take sword' will pick all of them up.

By default, take is bound to the comma key, with no parameters. To change this, look at the bind command.

throw

Throw a marked, or random, item in the direction the character is facing.

Usage:

throw

Only items that have a throwing property to them can be used with the throw command. To name a few: throwing dagger, throwing star, spear, trident

FIXME - clarify on how to find throwing items and identify them. Does the mark command apply? What about quivers for throwing items?

title

The title command will add or change the title appended to the character name. The title is displayed alongside the character name in some clients and on the hiscore list.

When you start a new character, the character's title defaults to “the <race>”. This is also the title that your character will default to when using the clear or default command option.

Usage

  • title
  • title <new title>
  • title clear
  • title default

title - If no new title is specified your current title is printed.

title <new title> - will set your title to 'new title'

title clear - resets the title to its default value

title default - resets the title to its default value

Example:

title
  Your title is 'the gnome'.
title the fierce
title
  Your title is 'the fierce'.
title clear
  Your title is 'the gnome'.

See Also: hiscore

unarmed_skill

The unarmed_skill command determines what skill you will use in unarmed combat.

If unarmed_skill is not set, a default skill will be used. That default will be karate, clawing, flame touch, punching, and wraith feed. For dragons, clawing will be tried first, then the rest in that same order.

The unarmed skill can always be overridden by explicitly using ready_skill for the desired skill.

For example, you have set the unarmed_skill to flame touch. However, you are fighting a flame resistant creature, you can use karate by doing a 'ready_skill karate'. You will continue to use karate until you change it again or use some other skill (equip a weapon, cast a spell, etc)

This value is saved and is persistent across logins. It is a property of the character, so different characters can be set with different unarmed_skill values.

Suggestions for unarmed_skills based on race & class:

Dragons: unarmed_skill clawing
Fireborn: unarmed_skill flame touch
Wraith: unarmed_skill wraith feed
Monks: unarmed_skill karate or unarmed_skill punching

See Also: bind

unbind

The unbind command is used to remove a shortcut, alias, or key sequence associated with a key (i.e., F3) or keyboard combination (i.e., shift + F3).

Usage:

  • unbind
  • unbind #
  • unbind -g #
  • unbind reset

Summary:

  • unbind - lists all available keybindings that are enabled
  • unbind # - will reset the character keybinding of the specified number (i.e., unbind 23 will unbind keybinding number 23)
  • unbind -g - will use the global bindings, which means a binding that is based on your login account and applies to all your characters
  • unbind -g # - will reset the global keybinding of the specified number (i.e., unbind -g 23 will unbind keybinding number 23)
  • unbind reset - will reset your character to all default keybindings

See Also: bind

use

Syntax:

use <item1> with <item2>

Will try to use both items together.

Result depends on the items themselves.

The order is important.

Example:

use slicing knife with apple

This will turn a whole apple into two apple halves

Example:

use file with silver bar

This will turn the silver bar into 1000 silver filings

FIXME - More details needed or wanted for the use command?

use_skill

The use_skill command will apply the designated skill to all objects in your inventory, or on objects located under your character.

Usage:

use_skill <skill name>

The use_skill command is also used for crafting. For instance, by placing specific items in a cauldron, you would apply the alchemy skill to try and create something new in the cauldron.

Example:

use_skill alchemy

This command is best used with keybindings (see help bind), as it does not set the designated skill as your active skill (see help ready_skill).

See Also: bind See Also: skills See Also: ready_skill

usekeys

The usekeys option determines the behavior of using keys when encountering locked doors.

Usage:

usekeys
usekeys <value>

Values are:

  • usekeys: displays that the current value is set to
  • inventory: Only keys in the top-level inventory are used (default)
  • keyrings: Only keys inside of active keyrings are used.
  • containers: Only keys inside active containers are used.

Example:

usekeys containers

Note that keyrings are just specialized containers, so the containers will also find keys in keyrings. Meaning, that if containers are the active setting the game client will check all active keyrings and all active containers (i.e., chests, backpacks, sacks, pouches, etc.)

Only active containers are used - keys will not jump out of closed containers, but hints will be given if you have keys in closed containers.

version

The version command displays the current version of the Crossfire server in use.

Usage:

version

This consists of the name and the version number of the server.

Example:

Crossfire v1.75.0

If the server is built from the Git repository, it will include a revision number in the version output.

Example:

Crossfire v1.75.0-ga725943

whereabouts

The whereabouts command gives a summary of the regions in which players are currently occupying.

Usage:

whereabouts

Example:

In the world currently there are:
3 players in The Kingdom of Scorn
4 players in The Sultanate of Darcap

wimpy

The wimpy command is a percentage of hitpoints left. When hitpoints drop below this level the character will blindly run away automatically.

Usage:

wimpy
wimpy <#>

wimpy without an argument shows the current setting.

Example:

Your current wimpy level is 0.

If a numeric argument is specified, the wimpy level is set and shown:

Example:

wimpy 10
Your new wimpy level is 10.

Your character will flee in a random direction when hit points fall to 10% total or lower.

Debug

verify

This command is only available if the server was compiled with DEBUG_MALLOC_LEVEL defined.

FIXME - Clarify documentation here and in the server help.

Directional

east

north

northeast

northwest

south

southeast

southwest

west

Move the character in the indicated direction.

stay

A direction command which indicates the space that the character is standing on.

Usage:

stay

For example, to fire a rod of heal on the character:

apply -a rod of heal
Readied skill: use magic item.
You ready rod of heal (lvl 60) * (readied).
stay fire
You are already fully healed.

Information

help

'help commands for help to list available commands.

keys

These are the basic movement keys:

  y k u
  h   l
  b j n

Running is done by holding the control key down, keeping it held down, and tapping a direction key once. Release the control key to stop running. Running is recommended - especially when attacking.

Firing a ranged attack ('help range) such as a bow, crossbow, wand, staff, rod, throwing weapon, or spellcasting ('help cast) is done by holding down the shift key, keeping it held down, and tapping a direction key once to fire in that direction.

'help mouse for help on what the mouse buttons do.

'help melee for advice on how to fight

'help traps for help with finding and disarming traps

See Also: range See Also: mouse See Also: melee See Also: traps See Also: cast

move

These are the basic movement keys:

  y k u
  h   l
  b j n

It is also possible to use the arrows keys to move, but that does not conveniently allow you to move diagonally (i.e., northwest, northeast, southwest, southeast)

Numeric keypad:

7 - northwest
8 - north
9 - northeast
4 - west
5 - not used
6 - east
1 - southwest
2 - south
3 - southeast

Important Note: certain clients in combination with certain operating systems may require you to enable or disable NumLock in order to actively use the numeric keypad for movement.

Generally, one direction key press is one step in that direction. This is good for slow and careful movement. But this does NOT work well for combat and for that you should use the run key.

Running is done by holding the control (ctrl) key down, keeping it held down, and tapping a direction key once. Release the control key to stop running. Running is recommended - especially when attacking.

Firing a ranged attack ('help range) such as a bow, crossbow, wand, staff, rod, throwing weapon, or spellcasting ('help cast) is done by holding down the shift key, keeping it held down, and tapping a direction key once to fire in that direction.

'help mouse for help on what the mouse buttons do

'help melee for advice on how to fight

'help traps for help with finding and disarming traps

See Also: range See Also: mouse See Also: melee See Also: traps See Also: cast

help mouse

The mouse isn't a great way to move your character. It'll work, but you'll be handicapped unless you use the keyboard for this. However, the mouse has the following inventory uses:

  • Middle button on item: apply or equip an inventory item, or use an item on the ground.
  • Right button: drop or pickup item on ground or an inventory item.
  • Left button: display information about an item on the map or an inventory item.
  • Shift key + left button: lock an inventory item.
  • Shift key + middle button: mark an inventory item.FIXME - Add documentation here.

hiscore

The hiscore command shows the top fifty scores on the server.

Usage: hiscore hiscore <player name> hiscore <title>

Output:

Number Score Who <max hp><max sp><max grace> <rank> <xp total> <player name> <title> <last seen|left the game|quit the game> on map <name of map> <max hp><max sp><max grace>

Example:

Overall high scores:
Rank     Score Who <max hp><max sp><max grace>
  1  522489565 Sven the  Knight was last seen on map apartments <524><38><302>.
  2     868154 Wraith the wraith left the game on map world_105_115 <115><1><1>.
  3        246 Moh the human was last seen on map Hall of Dungeon Masters <43><1><32>.
  4        150 test the dwarf left the game on map Wanderer Inn <49><1><1>.
  5        135 Hahn the human quit the game on map Wanderer Inn <42><38><33>.

You can also search the hiscore list by player name by adding the character name string to the end of the command.

Example:

hiscore test

Will display:

 4        150 test the dwarf left the game on map Wanderer Inn <49><1><1>.
 

It is also possible to search the hiscore list by title by adding the character name string to the end of the command.

Example:

hiscore human

Will display:

 3        246 Moh the human was last seen on map Hall of Dungeon Masters <43><1><32>.
 5        135 Hahn the human quit the game on map Wanderer Inn <42><38><33>.

inv

Prints the player's item list as it is displayed in the inventory window in the message window.

's inventory (1469268):        473.0 kg
- 1 guide to Faith * (1469309)   4.0 kg
- 1 bag (1469369)                0.0 kg
- 1 a dwarvish key ring (1469378)   0.1 kg

inventory

List the inventory carried by the character and report its total weight.

A parameter may be specified that requests the inventory of a specific object. The object is identified by a number, but players do not normally know object numbers, so this form is only useful to a dm.

FIXME: Is there a way for a player to use the inventory command to show the contents of a container?

mapinfo

mapinfo gives information about the map you are currently on.

Output format:
<map name> (<map path>) in <map region>
Created: <date> <developer name> [<developer email>]
[Modified: <date> <developer name> [<developer email>]]

This information is predominantly used for bug reports and similar development operations.

maps

List the maps that are currently loaded in server memory and show data about them. For example:

Current time is: 16:46:56.
Path               Pl PlM IM   TO Dif Reset
/HallOfSelection    0  0   2    0  1  17:37:54

Path = the map file path on the server. Pl = players. PlM = players on map. IM = in memory. TO = timeout until the map is saved to disk. Dif = map difficulty. Reset = real time on server when the map will reset.

FIXME: Add more information about the data columns.

Function map_info in file server/server/c_misc.c :

Path The map file path1) on the server. ( 18 chars )
Pl Players2) . Teleporter usage adds +1 player …
PlM Attempt to count “Real Players3)” on map.
IM In memory value4) .
TO Timeout5) until the map is saved to disk.
Dif Map difficulty6) .
Reset Real time on server when the map will reset7).

motd

motd displays the Message Of The Day file.

news

news displays the server news.

quest

Quest displays quest-related information. 'quest alone gives the following information:

 Quest commands:
  - list: displays quests you are currently attempting add 'all' to show completed quests also
  - info: displays information about the specified (by number) quest

quest list

'quest list displays the name of the started quests and their numbers. (to be used in 'quest info)
It also displays how many quests are finished and how many of them may be made again.
Example output:

 You have completed 8 quests, of which 2 may be restarted
 You have started the following quests:
 (  9) Darcap's Elemental quest
 ( 10) The Scorn Nobility
 ( 11) Gramps Malone's Earhorn
 ( 12) Kill the Bandit Guuh at Terry's Farm

'quest list all also displays the name and number of the finished quests and adds a (can be replayed) behind the name if it can be done again. As an example:

 You have completed the following quests:
 ... some quests
 (  6) Gork's Treasure Hoard (can be replayed)
 ....more quests
 You have started the following quests:
 ... some more quests (see previous example)

quest info <number>

gives detailed information about the quest specified by <number>
Here is an example for an unfinished quest:

 Description: Using either the keys, your weapon or your lockpicking skills,
 open all three doors and claim the treasure in the chest at the end.
 
 
 Current Status: I must open the first door, which uses a standard key, I can either use one of the keys 
 beside the door, or I can attempt to break it down or I can use my lockpicking skill do open it. The sign beside
 the door will tell me how to do this.

and an example after the (same) quest was finished:

 Quest: Getting Past Locked Doors
 Description: Using either the keys, your weapon or your lockpicking skills, open all three doors
 and claim the treasure in the chest at the end.
 
 This quest has been completed.
 
 Outcome: I have opened the final door, I should open the chest and claim my reward.

report

Report a bug or ask for help from a dungeon master.

Usage: report <description of issue>

If enabled, this command sends a bug report or request for help to the dungeon masters. The report contains your character name, current map location, and issue description.

resistances

FIXME - Add documentation here and in the server help.

rules

rules displays the rules in effect on this server.

skills

Use the skills command to learn your experience and level of your skills.

The values shown are:

  • The name of the skill. You use this name for commands like use_skill or ready_skill.
  • The skill level.
  • The current experience.
  • The experience needed to level up.
  • The permanent experience ratio relative to current experience. You'll never fall below permanent experience even if you die over and over.

You can optionally add a parameter of '-l' for a longer display with more details on permanent experience.

You can optionally add a search string to only show skills that include the match text.

Example:

skills -l traps

statistics

statistics shows various useful information about your character. None of the information it shows is stuff that is not contained in the documentation.

As of now, it shows how much experience you need for your next level. It also shows natural, real, and maximum statistic values.

  • Your natural stat is the stat without any items/spells applied.
  • Real is what the current value is (same as in the stat window.)
  • Maximum is the maximum value for your natural stat.

time

Displays in-game time. Some game-play might be affected by game time-of-day.

time
  It is 21 minutes past 3 o'clock am, on the Day of the Moon
  The 15th Day of the Month of the Frost Giant, Year 17
  Time of Year: The Season of New Year

Another way to find out game time is by applying clocks found throughout the world.

version

Displays the version of the server.

This is Crossfire v1.trunk-r12190M
The authors can be reached at crossfire@metalforge.org

weather

:!: The weather command is supported by servers until version 1.11.0 . See weather .

Displays the weather conditions the player is facing when on a world map.

It's currently -7 degrees Centigrade out.
It is muggy.
There is a strong wind coming from the west.
Snow is falling very heavily.

whereabouts

The whereabouts command gives a summary about the region in which players are currently standing.

whereabouts
  In the world currently there are:
  2 players in The Kingdom of Scorn

whereami

Gives some lore about the region the player is standing in. For example:

whereami
  You are in The Kingdom of Scorn. 
   Nestled snugly in a sheltered bay at the west of the Imperial Highway, Scorn
  is a safe and welcoming place for those who pass by. Its position on the
  Imperial highway allows it to maintain its importance as a stopping off
  point between the other major cities along the route and an attractive
  location for trade and commerce. This combined with the sheltered harbour and
  extensive shipping lines, ensures that Scorn remains a key crossroads
  bustling with activity, long after its former military dominance has
  diminished.

who

Display a list of currently logged in players. The map the player's character is on is shown. For example:

Total Players in The World. (2) -- WIZ(0) AFK(1) BOT(0)
meflin-f the fireborn
</random/level0222>
Rayvin Scripter
</usr/games/crossfire/var/crossfire/players/Rayvin/_scorn_apartment_apartments>

DM's can use the hide command to hide themselves from this command.

NOTE: Players may be connected to the server and may be able to see chats and shouts, etc. even though they are not logged in.

FIXME - Add documentation here and in the server help.

Communication

chat

Chat sends a message to the chat channel on the current server. Anyone with 'listen 10 enabled will see your message. On some servers 'chat is preferable over 'shout as a way to communicate with all players.

Chat usage:

'chat [insert a message that you want everyone to see]

cointoss

Simulates a coin toss so players may make heads or tails decisions. For example, Jeff types:

cointoss
  You flip a coin... Heads!

Other players see:

Jeff flips a coin... Heads!

gsay

gsay sends a message to all members of your current party.

gsay usage:

  • 'gsay [Message that you want all party members to see]

FIXME - In the “help commands” output, the command is listed as a regular command and not a communication command. The chat command appears in the communication command section. Should only the emotes should be in the communication section? If not at least the commands should be shown consistently in the help.

listen

Listen, sets the level of messages you will hear.

Listen usage:

  • 'listen 0 - turns off listen and shows no messages.
  • 'listen 10 - default listen level on modern Crossfire servers. This enables seeing messages on the chat channel.

me

The me command acts like /me in IRC. Players on the same map see the character's name followed by some descriptive phrase:

me cries
  Joe cries

orcknuckle

Parameters are ignored when using this command. To use this command successfully, a character must have enough dice in his inventory, or else the command returns:

orcknuckle
  You need at least 4 dice to play orcknuckle!

See also: The Guide to Orc Knuckle.

FIXME - Add documentation in the server help.

reply

Send a private reply to the last player that most recently used the tell command to tell the player something private.

WARNING: reply can send a private reply to an unexpected person if a tell from another player comes in while typing in the reply command. The tell command is safest because it always goes to the specified character.

FIXME - Clarify documentation here and in the server help.

say

Players on the same map see the message the character said.

Usage:

say <message>

If player Joe types:

say hi!

Everyone in the same map sees:

Joe says: hi!

FIXME - Clarify documentation in the server help.

shout

Usage:

shout <something>

Sends a message to all players on the server.

tell

Sends a private message to a particular person.

Usage:

tell <person> <message>

<person> is case sensitive

If Joe types:

tell Jack Hi!

Player Jack sees:

Joe tells you: Hi!

see also reply

FIXME - Clarify documentation in the server help.

Emotives

Emotives without a parameter say a canned message related to the command. For example, Jeff types:

bleed
  You bleed all over your nice new armour.

Other players in the vicinity see a slightly different message:

Jeff is bleeding all over the carpet - got a spare tourniquet?

Emotives may also be entered with a character name as a parameter. For example, Jeff enters:

smile Joe
  You smile at Joe.

Joe sees:

  Jeff smiles at you.

Other players see:

  Jeff smiles at Joe.

accuse

beg

bleed

blush

bounce

bow

burp

cackle

chuckle

clap

cough

cringe

cry

dance

flip

frown

gasp

giggle

glare

grin

groan

growl

hiccup

hug

kiss

laugh

lick

nod

poke

pout

puke

scream

shake

shiver

shrug

sigh

slap

smile

smirk

snap

sneeze

snicker

sniff

snore

spit

strut

sulk

thank

think

twiddle

wave

whistle

wink

yawn

1) map.h: struct mapdef { char path[HUGE_BUF]; /* Filename of the map */ }mapstruct;
2) map.h: struct mapdef { sint16 players; /* How many players are on this level right now. Automatically updated by the object handling functions. */
3) swap.c: players_on_map()
4) map.h: MAP_IN_MEMORY 1, MAP_SWAPPED 2, MAP_LOADING 3, MAP_SAVING 4
5) map.h: struct mapdef { sint32 timeout; /* swapout is set to this */
6) map.h: struct mapdef { uint16 difficulty; /* What level the player should be to play here */
7) map.h: #define MAP_WHEN_RESET(m) ((m)→reset_time); struct mapdef { uint32 reset_time; /* when this map should reset */
player_commands.txt · Last modified: 2024/03/01 17:09 by leaf