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.)