命令

开始之前#

Tosun AC 添加了一个主命令 /ts 及其众多子命令。此外还有独立的管理命令、仅限控制台的维护命令，以及几个用于管理菜单的客户端命令。每组命令都有各自的权限检查和各自的结果显示位置，因此请先阅读本节。

• 大多数 /ts 子命令和所有 ts_* 管理命令都把结果写入服务器控制台。游戏内的管理员在聊天中看不到任何内容，只有 /ts 帮助卡片和无权限卡片例外。
• 玩家工具（mute、sethp、giveweapon 等）和 ac* 命令在游戏内使用时会在聊天中回复。
• 许多回复是硬编码的土耳其语。无权限卡片始终显示 'Bu komutu kullanmak için yetkiniz yok!'。
• /freeze 或 /mute 等独立命令不是 /ts 子命令。/ts freeze 5 只会在控制台输出 'Unknown command'。
• revive、warn、players、freeze、mute、broadcast、setweather、settime、giveweapon、capture 和 emergency 等裸名称可能与其他资源的命令冲突。不确定时请使用 ts_ 形式。
• 如果禁用了管理菜单（ts.AdminMenu.enable 或 ts.AdminMenu.enabled = false），客户端命令 tsmenu、unspectate、stopspectate、tsdelaimed 和 tsfreecam、DELETE 绑定以及 F7 键都根本不会注册。

权限等级#

每个命令都会检查下面的某个等级。服务器控制台可以通过所有服务器端检查，但两个仅限游戏内的传送命令除外。客户端命令不能从控制台运行。本页所有表格都使用这些等级名称。

• tosun.admin（STAFF 和 MENU）与 tosunac.admin（维护命令）是不同的 ACE。完整管理员应两者都授予。
• 授予 builtin.everyone 的 ACE 永远不计为 STAFF 或 MENU。
• group.admin 等组名是作为 ACE 对象检测的。请显式授予 tosun.admin 之类的 ACE，不要只依赖组成员身份。

• 服务器配置

在 server.cfg 中授予权限#

下面第一段是常见安装模板中的 ACE 部分。它给予 group.admin 主体管理人员、菜单、维护和封禁界面测试权限，然后把一名玩家加入该组。将 <HEX> 替换为该玩家的 license。最后两行可选，不在模板中；只有当管理人员需要在游戏内运行 ts_setlang 或 ts_v9_help 时才添加。

也可以不用 ACE 授予权限。admins/anticheat_admins.lua（Admins）或 ts.AdminMenu.allowedIds 中的标识符给予 STAFF 和 MENU。ts.AdminBypassIdentifiers 中的标识符只给予 STAFF。网页面板中的管理员授权给予 STAFF 和 MENU。

ts.AdminMenu.allowedIds 中的 'all' 和 'staff' 值不是标识符，不授予任何权限。

add_ace group.admin tosun.admin allow
add_ace group.admin tosunac.admin allow
add_ace group.admin command.tosunac_setup allow
add_ace group.admin command.tosunac_backdoorscan allow
add_ace group.admin command.tosunac_eventscan allow
add_ace group.admin tosunac.banscreen.test allow
add_principal identifier.license:<HEX> group.admin

# 可选，不在模板中：两个受限的辅助命令
add_ace group.admin command.ts_setlang allow
add_ace group.admin command.ts_v9_help allow

• 服务器配置
• 面板连接

结果显示位置#

命令在游戏内看似没有反应时，请查看服务器控制台。

/ts 命令#

/ts 是一个服务器命令。其后的第一个词用于选择子命令，不区分大小写。在服务器控制台中输入同一行时去掉斜杠，例如 ts banlist。

• 在游戏内，/ts 或 /ts menu 会打开或关闭管理菜单，需要 MENU。在控制台中它会输出帮助列表。
• 其他所有子命令在游戏内都需要 STAFF。没有该权限时会显示无权限卡片，且不会执行任何操作。
• 未知子命令只会在服务器控制台输出 'Unknown command. Type ts help. For extra commands: ts_v9_help'。
• 别名：evtlist = faketriggerlist = evtliste；evtwhitelist = faketriggeroff = evtoff；evttrap = faketriggeron = evton；evtscan = faketriggerscan = evtara；sigpatterns = sigexc_help；quarantine = karantina；release = serbest；quarantines = karantinalar；在 sigexc 和 sigskip 下，del = remove。
• 控制台帮助列表（ts help）并不完整。它没有列出 quarantine、release、quarantines、各个别名以及 ts whitelist 的可选秒数。游戏内的 /ts 帮助卡片只列出 /ts、ban、kick、unban 和 help。本页提供完整列表。

/ts ban 12 aimbot          (in game)
ts banlist 2               (server console)

/ts：菜单、帮助和状态#

通用子命令。除非表格另有说明，输出都在服务器控制台。

/ts：封禁和踢出#

