updated cheat codes info

docs/players/Cheat codes.md

@@ -1,75 +0,0 @@
-Following cheat codes have been implemented in VCMI and must be used
-within in-game chat:
-
--   **vcmiistari** - gives all spells and 999 mana to currently selected
-    hero
--   **vcmiainur** - gives 5 Archangels to every empty slot of currently
-    selected hero
--   **vcmiangband** - gives 10 black knight into each slot
--   **vcmiglaurung** - gives 5000 crystal dragons into each slot
--   **vcmiarmenelos** - build all buildings in currently selected town
--   **vcminoldor** - all war machines
--   **vcminahar** - 1000000 movement points
--   **vcmiformenos** - give resources (100 wood, ore and rare resources
-    and 100000 gold)
--   **vcmieagles** - reveals FoW
--   **vcmiungoliant** - conceal FoW
--   **vcmiglorfindel** - advances currently selected hero to the next
-    level
--   **vcmisilmaril** - player wins
--   **vcmimelkor** - player loses
--   **vcmiforgeofnoldorking** - Hero gets all artifacts except spell
-    book, spell scrolls and war machines. This includes artifacts added
-    via mods.
-
-All cheat codes can be applied for specific players or all of them:
-
--   **vcmieagles ai** - Will reveal FoW only for AI players.
--   **vcmieagles all** - Will reveal FoW for all players on map.
--   **vcmieagles blue** - Will reveal FoW only for blue player.
--   **vcminahar ai** - give 1000000 movement points to each hero of
-    every AI player
-
-Some cheats can also be used with certain ObjectInstanceID:
-
--   **vcminahar 123** - give 1000000 movement points to hero with id of
-    123
--   **vcmiarmenelos 123** - build all buildings in town with id of 123
-
-These codes are not a cheats, but can be used in multiplayer by host
-player to control the session
-
--   **game exit/quit/end** - finish the game
--   **game save mygame** - saves the game into mygame file
--   **game kick red/blue/...** - kick player from the game. instead of
-    color, can be used a number, e.g. **game kick 0/1/2...**, number is
-    a corresponding player number (0 - red, 1 - blue, etc)
-
-# Console commands
-
-Following commands must be used in vcmiclient console (CMD on Windows or
-terminal on Linux / Mac):
-
--   **autoskip** - Toggles autoskip mode on and off. In this mode,
-    player turns are automatically skipped and only AI moves. However,
-    GUI is still present and allows to observe AI moves. After this
-    option is activated, you need to end first turn manually. Press
-    \[Shift\] before your turn starts to not skip it.
--   **onlyai** - When typed in pregame, it completely removes human
-    players and GUI from game. Use console and bugtracker to test AI
-    quickly. Additionally, game cna be launched with --onlyAI parameter
-    to enable this mode by default.
--   **crash** - force game crash. It is sometimes useful to generate
-    memory dump file in certain situations, for example game freeze.
--   **set <command> <on/off>** - toggle one of debug options on or off.
-    Possible commands:
-    -   **autoskip** - identical to "autoskip" option
-    -   **showGrid** - displays grid on adventure map
-    -   **showBlock** - shows blocked tiles on map. Requires image
-        **data/blocked.bmp** present.
-    -   **showVisit** - shows visitable tiles on map. Requires image
-        **data/visitable.bmp** present.
-    -   **hideSystemMessages** - supress server messages in chat.
--   **gosolo** - AI take control over human players and vice versa
--   **controlai** - give control of one (if color specified) or all AIs
-    to player

docs/players/Cheat_Codes.md

@@ -0,0 +1,83 @@
+See also: [Client Commands](Client_Commands.md)
+
+Similar to H3, VCMI provides cheat codes to make testing game more convenient.
+
+To use cheat code, press `Tab` key or click/tap on status bar to open game chat and enter code. Most cheat codes have several alternative names, including name of this cheat code in H3:SoD
+
+## List of cheat codes
+
+### Spells
+
+`nwcthereisnospoon` or `vcmiistari` or `vcmispells` - give a spell book, all spells and 999 mana to currently selected hero
+
+### Army
+
+`nwctrinity` or `vcmiainur` or `vcmiarchangel` - give 5 Archangels in every empty slot (to currently selected hero)  
+`nwcagents` or `vcmiangband` or `vcmiblackknight` - give 10 black knight in every empty slot  
+`vcmiglaurung` or `vcmicrystal` - give 5000 crystal dragons in every empty slot  
+`vcmiazure` - give 5000 azure dragons in every empty slot  
+`vcmifaerie` - give 5000 faerie dragons in every empty slot  
+
+Alternative usage: `vcmiarmy <creatureID> <amount>`
+Gives specific creature in every slot, with optional amount. Examples:
+`vcmiarmy imp` - give 5, 50, 500... 500k imps in every free slot
+`vcmiarmy grandElf 100` - gives 100 grand elves in every free slot
+
+### Town buildings
+
+`nwczion` or `vcmiarmenelos` or `vcmibuild` - build all buildings in currently selected town
+
+### Artifacts
+
+`nwclotsofguns` or `vcminoldor` or `vcmimachines` - give ballista, ammo cart and first aid tent  
+`vcmiforgeofnoldorking` or `vcmiartifacts` - give all artifacts, except spell book, spell scrolls and war machines. Artifacts added via mods included  
+
+### Movement points
+
+`nwcnebuchadnezzar` or `vcminahar` or `vcmimove` - give 1000000 movement points and free ship boarding for 1 day  
+Alternative usage: `vcmimove <amount>` - gives specified amount of movement points
+
+### Resources
+
+`nwctheconstruct` or `vcmiformenos` or `vcmiresources` - give resources (100000 gold, 100 of wood, ore and rare resources)  
+Alternative usage: `vcmiresources <amount>` - gives specified amount of all resources and x1000 of gold
+
+### Fog of War
+
+`nwcwhatisthematrix` or `vcmieagles` or `vcmimap` - reveal Fog of War  
+`nwcignoranceisbliss` or `vcmiungoliant` or `vcmihidemap` - conceal Fog of War  
+
+### Experience
+
+`nwcneo` or `vcmiglorfindel` or `vcmilevel` - advances currently selected hero to the next level
+Alternative usage: `vcmilevel <amount>` - advances hero by specified number of levels
+
+- `vcmiolorin` or `vcmiexp` - gives selected hero 10000 experience
+Alternative usage: `vcmiexp <amount>` - gives selected hero specified amount of experience
+
+### Finishing the game
+
+`nwcredpill` or `vcmisilmaril` or `vcmiwin` - player wins  
+`nwcbluepill` or `vcmimelkor` or `vcmilose` - player loses  
+
+## Using cheat codes on other players
+By default, all cheat codes apply to current player. Alternatively, it is possible to specify player that you want to target:
+
+- Specific players: `red`/`blue`/`green`...
+- Only AI players: `ai` 
+- All players: `all`
+
+### Examples
+
+`vcmieagles blue` - reveal FoW only for blue player  
+`vcmieagles ai` - reveal FoW only for AI players  
+`vcmieagles all` - reveal FoW for all players on map  
+`vcminahar ai` - give 1000000 movement points to each hero of every AI player  
+
+## Multiplayer chat commands
+Note: These commands are not a cheats, and can be used in multiplayer by host player to control the session
+
+- `game exit/quit/end` - finish the game  
+- `game save <filename>` - save the game into the specified file  
+- `game kick red/blue/tan/green/orange/purple/teal/pink` - kick player of specified color from the game  
+- `game kick 0/1/2/3/4/5/6/7/8` - kick player of specified ID from the game (_zero indexed!_) (`0: red, 1: blue, tan: 2, green: 3, orange: 4, purple: 5, teal: 6, pink: 7`)  

