Create Balloon

This mod is completely completed by AI.

---

Hot air balloons for Create × Create: Aeronautics.

Add craftable, flyable balloon blocks that provide lift, stabilization, and movement to your Sable physics structures. Pilot them with WASD controls, automate them with CC:Tweaked, or integrate them into redstone & Drive-By-Wire automation.

---

Features

Hot Air Balloon Block

• 16 dyeable colors — right-click with dye to recolor. Triple-click dyes a 17×17×17 radius.
• Produces physics-based lift via Sable — scales with altitude (exponential decay above Y=62).
• PD-controller gyroscope keeps structures upright during flight (adapted from Aeroworks).
• Multi-balloon support — place many balloons on one structure, they share the load. First balloon acts as primary for physics calculations.
• 97 crafting recipes: envelope conversion, dye crafting, Create pressing/washing/deploying.
• Supports hot air balloons as the original aeronautics.

Balloon Controller

• Right-click to take control. Space = ascend, V = descend, WASD = move and turn, Shift = exit.
• Auto-land detection — stops control when all balloons settle on the ground for 1 second.
• Redstone input support via block left/right sides.
• Optional Drive-By-Wire signal integration.

CC:Tweaked Integration (optional)

• Both peripheral and native API approaches supported.(Check the changelog for 1.0.7p2 and p3 for specific example code)
• Native: balloon.ascend() works from any computer on the structure — no wrapping needed.
• 11 Lua functions: ascend, descend, hover, forward, back, turnLeft, turnRight, stop, count, isActive, getHeight.

---

Getting Started

1. Craft a Balloon Controller (White Sail + Shaft + Brass Sheet on a Crafting Table).
2. Obtain balloons — craft Aeronautics envelopes into balloon blocks, then dye them with any dye.
3. Build a structure — place balloons on a Sable physics structure (use Create: Aeronautics to assemble).
4. Place the Controller anywhere on the same structure.
5. Right-click the Controller to take control.
6. Fly — Space to ascend, V to descend, WASD to move, Shift to exit.
7. Optional — place a CC:Tweaked computer on the structure and run a Lua script for automation.

---

CC:Tweaked API

Native global API (recommended):

balloon.ascend()
balloon.descend()
balloon.hover()
balloon.forward()
balloon.back()
balloon.turnLeft()
balloon.turnRight()
balloon.stop()
balloon.count()
balloon.isActive()
balloon.getHeight()

Legacy peripheral API (backward compatible):

local b = peripheral.find("balloon")
b.ascend()
b.descend()
b.hover()
b.forward()
b.back()
b.turnLeft()
b.turnRight()
b.stop()
b.count()
b.isActive()

---

Dependencies

Mod	Version	Required
NeoForge	21.1.226+	Yes
Minecraft	1.21.1	Yes
Create	6.0.10+	Yes
Create: Aeronautics Bundled	1.1.3+	Yes
Sable	1.1.3+	Yes

---

License

MIT