Ultra Sprite Kaiju Battleground

# Ultra Sprite Kaiju Battleground

**Transform into Ultraman. Capture legendary kaiju. Wage epic monster battles across the universe.**

A comprehensive Minecraft mod featuring full Ultraman transformation, iconic skills, giant sprite-based monsters with unique mechanics, cosmic dimensions, and the ultimate monster battle system.

---

## ✨ Features

### 🦸 Ultraman Transformation System
- Transform via Beta Capsule (right-click), V-key, or automatic survival transformation
- Cinematic transformation animation with light particles and sound effects
- Energy system with 3-tier red light warnings (normal / 1.4x / 2x speed)
- Unity Level system — reduces energy cost, increases max HP and energy, boosts skill damage
- Dual-form survival mechanism (lock HP at 1, auto-transform / auto-de-transform)
- Post-transformation buffs: Night Vision I, Speed I, Resistance III, 100+ HP
- Complete immunity to arrows, fire, lava, and knockback resistance

### ⚡ Skill System (5 Customizable Slots)
- **Spacium Beam** — 3-tier charge-up, aim with view, screen shake, recoil, particle beam
- **Ultra Slash** — saw-blade disc projectile
- **Ultra Bind Halo** — AOE stun with flying ring animation
- **Ultra Water Gun** — extinguish fire, turn lava to obsidian, irrigate farmland
- **Miracle Ultra Spray** — heal allied mobs with white spray particles
- Fully customizable skill loadout via in-game panel (press G)

### 🚀 Flight System
- Normal flight / High-speed flight (Ctrl, with FOV change + trail particles)
- **Red Ball Mode** (Alt) — ultra-high-speed flight, particle sphere, invisibility, dimension travel
- Red Ball ground impact damage
- Dynamic FOV adjustment during flight

### 🌌 Dimensions
- **Cosmic Dimension** — pure black starfield, particle planets (Earth/Moon/Sun), no void damage, auto-enter at Y400
- **Moon Dimension** — regolith/moonrock/deep moonrock blocks, crater terrain, particle Earth background, vacuum suffocation
- Particle Earth/Moon/Sun with rotation, glow effects, and teleport triggers
- Dimension travel with spectator-mode protection (10 seconds)

### 👾 Monster Battle System (Core Feature)
- **Battlenizer** — capture, summon, control, and recall kaiju (up to 3 monsters)
- **7 Playable Monsters:**
  - **King Joe** — separation mechanic, destruction ray, Pedanium pull, separation ray
  - **Zetton** — 1-trillion-degree fireball, hexagonal barrier, beam absorption & reflection, teleport
  - **Gomora** — super vibration wave, tail sweep, dash, EX form (100% loyalty unlock)
  - **Doghead Beast** — 3-stage evolution, puppy bark/big dog bark, dog bite, mad dog rush
  - **Mecha Seven** — Emerium ray, Wide Shot, eye slugger, Ultra barrier
  - **Mecha Ace** — Metallium ray, Vertical Guillotine, Ultra Slash
  - **Mecha Zoffy** — M87 ray, bind halo, intelligent healing spray
- 5 customizable skill slots per monster
- Manual / Auto control modes
- 3 behavior modes: Aggressive / Passive / Defensive
- Loyalty system (petting, combat, death affect loyalty)
- Monster renaming and skin/costume system
- ECG HUD (HP + status + skill cooldown, draggable via H key)
- Target designation (B key), remote recall (Y key)
- Group hate linkage (minions/split parts share aggro)

### 🤖 Brother Tactics System
- Summon all 3 Mecha Ultra Brothers simultaneously
- Stat buffs: Armor 20, Speed 0.5, Regeneration II, Speed I
- AI division: melee/ranged rotation, low-HP ranged mode, Zoffy intelligent healing
- **Stage 2 Combo** — refresh all cooldowns → bind halo (10s stun) → triple beam barrage (10s)
- **Alt-key to switch main control** (old → auto, new → manual)
- Golden border UI (main HUD + 2 mini-HUDs showing all 3 brothers)
- Text prompts: "[These are our Ultra Brothers]" / "[Stronger than the real thing!]"

### 🎨 UI & UX
- Ultraman energy bar UI (bottom-left, draggable & savable via H key)
- Ultraman HP bar UI (blue bar style)
- Timer light UI (independent & draggable)
- Monster ECG UI (bottom-left, draggable & savable)
- Skill configuration panel (Ultraman + Monsters)
- Beta Capsule & Battlenizer tooltips (hover + Shift for details)
- Creative mode item tab

### 🔊 Sound Effects
- Transformation sound
- Spacium Beam (3 stages + loop)
- Ultra Slash
- Red light warnings (3 speeds)
- Red Ball mode

### 🔧 Compatibility
- Epic Fight mod integration (combat mode switching, skill integration)
- First Person mod integration
- Not Enough Animations mod integration

---

## 🎮 Controls

| Key | Action |
|-----|--------|
| **R** | Skill Slot 1 (customizable) |
| **F** | Skill Slot 2 (customizable) |
| **Z** | Skill Slot 3 (customizable) |
| **X** | Skill Slot 4 (customizable) |
| **C** | Skill Slot 5 (customizable) |
| **V** | Transform / De-transform (long press) |
| **L** | Ascend de-transform |
| **Alt** | Red Ball Mode (Ultraman) / Switch main control (Brother Tactics) |
| **K** | Dimension selection (in Red Ball mode) |
| **Ctrl** | High-speed flight |
| **G** | Skill configuration panel (Ultraman / Monsters) |
| **H** | UI edit mode (drag & save positions) |
| **B** | Designate monster target |
| **Y** | Remote recall monster |

