CommandMode
From The Battle for Wesnoth Wiki
Template:CommandMode/Translations
Command Mode
You can access command mode by typing : (colon) in a single-player or multiplayer scenario.
If typing a colon is not feasible in your keyboard layout, you can reassign the hotkey in Preferences, or edit game.cfg.
Note: In Battle for Wesnoth versions prior to version 1.1.1, one needed to type Shift-; (Shift-semicolon).
Note: It is possible to highlight, copy, and paste text in the command entry field.
Several vi-like commands are available in command mode. They are defined in menu_events.cpp. In Battle for Wesnoth version 1.5 and in later versions, there is a :help command that lists all available commands, and :help foo displays more information about command foo. This is more reliable than the list that follows here:
- :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] [on|off]
- 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, the current side is assumed.
- :idle [side] [on|off]
- toggle player side between idle mode and not. This command should normally be needed only for debugging purposes. Template:DevFeature1.11
- :controller</nowiki [''side''] :debugging command which displays the current controller type of a side. {{DevFeature1.11}} ;<nowiki>: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.
- :unmute [username]
- unmute a specific observer. If no username is given everyone is unmuted. (Doesn't effect the muteall setting.)
- :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 by the IP address used by that username. Can be used on users not in the game but on the server. (Of course they won't be kicked then.)
- :unban username
- unban a user by the IP address used by that username. Can be used on users not in the game but on the server.
- :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)
- :give_control
- launch a friendly gui to assist with assigning control of sides to players
- :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
- :show_coordinates (or :sc)
- Overlay x,y coordinates on map tiles. 1.5.5 onwards
- :show_terrain_codes (or :tc)
- Overlay terrain codes on visible map tiles. 1.5.5 onwards
- :discover
- Show all hidden unit descriptions in the in-game Help. 1.7.0 onwards
Extra Debugging Commands
DebugMode (:debug) enables additional commands in command mode:
- :lua statement
- execute a Lua statement
- :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.
- :unit advances=N
- when a unit is selected, this will advance (level up) the unit N times.
- :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/fire event_name
- throw an event by name, like time over or enemies defeated. (Only available in 1.3.5 or later.)
- :inspect
- show a gamestate inspector dialog which allows to see variable info, team info, ai info.
- :cl
- pops up a menu that allows you to move directly to a specified scenario.
- :turn [number]
- change the current turn to the specified number. If no number is provided, the turn number is increased by one.
- :turn_limit [number]
- change the turn limit for the current scenario to the specified number. If no number is provided, or it is -1, the turn limit is switched off.
- :version
- Report the release version and repository revision level.