# Soulmask Console Commands Reference (/docs/soulmask/console-commands)



import { Tab, Tabs } from 'fumadocs-ui/components/tabs';

This is the comprehensive reference for **in-game** admin console commands. For setup (opening the console, authenticating as admin) see [Adding Admins](/docs/soulmask/admin-setup). For **remote** console commands over RCON or Telnet, see [RCON & Telnet](/docs/soulmask/rcon-setup).

> **Quick start:**
>
> 1. Press `` ` `` (backtick) or **Numpad Minus** to open the console
> 2. Authenticate: `gm key <YourAdminPassword>`
> 3. Run any command below with the `gm` prefix

> Many commands have both a Pinyin name and an English alias (`JSMJ` / `UnLock_Nodes`, `KeJiShu` / `UnLock_Techs`, `BaoCun` / `Save`). Either works.

***

Player Progression [#player-progression]

| Command                      | Aliases           | Effect                                           |
| ---------------------------- | ----------------- | ------------------------------------------------ |
| `AddExp <value>`             | —                 | Add general XP to yourself                       |
| `AddExpToTarget <value>`     | —                 | Add general XP to your target                    |
| `AddMJExp <value>`           | `Add_Mask_Exp`    | Add mask XP                                      |
| `AddMaskExpToTarget <value>` | —                 | Add mask XP to target                            |
| `AddShouLieExp <value>`      | `Add_Hunting_Exp` | Add hunting XP                                   |
| `JingYan <value>`            | —                 | Set XP value                                     |
| `DengJi <level>`             | —                 | Set character level                              |
| `SetAttr <attr> <value>`     | —                 | Set a character attribute                        |
| `Query <attr>`               | —                 | Query an attribute                               |
| `PinZhi <0-5>`               | —                 | Set quality tier                                 |
| `XiDian`                     | —                 | Refund all stat points                           |
| `State`                      | —                 | Show character state                             |
| `FuHuo`                      | —                 | ⚠️ Revive — known to cause issues, use sparingly |
| `ShowInfo`                   | —                 | Print detailed player info                       |

***

Masks, Talents & Tech [#masks-talents--tech]

| Command                   | Aliases             | Effect                      |
| ------------------------- | ------------------- | --------------------------- |
| `BianShen`                | —                   | Toggle mask transformation  |
| `SetHidePlayerMask <0/1>` | —                   | Hide / show mask            |
| `JSMJ`                    | `UnLock_Nodes`      | Unlock all mask nodes       |
| `UnLockAllMaskAndParts`   | —                   | Unlock every mask and part  |
| `KeJiShu`                 | `UnLock_Techs`      | Unlock all tech tree nodes  |
| `AddNG <id>`              | —                   | Add a natural gift          |
| `RemoveNG <id>`           | —                   | Remove a natural gift       |
| `ClearNG`                 | —                   | Clear all natural gifts     |
| `AddFashion <id>`         | —                   | Unlock a fashion item       |
| `AddHairStyle <id>`       | —                   | Unlock a hairstyle          |
| `AddWenShen <id>`         | —                   | Unlock a body paint pattern |
| `AddHuntingTitle`         | `Add_Hunting_Title` | Unlock a hunting title      |
| `JieSuoShouLieChengHao`   | —                   | Unlock hunting achievements |
| `ChengJiu`                | —                   | Manage achievements         |

***

Proficiencies & Mastery [#proficiencies--mastery]

| Command                      | Aliases                  | Effect                  |
| ---------------------------- | ------------------------ | ----------------------- |
| `SLDDengJi <name> <level>`   | —                        | Set a proficiency level |
| `SLDDengJiAll <level>`       | `Set_All_Pros_Level`     | Set all proficiencies   |
| `SLDJingYan <name> <xp>`     | —                        | Add proficiency XP      |
| `SetShuLianDuMaxVal <value>` | `Set_Proficiency_Maxval` | Set proficiency max     |
| `AddZJ <id>`                 | —                        | Add weapon mastery      |
| `RefreshZJ`                  | `Refresh_Mastery`        | Refresh mastery state   |

***

NPCs & Recruitment [#npcs--recruitment]

<Tabs items={['Spawning', 'Control', 'Cleanup']}>
  <Tab value="Spawning">
    | Command                                                            | Aliases               | Effect                     |
    | ------------------------------------------------------------------ | --------------------- | -------------------------- |
    | `CreateSpecifiedMan <num> <sex>`                                   | `Create_SpecifiedMan` | Spawn tribesmen            |
    | `CreateSWByClass <class> <isBaby> <level> <owned> <qty> <quality>` | —                     | Spawn an NPC by class name |
    | `Find120`                                                          | —                     | Find max-level entities    |
    | `FindSCGLoc`                                                       | —                     | Find NPC spawn locations   |
    | `ChaZhaoSCGWeiZhi`                                                 | —                     | Same as `FindSCGLoc`       |
  </Tab>

  <Tab value="Control">
    | Command                  | Aliases              | Effect                        |
    | ------------------------ | -------------------- | ----------------------------- |
    | `ZhaoMu`                 | `Recruit`            | Recruit the targeted NPC      |
    | `ZhuaBu`                 | —                    | Knock out the targeted NPC    |
    | `TameDongWu`             | —                    | Tame the targeted animal      |
    | `JoinGuildFromViewActor` | `Join_Target_Tribe`  | Join the targeted NPC's tribe |
    | `WeiSui`                 | `Follow_Player_View` | Make NPC follow you           |
  </Tab>

  <Tab value="Cleanup">
    | Command       | Aliases          | Effect                         |
    | ------------- | ---------------- | ------------------------------ |
    | `ClearAllNpc` | `Clear_All_Npcs` | Remove all NPCs from the world |
    | `ResetNpc`    | —                | Reset NPC state                |
  </Tab>
</Tabs>

***

Tribes & Permissions [#tribes--permissions]

| Command                                       | Aliases                  | Effect                                  |
| --------------------------------------------- | ------------------------ | --------------------------------------- |
| `ForceGuildOwner`                             | `Take_Over_Target_Tribe` | Force tribe ownership of target's tribe |
| `JiaRuGongHui`                                | `Join_Tribe`             | Join a tribe                            |
| `DeleteGuild`                                 | —                        | Delete a tribe                          |
| `AddGongHuiReputation <value>`                | —                        | Add tribe reputation                    |
| `SetTribeLevelVal <level>`                    | —                        | Set tribe level                         |
| `SetTanHeHuiZhangTime <seconds>`              | —                        | Set impeachment timer                   |
| `AddServerPermissionList <type> <steamid>`    | —                        | Add to whitelist/blacklist              |
| `RemoveServerPermissionList <type> <steamid>` | —                        | Remove from list                        |
| `ClearServerPermissionList <type>`            | —                        | Clear a list                            |
| `EnableServerPermissionList <type> <0/1>`     | —                        | Toggle a list                           |
| `ShowServerPermissionDetails`                 | —                        | Print all permission lists              |

***

Buildings [#buildings]

| Command                                     | Aliases                     | Effect                                                                                       |
| ------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------- |
| `SaveJianZhuToFile <filename>`              | —                           | Save buildings in radius to file (see [Building Transfer](/docs/soulmask/building-transfer)) |
| `LoadJianZhuFromFile <exact> <filename>`    | —                           | Load buildings from file                                                                     |
| `SetJianZhuToFileMode <radius>`             | —                           | Set capture radius (cm)                                                                      |
| `CuiHuiViewGongHuiJianZhuByRadius <radius>` | `destroy_buliding_in_range` | ⚠️ Destroy all buildings in radius                                                           |
| `TouQuAllJianZhues`                         | —                           | ⚠️ Loot all buildings — destructive                                                          |
| `TouQuViewJianZhu`                          | —                           | Loot the targeted building                                                                   |
| `ResetTargetChest`                          | —                           | Reset a targeted chest                                                                       |
| `ShowAroundJianZhuNumber`                   | —                           | Show building count nearby                                                                   |
| `ShowJianZhuTotalNumber`                    | —                           | Show total building count                                                                    |
| `SetJianZhuDaoTaMode <0/1>`                 | —                           | Toggle building collapse mode                                                                |
| `SetJianZhuFuLanMul <multiplier>`           | —                           | Set decay multiplier                                                                         |
| `CopyViewActorGuiShu`                       | —                           | Copy targeted building's owner                                                               |
| `ApplyGuiShuToViewActor`                    | —                           | Apply copied owner to target                                                                 |

***

World, Weather & Time [#world-weather--time]

| Command                         | Aliases                       | Effect                    |
| ------------------------------- | ----------------------------- | ------------------------- |
| `PrayWeather <type> <duration>` | —                             | Force weather (types 0–6) |
| `Set24hTime <HH:mm>`            | —                             | Set time of day           |
| `SetTimeOffset <hours>`         | —                             | Offset world time         |
| `SetTimePower <multiplier>`     | —                             | Time speed multiplier     |
| `AddGameWorldTime <seconds>`    | —                             | Advance world time        |
| `QueryWenDu`                    | —                             | Query temperature         |
| `ShuaXinZhiBei <radius>`        | `Refresh_Vegetation_In_Range` | Respawn vegetation        |
| `CuiHuiZhiBei <radius>`         | `Destroy_Vegetation_In_Range` | Destroy vegetation        |
| `ShowYingHuoLocation`           | —                             | Show firefly locations    |

***

Movement & Navigation [#movement--navigation]

| Command                 | Aliases      | Effect                     |
| ----------------------- | ------------ | -------------------------- |
| `Go <x> <y> <z>`        | —            | Teleport to coordinates    |
| `GoF <distance> <z>`    | —            | Teleport forward           |
| `GotoJiTan`             | —            | Teleport to nearest altar  |
| `GPS`                   | —            | Print your coordinates     |
| `GhostMode <0/1>`       | `Ghost_Mode` | Fly + invisible            |
| `YinShen`               | —            | Become untargetable        |
| `XiuMian`               | —            | Anti-hibernation toggle    |
| `AddJinZhiXiuMianHere`  | —            | Add no-hibernation zone    |
| `ClearAllJinZhiXiuMian` | —            | Clear no-hibernation zones |
| `DebugInfo`             | —            | Show debug info            |
| `DebugSelfLocation`     | —            | Print your location        |
| `DebugTargetLocation`   | —            | Print target's location    |

***

Selection & Inspection [#selection--inspection]

| Command            | Aliases                  | Effect                |
| ------------------ | ------------------------ | --------------------- |
| `Select`           | —                        | Select your target    |
| `ClearSelect`      | `Remove_Selected_Target` | Deselect              |
| `QuerySelect`      | —                        | Query selected target |
| `ShowCI`           | —                        | Show character info   |
| `ChaXunPSUniqueId` | —                        | Print player Steam ID |

***

Raid Heat (Invasion Fever) [#raid-heat-invasion-fever]

| Command           | Aliases       | Effect              |
| ----------------- | ------------- | ------------------- |
| `AddReDu <value>` | `Add_Fever`   | Increase raid heat  |
| `ClearAllReDu`    | `Clear_Fever` | Reset all raid heat |
| `ShowReDu`        | `Show_Fever`  | Show raid heat      |

***

Server Management [#server-management]

| Command                     | Aliases           | Effect                                            |
| --------------------------- | ----------------- | ------------------------------------------------- |
| `BaoCun`                    | `Save`            | Force-save the world                              |
| `Exit`                      | —                 | ⚠️ Save and shut down immediately                 |
| `Key <password>`            | —                 | Authenticate as admin                             |
| `KickPlayer <steamid>`      | —                 | Kick a player                                     |
| `LT <channel> <message>`    | —                 | Send a chat message                               |
| `RefreshServerGlobalConfig` | —                 | Reload server config                              |
| `GaiMM`                     | `Change_Password` | Change server password                            |
| `ShanHao`                   | —                 | ⚠️ Delete current player's account — irreversible |
| `ChongZhiRenWu`             | —                 | Reset guidance/quests                             |
| `ForceSavePlayerData`       | —                 | Force-save player data                            |

***

Special Events [#special-events]

| Command                                 | Aliases | Effect                         |
| --------------------------------------- | ------- | ------------------------------ |
| `SetSpecialEventOpenOrClose <id> <0/1>` | —       | Enable/disable a special event |
| `ResetSpecailEventTriggerTime`          | —       | Reset event trigger time       |
| `ResetSpecialEventTriggerCount`         | —       | Reset event trigger count      |
| `JiTanCeShi`                            | —       | Test altar event               |

***

Map & Exploration [#map--exploration]

| Command                    | Aliases    | Effect                |
| -------------------------- | ---------- | --------------------- |
| `ShowMap`                  | `Show_Map` | Reveal entire map     |
| `DebugNavMesh`             | —          | Toggle nav mesh debug |
| `QueryStreamingLevelState` | —          | Query level streaming |

***

Commands That Don't Need gm [#commands-that-dont-need-gm]

A handful of commands work for any player without admin authentication:

| Command     | Effect             |
| ----------- | ------------------ |
| `DebugInfo` | Show debug info    |
| `Egg`       | Easter egg / debug |
| `GPS`       | Print coordinates  |
| `SuDu`      | Show speed         |
| `ShowCI`    | Character info     |

***

Dangerous Commands — Use with Caution [#dangerous-commands--use-with-caution]

These commands are easy to misuse and can be hard to undo:

* `FuHuo` — revive command, known to cause issues
* `ShanHao` — deletes the current player's account
* `TouQuAllJianZhues` — loots every building on the server
* `CuiHuiViewGongHuiJianZhuByRadius` — destroys buildings in a radius (no undo)
* `ClearAllNpc` — wipes every NPC from the world
* `SimulatingPhysics` — physics debugging, can desync the world

**Always back up `world.db` before running destructive commands.**

***

Related Guides [#related-guides]

* [Adding Admins](/docs/soulmask/admin-setup)
* [RCON & Telnet](/docs/soulmask/rcon-setup)
* [Building Transfer](/docs/soulmask/building-transfer)
* [Server Configuration](/docs/soulmask/server-config)
* [Backup System](/docs/soulmask/backup-system)
