查看“︁工程参考/GM指令”︁的源代码

__NOTOC__
<div class="lua-reference">
<div class="lua-lead">
<div role="heading" aria-level="2" class="lua-h1">GM 指令</div>
<div class="lua-sub">203 个指令名 · 189 条指令（别名合并后）· 4 级权限</div>
</div>

GM 指令是聊天框里用 <code>!!</code> 前缀发出的服务端调试指令。本页列出全部 189 条：指令名、用法、参数槽与所需权限等级。

== 怎么使用 ==
* 在聊天框输入 <code>!!指令名 参数=值</code>，例如 <code>!!createitem itemtype=10101001 quality=1 count=1</code>。前缀是两个感叹号，客户端识别后剥掉前缀发往服务端（实现位于 <code>Client/Interface/GMInterface_Script_Talk.cpp</code> 的 <code>SendGMCommand</code>）。
* 指令名不区分大小写；参数一律 <code>键=值</code> 形式，多个参数之间不用逗号、直接连写（解析端按 <code>=</code> 逐个找键）。
* 指令正文最多 254 个文字单位（382 字节），超长客户端直接不发。
* 每条有效指令都会转发到 WorldServer 留审计记录（GUID、角色名、权限等级、指令原文）。

== 权限模型 ==
服务端入口 <code>CGCommandHandler::Execute</code>（实现位于 <code>Server/GameServer/Server/Packets/CGCommandHandler.cpp</code>）有两道闸：

# 全局开关 <code>g_Command_CommandEnable</code> 默认关。开关打开时任何人可用；关闭时查共享内存 GM 表（GUID + Access 等级），共享内存未启用则直接放行（单机调试）。
# 权限过滤 <code>Calc_GmRight</code>：GM 表的 Access 列 0–3 映射到四级执行权限——Access 0 = ALL、1 = ADMIN、2 = GMADMIN、3 = GM。指令按类型分四组，等级不够直接拒绝；未列入任何组的类型一律拒绝。

== 参数图例 ==
参数列写的是指令用到的参数槽：<code>P0</code>–<code>P9</code> 是整型、<code>F0</code>–<code>F3</code> 是浮点、<code>Exp</code>/<code>Combat</code> 是 64 位数值、<code>文本</code> 是字符串缓冲。用法列是源码分支上的注释原文，写 <code>??</code> 表示填数值。

== GM（Access 3） · 7 条 ==
最低权限，查人、传送、发系统消息。

{| class="wikitable"
! scope="col" | 指令
! scope="col" | 用法
! scope="col" style="width:14%" | 参数
! scope="col" style="width:7%" | 类型
|-
| <code>syschat</code>
| <code>syschat ????????</code>
| 文本
| 15
|-
| <code>searchplayer</code>
| —
| P0 P1 文本
| 176
|-
| <code>gotoplayer</code>
| —
| P0 P1 文本
| 177
|-
| <code>setautoremovebadpet</code>
| —
| P0
| 180
|-
| <code>sethumanattrpoint</code>
| —
| P0 P1 Combat
| 188
|-
| <code>setpetattrpoint</code>
| —
| P0 P1 P2 Combat
| 189
|-
| <code>sendsystemmessage</code>
| —
| P0 文本
| 190
|}

== GMADMIN（Access 2） · 25 条 ==
传送、复活、造怪、邮件、抓人。

