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.

Configuration (config/create_balloon-common.toml)

Section	Key	Default	Description
Lift	liftForce	100.0	Lift capacity per balloon (kpg)
Lift	baseKpg	0.2597	Gravity compensation (empirically tuned)
Lift	ascendSpeed	1.0	Ascend speed bonus
Lift	descendSpeed	1.0	Descend speed reduction
Gyroscope	gyroEnabled	true	Enable gyro stabilization
Gyroscope	gyroStrength	3.0	Stabilization multiplier
Movement	moveSpeed	1.0	Horizontal movement speed
Movement	turnSpeed	0.5	Rotation speed
Debug	logLevel	SIMPLE	OFF / SIMPLE / DETAILED

Debug Logging

• create-balloon-logs/latest-debug.log — last 5000 lines of current session (check this after a crash).
• create-balloon-logs/latest-debug-throttled.log — same but PHY throttled to 1 Hz.
• Full session logs archived as create-balloon-logs/debug-YYYY-MM-DD_HH-MM-SS.log.

---

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
CC:Tweaked	1.0+	Optional
Drive-By-Wire	0.2.9+	Optional
Aeroworks	1.2.10+	Optional

---

License

MIT