图杜尔的载具

<English>

简介

本模组本身不会添加任何载具。你必须自行创建载具，或安装公开可用的扩展包。

模组下载页面上提供了一个示例包。请用它来验证功能，或作为创建你自己扩展包的参考。

与 MCHeli 的关系

本项目之所以开始，是因为作者（Tuduraw）想要一个适用于当前 Minecraft 版本且与 MCHeli 兼容的模组；因此，它在某些方面保留了与 MCHeli 的兼容性。也可以使用转换脚本转换 MCHeli 扩展包。

虽然这些实现参考了面向包创建者的文档，但本模组并未参考或分析 MCHeli 模组本身的实际源代码。

因此，我们认定这不构成“将 MCHeli 模组的任何或全部文件再分发给公众”。

1. 你可以用本模组做什么

• 载具：支持五种运动模型：直升机、汽车、船、潜艇和固定翼飞机。只需提供 JSON 定义和 OBJ 模型，即可添加新载具。
• 武装：支持机枪、火箭、炸弹、鱼雷和制导导弹（地对地、地对空、反坦克）。支持多种射击机制：基于弹匣、基于热量（过热），或两者结合。
• 耐久与破坏：具有载具专属的 HP、装甲系数和破坏效果（焦黑 + 黑烟、对乘员造成伤害）。还模拟陡角撞击方块或高速撞击实体造成的严重损伤。
• 燃料：具有载具专属的燃料箱和消耗速率（取决于油门，并带有加速/减速曲线）。燃料耗尽会将油门锁定为零（仍可控制，但响应性降低）。* 补给：驾驶时，你可以访问载具菜单来补给弹药（消耗物品）、加油（使用已装备的油桶），以及管理载具物品栏（如果已配置）。通常，这些操作只能在载具静止时进行。
• 油桶和加油站：使用铁锭制作油桶，使用活塞和八个熔炉制作加油站。这些站点会将与燃料相关的物品转化为油桶中的燃料，再由油桶供应给载具。还提供用于创造模式的无限燃料油桶。
• HUD：支持兼容 MCHeli 的 HUD 脚本。它会跟踪生命值、燃料、弹药和热量水平等变量，并包含一些独特变量。
• 航空母舰：你可以配置跑道（飞行甲板），并使用专用武器发射舰载机；这些飞机可以自动飞行巡逻或攻击路线、返回基地并降落。
• 无人机、自主无人机和 CAS：使用注册棒和专用方块，任何载具都可以作为无人遥控单位（UAV）或自主 AI 驾驶无人机（TargetDrone）来操作。它还通过武器部署支援飞机来支持近距离空中支援（CAS）。

2. 如何创建扩展包（新载具）

添加新载具无需更改代码。请准备以下内容：1. 模型：assets/<namespace>/models/obj/<name>.obj（OBJ 格式；支持三角形、四边形或多边形）

1. 纹理：assets/<namespace>/textures/vehicle/<name>.png
2. 数据定义：data/<namespace>/vehicles/<name>.json

• entity_type：行为模型（tudursvehiclemod:car、helicopter、ship、submarine 或 aircraft 之一）
• model/texture：对上述步骤 1 和 2 中准备文件的引用
• 速度、碰撞箱、座位、武器、耐久和燃料等各种参数
• （可选）通过 weapons 指定武器，通过 spawn_item 指定生成物品，通过 hud 指定 HUD

1. 使用 /reload 在游戏中应用更改（无需重启）。*注意：建议重启以确保更改生效。

3. 其他说明

• 生成式 AI 的使用：本项目的代码和文档是使用 Anthropic 的生成式 AI“Claude”创建的。

＜日本語/Japanese＞

はじめに

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

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

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」を使用して作成されています。