{| class="wikitable"
! scope="col" | 指令
! scope="col" | 用法
! scope="col" style="width:14%" | 参数
! scope="col" style="width:7%" | 类型
|-
| <code>teleport</code>、<code>tp</code>
| <code>teleport obj=?? loc=???,??? scene=??</code>
| P0 P1 F0 F1
| 1
|-
| <code>relive</code>
| <code>relive</code>
| 无
| 7
|-
| <code>iamgod</code>
| <code>iamgod</code>
| 无
| 12
|-
| <code>iamdog</code>
| <code>iamdog</code>
| 无
| 13
|-
| <code>goto</code>
| <code>goto loc=??,?? scene=??</code>
| P0 F0 F1
| 34
|-
| <code>fullrecover</code>、<code>full</code>
| <code>fullrecover(full)</code>
| 无
| 35
|-
| <code>skillrelive</code>
| <code>skillrelive</code>
| 无
| 43
|-
| <code>setscenetype</code>
| <code>setscenetype scene=??</code>
| P0
| 46
|-
| <code>setdamage</code>
| <code>setdamage obj=?? damage=????</code>
| P0 P1
| 50
|-
| <code>killobj</code>
| <code>killobj obj=??</code>
| P0
| 51
|-
| <code>createmonster</code>
| <code>createmonster type=?? pos=??,?? baseai=?? scriptai=?? script=??</code>
| P0 P1 P2 P3 F0 F1 文本
| 52
|-
| <code>deletemonster</code>
| <code>deletemonster objid=???</code>
| P0
| 53
|-
| <code>setaitype</code>
| <code>setaitype objid=??? aitype=???</code>
| P0 P1
| 54
|-
| <code>sendmail</code>
| <code>sendmail destguid=??? contex=???</code>
| 文本 文本2
| 59
|-
| <code>recvmail</code>
| <code>recvmail</code>
| 无
| 60
|-
| <code>getobjinfo</code>
| <code>getobjinfo objid=???</code>
| P0
| 77
|-
| <code>who</code>
| <code>who</code>
| 无
| 80
|-
| <code>allwho</code>
| <code>allwho</code>
| 无
| 81
|-
| <code>catchplayer</code>
| <code>catchplayer name=???? 或者</code>
| P0 P1 文本
| 82
|-
| <code>playerinfo</code>
| <code>playerinfo name=???? 或者</code>
| P0 P1 文本
| 83
|-
| <code>loadmonster</code>
| <code>loadmonster filename</code>
| 文本
| 94
|-
| <code>fingerguid</code>
| —
| P0 P1
| 110
|-
| <code>fingername</code>
| <code>fingername opt=OnlineFlag,PreciseFlag,Position name=name</code>
| P0 P1 P2 文本
| 111
|-
| <code>advancedfinger</code>
| <code>advancedfinger =pos =menpai =guildid =sex =fromlevel,tolevel</code>
| P0 P1 P2 P3 F0 F1
| 112
|-
| <code>KillMonstersByClass</code>
| —
| P0
| 139
|}

== ADMIN（Access 1） · 50 条 ==
改属性、发物品发宠物、改钱改元宝、任务数据。

{| class="wikitable"
! scope="col" | 指令
! scope="col" | 用法
! scope="col" style="width:14%" | 参数
! scope="col" style="width:7%" | 类型
|-
| <code>modifyxinfa</code>
| <code>modifyxinfa xinfa=??,grade=??</code>
| P0 P1 P2
| 3
|-
| <code>levelupallxinfa</code>
| <code>levelupallxinxa grade=??</code>
| P0
| 4
|-
| <code>createitem</code>
| <code>createitem itemtype=物品编号 quality=品质 count=数量（count 省略为 1）</code>
| P0 P1 P2 P6 文本
| 5
|-
| <code>createitembind</code>
| <code>createitembind itemtype=物品编号 quality=品质 count=数量（绑定版，count 省略为 1）</code>
| P0 P1 P2 P6 文本
| 6
|-
| <code>enablegod</code>
| <code>enablegod</code>
| 无
| 10
|-
| <code>disablegod</code>
| <code>disablegod</code>
| 无
| 11
|-
| <code>createpet</code>
| <code>createpet petid=???</code>
| P0
| 36
|-
| <code>deletepet</code>
| <code>deletepet petid=???</code>
| P0
| 37
|-
| <code>capturepet</code>
| <code>capturepet petid=???</code>
| P0
| 38
|-
| <code>calluppet</code>
| <code>calluppet petindex=???</code>
| P0
| 39
|-
| <code>recallpet</code>
| <code>recallpet</code>
| 无
| 40
|-
| <code>freepettonature</code>
| <code>freepettonature =petindex</code>
| P0
| 41
|-
| <code>returntochild</code>
| <code>returntochild =petindex</code>
| P0
| 42
|-
| <code>setpkvalue</code>
| —
| P0
| 47
|-
| <code>setmodelid</code>
| —
| P0
| 48
|-
| <code>setequipdur</code>
| —
| P1 P2
| 49
|-
| <code>modifymoney</code>、<code>addmoney</code>
| <code>modifymoney gold=???</code>
| P0
| 55
|-
| <code>modifyyuanbao</code>、<code>addyuanbao</code>
| —
| P0
| 56
|-
| <code>modifyzengdian</code>、<code>addzengdian</code>
| <code>modifyzengdian value=??</code>
| P0
| 57
|-
| <code>levelup</code>
| <code>levelup =level</code>
| P0
| 78
|-
| <code>abilityup</code>
| <code>abilityup =abilityid =level</code>
| P0 P1
| 79
|-
| <code>setpethappiness</code>
| —
| P0 P1
| 84
|-
| <code>setpethp</code>
| —
| P0 Combat
| 85
|-
| <code>setpetlife</code>
| —
| P0 P1
| 86
|-
| <code>petlevelup</code>
| —
| P0
| 87
|-
| <code>setpetskill</code>
| —
| P0 P1 P2
| 88
|-
| <code>usepetskill</code>
| <code>usepetskill skillid=??? objid=???</code>
| P0 P1
| 89
|-
| <code>leveldown</code>
| <code>LevelDown =levelwillbecut</code>
| P0
| 90
|-
| <code>addexp</code>
| <code>AddExp =Expwillbeadded</code>
| Exp
| 91
|-
| <code>sethaircolor</code>
| —
| P0 P1 P2 P3
| 95
|-
| <code>sethairmodel</code>
| —
| P0
| 96
|-
| <code>createguard</code>
| <code>createhelper modelid=???</code>
| P0
| 97
|-
| <code>SetVigor</code>
| —
| P0
| 105
|-
| <code>SetEnergy</code>
| —
| P0
| 106
|-
| <code>PetPullulate</code>
| —
| P0
| 107
|-
| <code>addskill</code>
| <code>addskill =skilll_id</code>
| P0 P1
| 108
|-
| <code>removeskill</code>
| <code>removeskill =skilll_id</code>
| P0
| 109
|-
| <code>setabilityexp</code>
| <code>setabilityexp =abilityid =value</code>
| P0 P1
| 113
|-
| <code>EnableFatigue</code>
| —
| 无
| 140
|-
| <code>DisableFatigue</code>
| —
| 无
| 141
|-
| <code>clearyuanbaodaycost</code>
| <code>clearyuanbaodaycost value=??</code>
| P0
| 153
|-
| <code>setmissiondata</code>
| <code>setmissiondata param0=??,param1=??</code>
| P0 P1
| 158
|-
| <code>setmissionparam</code>
| <code>setmissionparam param0=??,param1=??,param2=??</code>
| P0 P1 P2
| 159
|-
| <code>setmissiondone</code>
| <code>setmissiondone param0=??,param1=??</code>
| P0 P1
| 160
|-
| <code>addpettitle</code>
| <code>addpettitle titleid=??</code>
| P0
| 162
|-
| <code>delpettitle</code>
| <code>delpettitle titleid=??</code>
| P0
| 163
|-
| <code>setusermissiondata</code>
| <code>setusermissiondata param0=??,param1=??,param2=??</code>
| P0 P1 P2
| 164
|-
| <code>killsafetime</code>
| —
| 无
| 166
|-
| <code>modifyjiaozi</code>、<code>addjiaozi</code>
| <code>modifyjiaozi value=??</code>
| P0
| 181
|-
| <code>modifyhonour</code>、<code>addhonour</code>
| <code>modifyhonour value=??</code>
| P0
| 187
|}

