Описание
# TurretCraft【cz】 (English)
TurretCraft is a **Minecraft Forge 1.20.1** turret mod featuring multiple turret types, smart auto-targeting with a **spherical range (includes vertical distance)**, an ammo GUI with mode toggles, and smooth aim/fire animations (turret yaw rotation, barrel pitch elevation, and recoil). Turret textures include a subtle **【cz】** nameplate.
---
## ✅ Features
- **Multiple turret types**: Arrow / Gatling / Poison / Fire / Lightning / Frost / Cannon (varies by version)
- **Animations**: Aim (Yaw/Pitch) + Recoil
- **Spherical targeting range**: Range is calculated like a sphere (vertical distance included)
- **Cannon**: Explosion damages entities only (no block grief)
- **GUI**: Load ammo, view ammo count, toggle targeting mode, unload ammo
---
## 🏹 Arrow Turret: supports many arrow types
The Arrow Turret can use various arrows such as normal arrows, spectral arrows, tipped arrows (effects preserved), and most modded arrows that extend `ArrowItem`.
---
## 📥 Installation
1. Install Minecraft Java **1.20.1**
2. Install Forge **1.20.1 (47.x)**
3. Put `TurretCraft-1.20.1-1.0.0.jar` into:
- Windows: `%appdata%\.minecraft\mods`
4. Launch with **Forge 1.20.1** → check **Mods** menu for TurretCraft
---
## ⚙️ How to use
- Right-click a turret to open the GUI
- Put ammo into the **ammo slot** to load it into the turret storage
- Use GUI buttons to toggle targeting mode and unload ammo
- Turrets automatically attack targets within the spherical range
(Very close targets directly below may be ignored to avoid self-collision; anywhere the barrel can aim at should be valid.)
---
## 📌 Requirements
- Minecraft **1.20.1**
- Forge **47.x**
- Java **17**
- Dependencies: **None**
---
## Copyright / Notes
This mod is an original implementation and includes a **【cz】** nameplate on textures. If you spot suspicious re-uploads or mirrors, please report them via your feedback/issue channel with a link.
---
# TurretCraft【cz】（中文）
TurretCraft 是一个面向 **Minecraft Forge 1.20.1** 的炮台模组：多种炮台、智能索敌、**球形攻击半径（含上下高度）**、GUI 装填与模式切换，并带有“炮塔头旋转 + 炮管俯仰 + 后坐力”的瞄准/发射动画。炮台贴图带【cz】铭牌。
---
## ✅ 主要特性
- **多种炮台**：箭炮台 / 机枪炮台 / 毒镖 / 火焰 / 雷电 / 寒冰 / 加农（以版本为准）
- **动画**：瞄准（Yaw/Pitch）+ 发射后坐力（Recoil）
- **球形范围**：范围像“圆/球”一样计算，**上下也算**
- **加农炮**：爆炸只伤害实体，不破坏方块
- **GUI**：装填弹药、查看弹量、切换索敌模式、卸载弹药
---
## 🏹 箭炮台：支持多种箭
箭炮台可装载多种箭（例如普通箭、光灵箭、药箭，并保留效果；多数模组的 `ArrowItem` 也可使用）。
---
## 📥 安装
1. 安装 Minecraft Java **1.20.1**
2. 安装 Forge **1.20.1（47.x）**
3. 将 `TurretCraft-1.20.1-1.0.0.jar` 放入：
- Windows：`%appdata%\.minecraft\mods`
4. 使用 **Forge 1.20.1** 启动游戏 → 主菜单 **Mods** 中看到 TurretCraft 即成功
---
## ⚙️ 使用方法
- 右键炮台打开 GUI
- 把弹药放入 **弹药槽** 装填（会进入炮台弹仓）
- GUI 可切换索敌模式、卸载弹药
- 炮台会在球形半径内自动攻击目标
（正下方极近距离可能不攻击以避免撞到自身；炮管能瞄到的位置应可正常开火）
---
## 📌 需求
- Minecraft **1.20.1**
- Forge **47.x**
- Java **17**
- 依赖：**无**
---
## 版权 / 说明
本模组为原创实现，炮台贴图含【cz】铭牌。如发现疑似盗传/镜像发布，请在反馈渠道附链接提交。
---
# TurretCraft【cz】（日本語）
TurretCraft は **Minecraft Forge 1.20.1** 向けのタレットMODです。複数種類のタレット、**上下を含む球形レンジ**での自動索敵、弾薬GUIとモード切替、そして「旋回（Yaw）＋俯仰（Pitch）＋リコイル」のエイム/発射アニメーションを搭載しています。タレットのテクスチャには控えめな **【cz】** 銘板があります。
---
## ✅ 特徴
- **複数のタレット**：矢 / ガトリング / 毒 / 炎 / 雷 / 氷 / 砲（バージョンにより変動）
- **アニメーション**：エイム（Yaw/Pitch）＋リコイル
- **球形レンジ**：範囲は球として計算（上下方向も含む）
- **砲タレット**：爆発はエンティティのみ（ブロック破壊なし）
- **GUI**：弾薬装填、残弾表示、ターゲット切替、弾薬取り出し
---
## 🏹 矢タレット：さまざまな矢に対応
通常の矢、スペクトラルの矢、ポーション効果付きの矢（効果保持）に加え、多くの MOD 追加矢（`ArrowItem`）にも対応します。
---
## 📥 導入方法
1. Minecraft Java **1.20.1** を用意
2. Forge **1.20.1（47.x）** を導入
3. `TurretCraft-1.20.1-1.0.0.jar` を以下へ入れる：
- Windows：`%appdata%\.minecraft\mods`
4. **Forge 1.20.1** で起動 → Mods メニューで TurretCraft を確認
---
## ⚙️ 使い方
- タレットを右クリックして GUI を開く
- **弾薬スロット**に弾薬を入れて装填（タレット内に格納）
- GUI でターゲットモード切替／弾薬取り出し
- 球形レンジ内の対象を自動攻撃
（真下の至近距離は自己衝突回避のため攻撃しない場合がありますが、砲身が狙える範囲は攻撃対象になります）
---
## 📌 必要環境
- Minecraft **1.20.1**
- Forge **47.x**
- Java **17**
- 依存：**なし**
---
## 著作 / 注意
本MODはオリジナル実装で、テクスチャに【cz】銘板があります。転載は禁止アップロード等を見つけた場合は、リンク付きで報告してください。