何を作りますか？

What are you making?

作りたいものを選んでください。どのページにも出てくる手順（Blender の基本、jar に固めて配る、確かめかた）は「共通」にまとめてあります。

Pick what you want to make. Steps that every page needs (Blender basics, packing a jar, checking it in game) live under "Common".

1このページについて

1About this page

車やパーツを足すのに Java は要りません。JSON・モデル・テクスチャ・音だけの jar を作って mods/ に入れます。このページには、何を作る人にも共通の手順をまとめてあります。

You do not need Java to add cars or parts. You build a jar holding only JSON, models, textures and sounds, and drop it in mods/. This page holds the steps everyone needs, whatever they are making.

やりたいことから探す

Find what you want to do

要るもの

What you need

2全体像

2The whole picture

モデルのある車や部品は、5 つの手順で作ります。どの章も、このどれかを詳しくしたものです。

A car or part with a model takes five steps. Every chapter is one of them in detail.

やること

What you do

1. Blender形を作る。（車の 1〜4 章、ホイールの 1 章、パーツの 2〜3 章）
2. BlenderOBJ で書き出す。（車の 5 章）
3. ファイル決まったフォルダへ置く。（車の 6 章）
4. ファイルJSON に「何 m で作ったか」を書く。（車の 6 章）
5. ゲームF3+T で読み直して見る。（共通の 5 章）

これで、直すたびに 5 へ戻って、再起動せずに確かめられます。はじめは粗い箱のような車で 1→5 を一周すると、あとは Blender の作業に集中できます。

1. BlenderModel it. (Car guide, chapters 1–4; Wheel guide, chapter 1; Parts guide, chapters 2–3)
2. BlenderExport it as OBJ. (Car guide, chapter 5)
3. FilePut it in the right folder. (Car guide, chapter 6)
4. FileWrite "how many metres I built it at" into the JSON. (Car guide, chapter 6)
5. GamePress F3+T and look. (Common, chapter 5)

Each time you fix something, go back to step 5 — no restart. Push a crude box of a car through 1→5 first; after that, the rest is Blender work.

必要なときだけ

Only when you need it

3Blender はこれだけ覚える

3Just enough Blender

Blender を触ったことがない人向けに、このガイドで使う操作だけを並べます。使える人は 車の 1 章へ。

For readers who have never opened Blender: only the operations this guide uses. If you know Blender, skip to chapter 1 of the Car guide.

覚えること

What to learn

1. Blender真ん中の広い所（3D ビューポート）で形を作る。車体・窓・ライトのように分けたかたまり 1 つ 1 つを「オブジェクト」と呼ぶ
2. Blender右上の一覧（アウトライナー）で、オブジェクトの名前を変える。名前をダブルクリックする
3. Blender単位はメートルのまま使う。床のマス目 1 つが 1m
4. Blender車の前を −Y、上を +Z に向けて作る。テンキーの 1 で、車を正面から見た向きになる。車の左が +X
5. Blender位置はワールド原点（赤い線と緑の線が交わる点）に合わせる。オブジェクトを選ぶと出るオレンジの点は気にしない

これで、車の 1 章から先の手順を進められます。

1. BlenderBuild in the big area in the middle (the 3D viewport). Each separate lump — body, window, light — is an "object"
2. BlenderRename objects in the list at the top right (the outliner). Double-click the name
3. BlenderKeep the units in metres. One floor square is 1 m
4. BlenderBuild with the front of the car towards −Y and up towards +Z. Numpad 1 shows the car from the front. The car's left is +X
5. BlenderLine things up with the world origin (where the red and green lines cross). Ignore the orange dot that appears on a selected object

You can now follow the steps from chapter 1 of the Car guide.

必要なときだけ

Only when you need it

最小の車を作る

Make a minimal car

新しい車を 1 台ゲームに出すのに、これだけは要るという流れです。各手順の詳しいことは、手順の最後にある章にあります。ここでは、パックの名前を mypack、車種の名前を ae86 とします。

The bare minimum to get one new car into the game. Each step links to the chapter with the details. Here the pack is called mypack and the car ae86.

手順

Steps

1. Blenderゲージを置く。→ 1 章
2. Blenderゲージのタイヤに合わせて車体を作る。原点は「地面の高さ・前後輪の中間・左右の中央」→ 2 章
3. Blender車体を ae86.obj に書き出す。Selected Only だけ入れて、ほかは既定のまま → 5 章
4. ファイル見本の carpack/example/ をフォルダごとコピーし、kurumamod_example_carpack をすべて mypack に置き換える。フォルダ名 2 つ（assets/ の下と data/ の下）、いちばん上のロゴ画像のファイル名、そしてすべてのファイルの中身（toml と、JSON の中のパス）。使える文字は a-z・0-9・_ だけ → 6 章
5. ファイル車体を置く。ae86.obj と ae86.mtl を assets/mypack/models/entity/ に、テクスチャを assets/mypack/textures/entity/ae86.png に。絵がまだ無ければ、白く塗った小さな PNG でよい → 4 章
6. ファイル見た目の JSON を書く。assets/mypack/vehicles/sample.json を ae86.json に改名して、中身をこうする:

   {
     "body":  { "model": "mypack:models/entity/ae86.obj",
                "texture": "mypack:textures/entity/ae86.png" },
     "wheel": { "model": "kurumamod:models/entity/wheel.obj",
                "texture": "kurumamod:textures/entity/wheel.png" }
   }

   タイヤは KurumaMod のものを借りている → 6 章
7. ファイル諸元の JSON を書く。data/mypack/cars/sample.json を ae86.json（見た目の JSON と同じ名前）に改名して、中身をこうする:

   {
     "values": { "mass": 1200.0 }
   }

   書いていない項目は既定の車と同じになる → 8 章
8. lang表示名を lang に書く。assets/mypack/lang/ja_jp.json と en_us.json に "car.mypack.ae86": "AE86" → 6 章
9. ファイルフォルダの中身を jar に固めて、mods/ に入れる。フォルダごとではなく中身を固める → 共通の 4 章
10. ゲーム起動して、クリエイティブの「KurumaMod」タブから車を出して乗る。→ 共通の 5 章

これで、自分の車体で、既定の車と同じように走る車が 1 台増えます。

1. BlenderPlace the gauge. → chapter 1
2. BlenderBuild the body around the gauge wheels. Origin at ground level, halfway between the axles, on the centreline → chapter 2
3. BlenderExport the body as ae86.obj. Tick only Selected Only; leave the rest at defaults → chapter 5
4. FileCopy the whole carpack/example/ folder and replace every kurumamod_example_carpack with mypack. That is two folder names (under assets/ and under data/), the file name of the logo image at the top, and the contents of every file (the toml files and the paths inside the JSON). Use only a-z, 0-9 and _ → chapter 6
5. FilePut the body in place. ae86.obj and ae86.mtl go in assets/mypack/models/entity/, the texture in assets/mypack/textures/entity/ae86.png. No art yet? A small all-white PNG will do → chapter 4
6. FileWrite the look JSON. Rename assets/mypack/vehicles/sample.json to ae86.json and make it:

   {
     "body":  { "model": "mypack:models/entity/ae86.obj",
                "texture": "mypack:textures/entity/ae86.png" },
     "wheel": { "model": "kurumamod:models/entity/wheel.obj",
                "texture": "kurumamod:textures/entity/wheel.png" }
   }

   The wheels are borrowed from KurumaMod → chapter 6
7. FileWrite the spec JSON. Rename data/mypack/cars/sample.json to ae86.json (same name as the look JSON) and make it:

   {
     "values": { "mass": 1200.0 }
   }

   Anything not written stays as on the default car → chapter 8
