CommandMode

From The Battle for Wesnoth Wiki
Revision as of 14:43, 14 November 2007 by ShikadiQueen (talk | contribs) (Command Mode: debug mode can be disabled with :nodebug too...)

Command Mode

You can access command mode by typing ' : ' in a single player or multiplayer scenario. (Prior to version 1.1.1, you need to type shift - semicolon( ; ). However this isn't possible on all keyboards; if your keyboard doesn't have ':' above ';' you can change the hotkey in the Preferences, or you could edit game.cfg by hand.')

Note: you can highlight, copy, and paste text in debug mode.

Several vi-like commands are available in command mode. They are defined in playturn.cpp in the turn_info::do_command() function:

:q or :q!
quit the scenario (without prompting)
:w
save the game (without prompting)
:wq
save the game and quit the scenario (without prompting)
:refresh
redraw the screen
:droid side
toggle player on side between human and AI player. The player/client who controls that side needs to issue this command. If you don't provide side, '1' is assumed.
:muteall
toggles muting/silencing of all observers on/off
:mute username
mute a specific observer. If no username is supplied the muted usernames are displayed.
:kick username
kick a user in multiplayer. They will be able to rejoin the game. Generally a friendly way to remove someone who is having connection or other difficulties.
:ban username
kick and ban a user in multiplayer, and the IP address used by that username.
:control side username
change the controller for side (write here the number of the side, the side must be controlled by you) to username (write here the nick of the player or observer)
:clear
clear chat messages
:debug
switch debug mode on (does not work in multiplayer). Debug mode is turned off by quitting the game or using the :nodebug command.
:theme
bring up theme selection menu
:nosaves
turns off the autosave function

Extra Debugging Commands

DebugMode enables additional commands in command mode:

:nodebug
disables debug-mode commands
:n
skip to next scenario by triggering a win event
:shroud
toggles shroud on/off (implemented since 1.3.10)
:fog
toggles fog on/off (implemented since 1.3.10)
:gold amount
add amount gold to the current player's side
:create unit_type
create a unit of type specified at last selected hex
:unit hitpoints=amount
edit units hitpoints
:unit experience=amount
edit units experience
:unit attribute=value
when a unit is selected, this will set the unit's attribute to value. See SingleUnitWML for possible values.
:set_var attribute=value
this will set a WML variable to a given value
:show_var attribute
this will display a popup with the content of the variable
:throw event_name
throw an event by name, like time over or enemies defeated. (Only available in 1.3.5 or later.)

See Also