docs/wiki/Client-commands.md → docs/players/Client_Commands.md

@@ -1,3 +1,5 @@
+See also: [Cheat Codes](Cheat_Codes.md)
+
 Client commands are set of predefined commands that are supported by VCMI, but unlike cheats they perform utility actions that do not alter state of the gameplay. As of release 1.2 client commands can work by typing them in-game like cheats, preceded by symbol / (for example `/controlai blue`)
 Alternative way, the only one working for older releases is typing them in console:
 

docs/wiki/Cheat-Codes.md

@@ -1,46 +0,0 @@
-# VCMI cheat codes that can be used within in-game chat
-> _Note: All cheat codes can be applied for:_  
->  -_current player_ - `no arguments`  
->  -_specific players_ - `red`/`blue`/`ai`  
->  -_all players_ - `all`  
-
-`vcmiistari` or `vcmispells` - give a spell book, all spells and 999 mana (to currently selected hero)  
-`vcminoldor` or `vcmimachines` - give ballista, ammo cart and first aid tent  
-`vcmiforgeofnoldorking` or `vcmiartifacts` - give all artifacts, except spell book, spell scrolls and war machines. Artifacts added via mods included  
-  
-`vcmiarmy <creatureID>` or `vcminissi <creatureID>` - give 5000, 50k, 500k,... of the specified creature in every empty slot. EG: `vcmiarmy imp`  
-`vcmiainur` or `vcmiarchangel` - give 5 Archangels in every empty slot (to currently selected hero)  
-`vcmiangband` or `vcmiblackknight` - give 10 black knight in every empty slot  
-`vcmiglaurung` or `vcmicrystal` - give 5000 crystal dragons in every empty slot  
-`vcmiazure` - give 5000 azure dragons in every empty slot  
-`vcmifaerie` - give 5000 faerie dragons in every empty slot  
-  
-`vcminahar` or `vcmimove` - give 1000000 movement points and free ship boarding for 1 day  
-`vcmiformenos` or `vcmiresources` - give resources (100000 gold, 100 of wood, ore and rare resources)  
-`vcmiarmenelos` or `vcmibuild` - build all buildings in currently selected town  
-  
-`vcmieagles` or `vcmimap` - reveal Fog of War  
-`vcmiungoliant` or `vcmihidemap` - conceal Fog of War  
-  
-`vcmiexp <quantity>` or `vcmiolorin <quantity>` - give specified experience. EG: `vcmiexp 10000`  
-`vcmiglorfindel` or `vcmilevel` - advance currently selected hero to the next level  
-`vcmisilmaril` or `vcmiwin` - player wins  
-`vcmimelkor` or `vcmilose` - player loses  
-  
-# Cheat code usage examples, beyond current player
-`vcmieagles blue` - reveal FoW only for blue player  
-`vcmieagles ai` - reveal FoW only for AI players  
-`vcmieagles all` - reveal FoW for all players on map  
-`vcminahar ai` - give 1000000 movement points to each hero of every AI player  
-
-> _Note: Some cheats can also be used with certain ObjectInstanceID_
-`vcminahar 123` - give 1000000 movement points to hero with id of 123
-`vcmiarmenelos 123` - build all buildings in town with id of 123
-
-# Multiplayer chat commands
-> _Note: These commands are not a cheats, and can be used in multiplayer by host player to control the session_
-
-`game exit/quit/end` - finish the game  
-`game save <filename>` - save the game into the specified file  
-`game kick red/blue/tan/green/orange/purple/teal/pink` - kick player of specified color from the game  
-`game kick 0/1/2/3/4/5/6/7/8` - kick player of specified ID from the game (_zero indexed!_) (`0: red, 1: blue, tan: 2, green: 3, orange: 4, purple: 5, teal: 6, pink: 7`)