手动封禁与检测使用相同的惩罚流程。输出在服务器控制台。

• 封禁 ID 形如 XXXX-XXXX；当 ts.banIDFormat = 2 时形如 #NNNN。
• ts.punishType 也控制手动封禁。如果设为 LOG 或 KICK，/ts ban 只会记录日志或踢出。
• 除非开启 ts.Debug，否则管理人员（ts.AdminBypassDetections 开启时）、白名单和面板白名单中的目标会被静默跳过。[BAN] 行仍会输出。

/ts：白名单、豁免和隔离#

用这些命令暂时停止对某玩家的惩罚，或隔离嫌疑人而不是封禁。白名单和豁免条目保存在内存中，以服务器 ID 为键，玩家断开连接时失效。

• 隔离时间默认 300 秒，并被限制在 30 秒到 ts.quarantine.maxSeconds（默认 1800）之间。默认原因为 'admin karantinasi'。
• 隔离会拒绝免于惩罚的玩家：管理人员、白名单、面板白名单或临时豁免的玩家。
• ts.quarantine.enabled = false 时不会加载隔离模块，命令会输出失败行。
• 已处于隔离中的玩家仍会产生成功行。

/ts：清除实体#

这些子命令会一次性删除整个服务器上的实体，没有确认步骤。输出在服务器控制台。

/ts：蜜罐事件#

蜜罐是正常脚本永远不应触发的虚假触发事件，因此触发它的玩家可以被封禁。当前列表保存在 ac_protected_events 表中。输出在服务器控制台。

/ts：特征码扫描器例外#

当特征码扫描器标记了正常脚本时使用这些命令。特征码显示在 [Signature Scanner] 日志行中。例外和跳过项保存在数据库中。输出在服务器控制台。

/ts sigexc 或 /ts sigskip 后面没有有效的第二个词时，会输出用法提示。

ts sigexc add my-job lua_loadstring client/main.lua
ts sigskip add my-escrow-pack

管理命令（ts_ 形式和裸名称）#

这 17 个命令不是 /ts 子命令。每个命令都有 ts_<name> 和裸名称 <name> 两种形式，例如 /ts_freeze 7 或 /freeze 7。两种形式在游戏内都需要 STAFF，控制台也可以运行。所有结果都输出到服务器控制台。

• 被拒绝的 ts_<name> 会在控制台输出 '[ts_<name>] Yetersiz yetki.'。被拒绝的裸名称不做任何事。
• 裸名称会在去掉分号、双引号和换行后，把 ts_<name> 作为服务器命令重新执行。这个嵌套命令很可能以控制台身份运行。因此 /tphere 和 /tpto 会失败，/adminsync 需要 ID，/kickall 也会踢出你，/warn 会把执行者记录为控制台。这些命令请使用 ts_ 形式，并在游戏内确认一次。
• ts_v9_help 把这些命令列为 'ts freeze <id>' 等形式。该语法无效；请输入 ts_freeze 或 freeze。

玩家工具（mute、sethp、giveweapon ...）#

这 11 个命令有 ts_<name> 和 <name> 两种形式，两种形式都会把你识别为执行者，因此裸名称可以在游戏内使用。它们需要 STAFF；控制台也可以运行。拒绝时没有任何提示。回复发送到你的聊天，或以 '[AC] ...' 输出到控制台。回复大多为土耳其语。

快捷命令（acwarn、acfreeze、acstats ...）#

五个在聊天中回复的简短命令。除 /acping 外都需要 STAFF 或控制台，拒绝时没有任何提示。

维护和诊断命令#

请从服务器控制台运行这些命令。其中少数在拥有所示 ACE 时也可以在游戏内运行。除 banscreentest 外，输出始终在服务器控制台。

tosunac_setup、tosunac_backdoorscan、tosunac_eventscan 和 banscreentest 被拒绝时没有任何提示。tosunac_setup 运行期间再次执行会被拒绝。

受限命令同时需要 FiveM 命令 ACE 和 AC 检查。例如，只有 tosunac.admin 的玩家不能运行 tosunac_setup。

• 安装
• 设置与性能
• 服务器集成

安全地运行 tosunac_setup#

tosunac_setup 会信任当前已安装的内容。只在你确定干净的服务器上运行它。

1. 启动服务器时只加载你信任的资源。
2. 确认 Backdoor Guard 已启用。如果它被禁用，setup 会中止且不批准任何内容。
3. 在服务器控制台输入 tosunac_setup。后门扫描最多可能需要 120 秒。
4. 阅读摘要。每个被跳过的资源都会按名称记录；请在网页面板中逐一检查。
5. 运行 tosunac_doctor，检查已生效设置中的误封和安全风险。

• 分步安装

测试和预览#

这些命令让你在不惩罚任何人的情况下检查 AC。

