本指南涵盖了在 Legion Hosting 上 Onset 专用服务器的管理员设置、控制台命令、Lua 扩展包系统、玩家和载具管理以及数据库配置。有关初始服务器设置，请参阅我们的 Onset 服务器设置指南。
管理员设置
Onset 通过游戏模式扩展包中的 Lua 脚本来处理管理员权限。与许多具有内置管理员系统的游戏不同，Onset 依赖您的扩展包来定义谁拥有提升的权限以及这些权限允许什么操作。
大多数社区游戏模式扩展包都包含管理员系统。通常，管理员设置包括：
- 在 GPanel 中打开 File Manager
- 导航到您的扩展包目录（例如
packages/mygamemode/） - 找到管理员配置文件（通常是
config.lua、admins.lua或 JSON 配置文件） - 将您的 Steam64 ID 或游戏内玩家 ID 添加到管理员列表中
- 保存文件并重启服务器
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}
查找 Steam64 ID：访问 steamid.io 并输入 Steam 个人资料 URL 即可查找 Steam64 ID。
服务器控制台命令
Onset 提供内置的服务器控制台命令，无论安装了什么扩展包都可以使用。这些命令可以直接在 GPanel 控制台中输入。
| 命令 | 描述 |
|---|---|
help |
列出所有可用的控制台命令 |
stop |
优雅地停止服务器 |
restart |
重启服务器 |
players |
列出所有已连接的玩家及其 ID |
kick <playerid> [reason] |
将玩家踢出服务器 |
ban <playerid> [reason] |
封禁玩家 |
unban <steamid> |
解除指定 Steam ID 的封禁 |
package reload <name> |
无需重启服务器即可重新加载扩展包 |
package start <name> |
启动当前未运行的扩展包 |
package stop <name> |
停止正在运行的扩展包 |
package list |
列出所有已加载的扩展包及其状态 |
扩展包系统（Lua 脚本）
Onset 的游戏玩法完全由使用 Lua 编写的扩展包定义。每个扩展包都是 packages/ 目录中的一个文件夹，包含在服务器端和/或客户端运行的 Lua 脚本。
扩展包结构
packages/
mygamemode/
package.json <-- Package metadata and file declarations
server/
main.lua <-- Server-side entry point
commands.lua <-- Custom command handlers
client/
main.lua <-- Client-side entry point
ui.lua <-- User interface scripts安装扩展包
- 从 Onset 社区论坛或 GitHub 仓库下载扩展包
- 通过 SFTP 连接到您的服务器
- 将扩展包文件夹上传到
packages/目录 - 在 File Manager 中打开
server_config.json - 将扩展包文件夹名称添加到
"packages"数组中 - 通过 GPanel 重启服务器
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}
加载顺序：
"packages" 数组中的扩展包按列出的顺序加载。如果一个扩展包依赖另一个，请确保被依赖的扩展包排在前面。
玩家管理
除了内置的踢出和封禁命令外，大多数游戏模式扩展包还提供额外的玩家管理功能。常见的扩展包提供的命令包括：
| 命令（取决于扩展包） | 描述 |
|---|---|
/tp <player> |
传送到另一个玩家 |
/bring <player> |
将另一个玩家传送到您的位置 |
/goto <x> <y> <z> |
传送到指定的世界坐标 |
/setadmin <player> <level> |
设置玩家的管理员等级（如果扩展包支持分级） |
/announce <message> |
发送全服公告 |
载具管理
Onset 拥有内置的载具系统，扩展包可以对其进行扩展。管理员通常需要管理已生成的载具以防止服务器混乱。
- 载具生成 — 大多数 RP 扩展包允许管理员通过命令生成载具，如
/car <model> - 载具清理 — 一些扩展包包含废弃载具的自动消失功能或管理员命令，如
/destroyvehicles - 载具限制 — 配置每个玩家的最大载具数量，以防止过多生成的实体导致延迟
数据库（MariaDB）
Onset 支持 MariaDB/MySQL 数据库连接以实现持久数据存储。角色扮演和其他游戏模式扩展包使用此功能来存储玩家数据、物品栏、财产等。
数据库配置在您的扩展包配置文件中处理。典型设置如下：
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}
数据库访问：您的数据库凭据可以在 GPanel 的 Databases 选项卡中找到。如果您需要创建新数据库，请 提交支持工单，我们的团队将为您设置。
故障排除
| 问题 | 解决方案 |
|---|---|
| 服务器启动但没有可用的游戏玩法 | 您需要至少安装一个游戏模式扩展包并在 server_config.json 中列出。裸 Onset 服务器没有内置的游戏玩法。 |
| 扩展包加载失败 | 检查 GPanel 控制台中的 Lua 错误消息。常见原因：缺少 package.json、Lua 文件中的语法错误或缺少依赖项。 |
| 数据库连接错误 | 验证您的数据库凭据，确保数据库存在，并检查 MariaDB 服务是否正在运行。从控制台日志中测试连接性。 |
| 服务器在浏览器中不可见 | 确保在 server_config.json 中设置了 "visible": true。同时验证端口 7776（TCP）对于查询端口是否可访问。 |
| 高延迟或卡顿 | 降低 streamdistance 值，如果 CPU 使用率过高则减少 tickrate，并检查扩展包中是否有低效的 Lua 脚本。 |
相关文章
需要帮助？
如果您的 Onset 服务器遇到问题或需要进一步帮助，我们的支持团队随时为您服务。提交支持工单，我们将尽快回复您。
