ドキュメントの目次

FXO

やりたいことから引く

「何が使えるか」ではなく「いま困っていること」から入れるようにした索引です。目的の機能へ最短で辿り着けます。
いま困っていることに近いものを選んでください。どこを開けばよいか、順番に書いてあります。
読みかた

「やさしく」に切り替えると、専門用語を避けた言い方で読めます。手順や数値は同じです。

このページの内容

起動・読み込みの問題

サーバーが起動しない / リソースが読み込まれない

  1. 1「サーバー起動チェック」で server.cfg と実体を突き合わせ、ensure 漏れ・綴り違いを見る
  2. 2それでも読まれないなら「リソース検証 / manifest」で manifest 欠如・data_file 未宣言を確認する
  3. 3manifest が無い・壊れているなら、その場で生成できる

角括弧フォルダ([category])の直下に fxmanifest を置くと無視されます。よくある落とし穴です。

リソースを消すと直る(何かとぶつかっている)

  1. 1「リソース間の衝突」で同名資産・車両名・handling 名・modkit ID の取り合いを洗い出す
  2. 2どちらを残すかを決めて、片方の名前を変えるか外す

重い・落ちる

サーバーが重い・テクスチャが落ちる

  1. 1「テクスチャ解析」で上限超え(約 14.5MB)・非圧縮・mip 欠如を洗い出す
  2. 2サムネイルで実物を見てから、ダウンスケールか再エンコードをその場で当てる
  3. 3全体の傾向は「リソーススキャナ」のスコアで確認する

当たり判定が重い / すり抜ける

  1. 1「マップ整合チェック」のコリジョン監査タブで、すり抜けと重い ybn を確認する

見た目がおかしい

置いたはずのものが透明・出てこない

  1. 1「マップ整合チェック」で ymap / ytyp / モデルの噛み合わせを見る
  2. 2ytyp にアーキタイプ定義が無いと、配置しても透明になります

MLO やマップが別の建物と重なっている

  1. 1「YMAP 配置移動」の俯瞰プランで、重なっている ymap を赤で確認する
  2. 2重なりの大きい順に選んで、移動量を入れてプレビュー
  3. 3プレビュー済みのものだけを適用する

モデルの見た目を納品前に確かめたい

  1. 1「3D プレビュー」で開き、H キーでショートカット一覧を出す
  2. 2B で寸法、D で法線 / UV / チェッカー、W でワイヤーフレームに切り替えて検品

外から来たものを扱う

買ったリソースを本番に入れる前に安全を確かめたい

  1. 1「リソース信頼性監査」でバックドアの兆候を静的に検出する
  2. 2escrow で守られている部分は「エスクロー暗号化監査」で保護の健全性だけ確認する

コードは実行しません。escrow の復号もしません。検知は「疑わしい」を挙げるもので、最終判断は人が行ってください。

ネットで拾った 3D モデルを FiveM で使いたい

  1. 1「モデル取込」で OBJ / glTF / GLB / FBX を読み込む
  2. 2スケールと原点を合わせ、シェーダーの自動割り当てを確認する
  3. 3リソース一式を書き出し、ゲーム内で /spawn_<asset> で確認する

Assetto Corsa の車を持ってきたい

  1. 1「AC → FiveM 変換」で車両フォルダを読み込み、メタ一式を生成する

最終的な .yft 化は Blender / Sollumz の工程が要ります。

まとめて直す・記録に残す

見つかった問題をまとめて直したい

  1. 1「一括最適化」を開くと、ルール別に修正案が集計される
  2. 2当てたくないルールを外す
  3. 3行単位の差分を見てから適用する

扱うのは挙動が変わらない変換だけです。初回の書き換えでは原本を .fxo.bak に退避します。

車両の挙動をまとめて調整したい

  1. 1「ハンドリング一括編集」で対象車両を選ぶ
  2. 2倍率 / 加算 / 固定値、またはプリセットで変更量を決める
  3. 3プレビューを確認してから適用する

対応した内容を報告書にしたい

  1. 1「健康診断」で全監査を一括実行する
  2. 2HTML / PDF / Word で書き出す(Report ID と SHA-256 が付きます)
  3. 3修正前後を比べるなら新旧対照表を出す

ここに載っていない症状

困ったときにアプリ自体の不調(画面が出ない・3D が映らない等)をまとめています。それでも解決しないときは、 画面IDと診断情報を添えて お問い合わせください。