本指南涵盖了在 Legion Hosting 上运行的 Empyrion: Galactic Survival 专用服务器所有可用的管理员和控制台命令。了解如何设置管理员权限、管理玩家以及使用 GameMaster 命令来管理您的服务器。有关初始服务器设置和配置，请参阅我们的 Empyrion: Galactic Survival 服务器设置指南。
权限等级
Empyrion 使用数字权限系统，数字越小权限越高。每个权限等级都包含所有更高数字等级可用的命令。
| 等级 | 角色 | 代码 | 描述 |
|---|---|---|---|
| 0 | Player | pl |
所有玩家的默认权限等级。仅可使用基本命令。 |
| 3 | GameMaster | gm |
提升的权限，用于游戏管理、传送、生成和世界控制。 |
| 6 | Moderator | mod |
玩家管理功能，包括封禁、给予物品和实体管理。 |
| 9 | Admin | admin |
完全的管理权限，包括角色分配、游戏区域管理和服务器控制。 |
权限继承： 拥有 GameMaster（等级 3）权限的玩家可以使用所有需要等级 3 或更高（3+、6+、9+）的命令。Admin（等级 9）可以使用所有命令。
设置管理员权限
方法 1：adminconfig.yaml（推荐）
设置管理员权限最可靠的方式是通过 adminconfig.yaml 文件。此文件位于服务器的 Saves/ 文件夹中（有时也在 dedicated.yaml 旁边）。
使用以下结构创建或编辑 adminconfig.yaml：
Elevated:
- Id: 76561198012345678
Permission: 3
Name: "PlayerOne"
- Id: 76561198087654321
Permission: 9
Name: "ServerAdmin"
Banned:
- Id: 76561198099999999
Until: "2027-01-01 00:00:00"每个条目需要：
Id— 玩家的 SteamID64（以 7656 开头的 17 位数字）Permission— 要分配的权限等级（3 = GameMaster、6 = Moderator、9 = Admin）Name— 玩家名称（可选，供您参考）
查找 SteamID64： 玩家可以访问 steamid.io 并输入其 Steam 个人资料 URL 来查找 SteamID64。SteamID64 是一个以
7656 开头的 17 位数字。
方法 2：initadmin 控制台命令
如果您以玩家身份登录服务器且尚未设置管理员，可以使用 initadmin 命令将自己设置为初始管理员：
initadmin此命令仅在当前未配置管理员时有效。一旦管理员已存在，后续角色分配必须通过 setrole 命令或 adminconfig.yaml 文件完成。
方法 3：setrole 控制台命令
现有管理员（权限等级 9）可以使用 setrole 命令为其他玩家分配角色：
setrole PlayerName gm # Set as GameMaster (level 3)
setrole PlayerName mod # Set as Moderator (level 6)
setrole PlayerName admin # Set as Admin (level 9)
setrole PlayerName pl # Reset to Player (level 0)您也可以使用玩家的 SteamID64 代替其名称：
setrole 76561198012345678 gm打开控制台
要访问游戏内控制台，请按键盘上的波浪键（~）。控制台允许您在游戏中直接输入命令。所有命令不区分大小写。
Telnet 控制台： 如果在
dedicated.yaml 中启用了 Telnet，您也可以通过 Telnet 远程发送命令。使用 PuTTY 或类似终端客户端以 Raw 连接类型（非标准 Telnet）连接到 Telnet 端口（默认：1030）。有关 Telnet 配置详情，请参阅服务器设置指南。
玩家命令（等级 0+）
这些命令对所有玩家可用。
| 命令 | 描述 |
|---|---|
help |
列出所有可用的控制台命令。使用 help [command] 查看特定命令的详情。 |
detach |
当本地玩家卡在驾驶舱下方或几何体中时将其分离 |
destroyme |
杀死自己的角色（卡住时有用） |
undock |
将指定的 SV 或 HV 从其父级结构中分离 |
difficulties |
显示游戏当前的难度设置 |
origins |
列出可用的起源（起始阵营） |
oxygen |
显示 POI 中的含氧区域 |
combiner |
切换网格合并器开/关（性能优化） |
deco |
切换地形装饰开/关（性能优化） |
initadmin |
将自己设置为初始管理员（仅在未设置管理员时有效） |
GameMaster 命令（等级 3+）
GameMaster 命令提供对游戏世界、实体和玩家状态的控制。
玩家和实体管理
| 命令 | 描述 |
|---|---|
godmode / gm |
切换自己的上帝模式（无敌） |
itemmenu / im |
启用/禁用创意物品菜单，可生成任何物品 |
kick [player] |
踢出一个玩家（或所有玩家） |
unban [player|SteamID] |
移除对玩家的封禁 |
list |
列出拥有特殊权限的玩家和被封禁的玩家 |
level [set|add] [value] |
修改当前玩家的等级、经验值或升级点数 |
entity [operation] |
对实体执行各种操作（使用 help entity 查看详情） |
ents |
列出当前游戏区域中的所有实体 |
find [name] |
在当前游戏区域中按名称查找结构并显示其 ID |
faction [operation] |
阵营管理辅助功能 |
传送和移动
| 命令 | 描述 |
|---|---|
teleport [x] [y] [z] / tt |
将自己（及控制的飞船）传送到指定坐标 |
setposition [entity] [x] [y] [z] |
将实体的位置设置为指定坐标 |
setrotation [entity] [x] [y] [z] |
设置结构的旋转角度 |
sector [x] [y] [z] |
跳转到太空中的指定区域 |
世界和游戏管理
| 命令 | 描述 |
|---|---|
changemode |
在生存模式和创造模式之间切换 |
map |
揭示当前地图上的所有资源和 POI |
regenerate [entityId] |
重新生成 POI 或结构，将其恢复到原始状态 |
weather [type] |
在当前游戏区域激活自定义天气设置 |
time [set] [value] |
获取或设置全局服务器时间 |
finishbp / fbp |
立即完成当前的蓝图生产 |
spawnanyblueprint / sbp |
切换是否可以无视要求生成任何蓝图 |
gameoptions / gopt |
列出所有当前游戏选项值（参见下方游戏选项部分） |
op [entityId] |
切换特定结构的离线保护 |
wipe [target] |
在服务器重启后清除指定内容（请谨慎使用） |
stats |
打印当前游戏区域的状态信息 |
traders |
列出所有交易者并重新加载交易者配置文件 |
状态效果和玩家状态
| 命令 | 描述 |
|---|---|
statuseffect [effect] |
对玩家施加状态效果 |
statuseffectremove [effect] |
移除玩家的状态效果 |
prefabactivate |
开启结构中的所有电力方块 |
prefabinfo |
显示用户蓝图的信息 |
resetcore |
清除本地结构中的燃料和氧气 |
Moderator 命令（等级 6+）
Moderator 命令增加了玩家管理和实体控制功能。
| 命令 | 描述 |
|---|---|
ban [player] [duration] |
封禁玩家指定时间 |
give [player] [itemId] [amount] |
通过物品 ID 给予玩家物品 |
repair [player] |
修复玩家的物品 |
destroy [entityId] |
销毁实体或结构 |
debugmenu / dm |
启用/禁用调试菜单 |
armor [operation] |
玩家护甲调整 |
gents [factionId] |
列出属于特定阵营的所有结构 |
alliances |
列出联盟、联盟请求并管理联盟设置 |
sectors [reveal|hide] |
在地图上显示或隐藏游戏区域 |
ai |
切换当前游戏区域的 AI 开/关 |
si |
切换结构完整性计算开/关 |
globaleffects |
显示服务器上当前活跃的全局效果 |
marker [operation] |
管理地图标记 |
weathersv [type] |
在全服范围激活自定义天气设置 |
poimanager |
POI（兴趣点）管理命令 |
Admin 命令（等级 9）
Admin 命令提供最高级别的服务器控制。
| 命令 | 描述 |
|---|---|
setrole [player|SteamID] [role] |
设置玩家的权限角色（gm、mod、admin、pl） |
playfield / pf |
重新加载当前游戏区域（仅服务器端命令） |
replaceblocks [entityId] [blockFrom] [blockTo] |
将结构中指定方块替换为另一种方块类型 |
setdevicespublic [entityId] |
将结构中所有设备设置为公共访问 |
pda [operation] |
执行 PDA 相关命令（使用 help pda 查看详情） |
游戏选项（gopt）命令
gameoptions（或 gopt）命令允许您在运行时查看和修改服务器游戏设置，无需编辑配置文件或重启服务器。
查看设置
# Show all game options
gopt
# Show only settings that differ from defaults
gopt nd修改设置
# Set a specific option
gopt set DecayTime 48
gopt set MaxStructures 150
gopt set ForcePvP true
gopt set DiffAttackStrength Hard
gopt set DiffConstrCraftTime Instant可用游戏选项
| 选项 | 默认值 | 描述 |
|---|---|---|
DecayTime |
24 | 无核心/小型结构在无人访问时被移除前的小时数 |
WipeTime |
0 | 任何无人访问的结构被移除前的小时数（0 = 禁用） |
ProtectTime |
48 | 玩家结构的离线保护时间（小时） |
ProtectDelay |
300 | 离线保护激活前的延迟秒数 |
MaxStructures |
200 | 每个游戏区域的最大结构数（0-255） |
AntiGriefDistancePvE |
30 | PvE 中不同阵营基地之间的最小距离（米） |
AntiGriefDistancePvP |
300 | PvP 中不同阵营基地之间的最小距离（米） |
ForcePvP |
false | 在所有游戏区域强制启用 PvP |
DiffAmountOfOre |
Normal | 矿石储量丰富程度（Rich、Normal、Poor） |
DiffNumberOfDeposits |
Normal | 矿藏数量频率（Plenty、Normal、Few） |
DiffAttackStrength |
Medium | NPC 攻击伤害（Easy、Medium、Hard） |
DiffConstrCraftTime |
Normal | 制造器速度（Faster、Normal、Slower、Instant） |
服务器管理命令
这些是日常服务器管理的基本命令，可通过游戏内控制台或 Telnet 使用。
# Save and shut down the server (with countdown in minutes, max 15)
saveandexit 5
# List all connected players
plys
# List all active playfield servers
servers
# Regenerate a specific playfield
regenerateplayfield [name]
# View server performance statistics
stats
服务器关闭： 请始终使用
saveandexit [minutes] 来安全关闭服务器。此命令会触发自动保存并给已连接的玩家一个倒计时警告。直接结束服务器进程可能导致数据丢失。
常见管理任务
处理卡住的玩家
如果玩家卡在几何体中或驾驶舱下方：
# Player can try this themselves:
detach
# If that fails, teleport them:
tt [player] [x] [y] [z]
# Or as a last resort, kill and respawn:
destroyme清理废弃结构
# List all structures for a faction
gents [factionId]
# Find a specific structure
find "Structure Name"
# Destroy a structure by ID
destroy [entityId]
# Adjust automatic decay timers
gopt set DecayTime 12
gopt set WipeTime 168封禁和解封玩家
# Ban a player (duration examples: 1h, 24h, 7d, permanent)
ban PlayerName 7d
# Unban a player
unban PlayerName
# List all players with special roles or bans
list相关文章
需要帮助？
如果您需要有关 Empyrion 服务器管理的进一步帮助或对特定命令有疑问，我们的支持团队随时为您服务。提交支持工单，我们将尽快回复您。
