mcpField
F
fivemanage

fivemanage

github.com/germanfndez开发19330 次安装2 周前更新
代码仓库

关于 fivemanage

用于在 FiveM 中配置和使用 Fivemanage SDK 的技能，面向处理截图、图片上传和集中日志的开发者。内容说明客户端与服务器端导出、API 密钥设置及元数据规范。

主要功能

  1. 01捕获客户端和服务器截图
  2. 02上传图片文件或缓冲区
  3. 03发送按数据集分类的日志
  4. 04配置自动事件日志
  5. 05遵循 API 密钥与元数据规范

适用场景

  1. 01捕获玩家截图
  2. 02从服务器资源上传现有图片
  3. 03记录分类的游戏或管理事件
  4. 04配置 SDK 安装和 server.cfg

安装

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

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

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

包含的文件

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

rules/
configuration.md
images.md
installation.md
logs.md
reference-links.md

详细介绍

Fivemanage SDK

通过 exports.fmsdk 为 FiveM 提供截图、图片上传和集中式日志。

激活约定

当用户安装或配置 Fivemanage SDK、截取或上传玩家截图、向 Fivemanage 仪表板发送日志，或在 Lua 或 JavaScript 中调用任何 exports.fmsdk 函数时，加载此技能。

硬性规则

  • 资源文件夹必须命名为 fmsdk，并直接放在 resources/ 下；不支持分类文件夹。
  • takeImage / takeServerImage 需要 screenshot-basic，并且必须在 server.cfg 中先于 fmsdk 执行 ensure。
  • API 密钥是 server.cfg 中的 ConVar（FIVEMANAGE_MEDIA_API_KEY、FIVEMANAGE_LOGS_API_KEY），绝不能放在 config.json 中。只设置所用功能对应的密钥。
  • takeImage 在客户端执行；takeServerImage(playerSource, ...) 和 uploadImage(buffer, ...) 在服务端执行。
  • Log(dataset, level, message, metadata) 是主要日志导出函数；Info/Warn/Error(dataset, message, metadata) 是固定级别的简写函数。LogMessage 已过时。
  • 在元数据中包含 playerSource / targetSource，以便 SDK 自动附加玩家标识符。
  • 切勿向 NUI 暴露 API 令牌；客户端上传应使用预签名 URL。

决策参考

需求调用
截取玩家自己客户端的画面exports.fmsdk:takeImage({ ... })
从服务端截取玩家画面exports.fmsdk:takeServerImage(playerSource, { ... })
上传已有图片文件/缓冲区exports.fmsdk:uploadImage(buffer, { ... })
使用明确级别记录日志exports.fmsdk:Log(dataset, level, message, metadata)
快速记录日志exports.fmsdk:Info/Warn/Error(dataset, message, metadata)
自动记录玩家/聊天/资源日志fmsdk 内的 config.json

执行步骤

  1. 验证安装顺序和 ConVar（阅读 rules/installation.md）。
  2. 根据“决策参考”选择执行端和导出函数。
  3. 附加元数据（name、description、playerSource），以便搜索条目。
  4. 按关注领域选择数据集（economy、anticheat、admin_actions）。
  5. 在适用时于 config.json 中启用自动事件（阅读 rules/configuration.md）。

输出约定

安装时返回 server.cfg 配置行，然后提供可运行的 Lua 或 JS 代码，明确标注执行端并包含元数据。

参考资料

  • rules/installation.md — 下载、文件夹位置、server.cfg 顺序、API 密钥。
  • rules/images.md — takeImage、takeServerImage、uploadImage、元数据。
  • rules/logs.md — Log、Info/Warn/Error、LogMessage、数据集、标识符。
  • rules/configuration.md — config.json、自动事件、预签名 URL。
  • rules/reference-links.md — 官方文档和 SDK 下载。

上游文档：https://docs.fivemanage.com/fivem-sdk/installation

评论

支持 Markdown