本指南涵盖了在 Legion Hosting 上 Avorion 专用服务器的所有管理员命令、Mod 支持和服务器管理工具。了解如何管理玩家、控制星系、安装 Mod 以及排查常见问题。有关初始服务器设置和配置，请参阅我们的 Avorion 服务器设置指南。
管理员设置
Avorion 使用基于 XML 的管理员系统，为特定玩家授予提升的权限。管理员在 admin.xml 文件中定义，也可以通过游戏内命令添加。
通过 admin.xml 添加管理员
admin.xml 文件位于您的星系存档文件夹中（例如 galaxies/your_galaxy_name/admin.xml）。您可以通过 GPanel 的文件管理器编辑此文件。
<?xml version="1.0" encoding="UTF-8"?>
<admin>
<admin id="76561198012345678" />
<admin id="76561198087654321" />
</admin>每个 <admin> 条目包含玩家的 Steam ID（SteamID64 格式）。要查找玩家的 Steam ID：
- 前往玩家的 Steam 个人资料页面
- 如果其个人资料 URL 使用了自定义名称，请使用 SteamID 查询工具查找其 SteamID64
- SteamID64 是以
7656119开头的 17 位数字
在游戏内添加管理员
如果您已经是管理员，可以使用游戏内聊天命令添加其他管理员：
/admin <playerName>这将立即将指定玩家添加到管理员列表，无需重启服务器。
首位管理员：初次设置管理员时，您必须通过 GPanel 的文件管理器直接编辑
admin.xml，因为此时还没有管理员可以运行游戏内命令。添加您的 Steam ID 并重启服务器后，即可使用游戏内命令添加其他管理员。
常用管理员命令
管理员命令在游戏内聊天中输入（按 Enter 打开聊天），以 / 为前缀。这些命令也可以从 GPanel 服务器控制台执行。
玩家管理
| 命令 | 描述 |
|---|---|
/kick <name> |
将玩家踢出服务器。该玩家可以立即重新连接。 |
/ban <name> |
封禁玩家。其 Steam ID 将被添加到 banlist.txt。 |
/unban <steamid> |
通过 Steam ID 解除对玩家的封禁。 |
/admin <name> |
授予玩家管理员权限。 |
/removeadmin <name> |
移除玩家的管理员权限。 |
/say <message> |
向所有玩家广播全服消息。 |
/players |
列出所有在线玩家及其 Steam ID 和当前所在区域。 |
/whisper <name> <message> |
向特定玩家发送私聊消息。 |
服务器控制
| 命令 | 描述 |
|---|---|
/save |
手动将所有已加载的区域和玩家数据保存到磁盘。 |
/stop |
安全保存所有数据并关闭服务器。 |
/seed |
显示当前星系种子。 |
/status |
显示服务器状态，包括玩家数量、已加载区域和性能指标。 |
/difficulty <value> |
更改服务器难度等级（-3 到 3）。对新生成的区域生效。 |
/pvp <on|off> |
开启或关闭玩家对战功能。 |
/maxplayers <number> |
在服务器运行时更改最大玩家数量。 |
/password <password> |
设置或更改服务器密码。留空可移除密码。 |
传送与导航
| 命令 | 描述 |
|---|---|
/tp <x> <y> |
将自己传送到区域坐标（x, y）。 |
/tp <playerName> |
将自己传送到另一位玩家的位置。 |
/tp <playerName> <x> <y> |
将指定玩家传送到区域坐标。 |
/give <playerName> <amount> <material> |
给予玩家资源。材料包括：Iron、Titanium、Naonite、Trinium、Xanion、Ogonite、Avorion。 |
星系管理
作为管理员，您拥有管理星系结构和区域的工具。
区域管理
| 命令 | 描述 |
|---|---|
/sector |
显示当前区域的信息（坐标、实体、势力）。 |
/regeneratesector <x> <y> |
重新生成区域，将其重置为程序生成的状态。警告：会销毁该区域中所有玩家建造的建筑。 |
/clearsector <x> <y> |
移除区域中的所有实体，使其变为空白。 |
警告：区域重新生成和清除是破坏性操作。受影响区域中的所有玩家飞船、空间站或建筑将被永久删除。使用这些命令前务必提醒玩家并进行备份。
材料等级
Avorion 的星系按材料等级由外向内排列成环形，越靠近核心屏障等级越高。了解这一点有助于传送玩家或管理区域内容。
| 材料 | 等级 | 星系环 | 颜色 |
|---|---|---|---|
| Iron | 0 | 最外层环 | 灰色 |
| Titanium | 1 | 第二环 | 白色 |
| Naonite | 2 | 第三环 | 绿色 |
| Trinium | 3 | 第四环 | 蓝色 |
| Xanion | 4 | 第五环 | 黄色 |
| Ogonite | 5 | 第六环 | 橙色 |
| Avorion | 6 | 核心（屏障之后） | 金色 |
Mod 和创意工坊支持
Avorion 拥有完善的 Steam 创意工坊支持，允许您使用社区创建的 Mod 来扩展服务器功能。
安装 Mod
- 在 Avorion 的 Steam 创意工坊中找到您想要的 Mod
- 从 Mod 的 URL 中记下创意工坊 ID（URL 末尾的数字）
- 在 GPanel 中停止服务器
- 打开 GPanel 的文件管理器
- 导航到
galaxies/your_galaxy_name/目录 - 编辑
modconfig.lua文件（如果不存在则创建） - 将 Mod 的创意工坊 ID 添加到配置中
- 启动服务器 — Mod 将自动下载
modconfig.lua 格式
-- Avorion Mod Configuration
modLocation = ""
forceEnabling = false
mods =
{
{workshopid = "1234567890"},
{workshopid = "0987654321"},
{workshopid = "1122334455"},
}
重要：连接到使用 Mod 的服务器的所有玩家必须安装相同的 Mod。Steam 创意工坊 Mod 通常在玩家连接时自动下载，但某些 Mod 可能需要在客户端手动安装。
Mod 管理技巧
- 逐个添加 Mod，每次添加后进行测试以识别兼容性问题
- 某些 Mod 需要重置星系才能完全生效（特别是修改区域生成的 Mod）
- 安装前查看 Mod 的评论和说明，了解已知的不兼容问题
- 在添加或移除 Mod 之前，备份您的
modconfig.lua和星系文件夹 - 仅限服务器端的 Mod 不需要客户端安装，但大多数玩法 Mod 需要双方都安装
故障排除
服务器未出现在浏览器中
- 确认
server.ini或启动变量中listed=true - 检查 Steam 查询端口（
steamQueryPort）是否可访问 — 通常是游戏端口 + 1 - 服务器启动后等待 2-3 分钟，让 Steam 列表完成传播
- 尝试通过直接连接确认服务器正在运行
- 在控制台中检查是否出现
Server startup complete以确保服务器已完全启动
服务器崩溃
如果您的 Avorion 服务器崩溃，请按以下步骤操作：
- 检查崩溃日志 — 查看 GPanel 控制台和星系目录中的
logs/文件夹以获取错误信息 - 移除最近添加的 Mod — 如果崩溃是在添加 Mod 后开始的，请将其从
modconfig.lua中移除并重启 - 检查区域损坏 — 如果崩溃发生在加载特定区域时，该区域可能已损坏。从控制台使用
/regeneratesector（如果可以访问）或从sectors/文件夹中删除该区域文件 - 更新服务器 — 通过 GPanel 确保服务器运行最新版本
- 减少工作线程 — 如果服务器资源不足，尝试减少
server.ini中的workerThreads和generatorThreads - 从备份恢复 — 如果以上方法都无效，从问题发生前的备份恢复星系文件夹
性能问题
- 高 tick 时间 — 使用
/status检查服务器性能。高 tick 时间表示服务器难以跟上模拟需求。 - 加载的区域过多 — 每个有玩家或活跃 AI 的区域都会消耗资源。建议玩家避免同时分散在星系中太多区域。
- 大型飞船 — 方块数量过多的飞船会增加模拟负载。考虑设置飞船大小的上限指南。
- 空间站过多 — 单个区域中大量玩家建造的空间站会降低性能。使用
/sector监控区域实体数量。
玩家连接问题
- 版本不匹配 — 所有玩家必须与服务器使用相同的游戏版本。确保所有人都通过 Steam 进行了更新。
- Mod 不匹配 — 玩家需要安装相同的 Mod。如果玩家无法连接，请确认其 Mod 列表与服务器的
modconfig.lua一致。 - 超时错误 — 可能表示服务器过载或网络问题。使用
/status检查服务器性能。 - 密码问题 — 如果玩家反映密码无效，请确认启动变量和
server.ini中的密码一致。
快速参考
日常服务器管理最常用的管理员命令：
# Check server health
/status
# See who is online
/players
# Save all data
/save
# Broadcast a message
/say Server restarting in 5 minutes!
# Kick a player
/kick PlayerName
# Ban a player
/ban PlayerName
# Teleport to a player
/tp PlayerName
# Give resources to a player
/give PlayerName 10000 Trinium
# View current sector info
/sector
# Check galaxy seed
/seed
# Safely shut down
/stop相关文章
需要帮助？
如果您需要有关 Avorion 服务器管理的进一步帮助或对特定命令有疑问，我们的支持团队随时准备为您提供帮助。提交支持工单，我们将尽快回复。
