本指南涵盖了在 Legion Hosting 上运行 StarMade 服务器的管理、控制台命令、派系管理和宇宙维护。有关初始设置和玩家连接说明，请参阅 StarMade 服务器设置指南。
1. 服务器控制台
StarMade 服务器提供了一个控制台，可通过 GPanel 中的 Console 选项卡访问。直接在控制台输入框中输入命令。服务器必须处于运行状态才能接受命令。
2. 管理员权限
要在游戏内获取管理员权限，请使用在 server.cfg 中配置的 SUPER_ADMIN_PASSWORD。
- 以玩家身份连接到服务器。
- 打开游戏内聊天并输入：
/login [SUPER_ADMIN_PASSWORD] - 您将获得当前会话的管理员权限。
您还可以通过编辑服务器目录中的管理员配置文件来添加永久管理员。
请更改默认的超级管理员密码。 在
server.cfg 中设置一个强且唯一的密码，以防止未经授权的管理员访问。
3. 常用服务器命令
命令可以在 GPanel 控制台中输入，或以管理员身份登录后在游戏内聊天中输入（以 / 为前缀）。
| 命令 | 说明 |
|---|---|
/help |
列出所有可用命令。 |
/status |
显示服务器状态和已连接的玩家。 |
/kick [player] |
将玩家踢出服务器。 |
/ban [player] |
封禁玩家。 |
/unban [player] |
解除玩家的封禁。 |
/tp [player] [x] [y] [z] |
将玩家传送到指定坐标。 |
/give [player] [item] [amount] |
给予玩家物品。 |
/god_mode [player] |
切换玩家的无敌模式。 |
/change_sector [player] [x] [y] [z] |
将玩家移动到宇宙中的不同星区。 |
/save |
强制保存世界。 |
/shutdown [seconds] |
在指定延迟后关闭服务器。使用 /shutdown 0 立即关闭。 |
使用
/shutdown 进行安全关闭。 始终优先使用 /shutdown 0 或 GPanel 的 Stop 按钮，而非强制终止，以防止宇宙数据损坏。
4. 派系管理
StarMade 具有派系系统，玩家可以创建和加入派系。作为管理员，您可以通过命令管理派系：
- 查看派系 -- 检查服务器日志或使用派系命令查看活跃的派系。
- 解决争端 -- 使用传送和踢出命令处理派系冲突。
- 清理废弃派系 -- 移除不活跃的派系及其建筑以释放服务器资源。
5. 宇宙维护
备份
要备份您的 StarMade 宇宙：
- 停止服务器（或先使用
/save强制保存）。 - 通过 SFTP 下载世界目录和配置文件。
- 将备份存储在安全的位置。
性能优化
- 定期清理消耗服务器资源的废弃飞船和空间站。
- 在 GPanel 中监控内存使用情况 -- StarMade 在大型建筑下可能会占用大量内存。
- 考虑在
server.cfg中设置实体限制以防止性能下降。
6. 配置文件参考
关键配置文件位于服务器根目录中：
| 文件 | 用途 |
|---|---|
server.cfg |
核心服务器设置（名称、密码、最大客户端数、管理员密码）。 |
blacklist.txt |
被封禁的玩家名称/IP 列表。 |
whitelist.txt |
允许的玩家列表（启用白名单模式时）。 |
admins.txt |
永久服务器管理员列表。 |
编辑配置文件前请始终停止服务器。 更改仅在启动时读取。
7. 故障排除
| 问题 | 解决方案 |
|---|---|
| 服务器因 OutOfMemoryError 崩溃 | 服务器需要更多内存。请联系支持团队增加分配量，或减少宇宙大小和实体数量。 |
| 玩家无法连接 | 确认服务器正在运行，在 GPanel 的 Network 选项卡中检查 IP 和端口，并确保密码正确。 |
| 服务器卡顿 / TPS 过低 | 清理废弃建筑，减少最大玩家数，或增加内存分配。 |
| 宇宙数据损坏 | 从备份恢复。如果没有备份，请尝试重新安装服务器（这将重置宇宙）。 |
相关文章
需要帮助？
如果您在使用 StarMade 服务器时遇到问题，请 提交支持工单，并提供您的服务器 IP、问题描述以及 GPanel 控制台中的相关错误信息。
