FiveM Artifacts の基礎

1. FiveM の artifact とは

Cfx.re は runtime.fivem.net で週に数回、番号が増えていく新しい FXServer ビルドを公開しています。各ビルドは完全なサーバーパッケージで、FXServer のバイナリ、Citizen ランタイム、同梱の txAdmin が含まれます。あなたの resources、server.cfg、データベースは含まれず、ビルドを変えてもそのまま残ります。

サーバーリストとゲームクライアントが確認するのはビルド番号です。Cfx.re が新しいサーバーを必要とするクライアント更新を配信すると、古いビルドのサーバーは更新するまで新規プレイヤーを受け付けなくなります。artifact の更新が FiveM サーバーで最も頻繁なメンテナンス作業であるのはこのためです。

2. Recommended、latest、それとも特定のビルド？

Cfx.re は一つのビルドを Recommended として指定します。十分な期間公開され、信頼できると判断されたビルドです。Latest は公開されたばかりの最新ビルドで、数時間しか経っていないこともあります。公開 roleplay サーバーなら Recommended が安全な選択です。Latest を選ぶのは、クライアント更新で必要になった場合や、changelog の項目があなたの抱える問題を修正している場合に限りましょう。

古いビルドも公開され続けているので、特定の番号に固定することもできます。たとえば依存している resource が新しいビルドで動かなくなった場合です。changelogs.fivem.net の changelog にはビルド間の変更点が記載され、critical と記されたビルドが示されています。

3. サーバーが動いているビルドを確認する

サーバーの txAdmin ログインページを開くと、フッターに tx: v8.1.1 | fx: b に続く番号のように二つのバージョンが表示されます。この fx の番号があなたの artifact で、確認にログインは不要です。サーバーコンソールも起動直後に同じ番号を表示します。

4. VibeGAMES サーバーでの更新（ワンクリック）

ゲームパネルでサーバーを開き、Game Server の下にある Artifacts Updater をクリックします。一覧には runtime.fivem.net のビルドが表示され、Cfx.re が推奨するビルドには Recommended、最新ビルドには Optional のタグが付きます。検索ボックスで特定の番号も探せます。

ビルドを選んで Install を押します。パネルがサーバーを停止し、Cfx.re から直接ビルドをダウンロードして、サーバーを再起動します。復帰のタイミングは Console ページで確認できます。resources、server.cfg、txAdmin のデータ、データベースには手を加えません。一度に多くのビルドを飛ばす場合は、先にバックアップを取ってください。

FiveM for GTAV Enhanced に切り替えたサーバーは常に自動で最新ビルドを使うため、そこでは更新ツールは閲覧専用です。ビルドを固定したい場合は GTAV Enhanced ページで元に戻してください。

5. VPS や専用サーバーで手動更新する

サーバーを停止します。runtime.fivem.net から目的のビルド（Linux は fx.tar.xz、Windows は server.7z）をダウンロードし、古いフォルダーの隣の新しいフォルダーに展開して、起動コマンドまたは run.sh を新しいフォルダーに向けます。resources、server.cfg、キャッシュを含む server-data フォルダーはそのままです。

サーバーを起動し、コンソールでビルド番号と、ライセンスキーの認証に成功したという行を確認します。すべて正常に動くと確信できるまで古いフォルダーは残しておきましょう。ロールバックは起動コマンドを元に戻すだけで済みます。

6. 更新で何かが壊れたとき

更新後にサーバーが起動しなくなる原因は、たいてい新しいビルドで削除された API を使う resource か、リセットが必要な txAdmin プロファイルです。コンソールで最初の赤い行を探し、そこに書かれた resource を無効にして再試行してください。それでも直らなければ Recommended ビルドを入れ直しましょう。ダウングレードはアップグレードと同じくらい安全です。

resource の作者は Cfx.re フォーラムやリリースページに互換性の注意を公開しているので、大きくビルドを飛ばしたあとは、主要な resources（フレームワーク、インベントリ、アンチチート）を同じ機会に更新しておくと安心です。

7. どのくらいの頻度で更新すべきか

ほとんどのサーバーでは数週間に一度で十分で、加えてクライアント更新でプレイヤーが接続できなくなったときに更新します。changelog で critical と記されたビルドには注意してください。セキュリティや安定性の問題を修正するもので、すぐに導入する価値があります。VibeGAMES なら更新はワンクリックと約1分のダウンタイムで済むので、1年遅れのままにしておく理由はありません。