== ALL（Access 0） · 107 条 ==
最高权限，场景管理、帮会队伍管理、重载配置、Lua 热执行。

{| class="wikitable"
! scope="col" | 指令
! scope="col" | 用法
! scope="col" style="width:14%" | 参数
! scope="col" style="width:7%" | 类型
|-
| <code>modifymenpai</code>
| <code>modifymenpai menpai=??</code>
| P0
| 2
|-
| <code>godrelive</code>
| <code>godrelive</code>
| 无
| 8
|-
| <code>debug_print</code>
| <code>debug_print param0=??,param1=??</code>
| P0 P1
| 9
|-
| <code>debug_reloadconfig</code>、<code>reloadgmlist</code>
| <code>debug_reloadconfig</code>
| 无
| 14
|-
| <code>debug_shutdown</code>
| <code>debug_shutdown</code>
| 无
| 16
|-
| <code>team_invite</code>
| <code>team_invite sguid=????, dguid=????</code>
| P0 文本
| 17
|-
| <code>team_retinvite</code>
| <code>team_retinvite ret=?, guid=????</code>
| P0 P1
| 18
|-
| <code>team_leaderretinvite</code>
| <code>team_leaderretinvite ret=?, sguid=????, dguid=????</code>
| P0 P1 P2
| 19
|-
| <code>team_apply</code>
| <code>team_apply sguid=????, dguid=????</code>
| P0 文本
| 20
|-
| <code>team_retapply</code>
| <code>team_retapply ret=?, sguid=????, dguid=????</code>
| P0 P1 P2
| 21
|-
| <code>team_leave</code>
| <code>team_leave guid=????</code>
| P0
| 22
|-
| <code>team_kick</code>
| <code>team_kick sguid=????, dguid=????</code>
| P0 P1
| 23
|-
| <code>team_dismiss</code>
| <code>team_dismiss guid=????</code>
| P0
| 24
|-
| <code>team_appoint</code>
| <code>team_appoint sguid=????, dguid=????</code>
| P0 P1
| 25
|-
| <code>ability_detail</code>、<code>ability</code>
| <code>ability objid=????</code>
| P0
| 26
|-
| <code>use_ability</code>
| <code>use_ability ability_id=?? prescription_id=???? obj_id=????</code>
| P0 P1 P2
| 27
|-
| <code>combound_gem</code>
| <code>宝石表号、合成符格号、消耗颗数。</code>
| P6 文本
| 28
|-
| <code>use_gem</code>
| <code>旧入口只保留权限检查和退役提示，不再生成旧协议请求。</code>
| 无
| 29
|-
| <code>channel_create</code>
| <code>channel_create guid=????</code>
| P0
| 30
|-
| <code>channel_invite</code>
| <code>channel_invite sguid=????, dguid=????</code>
| P0 P1
| 31
|-
| <code>channel_dismiss</code>
| <code>channel_dismiss guid=????</code>
| P0
| 32
|-
| <code>channel_kick</code>
| <code>channel_kick sguid=????, dguid=????</code>
| P0 P1
| 33
|-
| <code>createscene</code>
| <code>createscene</code>
| 无
| 44
|-
| <code>closescene</code>
| <code>closescene scene=??</code>
| P0
| 45
|-
| <code>teamfollow</code>
| <code>teamfollow</code>
| 无
| 58
|-
| <code>createguild</code>
| <code>createguild =guildname</code>
| 文本
| 61
|-
| <code>joinguild</code>
| <code>joinguild =guildid</code>
| P0
| 62
|-
| <code>guildrecruit</code>
| <code>guildrecruit =guid</code>
| P0
| 63
|-
| <code>guildexpel</code>
| <code>guildexpel =guild</code>
| P0
| 64
|-
| <code>leaveguild</code>
| —
| 无
| 65
|-
| <code>dismissguild</code>
| —
| 无
| 66
|-
| <code>guildlist</code>
| <code>guildlist =startindex</code>
| P0
| 67
|-
| <code>setmovemode</code>
| <code>setmovemode modeid=???</code>
| P0
| 68
|-
| <code>relation</code>
| <code>relation</code>
| 无
| 69
|-
| <code>addfriend</code>
| <code>addfriend =friendguid =friendgroup =friendname</code>
| P0 P1 文本
| 70
|-
| <code>setfriendpoint</code>、<code>setfp</code>
| <code>setfp =friendguid =friendpoint</code>
| P0 P1
| 71
|-
| <code>addblackname</code>、<code>addblack</code>
| <code>addblack =blackguid =blackname</code>
| P0 文本
| 72
|-
| <code>delfriend</code>
| <code>delfriend =friendguid =passwd</code>
| P0 文本
| 73
|-
| <code>delblack</code>
| <code>delblack =blackguid</code>
| P0
| 74
|-
| <code>transition</code>
| <code>transition =guid =type =group</code>
| P0 P1 P2
| 75
|-
| <code>save</code>
| <code>save</code>
| 无
| 76
|-
| <code>CityCreate</code>
| <code>建立城市 =入口场景号</code>
| P0
| 92
|-
| <code>CityDelete</code>
| <code>建立城市 =入口场景号</code>
| P0 P1
| 93
|-
| <code>CreateSpecialObj</code>
| —
| P0
| 98
|-
| <code>useitem</code>
| <code>useitem bagitempos=??,targetitempos=??</code>
| P0 P1
| 99
|-
| <code>forgetrecipe</code>
| —
| P0
| 100
|-
| <code>SendImpactToUnit</code>
| —
| P0 P1
| 101
|-
| <code>ReloadCombatTables</code>
| —
| 无
| 102
|-
| <code>UseSkill</code>
| —
| P0 P1 F0 F1 F2 文本
| 103
|-
| <code>savepacketinfo</code>
| —
| 无
| 104
|-
| <code>setgoodbad</code>
| —
| P0
| 114
|-
| <code>reloadmonsterattr</code>
| —
| 无
| 115
|-
| <code>reloadbasevalue</code>
| —
| 无
| 116
|-
| <code>setguildattr</code>
| —
| P0 P1 Combat
| 117
|-
| <code>ResetCooldownList</code>
| —
| P0
| 118
|-
| <code>DispelHostileImpacts</code>
| —
| P0
| 119
|-
| <code>OutputPacketAuditReport</code>
| —
| 无
| 120
|-
| <code>SetMenpaiPoint</code>
| —
| P0
| 121
|-
| <code>UnitAttr</code>
| —
| P0
| 122
|-
| <code>setmasterlevel</code>
| —
| P0
| 123
|-
| <code>showcooldown</code>
| —
| P0
| 124
|-
| <code>LogUnitAttr</code>
| —
| P0 P1 Combat
| 125
|-
| <code>loadlua</code>
| —
| P0
| 126
|-
| <code>exeluafunc</code>
| —
| P0 P1 P2 文本
| 127
|-
| <code>SetCampID</code>
| <code>SetCampID =objid =campid</code>
| P0 P1
| 128
|-
| <code>SetReputationID</code>
| —
| P0 P1 Combat
| 129
|-
| <code>SetReputationByID</code>
| —
| P0 P1 P2 Combat
| 130
|-
| <code>ModifyMyFightBackList</code>
| —
| P0 P1 Combat
| 131
|-
| <code>ModifyMyDuelList</code>
| —
| P0 P1 Combat
| 132
|-
| <code>ModifyMyEnemyList</code>
| —
| P0 P1 Combat
| 133
|-
| <code>SetPvpMode</code>
| —
| P0 P1 Combat
| 134
|-
| <code>SetPvpAuth</code>
| —
| P0 P1 P2 Combat
| 135
|-
| <code>TestFunction</code>
| —
| P0 P1 P2 P3
| 136
|-
| <code>SetMonsterFightWithNpcFlag</code>
| —
| P0 P1 P2 P3
| 137
|-
| <code>IncreaceSavvyByCompound</code>
| <code>IncreaceSavvyByCompound param0=??,param1=??</code>
| P0 P1
| 138
|-
| <code>reloadaiscript</code>
| —
| 无
| 142
|-
| <code>SetZBValue</code>
| —
| P0
| 143
|-
| <code>SetZBTitle</code>
| —
| P0
| 144
|-
| <code>reloadtab</code>
| —
| 文本
| 145
|-
| <code>showiteminfo</code>
| <code>showiteminfo itemindex=??</code>
| P0
| 146
|-
| <code>setft</code>
| —
| P0 P1
| 147
|-
| <code>AuditSwitch</code>
| —
| P0
| 148
|-
| <code>log_procreate</code>
| —
| 无
| 149
|-
| <code>GuildLeaveWord</code>、<code>glw</code>
| —
| 文本
| 150
|-
| <code>slot</code>
| —
| P0
| 151
|-
| <code>showcharinfo</code>
| —
| P0
| 152
|-
| <code>ResetFightBackList</code>
| —
| P0
| 154
|-
| <code>modifyweather</code>
| —
| P0 P1 Combat
| 155
|-
| <code>ChangeUserName</code>
| —
| 文本
| 156
|-
| <code>ChangeGuildName</code>
| —
| 文本
| 157
|-
| <code>couplequestion</code>
| <code>couplequestion question=??</code>
| 文本
| 161
|-
| <code>setpetnumextra</code>
| <code>setpetnumextra value=??</code>
| P0
| 165
|-
| <code>createleague</code>
| —
| 文本 文本2
| 167
|-
| <code>destroyleague</code>
| —
| 无
| 168
|-
| <code>askenterleague</code>
| —
| P0
| 169
|-
| <code>answerenterleague</code>
| —
| P0
| 170
|-
| <code>quitleague</code>
| —
| 无
| 171
|-
| <code>leaguelist</code>
| —
| 无
| 172
|-
| <code>leagueinfo</code>
| —
| 无
| 173
|-
| <code>leaguememberapplylist</code>
| —
| 无
| 174
|-
| <code>leaguechangedesc</code>
| —
| 文本
| 175
|-
| <code>enhance</code>
| —
| P0 P1 Combat
| 178
|-
| <code>setpetsavvy</code>
| —
| P0 P1
| 179
|-
| <code>levelupanqi</code>
| —
| P0
| 184
|-
| <code>setanqiattr</code>
| —
| P0 P1 Combat
| 185
|-
| <code>adddarkexp</code>
| —
| P0
| 186
|-
| <code>deleteitem</code>、<code>delitem</code>
| <code>deleteitem index=格号 count=数量（count=all 整格删除；道具栏 0–99、材料栏 100–199、任务栏 200–219）</code>
| P0 P1 P2 P6 文本
| 191
|}

== 占位与别名 ==
* <code>none</code> 是空指令占位，解析后直接返回、不执行任何操作。
* 同一行的多个指令名是别名（如 <code>teleport</code> 与 <code>tp</code>），效果相同。
* 指令类型号来自 <code>Common/GameDefine2.h</code> 的 <code>COMMAND_TYPE</code> 枚举，共 193 个枚举值；改指令解析或权限分组时用它定位。

[[Category:工程参考]]
</div>