mcpField
F
fivem-deployment

fivem-deployment

github.com/germanfndez云与 DevOps1966 次安装2 周前更新
代码仓库

关于 fivem-deployment

用于 FiveM 管理者的部署指导技能，涵盖 FXServer 版本选择、更新与 server.cfg 检查。它要求核对官方生命周期数据，并遵循版本支持、安全设置和资源加载顺序规则。

主要功能

  1. 01核对 FXServer 版本与生命周期
  2. 02指导 Legacy 与 Enhanced 游戏版本设置
  3. 03检查 server.cfg 配置和资源顺序
  4. 04提供 txAdmin 与更新参考规则

适用场景

  1. 01为生产服务器选择受支持的构建版本
  2. 02排查更新后客户端无法连接
  3. 03审查启动配置与资源依赖顺序

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/germanfndez/fiveai-skills --skill fivem-deployment

安装后在 Claude Code 中输入/fivem-deployment确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

rules/
artifacts.md
compatibility-window.md
server-cfg.md
txadmin.md

详细介绍

FiveM 部署

选择 FXServer 构建版本、确保其处于支持期限内，并编写可正常启动的 server.cfg。

激活约定

当用户询问应运行哪个构建版本、如何更新 FXServer 或 txAdmin、更新后客户端为何无法连接、sv_enforceGameBuild 应设置为何值，或如何编写或审查 server.cfg 时，加载此技能。

硬性规则

  • 切勿凭记忆给出构建版本号。回答前，先从变更日志 API 读取 recommended 和 latest。
  • 忽略 critical 和 optional 字段。这些字段被过时地固定为构建版本 7290，且不再维护。
  • EOL 按构建版本滚动变化。今天可用的构建版本下周可能就会过期；请检查当前使用的确切构建版本对应的 support_policy_eol。
  • sv_replaceExeToSwitchBuilds 自构建版本 35245 起已弃用。切勿输出此项。
  • 在 Enhanced 上，sv_enforceGameBuild 只接受 1（基础游戏，不含 DLC）；数字构建版本值仅适用于 Legacy。
  • sv_enforceGameBuild 只能在启动时设置，不能在运行时设置。
  • 切勿建议使用 sv_scriptHookAllowed true。这会使服务端容易受到攻击。
  • server.cfg 中的资源加载顺序是明确的：必须先 ensure 依赖项，再 ensure 依赖这些项的资源。

决策条件

情况应选择的构建版本
生产环境服务端API 中的 recommended
测试新的游戏 DLClatest
当前版本低于 35245在 2026 年 10 月 15 日之前升级到 35245 或更高版本
构建版本的 support_policy_eol 日期已过立即升级；该版本已停止支持
症状查阅
更新后客户端无法加入rules/compatibility-window.md
选择或验证构建版本rules/artifacts.md
服务端无法启动／convar 配置错误rules/server-cfg.md
原地更新构建版本rules/txadmin.md

执行步骤

  1. 获取对应平台（linux 或 win32）的生命周期 JSON，并读取 recommended、latest、support_policy、support_policy_eol。
  2. 将用户当前的构建版本与 recommended 以及其自身的 support_policy_eol 条目进行比较。
  3. 如果当前构建版本早于 35245，指出 2026 年 10 月 15 日的兼容性截止日期。
  4. 按照上述 Legacy／Enhanced 规则设置 sv_enforceGameBuild，或省略该项以使用默认值。
  5. 部署前，依据 rules/server-cfg.md 审查 server.cfg。
  6. 在回答中重申构建版本号、其 EOL 值以及来源 URL。

输出约定

返回所选构建版本号、其 EOL 时间戳，以及读取该信息所用的 API URL。以可运行的 cfg 代码块输出 server.cfg 行，并保持 ensure 顺序不变。切勿捏造构建版本号、convar 或 txAdmin 菜单路径。

参考资料

  • rules/artifacts.md — 变更日志 API、recommended 与 latest、滚动 EOL、构建版本选择。
  • rules/compatibility-window.md — 2026 年 10 月 15 日截止日期、升级路径、弃用项。
  • rules/server-cfg.md — server.cfg 基本配置、gamebuild、安全 convar。
  • rules/txadmin.md — txAdmin 在构建版本更新和版本配对中的作用。

上游文档：https://docs.fivem.net/docs/server-manual/setting-up-a-server/

评论

支持 Markdown