8. langAdd the display name to lang: "car.mypack.ae86": "AE86" in assets/mypack/lang/en_us.json and ja_jp.json → chapter 6
9. FileZip the folder's contents into a jar and put it in mods/. Zip what is inside the folder, not the folder itself → chapter 4 of Common
10. GameStart the game, take the car from the "KurumaMod" creative tab and get in. → chapter 5 of Common

You now have one more car: your body, driving like the default car.

必要なときだけ

Only when you need it

1ゲージを置く

1Place the gauge

車体を作る前に、寸法の目安になる枠（ゲージ）を Blender に置きます。ゲージに合わせて作れば、JSON の寸法は既定のままで済みます。

Before you model, put a reference frame (the gauge) into Blender. Build to it and the sizes in the JSON can stay at their defaults.

やること

What to do

1. Blender上の Scripting タブを開き、新規（New）を押す。
2. Blendermodeling_tools/blender_gauge.py の中身を全部貼り付けて、実行する。▶ を押すか Alt+P

これで、タイヤ 4 つ・地面・シャシー基準面がワイヤーフレームで置かれます。

1. BlenderOpen the Scripting tab at the top and press New.
2. BlenderPaste the whole of modeling_tools/blender_gauge.py and run it. Press ▶ or Alt+P

Four wheels, the ground and the chassis plane now appear as wireframes.

置かれるもの

What it places

必要なときだけ

Only when you need it

2車体を作る

2Build the body

車体のメッシュを作る章です。決まりは原点の位置と向きだけで、大きさと形は自由です。

This chapter is about modelling the body. The only rules are where the origin is and which way the car faces; size and shape are up to you.

最小の車体を作る

Make a minimal body

1. Blender前を −Y、上を +Z に向けて作る。Blender の標準の向きのまま（テンキー 1 で正面から見た向き）
2. Blenderワールド原点が「地面の高さ・前後輪のちょうど中間・左右の中央」に来るように置く。ゲージのとおりに作れば、そうなっている
3. Blenderタイヤハウスを、ゲージのタイヤに合わせて切る。

これで、書き出せばゲームのタイヤと車体が合います。

1. BlenderFace the car towards −Y with +Z up. That is Blender's default (numpad 1 looks at the front)
2. BlenderPut the world origin at ground level, exactly halfway between the axles, on the centreline. If you follow the gauge, it already is
3. BlenderCut the wheel arches around the gauge wheels.

Once exported, the body and the in-game wheels line up.

原点の 3 つの条件

The three origin rules

合わせるのはワールド原点です。オブジェクトを選んだときに出るオレンジの点（オブジェクト原点）はどこにあっても構いません（共通の 3 章）。

What matters is the world origin. The orange dot you see on a selected object (its object origin) can be anywhere (chapter 3 of Common).

必要なときだけ

Only when you need it

3ライト・ガラス・ミラー（名前で決まる機能）

3Lights, glass and mirrors (names that do things)

オブジェクトに決まった名前を付けるだけで、ライトが光り、窓が透け、ミラーに後ろが映ります。JSON には何も書きません。

Give an object one of a few set names and it lights up, turns see-through or reflects what is behind. Nothing goes into the JSON.

ライトを光らせる

Make the lights work

1. Blenderライトのレンズを別のオブジェクトにして、名前を付ける。ヘッドライトは light_head、テールランプは light_tail、バックランプは light_reverse。左右で 1 つのオブジェクトでよい（ミラーモディファイアのままでよい）
2. Blenderレンズの面を、車体から 1〜2mm 浮かせる。
3. Blenderレンズの UV は展開せず、1 点に潰してテクスチャの白い画素に置く。色はゲームが付ける

これで、L でヘッドライトが点き、テールランプはいつもうっすら光ってブレーキで明るくなり、ギアを R に入れるとバックランプが点きます。

1. BlenderMake each lens its own object and name it. light_head for headlights, light_tail for tail lights, light_reverse for reverse lights. One object for both sides is fine (a mirror modifier is fine)
2. BlenderFloat the lens faces 1–2 mm proud of the body.
3. BlenderDon't unwrap the lens: collapse its UVs to one point on a white pixel of the texture. The game adds the colour

L now turns the headlights on, the tail lights glow dimly and brighten under braking, and the reverse lights come on in R.

窓を透けさせる

Make the windows see-through

1. Blender窓を別のオブジェクトにして、名前を glass で始める。glass・glass_side・glass.front など

これで、窓が透けます（濃さは 0.35）。

1. BlenderMake the windows their own object and start the name with glass. glass, glass_side, glass.front and so on

The windows are now see-through (opacity 0.35).

ミラーに後ろを映す

Make the mirrors reflect

1. Blender鏡を別のオブジェクトにして、名前を付ける。ルームミラーは mirror_rear、ドアミラーは mirror_left と mirror_right。筐体ごとの箱 1 つでよい
2. Blender左右のドアミラーは、別々のオブジェクトにする。ミラーモディファイアで 1 つにしたままにしない（適用してから分ける）
3. Blender鏡になる面（いちばん広い平らな面）を、運転席のほうへ向ける。角度は合わせなくてよい
4. ゲームH のメニューで、ミラーを入れる。既定は切

これで、ミラーに後ろの景色が実際に映ります。

1. BlenderMake each mirror its own object and name it. mirror_rear for the rear-view mirror, mirror_left and mirror_right for the door mirrors. One box for the whole housing is fine
2. BlenderKeep the two door mirrors as separate objects. Don't leave them joined by a mirror modifier (apply it, then separate)
3. BlenderTurn the mirror face (the largest flat face) towards the driver. You don't need to aim it
4. GameTurn mirrors on in the H menu. They are off by default

The mirrors now show what is really behind you.

名前の一覧

All the names

必要なときだけ

Only when you need it

1ホイールのモデルを作る

1Model the wheel

ホイールを Blender で作り、OBJ に書き出すまでです。ホイールは車体とは別のファイルで作ります。

This chapter takes a wheel from Blender to an exported OBJ. Wheels are built in a separate file from the body.

最小のホイールを作る

Make a minimal wheel

1. Blender新しいファイルで、ゲージを置く。Scripting タブで modeling_tools/blender_wheel_gauge.py を実行する。半径 0.45m の輪・車軸の線・地面・表を示す矢印が置かれる
2. Blenderゲージの輪に収まるように、ホイールを作る。原点は車軸の中心に置く。円柱から作るなら、先に R Y 9 0 で回して軸を左右（X）へ向ける
3. Blenderホイールの表（デザイン面）を +X へ向ける。ゲージの矢印の側。作るのは左側用の 1 つだけ
4. Blenderタイヤも作るなら、ホイールとは別のオブジェクトにして、名前を Tire にする。リムだけで作るなら、この手順は要らない
5. Blenderゲージを除いてホイールだけを選び、OBJ に書き出す。「Selected Only」を入れ、「Triangulated Mesh」は入れない（設定の全体は車の 5 章と同じ）
6. ファイル書き出したファイルとテクスチャを置く。assets/mypack/models/entity/my_wheel.obj（.mtl も一緒に）と assets/mypack/textures/entity/my_wheel.png

これで、ホイールのモデルができました。換装画面で選べるようにするのは 2 章、自分の車に最初から履かせるのは下の「自分の車に最初から履かせたい」です。