• 封禁界面：游戏内 /banscreentest 在你自己的屏幕上显示；控制台中 banscreentest <id> 在该玩家屏幕上显示。封禁界面设置来自网页面板。
• 有风险的设置：tosunac_doctor。
• 数据库：tosunac_db_check 检查本地 SQL 连接，tosunac_db_status 检查 DB 桥接和面板状态。
• 你自己脚本的 export 信任：tosunac_integration。
• AC 是否在运行：/acping（任何人）或 /acstats（管理人员）。/ts status 还会显示封锁状态。

• 数据库与桥接
• 面板连接

打开管理菜单#

用 /ts、/ts menu、/tsmenu 或 F7 打开游戏内管理菜单。同一命令或按键可关闭菜单。每次打开菜单时服务器都会检查 MENU。

• /tsmenu 任何人都能输入；由服务器决定是否允许。每名玩家每 1.5 秒最多发出一次请求。
• 被拒绝的 /tsmenu 或 F7 请求会缓存 10 秒并被记录：一条数据库日志、一条管理人员事件记录和一条控制台警告。
• 只有 ts.NuiNeverBanUnauthorized = false（默认 true）时，玩家才会因被拒绝的请求受到惩罚，此时适用 ts.punishType。
• 被拒绝的 /ts 会显示无权限卡片，不记录日志。
• 拥有 STAFF 但没有 MENU 的管理人员（例如只有 txAdmin ACE）可以按 F7，但每次请求都会被拒绝并记录。
• ts.AdminMenu 的开关 allowFreecam、allowDelete 和 allowEsp 只在客户端执行。

• 服务器配置

游戏内管理工具#

自由视角、瞄准删除、noclip 和观战只对管理人员有效。自由视角和 noclip 还需要菜单会话：自加入服务器以来，菜单必须至少成功打开过一次。

如果你在自由视角或观战期间被移除了菜单权限，退出该模式时会发送一条菜单日志，服务器会将其视为未授权操作。这可能导致一次惩罚尝试。

按键绑定和默认按键#

Tosun AC 注册了一个可重新绑定的按键（DELETE）。菜单键是在配置中设置的固定 control ID。其他按键只在某个工具内部有效。

• F7 每 50 毫秒检查一次，而按键状态只持续一帧，因此可能漏掉一次按键。菜单没打开时请再按一次。
• F7 的 control ID 只在客户端脚本启动时读取一次。面板中的更改要等玩家重新连接后才生效。

ts.AdminMenu.openKeyControl = 166 -- F5

自由视角操作#

自由视角开启时，其他所有操作都被禁用。你瞄准的实体（最远 120 米）会被标记并显示标签，游戏会加载摄像机周围的区域。HUD 文本为土耳其语，显示的是每帧移动距离，而不是 m/s。

Noclip 操作#

在管理菜单中开关 noclip。开启时，攻击、瞄准、武器选择、近战和 X（control 73）都被禁用。由于文本模板不匹配，HUD 会把速度显示为 'N m/sx speed'。

管理菜单键盘快捷键#

这些按键在管理菜单打开时有效。在输入框中打字、查看器打开，或按住 Ctrl、Alt 或 Meta 时（Ctrl/Cmd+K 除外）会被忽略。

屏蔽的按键和黑名单命令#

两个配置列表会影响玩家的按键和客户端命令。面板可以替换这两个列表。

tosun-ac 的命令、内置命令（不属于任何资源）以及 Resource Guard 视为已授权的资源的命令会被忽略。Resource Guard 基线就绪之前不会判定任何命令。ts.BlacklistKeys 的配置标题称其为菜单组合键，但列表中的每个 control 都是单独屏蔽的。

常见陷阱#

最常让服主感到意外的行为简表。

• /ts reload 会破坏正在运行的 AC，直到重启。请改为重启 tosun-ac。
• /freeze、/acfreeze 和 /massfreeze 对非管理员玩家的冻结持续很短，因为 AC 自身的反冻结检查会在约 10 秒内解冻他们。
• 封锁（来自 /ts_lockdown 或 /emergency）也会阻止管理人员加入，并在重启后重置。请在你的服务器上测试一次，确认新加入确实会被拒绝。
• 禁言与服务器 ID 绑定。被禁言的玩家重新连接后就能再次聊天。
• 没有 ox_inventory 时，/clearinv 不会清空任何东西。
• AC 不保存 /capture 的结果；请检查 ts_screen_upload 中设置的上传目标。
• /ts exempt 会把永久的 /ts whitelist 缩短为豁免时长。
• /acping 对所有玩家开放，并会显示 AC 版本。
• v9 裸名称（tphere、tpto、kickall、adminsync、warn）的行为与 ts_ 形式不同。请优先使用 ts_ 形式。

内部事件和 exports#

Tosun AC 还为管理菜单、网页面板桥接和自身保护注册了内部网络事件和 exports。它们不是命令，受权限和令牌检查保护，其他脚本不得调用。请改用公开的 exports 和事件。

• Export 参考
• 事件