**Note:** R/F/Z/X/C correspond to skill slots, not fixed skills. Customize your loadout in the skill configuration panel (press G).

---

## 📋 Requirements

- Minecraft 1.20.1
- Forge 47.4.23+
- Java 17
- **No mandatory dependencies!** (GeckoLib removed)

---

## 💡 Recommended Addons

For the best experience, we highly recommend:
- **Epic Fight** — combat mode switching, skill integration
- **First Person** — see Ultraman skin and animations in first-person
- **Not Enough Animations** — more player animations

奥特幻影怪兽大格斗

变身奥特曼，收服传说怪兽，在宇宙中展开史诗级怪兽大战。

✨ 功能特色

🦸 奥特曼变身系统

• 贝塔魔棒右键变身 / V 键变身 / 保命自动变身
• 电影级变身动画，光粒子特效 + 变身音效
• 能量系统，三档红灯警告（普通 / 1.4 倍速 / 2 倍速）
• 一心同体等级系统 —— 减少能耗、增加血量和能量上限、提升技能伤害
• 双形态保命机制（锁血 1 点，自动变身 / 自动解除）
• 变身后增益：夜视 I、速度 I、抗性 III、100 + 血量
• 完全免疫箭矢、火焰、岩浆，击退抗性

⚡ 技能系统（5 个可自定义技能槽）

• 斯派修姆光线 — 三档蓄力，随视角瞄准，屏幕震动，后坐力，粒子光束
• 八分光轮 — 锯片圆盘投掷，50 点伤害
• 奥特束缚光环 — AOE 范围定身，光圈飞行动画，5 秒禁锢
• 奥特水枪 — 灭火、岩浆变黑曜石、灌溉耕地
• 神奇的奥特喷雾 — 治疗友方生物，白色喷雾粒子
• 游戏内技能配置面板自由装配（按 G 键）

🚀 飞行系统

• 普通飞行 / 高速飞行（Ctrl 键，视场距变化 + 拖尾粒子）
• 红球模式（Alt 键）—— 超高速飞行，粒子球体，隐身，维度穿越
• 红球地面撞击伤害（周围生物 100 点伤害）
• 飞行中视场距动态调整

🌌 维度系统

• 宇宙维度 — 纯黑星空背景，粒子星球（地球 / 月球 / 太阳），无虚空伤害，Y400 自动进入
• 月球维度 — 月壤 / 月岩 / 深层月岩方块，陨石坑地形，粒子地球背景，真空窒息
• 粒子地球 / 月球 / 太阳，带自转、发光效果和传送判定
• 维度穿越自动旁观者模式保护（10 秒）

👾 大怪兽格斗系统（核心玩法）

• 格斗仪 — 捕捉、召唤、操控、收回怪兽（最多 3 只）
• 7 只可操控怪兽：
  • 金古桥 — 分体机制、破坏射线、佩丹尼姆牵引、分离怪光线
  • 芝顿 — 一兆度火球、六边柱屏障、光线吸收反弹、瞬移
  • 哥莫拉 — 超震动波、扫尾、冲刺、EX 形态（忠诚度 100 解锁）
  • 狗头兽 — 三阶段进化、小狗叫 / 大狗叫、大狗撕咬、疯狗突进
  • 机械赛文 — 艾梅利姆光线、集束射线、头标、奥特屏障
  • 机械艾斯 — 梅塔利姆光线、垂直断头刀、八分光轮
  • 机械佐菲 — M87 光线、束缚光环、智能治疗喷雾
• 每只怪兽 5 个可自定义技能槽
• 手动 / 自动双操控模式
• 三种行为模式：主动 / 被动 / 自保
• 忠诚度系统（抚摸、战斗、死亡影响忠诚度）
• 怪兽改名系统和皮肤 / 时装系统
• 心电图 UI（血量 + 状态 + 技能冷却，H 键拖动保存）
• 指定目标（B 键）、远程收回（Y 键）
• 群体仇恨联动（小怪 / 分体共享仇恨）

🤖 兄弟战法系统

• 同时召唤机械三兄弟
• 属性加成：护甲 20、移速 0.5、生命恢复 II、速度 I
• AI 分工：近战 / 迂回轮换，低血量迂回模式，佐菲智能治疗
• 二段连招 — 刷新全部冷却→束缚光环（10 秒禁锢）→三光线齐射（10 秒）
• Alt 键切换主控（原主控→自动，新主控→手动）
• 金色边框 UI（主 UI+2 个小 UI 显示三兄弟状态）
• 文字提示：「[这是我们的奥特兄弟]」/「[比真货更加强大！]」

🎨 UI 与体验

• 奥特曼能量条 UI（左下角，H 键拖动保存）
• 奥特曼血量条 UI（蓝条风格）
• 计时器灯 UI（独立可拖动）
• 怪兽心电图 UI（左下角，H 键拖动保存）
• 技能配置面板（奥特曼 + 怪兽）
• 贝塔魔棒信息显示（悬停 + Shift 查看详情）
• 格斗仪信息显示（怪兽状态 + Shift 查看详情）
• 创造模式物品栏分类

🔊 音效系统

• 变身音效
• 斯派修姆光线（三阶段 + 循环）
• 八分光轮
• 红灯警告（三档速度）
• 红球模式

🔧 兼容性

• 史诗战斗模组适配（战斗模式切换、技能联动）
• 更真实的第一人称模组适配
• 更多动画模组适配

🎮 按键说明

📋 需求

• Minecraft 1.20.1
• Forge 47.4.23+
• 无强制依赖！（已移除 GeckoLib）
• 强烈建议加上更多动画、更真实的第一人称、史诗战斗。