1. BlenderIn a new file, place the gauge. Run modeling_tools/blender_wheel_gauge.py from the Scripting tab. It places a 0.45 m radius ring, the axle line, the ground and an arrow marking the outer face
2. BlenderModel the wheel to fit inside the gauge ring, with the origin at the centre of the axle. If you start from a cylinder, first rotate it with R Y 9 0 so its axis runs left–right (X)
3. BlenderPoint the face of the wheel (the design side) towards +X, the side the gauge arrow points to. Build the left-hand wheel only
4. BlenderIf you model a tyre too, make it a separate object from the wheel and name it Tire. Skip this if you only build the rim
5. BlenderSelect only the wheel (not the gauge) and export it as OBJ. Tick "Selected Only" and leave "Triangulated Mesh" off (the full settings are the same as chapter 5 of the Car guide)
6. FilePut the exported file and the texture in your pack: assets/mypack/models/entity/my_wheel.obj (with its .mtl) and assets/mypack/textures/entity/my_wheel.png

The wheel model is done. To make it selectable in the parts screen, go to chapter 2; to fit it to your own car from the start, see "Fit it to my own car" below.

必要なときだけ

Only when you need it

{
  "body":  { "model": "mypack:models/entity/my_car.obj",
             "texture": "mypack:textures/entity/my_car.png" },
  "wheel": { "model": "mypack:models/entity/my_wheel.obj",
             "texture": "mypack:textures/entity/my_wheel.png" },
  "designWheelRadius": 0.45
}

{
  "body":  { "model": "mypack:models/entity/my_car.obj",
             "texture": "mypack:textures/entity/my_car.png" },
  "wheel": { "model": "mypack:models/entity/my_wheel.obj",
             "texture": "mypack:textures/entity/my_wheel.png" },
  "designWheelRadius": 0.45
}

4テクスチャを貼る

4Add a texture

車体に色や模様を付ける章です。テクスチャが無くても車は走るので、形だけ先に作ってあとで貼ってもかまいません。

This chapter is about giving the body colour and detail. The car drives without a texture, so you can build the shape first and paint it later.

最小のテクスチャを貼る

Add a minimal texture

1. Blender車体を UV 展開して、PNG のテクスチャに色を塗る。大きさは自由
2. Blenderマテリアルを使っているなら、Base Color を白（1.0）にする。
3. ファイルPNG を置き、見た目の JSON で指す。assets/mypack/textures/entity/mycar.png に置いて、assets/mypack/vehicles/mycar.json の body に書く:

   "body": { "model": "mypack:models/entity/mycar.obj",
             "texture": "mypack:textures/entity/mycar.png" }

これで、ゲームで F3+T を押すと車体にテクスチャが貼られます。

1. BlenderUV-unwrap the body and paint a PNG texture. Any resolution
2. BlenderIf you use materials, set Base Color to white (1.0).
3. FilePut the PNG in place and point the look JSON at it. Save it as assets/mypack/textures/entity/mycar.png and write it into body in assets/mypack/vehicles/mycar.json:

   "body": { "model": "mypack:models/entity/mycar.obj",
             "texture": "mypack:textures/entity/mycar.png" }

Press F3+T in game and the body is textured.

必要なときだけ

Only when you need it

"wheel": { "model": "mypack:models/entity/mywheel.obj",
           "texture": "mypack:textures/entity/mywheel.png" }

"wheel": { "model": "mypack:models/entity/mywheel.obj",
           "texture": "mypack:textures/entity/mywheel.png" }

5OBJ に書き出す

5Export to OBJ

Blender の車体を、ゲームが読む OBJ ファイルにする章です。入れるチェックは 1 つだけで、あとは既定のままにします。

This chapter turns the Blender body into the OBJ file the game reads. You tick one box and leave everything else at its default.

やること

What to do

1. Blender車体を全部選ぶ（A）。ゲージは選ばれない
2. Blenderファイル → エクスポート → Wavefront (.obj) を開く。
3. Blender右のパネルで Selected Only を入れる。ほかの設定は触らない。下の表のとおりになっているか見る
4. Blenderファイル名を付けて書き出す。例 mycar.obj
5. ファイルできた .obj と .mtl を、両方 assets/mypack/models/entity/ に置く。

これで、見た目の JSON（6 章）の body.model から指せる車体ができます。

1. BlenderSelect the whole body (A). The gauge is not selected
2. BlenderOpen File → Export → Wavefront (.obj).
3. BlenderTick Selected Only in the right-hand panel. Don't touch anything else. Check it matches the table below
4. BlenderName the file and export. For example mycar.obj
5. FilePut both the .obj and the .mtl in assets/mypack/models/entity/.

You now have a body that body.model in the look JSON (chapter 6) can point at.

書き出しの設定

Export settings

必要なときだけ

Only when you need it

6車をゲームに入れる（置き場所と JSON）

6Put the car in the game (files and JSON)

作ったモデルを、ゲームで走る車種にします。見本のパックをコピーして、名前と中身を入れ替えるのがいちばん早い道です。

This turns your model into a car you can drive in game. The quickest way is to copy the example pack and swap in your own names and files.

最小のカーパックを作る

Make a minimal car pack

ここでは、パックの名前を mypack、車種の名前を ae86 とします。

Here the pack is called mypack and the car ae86.

1. ファイルcarpack/example/ をフォルダごとコピーする。
2. ファイルkurumamod_example_carpack を、すべて mypack に置き換える。フォルダ名 2 つ（assets/ の下と data/ の下）、いちばん上のロゴ画像 kurumamod_example_carpack.png のファイル名、そしてすべてのファイルの中身（META-INF/mods.toml・META-INF/neoforge.mods.toml と、JSON の中のパス）です。使える文字は a-z・0-9・_ だけ
3. ファイルモデルとテクスチャを置く。assets/mypack/models/entity/ae86.obj（.mtl も一緒に）と assets/mypack/textures/entity/ae86.png
4. ファイル見た目の JSON を書く。assets/mypack/vehicles/sample.json を ae86.json に改名して、中身をこうする:

   {
     "body":  { "model": "mypack:models/entity/ae86.obj",
                "texture": "mypack:textures/entity/ae86.png" },
     "wheel": { "model": "kurumamod:models/entity/wheel.obj",
                "texture": "kurumamod:textures/entity/wheel.png" }
   }

5. ファイル諸元の JSON を書く。data/mypack/cars/sample.json を ae86.json に改名して、中身をこうする（走りは8 章で詰める）:

   {
     "values": { "mass": 1200.0 }
   }

6. lang表示名を lang に書く。assets/mypack/lang/ja_jp.json と en_us.json に "car.mypack.ae86": "AE86"
7. ファイルjar に固めて mods/ に入れる。固め方は共通の 4 章

これで、クリエイティブタブに「AE86」が並び、自分の車体で走ります。

1. FileCopy the whole carpack/example/ folder.
2. FileReplace every kurumamod_example_carpack with mypack. That is two folder names (under assets/ and under data/), the logo image kurumamod_example_carpack.png at the top, and the contents of every file (META-INF/mods.toml, META-INF/neoforge.mods.toml and the paths inside the JSON). Use only a-z, 0-9 and _
3. FileAdd the model and texture: assets/mypack/models/entity/ae86.obj (with its .mtl) and assets/mypack/textures/entity/ae86.png
4. FileWrite the looks JSON. Rename assets/mypack/vehicles/sample.json to ae86.json and make it:

   {
     "body":  { "model": "mypack:models/entity/ae86.obj",
                "texture": "mypack:textures/entity/ae86.png" },
     "wheel": { "model": "kurumamod:models/entity/wheel.obj",
                "texture": "kurumamod:textures/entity/wheel.png" }
   }

5. FileWrite the spec JSON. Rename data/mypack/cars/sample.json to ae86.json and make it (tune the handling in chapter 8):

   {
     "values": { "mass": 1200.0 }
   }

6. langAdd the display name to lang: "car.mypack.ae86": "AE86" in assets/mypack/lang/en_us.json and ja_jp.json
7. FilePack it into a jar and put it in mods/. See chapter 4 of the Common guide

