Tudur's Vehicle

<English>

Introduction

This mod does not add any vehicles on its own. You must either create your own vehicles or install publicly available expansion packs.

A sample pack is available on the mod download page. Please use it to verify functionality or as a reference for creating your own expansion packs.

I have included links to each project in the GitHub README. Please take a look.

Relationship with MCHeli

This project began because the author (Tuduraw) wanted a mod compatible with MCHeli for current Minecraft versions; consequently, it retains compatibility with MCHeli in certain aspects. It is also possible to convert MCHeli expansion packs using a conversion script.

While these implementations reference documentation intended for pack creators, the mod does not reference or analyze the actual source code of the MCHeli mod itself.

Therefore, we have determined that this does not constitute the "redistribution of any or all files from the MCHeli mod to the general public."

1. What You Can Do with This Mod

• Vehicles: Supports five types of movement models: helicopters, cars, boats, submarines, and fixed-wing aircraft. New vehicles can be added simply by providing a JSON definition and an OBJ model.
• Armament: Supports machine guns, rockets, bombs, torpedoes, and guided missiles (surface-to-ground, surface-to-air, anti-tank). Supports various firing mechanics: magazine-based, heat-based (overheating), or a combination of both.
• Durability & Destruction: Features vehicle-specific HP, armor coefficients, and destruction effects (charring + black smoke, damage to occupants). Also simulates heavy damage from steep-angle block collisions or high-speed entity collisions.
• Fuel: Features vehicle-specific fuel tanks and consumption rates (throttle-dependent, with acceleration/deceleration curves). Running out of fuel locks the throttle to zero (control remains possible, though responsiveness is reduced). * Resupply: While piloting, you can access the vehicle menu to resupply ammunition (consuming items), refuel (using equipped jerrycans), and manage the vehicle inventory (if configured). Generally, these actions can only be performed while the vehicle is stationary.
• Jerrycans and Refueling Stations: Craft jerrycans using iron ingots and refueling stations using a piston and eight furnaces. These stations convert fuel-related items into fuel for jerrycans, which then supply the vehicle. An infinite-fuel jerrycan for Creative Mode is also available.
• HUD: Supports MCHeli-compatible HUD scripts. It tracks variables such as health, fuel, ammunition, and heat levels, and includes some unique variables.
• Aircraft Carrier: You can configure a runway (flight deck) and launch carrier-based aircraft using dedicated weapons; these aircraft can automatically fly patrol or attack routes, return to base, and land.
• UAVs, Autonomous Drones, and CAS: Using a registration stick and dedicated blocks, any vehicle can be operated as an unmanned remote-controlled unit (UAV) or an autonomous AI-piloted drone (TargetDrone). It also supports Close Air Support (CAS) by deploying support aircraft via weapons.

2. How to Create Expansion Packs (New Vehicles)

No code changes are required to add new vehicles. Prepare the following: 1. Model: assets/<namespace>/models/obj/<name>.obj (OBJ format; supports triangles, quads, or polygons)

1. Texture: assets/<namespace>/textures/vehicle/<name>.png
2. Data Definition: data/<namespace>/vehicles/<name>.json

• entity_type: Behavior model (one of tudursvehiclemod:car, helicopter, ship, submarine, or aircraft)
• model/texture: References to the files prepared in steps 1 and 2 above
• Various parameters such as speed, hitboxes, seats, weaponry, durability, and fuel
• (Optional) Specify weaponry via weapons, the spawn item via spawn_item, and the HUD via hud

1. Apply changes in-game using /reload (no restart required). *Note: Restarting is recommended to ensure changes take effect.

3. Other Notes

• Use of Generative AI: The code and documentation for this project were created using Anthropic's generative AI, "Claude."

＜日本語/Japanese＞

はじめに

　このmod単体では乗り物は追加されません。自ら乗り物を作成するか、公開されている拡張パックを導入する必要があります。

　なお、サンプルパックをmodダウンロードページにて配布しています。動作の確認や拡張パック作成の参考としてお役立てください。

　GitHubのREADME内に各プロジェクトのリンクを貼っています。確認をお願いします。

MCヘリとの関係性について

　もともと作者(Tuduraw)がMCヘリ互換の現行Ver向けmodを欲して始めたプロジェクトのため、一部要素でMCヘリとの互換性があります。また、変換スクリプトによるMCヘリ拡張パックのコンバートも可能です。

　これらの実装はパック製作者向けのドキュメントなどを参考にしているものの、MCヘリ本体のコードを参照したり解析したりはしておりません。

　よって、"MCヘリMODの一部、または全てのファイルの不特定多数への2次配布"には該当しないと判断しています。

1. このMODでできること

• 乗り物: ヘリコプター・車・船・潜水艦・固定翼機の5種類の動作モデルに対応。 それぞれJSON定義 + OBJモデルを追加するだけで新しい乗り物を増やせる。
• 武装: 機関銃・ロケット・爆弾・魚雷・誘導ミサイル(対地/対空/対戦車)などに対応。 弾数(マガジン)・熱量式(オーバーヒート)・両方併用のいずれにも対応。
• 耐久・撃破: 機体ごとのHP・装甲係数・撃破時の演出(黒焦げ化+黒煙、搭乗者への ダメージ)、急角度でのブロック衝突や高速でのエンティティ衝突による大ダメージ。
• 燃料: 機体ごとの燃料タンク・消費レート(スロットル依存、緩急カーブあり)。 燃料切れでスロットルが0固定に(応答性は落ちるものの制御自体は可能)。
• 補給: 搭乗中に開ける機体メニューから、弾薬補給(アイテム消費)・燃料補給 (携行缶をセット)・機体インベントリ(設定時)を利用可能。原則として静止状態のみ使用可能。
• 携行缶と給油装置: 鉄インゴットで携行缶を作成、ピストン+かまど8個で給油装置を 作成し、燃料系アイテムを燃料に変換して携行缶へ、携行缶から機体へ供給する。 クリエイティブ専用の無限燃料缶も用意。
• HUD: MCヘリ互換のHUDスクリプトに対応。体力・燃料・弾薬・熱量などの変数に対応し、一部で独自の変数も存在する。
• 空母(Carrier): 滑走路(甲板)を設定したり、専用武器から艦載機を発艦させ、自動で哨戒/攻撃ルートを飛行、帰投・着艦させることが可能。
• 無人機・自律ドローン・CAS: 登録スティック+専用ブロックにより、すべての機体を無人の遠隔操縦(UAV)・自律AI飛行(TargetDrone)として運用できる。また、武器から支援機を出撃させる近接航空支援(CAS)にも対応。

2. 拡張パック(新しい乗り物)の作り方

新しい乗り物を追加するのにコードの変更は不要。以下を用意。

1. モデル: assets/<namespace>/models/obj/<名前>.obj(OBJ形式、三角形/四角形/ 多角形いずれも可)
2. テクスチャ: assets/<namespace>/textures/vehicle/<名前>.png
3. データ定義: data/<namespace>/vehicles/<名前>.json
   • entity_type: 動作モデル(tudursvehiclemod:car/helicopter/ship/submarine/ aircraftのいずれか)
   • model/texture: 上記1・2で用意したファイルの参照
   • 速度・当たり判定・座席・武装・耐久・燃料などの各種パラメータ
   • (任意)weaponsで武装、spawn_itemでスポーンアイテム、hudでHUD指定
4. /reloadでゲーム内に反映(再起動不要)。※確実な反映には再起動推奨

3. その他注意事項

• 生成AIの使用について　このプロジェクトのコードおよびドキュメントは、Anthropic社の生成AI 「Claude」を使用して作成されています。