mcpField
F
fivemanage

fivemanage

github.com/germanfndez開発19330 回インストール2 週間前に更新
リポジトリ

fivemanage について

FiveM で Fivemanage SDK を設定・利用するためのスキルです。スクリーンショット、画像アップロード、ログ集約を扱う開発者向けに、クライアント／サーバー別のエクスポートや API キー、メタデータの扱いを示します。

主な機能

  1. 01クライアントとサーバーのスクリーンショット取得
  2. 02画像ファイルやバッファーのアップロード
  3. 03データセット別ログの送信
  4. 04イベントログ自動記録の設定
  5. 05API キーとメタデータの規則

活用シーン

  1. 01プレイヤーのスクリーンショット取得
  2. 02サーバーリソースから既存画像をアップロード
  3. 03分類したゲーム内イベントや管理操作の記録
  4. 04SDK と 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 は旧式の関数です。
  • SDK がプレイヤー識別子を自動的に付加できるよう、メタデータに playerSource ／ targetSource を含めます。
  • API トークンを NUI に公開しないでください。クライアント側からアップロードする場合は、署名済み 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 の行を提示し、続けて実行側を明示した exports.fmsdk 使用の 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 対応