"AE86" now appears in the creative tab and drives with your body.

できあがりの形:

What you end up with:

mypack.jar
├── META-INF/mods.toml              ← Forge 1.20.1 用
├── META-INF/neoforge.mods.toml     ← NeoForge 1.21.1 用
├── pack.mcmeta
├── assets/mypack/                  ← 見た目
│   ├── models/entity/ae86.obj
│   ├── models/entity/ae86.mtl
│   ├── textures/entity/ae86.png
│   ├── vehicles/ae86.json
│   └── lang/ja_jp.json, en_us.json
└── data/mypack/                    ← 走り
    └── cars/ae86.json

mypack.jar
├── META-INF/mods.toml              <- for Forge 1.20.1
├── META-INF/neoforge.mods.toml     <- for NeoForge 1.21.1
├── pack.mcmeta
├── assets/mypack/                  <- looks
│   ├── models/entity/ae86.obj
│   ├── models/entity/ae86.mtl
│   ├── textures/entity/ae86.png
│   ├── vehicles/ae86.json
│   └── lang/en_us.json, ja_jp.json
└── data/mypack/                    <- handling
    └── cars/ae86.json

名前がずれてもエラーは出ません。車種 id mypack:ae86 から、次の 3 つが決まります。1 つでもずれると、黙って既定の姿や名前になります。

A mismatched name gives no error. The car id mypack:ae86 fixes these three names; if one is off, the car quietly gets the default body or name.

必要なときだけ

Only when you need it

{
  "body":  { "model": "mypack:models/entity/ae86.obj",
             "texture": "mypack:textures/entity/ae86.png" },
  "wheel": { "model": "kurumamod:models/entity/wheel.obj",
             "texture": "kurumamod:textures/entity/wheel.png" },

  "designWheelBase": 3.12,
  "designWheelRadius": 0.45,
  "designRideHeight": 0.6019
}

"body": { "model": "...", "texture": "...",
          "offset": [0.0, 0.02, 0.0],
          "scale": 1.05 }

{
  "body":  { "model": "mypack:models/entity/ae86.obj",
             "texture": "mypack:textures/entity/ae86.png" },
  "wheel": { "model": "kurumamod:models/entity/wheel.obj",
             "texture": "kurumamod:textures/entity/wheel.png" },

  "designWheelBase": 3.12,
  "designWheelRadius": 0.45,
  "designRideHeight": 0.6019
}

"body": { "model": "...", "texture": "...",
          "offset": [0.0, 0.02, 0.0],
          "scale": 1.05 }

"seat": [0.5, -0.55, 0.2]

"seat": [0.5, -0.55, 0.2]

"wheel": { "model": "mypack:models/entity/ae86_wheel.obj",
           "texture": "mypack:textures/entity/ae86_wheel.png",
           "offset": [0.03, 0.0, 0.0],
           "scale": [1.2, 1.0, 1.0],
           "camber": -2.0 }

"wheel": { "model": "mypack:models/entity/ae86_wheel.obj",
           "texture": "mypack:textures/entity/ae86_wheel.png",
           "offset": [0.03, 0.0, 0.0],
           "scale": [1.2, 1.0, 1.0],
           "camber": -2.0 }

7音を付ける

7Add sounds

エンジン音などを車ごとに差し替えます。書かなかった音は KurumaMod の音のままなので、この章は飛ばしてもかまいません。

Give a car its own engine note and other sounds. Anything you leave out stays KurumaMod's, so you can skip this chapter.

最小のエンジン音を付ける

Add a minimal engine sound

1. ファイル音源を置く。assets/mypack/sounds/ae86_exhaust.ogg。OGG・モノラルで、継ぎ目なくループするもの
2. ファイル高回転用の音源を作って、同じ場所に置く。同梱の道具を使う（Python が要る）:

   pip install numpy soundfile
   python sound_tools/make_octave_up.py ae86_exhaust.ogg
   # → ae86_exhaust_high.ogg

3. ファイル音に名前を付ける。assets/mypack/sounds.json:

   {
     "ae86_exhaust": {
       "category": "neutral",
       "subtitle": "subtitles.kurumamod.car_exhaust",
       "sounds": [{ "name": "mypack:ae86_exhaust", "attenuation_distance": 64 }]
     },
     "ae86_exhaust_high": {
       "category": "neutral",
       "subtitle": "subtitles.kurumamod.car_exhaust",
       "sounds": [{ "name": "mypack:ae86_exhaust_high", "attenuation_distance": 64 }]
     }
   }

4. ファイル車の見た目の JSON から指す。assets/mypack/vehicles/ae86.json（6 章）のいちばん外側に、手順 3 で付けた名前を書く:

   "sounds": {
     "exhaust": "mypack:ae86_exhaust",
     "exhaust_high": "mypack:ae86_exhaust_high"
   }

5. ゲームF3+T を押す。

これで、乗っている車のエンジン音がその場で入れ替わります。

1. FileAdd the sound assets/mypack/sounds/ae86_exhaust.ogg: Ogg Vorbis, mono, a seamless loop
2. FileMake the high-rpm copy and put it next to it, with the bundled tool (needs Python):

   pip install numpy soundfile
   python sound_tools/make_octave_up.py ae86_exhaust.ogg
   # → ae86_exhaust_high.ogg

3. FileName the sounds in assets/mypack/sounds.json:

   {
     "ae86_exhaust": {
       "category": "neutral",
       "subtitle": "subtitles.kurumamod.car_exhaust",
       "sounds": [{ "name": "mypack:ae86_exhaust", "attenuation_distance": 64 }]
     },
     "ae86_exhaust_high": {
       "category": "neutral",
       "subtitle": "subtitles.kurumamod.car_exhaust",
       "sounds": [{ "name": "mypack:ae86_exhaust_high", "attenuation_distance": 64 }]
     }
   }

4. FilePoint the car's looks JSON at them. At the top level of assets/mypack/vehicles/ae86.json (chapter 6), write the names from step 3:

   "sounds": {
     "exhaust": "mypack:ae86_exhaust",
     "exhaust_high": "mypack:ae86_exhaust_high"
   }

5. GamePress F3+T.

The car you are in switches to the new engine sound on the spot.

ほかの音も同じやり方で差し替えられます。sounds に書ける名前:

Other sounds are replaced the same way. Names you can use in sounds:

必要なときだけ

Only when you need it

8諸元（走り）を書く

8Write the spec (how it drives)

加速・ブレーキ・曲がりかたを決める値（諸元）を書きます。置き場所は data/mypack/cars/<車>.json です。

This sets the values that decide acceleration, braking and cornering (the spec). They go in data/mypack/cars/<car>.json.

最小の諸元を作る

Make a minimal spec

1. ゲーム車に乗り、G で調整画面を開いて、走りを詰める。
2. ゲーム「プリセット」から名前を付けて保存する。
3. ファイルconfig/kurumamod-setups.json を開き、付けた名前の { … } の中身をコピーする。中に "parts": { … } があれば、そこは除く
4. ファイルdata/mypack/cars/ae86.json の values に貼る。

   {
     "order": 10,
     "values": {
       "mass": 1500.0,
       "peak_torque": 200.0,
       "peak_torque_rpm": 3200.0,
       "redline_rpm": 5600.0
     }
   }

5. ゲーム/reload を打つ。（F3+T ではない）

これで、クリエイティブタブから出したその車が、調整画面で詰めたとおりに走ります。

1. GameGet in a car, press G to open the tuning screen, and dial in the handling.
2. GameSave it under a name from "Preset".
3. FileOpen config/kurumamod-setups.json and copy what is inside the { … } under your name. If there is a "parts": { … } inside, leave that out
4. FilePaste it into values in data/mypack/cars/ae86.json.

   {
     "order": 10,
     "values": {
       "mass": 1500.0,
       "peak_torque": 200.0,
       "peak_torque_rpm": 3200.0,
       "redline_rpm": 5600.0
     }
   }

5. GameRun /reload. (Not F3+T.)

The car, taken fresh from the creative tab, now drives the way you tuned it.

必要なときだけ

Only when you need it

{
  "values": {
    "_comment_mass": "バンなので既定より重くする",
    "mass": 1500.0
  }
}

{
  "values": {
    "_comment_mass": "A van, so heavier than the default",
    "mass": 1500.0
  }
}

2ホイールを部品にする

2Make a wheel a part

作ったホイールを、ゲームの換装画面で選べるようにします。見た目だけの部品で、走りは変わりません。

Make your wheel selectable in the in-game parts screen. It changes the looks only; driving stays the same.

最小のホイール部品を作る

Make a minimal wheel part

1. Blenderホイールのモデルを作って置く。作り方は 1 章。ここでは assets/mypack/models/entity/my_wheel.obj と assets/mypack/textures/entity/my_wheel.png に置いたとする
2. ファイル部品のファイルを置く。data/mypack/car_parts/my_wheel.json（ファイル名が部品名）:

   { "slot": "wheel" }

3. ファイル見た目のファイルを置く。assets/mypack/car_parts/my_wheel.json（部品と同じファイル名）。designRadius は作った半径（ゲージどおりなら 0.45）:

   {
     "wheel": {
       "model": "mypack:models/entity/my_wheel.obj",
       "texture": "mypack:textures/entity/my_wheel.png",
       "designRadius": 0.45
     }
   }

4. lang表示名を lang に書く。"part.mypack.my_wheel": "マイホイール"

これで、ゲームの G →「パーツ」→「ホイール」のタブに並びます。

1. BlenderBuild the wheel model and put it in your pack. See chapter 1. Here it is at assets/mypack/models/entity/my_wheel.obj and assets/mypack/textures/entity/my_wheel.png
2. FileAdd the part file data/mypack/car_parts/my_wheel.json (the file name is the part name):

   { "slot": "wheel" }

3. FileAdd the looks file assets/mypack/car_parts/my_wheel.json (same file name as the part). designRadius is the radius you built at (0.45 if you followed the gauge):

   {
     "wheel": {
       "model": "mypack:models/entity/my_wheel.obj",
       "texture": "mypack:textures/entity/my_wheel.png",
       "designRadius": 0.45
     }
   }

4. langAdd the display name to lang. "part.mypack.my_wheel": "My Wheels"

It now appears under G → "Parts" → the "Wheels" tab.

見本パックの sample_wheel が、この形そのものです。

The example pack's sample_wheel is exactly this setup.

必要なときだけ

Only when you need it

{
  "wheel": {
    "model": "mypack:models/entity/my_wheel.obj",
    "texture": "mypack:textures/entity/my_wheel.png",
    "designRadius": 0.45,
    "offset": [0.02, 0.0, 0.0],
    "scale": [1.3, 1.0, 1.0],
    "camber": -4.0
  }
}

{
  "wheel": {
    "model": "mypack:models/entity/my_wheel.obj",
    "texture": "mypack:textures/entity/my_wheel.png",
    "designRadius": 0.45,
    "offset": [0.02, 0.0, 0.0],
    "scale": [1.3, 1.0, 1.0],
    "camber": -4.0
  }
}

{
  "wheel": {
    "scale": [1.6, 1.0, 1.0],
    "camber": -12.0
  }
}

{
  "wheel": {
    "scale": [1.6, 1.0, 1.0],
    "camber": -12.0
  }
}

{
  "slot": "wheel",
  "cars": ["mypack:kei", "mypack:kei_van"]
}

{
  "slot": "wheel",
  "cars": ["mypack:kei", "mypack:kei_van"]
}

{
  "slot": "wheel",
  "order": 10
}

{
  "slot": "wheel",
  "order": 10
}

4jar に固めて配る

4Pack it into a jar and ship it

カーパックは、コードを持たない MOD の jar です。フォルダの中身を zip で固めて .jar にし、mods/ に入れます。

A car pack is a mod jar with no code in it. You zip the folder's contents, name it .jar and put it in mods/.

最小のパックを作る

Make a minimal pack

1. ファイル見本のフォルダ carpack/example/ をコピーする。例: mypack/
2. ファイルコピーしたフォルダの中で、中身を jar に固める。どちらか 1 つ:

   cd mypack
   jar --create --file ../mypack.jar .     # JDK があるとき
   zip -r ../mypack.jar .                  # zip があるとき

   # Windows の PowerShell（JDK が無いとき）
   cd mypack
   Compress-Archive -Path * -DestinationPath ..\mypack.zip
   Rename-Item ..\mypack.zip mypack.jar

3. ファイルできた mypack.jar を、Minecraft の mods/ フォルダに入れる。
4. ゲーム起動して、クリエイティブの「KurumaMod」タブを開く。

これで、タブに「サンプルカー」が並びます。この jar を土台に、中身を自分の車やパーツに置き換えていきます。

1. FileCopy the example folder carpack/example/. For example, to mypack/
2. FileFrom inside the copied folder, pack its contents into a jar. Use one of these:

   cd mypack
   jar --create --file ../mypack.jar .     # if you have a JDK
   zip -r ../mypack.jar .                  # if you have zip

   # Windows PowerShell (without a JDK)
   cd mypack
   Compress-Archive -Path * -DestinationPath ..\mypack.zip
   Rename-Item ..\mypack.zip mypack.jar

3. FilePut the resulting mypack.jar into Minecraft's mods/ folder.
4. GameStart the game and open the "KurumaMod" creative tab.

The "Sample Car" is now in the tab. Use this jar as your base and replace its contents with your own cars and parts.

必要なときだけ

Only when you need it

5確認する

5Check it in game

ゲームを開いたまま、直しては読み直して見る、を繰り返します。再起動は要りません。

Keep the game running and repeat: fix, reload, look. No restart needed.

やること

What you do

1. ゲームクリエイティブの「KurumaMod」タブから車を出して乗る。
2. Blender直して、同じファイル名で書き出し直す。
3. ゲーム見た目（assets/）を直したら F3+T を押す。モデル・テクスチャ・vehicles/*.json・部品の見た目・音が読み直される
4. ゲーム走りや部品の中身（data/）を直したら /reload を打つ。諸元・部品の性能・初期装備が読み直される

これで、直したところがすぐゲームに出ます。下の表で見ていきます。

1. GameTake a car from the "KurumaMod" creative tab and get in.
2. BlenderFix it and export again under the same file name.
3. GameAfter changing the looks (assets/), press F3+T. Models, textures, vehicles/*.json, part looks and sounds reload
4. GameAfter changing driving or part contents (data/), type /reload. The spec, part performance and default parts reload

Your fix now shows up in game. Use the table below to check it.

見るところ

What to look at

必要なときだけ

Only when you need it

6症状別の直しかた

6Troubleshooting

カーパックは、失敗してもエラー画面を出しません。壊れたファイルは捨てて先へ進むので、症状から探します。理由はたいてい logs/latest.log に 1 行残っています。

Car packs fail without an error screen. A broken file is dropped and loading carries on, so you work from the symptom. The reason is usually one line in logs/latest.log.

読み込み・名前

Loading and names

形と大きさ

Shape and size

色・ガラス・ライト・ミラー

Colour, glass, lights, mirrors

パーツ

Parts

音

Sound

7チェックリスト

7Checklists

場面ごとに、見落としやすいところを並べます。症状が出てから探すときは6 章へ。

What is easy to miss, by stage. If something is already wrong, go to chapter 6.

書き出す前（Blender）

Before exporting (in Blender)

• ワールド原点が「地面の高さ・前後輪の中点・左右中央」にある
• 車の前が −Y を向いている
• フェンダーがゲージのタイヤに合っている
• ライトの名前（オブジェクト名かマテリアル名）が light_head / light_tail / light_reverse のどれか。ほかの light_ は無い
• レンズ面が車体から 1〜2mm 浮いている
• 窓の名前（オブジェクト名かマテリアル名）が glass で始まる
• 左右のドアミラーが別のオブジェクトになっている
• マテリアルの Base Color が白
• タイヤは別ファイル・左側用 1 つ・原点は車軸・表は +X

• The world origin is at ground level, midway between the axles, on the centreline
• The front of the car points along −Y
• The arches line up with the gauge wheels
• Light names (object or material) are light_head, light_tail or light_reverse. No other light_ exists
• Lens faces float 1–2 mm proud of the body
• Window names (object or material) start with glass
• The two door mirrors are separate objects
• Material Base Color is white
• Wheel: separate file, left side only, origin at the axle, face towards +X

外装パーツ・マフラーを入れたとき（Blender）

If you added body parts or exhausts (in Blender)

• 部品のオブジェクト名が part_<場所>-<部品名> で、部品名が car_parts/ のファイル名と同じ
• 付け替える純正の部分も、body から分けて別のオブジェクトにした
• 付け替え候補の部品を全部表示にしてから選んだ（非表示のものは書き出されない）
• 部品の中のライトは、その面に light_ のマテリアルを割り当てた

• Part objects are named part_<slot>-<part>, and the part name matches the file name in car_parts/
• Stock pieces that can be swapped are split from body into their own objects
• Every selectable part was unhidden before selecting (hidden objects are not exported)
• Lights inside a part use a light_ material on those faces

書き出しの画面

In the export dialog

• Selected Only を入れた（ゲージが混ざらない）
• Triangulated Mesh を入れていない
• Forward Axis / Up Axis を触っていない
• 「マテリアル」の「書き出し」が入っている（既定で入っている）
• 車体とタイヤを別のファイルに書き出した
• .mtl も一緒に置いた

• Selected Only ticked, so the gauge stays out
• Triangulated Mesh left off
• Forward Axis / Up Axis untouched
• "Materials" → "Export" ticked (it is by default)
• Body and wheel exported to separate files
• The .mtl kept alongside

ゲームで見る前

Before loading it in game

• JSON に書いたパスが、実際のファイル名と同じ
• designWheelBase / designWheelRadius がメッシュの実寸
• リソースパックで試すなら、ゲームで有効にした
• 見た目を直したら F3+T、data/ を直したら /reload

• The paths in the JSON match the actual file names
• designWheelBase and designWheelRadius are your mesh's real sizes
• If testing with a resource pack, it is enabled in game
• F3+T after changing looks, /reload after changing data/

音を付けたとき

If you added sounds

• ogg・モノラル・継ぎ目の無いループ
• exhaust_high を sound_tools/make_octave_up.py で作って並べた
• sounds.json の "name" に拡張子を付けていない
• vehicles/<car>.json の sounds（マフラーなら部品の見た目の exhaust.sound）が sounds.json の名前を指している

• Ogg, mono, seamless loops
• exhaust_high made with sound_tools/make_octave_up.py and put alongside
• No extension on "name" in sounds.json
• sounds in vehicles/<car>.json (for an exhaust part, exhaust.sound in its looks JSON) points at names from sounds.json

配る前

Before you ship

• modId が a-z 0-9 _ だけで、名前空間（フォルダ名）と同じ
• 諸元・見た目・lang のファイル名と翻訳キーが車種 id と揃っている
• 部品の表示名を part.<パック>.<部品名> で lang に書いた
• default_parts を values の中ではなく、いちばん外側に書いた
• 諸元の角度をラジアンで書いた（ゲーム内で書き出したなら問題ない）
• META-INF/ と pack.mcmeta が jar のいちばん上にある
• マルチプレイなら、サーバーにも入れた

• modId uses only a-z 0-9 _ and matches the namespace (folder name)
• Spec, looks and lang file names and translation keys all match the car id
• Part display names are in lang as part.<pack>.<part>
• default_parts is at the top level, not inside values
• Spec angles are in radians (fine if you exported from in game)
• META-INF/ and pack.mcmeta sit at the top of the jar
• For multiplayer, installed on the server too

3タイヤを部品にする

3Make a tyre a part

ダート用・オフロード用のような、走りが変わるタイヤを作ります。タイヤはホイールとは別の部品で、路面ごとのグリップが変わります。

Make a tyre that changes how the car drives, such as a gravel or mud-terrain tyre. Tyres are a separate part from wheels, and they change grip on each surface.

最小のタイヤ部品を作る

Make a minimal tyre part

1. ファイル部品のファイルを置く。data/mypack/car_parts/my_tire.json（ファイル名が部品名）:

   {
     "slot": "tire",
     "tire": {
       "grip": { "paved": 0.90, "gravel": 1.20 }
     }
   }

2. lang表示名を lang に書く。"part.mypack.my_tire": "マイタイヤ"

これで、ゲームの G →「パーツ」→「タイヤ」のタブに並びます。数字はノーマルタイヤに対する倍率で、この例は舗装で 0.9 倍・砂利で 1.2 倍のグリップです。見た目は KurumaMod 標準のタイヤです。

1. FileAdd the part file data/mypack/car_parts/my_tire.json (the file name is the part name):

   {
     "slot": "tire",
     "tire": {
       "grip": { "paved": 0.90, "gravel": 1.20 }
     }
   }

2. langAdd the display name to lang. "part.mypack.my_tire": "My Tyres"

It now appears under G → "Parts" → the "Tyres" tab. The numbers are ratios to the Normal tyre; this one has 0.9× grip on tarmac and 1.2× on gravel. It looks like KurumaMod's standard tyre.

必要なときだけ

Only when you need it

{
  "slot": "tire",
  "tire": {
    "stiffness": 0.85,
    "grip":    { "paved": 0.88, "dirt": 1.20, "gravel": 1.25, "sand": 1.10, "snow": 1.10 },
    "rolling": { "paved": 1.15 }
  }
}

{
  "slot": "tire",
  "tire": {
    "stiffness": 0.85,
    "grip":    { "paved": 0.88, "dirt": 1.20, "gravel": 1.25, "sand": 1.10, "snow": 1.10 },
    "rolling": { "paved": 1.15 }
  }
}

{
  "wheel": {
    "model": "mypack:models/entity/my_wheel.obj",
    "texture": "mypack:textures/entity/my_wheel.png",
    "designRadius": 0.45,
    "rimRadius": 0.33
  }
}

{
  "wheel": {
    "model": "mypack:models/entity/my_wheel.obj",
    "texture": "mypack:textures/entity/my_wheel.png",
    "designRadius": 0.45,
    "rimRadius": 0.33
  }
}

{
  "slot": "tire",
  "order": 30,
  "cars": ["mypack:kei"],
  "tire": { "grip": { "paved": 0.90, "gravel": 1.20 } }
}

{
  "slot": "tire",
  "order": 30,
  "cars": ["mypack:kei"],
  "tire": { "grip": { "paved": 0.90, "gravel": 1.20 } }
}

1ターボとブローオフバルブ

1Turbos and blow-off valves

ターボは加速が変わる部品、ブローオフバルブはアクセルを抜いたときに「プシュッ」と鳴るだけの部品です。どちらもモデルは要りません。

A turbo changes how the car accelerates; a blow-off valve only adds the "pssh" when you lift off. Neither needs a model.

最小のターボを作る

Make a minimal turbo

1. ファイル部品のファイルを置く。data/mypack/car_parts/my_turbo.json:

   {
     "slot": "turbo",
     "turbo": { "boost": 0.5 }
   }

2. lang表示名を lang に書く。"part.mypack.my_turbo": "マイタービン"

これで、ゲームの G →「パーツ」→「ターボ」のタブに並びます。boost は全開のときにトルクを何割増やすか（0.5 で 1.5 倍）です。

1. FileAdd the part file data/mypack/car_parts/my_turbo.json:

   {
     "slot": "turbo",
     "turbo": { "boost": 0.5 }
   }

2. langAdd the display name to lang. "part.mypack.my_turbo": "My Turbo"

It now appears under G → "Parts" → the "Turbo" tab. boost is how much extra torque at full boost (0.5 means 1.5×).

最小のブローオフバルブを作る

Make a minimal blow-off valve

1. ファイル部品のファイルを置く。data/mypack/car_parts/my_bov.json:

   { "slot": "blowoff" }

2. lang表示名を lang に書く。"part.mypack.my_bov": "マイブローオフ"

ターボを付けている車にだけ、「ブローオフ」のタブが出ます。

1. FileAdd the part file data/mypack/car_parts/my_bov.json:

   { "slot": "blowoff" }

2. langAdd the display name to lang. "part.mypack.my_bov": "My Blow-off"

The "Blow-off" tab only appears on a car with a turbo fitted.

必要なときだけ

Only when you need it

{
  "slot": "turbo",
  "turbo": {
    "boost": 0.50,
    "spool_from": 0.30,
    "spool_full": 0.65,
    "spool_rate": 2.0
  }
}

{
  "slot": "turbo",
  "turbo": {
    "boost": 0.50,
    "spool_from": 0.30,
    "spool_full": 0.65,
    "spool_rate": 2.0
  }
}

{
  "slot": "turbo",
  "cars": ["mypack:prado"],
  "turbo": { "boost": 0.4 }
}

{
  "slot": "turbo",
  "cars": ["mypack:prado"],
  "turbo": { "boost": 0.4 }
}

2外装パーツ

2Body parts

ウイング・バンパー・フェンダーなど、車体に固定される部品です。

Wings, bumpers, fenders — parts fixed to the body.

最小のパーツを作る

Make a minimal part

1. Blender車体の .blend の中に、部品を別のオブジェクトとして作る。名前は part_<場所>-<部品名>（例 part_rear_wing-gt_wing）。場所は下の表から選ぶ
2. Blender付け替え候補の部品を全部表示にして、車体と一緒に 1 つの OBJ に書き出す。
3. ファイル部品のファイルを置く。data/mypack/car_parts/gt_wing.json（ファイル名が部品名）:

   { "slot": "rear_wing" }

4. lang表示名を lang に書く。"part.mypack.gt_wing": "GT ウイング"

これで、ゲームの G →「パーツ」に、その場所のタブと部品が並びます。

1. BlenderModel the part as a separate object inside the car's .blend. Name it part_<slot>-<part> (e.g. part_rear_wing-gt_wing); pick the slot from the table below
2. BlenderUnhide every selectable part and export them together with the body, as one OBJ.
3. FileAdd the part file data/mypack/car_parts/gt_wing.json (the file name is the part name):

   { "slot": "rear_wing" }

4. langAdd the display name to lang. "part.mypack.gt_wing": "GT Wing"

The slot's tab and the part now appear under G → "Parts" in game.

付ける場所（slot）

Slots (slot)

その車にオブジェクトのある部品も初期装備も無い場所は、タブが出ません。

A slot's tab only appears if the car has an object for one of its parts, or a default part.

必要なときだけ

Only when you need it

{
  "slot": "rear_wing",
  "aero": { "rear": 0.25 }
}

{
  "slot": "rear_wing",
  "aero": {
    "rear": [0.6, 1.6],
    "front": 0.1,
    "angle": 0.4
  }
}

{
  "slot": "rear_wing",
  "aero": { "rear": 0.25 }
}

{
  "slot": "rear_wing",
  "aero": {
    "rear": [0.6, 1.6],
    "front": 0.1,
    "angle": 0.4
  }
}

"parts": {
  "mypack:twin_muffler": { "show": ["part_exhaust-twin", "part_exhaust-twin_tip"] }
}

"parts": {
  "mypack:twin_muffler": { "show": ["part_exhaust-twin", "part_exhaust-twin_tip"] }
}

{
  "values": { "mass": 1250 },
  "default_parts": {
    "rear_wing": "mypack:s15_spoiler",
    "exhaust": { "part": "mypack:stock_muffler", "removable": false }
  }
}

{
  "values": { "mass": 1250 },
  "default_parts": {
    "rear_wing": "mypack:s15_spoiler",
    "exhaust": { "part": "mypack:stock_muffler", "removable": false }
  }
}

3マフラー

3Exhausts

見た目と排気音を変える部品です。走りは変わりません。

A part that changes the look and the exhaust note. Driving does not change.

最小のマフラーを作る

Make a minimal exhaust

1. Blender車体の .blend の中に、マフラーを別のオブジェクトとして作る。名前は part_exhaust-<部品名>（例 part_exhaust-titanium）
2. Blender付け替え候補のマフラーを全部表示にして、車体と一緒に 1 つの OBJ に書き出す。
3. ファイル部品のファイルを置く。data/mypack/car_parts/titanium.json:

   { "slot": "exhaust" }

4. lang表示名を lang に書く。"part.mypack.titanium": "チタンマフラー"

これで、ゲームの G →「パーツ」→「マフラー」のタブに並びます。このままでは音はその車のままです。

1. BlenderModel the exhaust as a separate object inside the car's .blend. Name it part_exhaust-<part> (e.g. part_exhaust-titanium)
2. BlenderUnhide every selectable exhaust and export them together with the body, as one OBJ.
3. FileAdd the part file data/mypack/car_parts/titanium.json:

   { "slot": "exhaust" }

4. langAdd the display name to lang. "part.mypack.titanium": "Titanium exhaust"

It now appears under G → "Parts" → the "Exhaust" tab. The sound is still the car's own.

必要なときだけ

Only when you need it

{
  "exhaust": {
    "pitch": [0.85, 1.00],
    "volume": 1.2,
    "tone": 0.3
  }
}

{
  "exhaust": {
    "pitch": [0.85, 1.00],
    "volume": 1.2,
    "tone": 0.3
  }
}

{
  "values": { ... },
  "default_parts": {
    "exhaust": { "part": "mypack:stock", "removable": false }
  }
}

{
  "values": { ... },
  "default_parts": {
    "exhaust": { "part": "mypack:stock", "removable": false }
  }
}

付録 A. 座標系

Appendix A. Axes

Blender・OBJ ファイル・ゲームで軸の意味が変わりますが、読み替えは MOD 側が済ませています。Blender 標準の向きで作り、エクスポート設定も標準のままにしておけば、この表を意識する必要はありません。

The axes mean different things in Blender, in the OBJ file and in game, but the mod already does the conversion. Model in Blender's default orientation, leave the export settings alone, and you never need this table.

vehicles/*.json の offset と seat はゲーム内の向き（+X 右・+Y 上・−Z 前）で書きます。Blender の向きとは前後・左右が逆なので注意してください。

offset and seat in vehicles/*.json use the in-game axes (+X right, +Y up, −Z forward). Note that both the front–back and left–right senses are reversed from Blender's.

UV も上下が逆（OBJ は下が 0・Minecraft は上が 0）ですが、こちらも読み込み時に反転しているので Blender 側で気にする必要はありません。

UVs are flipped vertically too (0 is the bottom in OBJ, the top in Minecraft), but that is also handled on load, so there is nothing to do in Blender.

付録 B. 用語

Appendix B. Glossary

付録 A. 諸元の全項目（data/<pack>/cars/<car>.json）

Appendix A. Every spec key (data/<pack>/cars/<car>.json)

これで全部（57 項目）。書き方は 8 章。範囲は調整画面のスライダーの範囲と同じです。外れた値は、上に外れれば上限、下に外れれば下限へ丸めて読み込み、ログに 範囲（… 〜 …）の外なので … に丸めました と残します。

That is all of them (57 keys). How to write them is in chapter 8. The ranges are the same as the tuning screen's sliders. A value above the range is loaded as the maximum and one below as the minimum, and the log records 範囲（… 〜 …）の外なので … に丸めました ("outside the range, clamped to …").

サスペンション

足を硬くしたいときは stroke を短くします。沈み込みがストロークの 39.2% で固定なので、短いほどバネが硬くなり、ダンパーの係数もそれに合わせて上がります。

ダンパー

N·s/m ではなく減衰比（臨界減衰に対する割合）で書きます。係数はその輪のバネと荷重から KurumaMod が計算するので、stroke や mass を変えても効き方は変わりません。1 で揺り返しがちょうど出なくなる硬さ。実車は伸び側を縮み側の 1.5〜3 倍にすることが多く、そうすると段差を柔らかくいなしつつ揺れがすぐ収まります。

ステアリング ジオメトリ

タイヤ

friction に書くのは実際の摩擦係数（μ）です。調整画面は既定を 1.00 とした相対値で出しています（いまは基準が 1.0 なので同じ数字）。

車体

エンジン

変速機

駆動系・デフ

diff_lock_ratio と diff_preload がどちらも 0 ならオープンデフ。diff_coast_ratio は 0 で 1way、0.5 で 1.5way、1 で 2way。

torque_split と center_diff_lock は 4WD（drive_layout が 2）のときだけ効きます。torque_split は前後へ配る駆動力の割合で、後ろへ寄せるほど踏んだときに尻が出やすくなります（FR 寄り）。center_diff_lock が 0 ならオープンで配分どおり、上げると前後の回転差を揃えにいき、空転しかけた軸から掴んでいる軸へトルクが移ります（1 で直結）。締めるほど配分の意味は薄れ、低速で小さく回ったときに止まろうとします（タイトコーナーブレーキング）。サイドブレーキを引いている間は自動で切れます。古い drive_bias（0 = FF・1 = FR・間は 4WD の配分）も読めます。

ブレーキ・走行抵抗

最高速の項目はありません。実際の最高速はトルクと抵抗から決まり、最高段でレブまで回した速度より速くは走れません。

空力

空気抵抗は力として掛かるので、同じ値でも重い車ほど減速しにくくなります。目安はスポーツカー 0.5、乗用車 0.7、SUV 1.0。以前の drag（減速度の係数）を書いたパックは、その車の車重で自動的に換算され、走りは変わりません。

ダウンフォースは前軸・後軸の位置で車体を下へ押し、速度の 2 乗で増えます。前を強くするとオーバー、後ろを強くするとアンダー。押し付けるぶん空気抵抗も増える（ダウンフォースの 1/6 が CdA に足される）ので、付けるほど最高速は落ちます。目安はウイング付きの市販車で前後合わせて 0.3〜0.6、GT 系のレーシングカーで 2〜3。

操作と補助

Suspension

To stiffen the suspension, shorten stroke. Static sag is fixed at 39.2% of the stroke, so a shorter stroke means stiffer springs, and the damper coefficients rise with them.

Dampers

Write a damping ratio (a fraction of critical damping), not N·s/m. KurumaMod works out the coefficient from that wheel's spring and load, so changing stroke or mass keeps the feel the same. At 1 the car just stops bouncing back. Real cars often run rebound at 1.5–3 times bump, which soaks up bumps softly but settles quickly.

Steering geometry

Tires

friction is the actual coefficient of friction (μ). The tuning screen shows it relative to the default (the reference is 1.0 for now, so the numbers match).

Chassis

Engine

Gearbox

Driveline & Differential

With diff_lock_ratio and diff_preload both at 0 it is an open diff. diff_coast_ratio is 1-way at 0, 1.5-way at 0.5, 2-way at 1.

torque_split and center_diff_lock only apply to AWD (drive_layout 2). torque_split is the share of drive sent to each axle; the more goes to the rear, the more the tail steps out on the throttle (RWD-like). With center_diff_lock at 0 the centre is open and the split holds exactly; raising it pulls the front and rear speeds together and moves torque from an axle that starts to spin to the one that still grips (1 is fully locked). The tighter it is, the less the split matters, and the car resists tight turns at low speed (tight-corner braking). It opens automatically while the handbrake is pulled. The old drive_bias (0 = FWD, 1 = RWD, anything between = AWD split) is still read.

Brakes & Resistance

There is no top-speed field. The real top speed comes out of torque versus resistance, and the car can never go faster than top gear at the redline.

Aerodynamics

Drag is applied as a force, so the same value slows a heavier car less. Rough guide: sports car 0.5, saloon 0.7, SUV 1.0. Packs that still write the old drag (a deceleration coefficient) are converted using that car's mass, so they drive exactly as before.

Downforce pushes the body down at the front and rear axles and grows with the square of speed. More at the front gives oversteer, more at the rear gives understeer. It costs drag too (one sixth of the downforce is added to CdA), so the more you add, the lower the top speed. Rough guide: 0.3–0.6 in total for a road car with a wing, 2–3 for a GT-class race car.

Controls & Aids

付録 B. 書いても読まれない値

Appendix B. Values ignored even if you write them

他の諸元から決まる値は、書いても黙って捨てられます。KurumaMod が計算します。

Values that follow from other values are silently dropped. KurumaMod computes them.

そのため「タイヤ半径を変えたらファイナルも直す」「寸法を変えたら慣性も」といった組み合わせの手直しは要りません。半径を変えればギアリングも車高も登坂力も一緒に動きます。

So there is no cross-checking to do — no "I changed the tyre radius, now fix the final drive", no "I changed the dimensions, now fix the inertia". Change the radius and the gearing, ride height and climbing ability all move with it.

付録 A. 部品の全項目

Appendix A. Every part key

素性 — data/<pack>/car_parts/<part>.json

Definition — data/<pack>/car_parts/<part>.json

見た目 — assets/<pack>/car_parts/<part>.json（"wheel": { ... } の中。入れ子を省いて、いちばん外側に書いてもよい。ホイールだけ。ターボとブローオフには要らない）

Looks — assets/<pack>/car_parts/<part>.json (inside "wheel": { ... }, or at the top level without the nesting). Wheels only; turbos and blow-off valves need none

タイヤの見た目 — assets/<pack>/car_parts/<part>.json（"tire": { ... } の中。いちばん外側には書けない）

Tyre looks — assets/<pack>/car_parts/<part>.json (inside "tire": { ... }; not at the top level)

マフラーの音 — assets/<pack>/car_parts/<part>.json（"exhaust": { ... } の中。いちばん外側には書けない）

Exhaust sound — assets/<pack>/car_parts/<part>.json (inside "exhaust": { ... }; not at the top level)

車の側 — 初期装備（data/<pack>/cars/<car>.json のいちばん外側）と対応（assets/<pack>/vehicles/<car>.json）

On the car — default parts (top level of data/<pack>/cars/<car>.json) and mapping (assets/<pack>/vehicles/<car>.json)