What's New in 1.0.10

• Console instruction editor — right-click the control console to open a card-based instruction editor. Compose rows of actions, parameter overrides, and text, then bind each card to a redstone signal condition on either side.

• Three row modes — Action (drive the balloon: forward, back, ascend, descend, turn), Config (override lift / speed / turn rate / gyro per matching signal), and Text (show a subtitle on screen when the signal fires).

• Redstone signal matching — each card triggers on the left or right signal with an exact value, an interval, or any non-zero strength; left/right rules are mirrored to match the physical redstone inputs on the console.

Thanks for waiting！

What's New in 1.0.9

• Physics force overhaul — lift and propulsion now use tuned P-control impulse forces on the physics tick, replacing the old lift/drag system for smooth, predictable altitude control.
• Gyro yaw damping — automatic suppression of spontaneous structure rotation around the Y axis. Automatically pauses during player A/D turning. Configurable via the new GUI (0–50 strength).
• Config GUI — press V+E to open a live configuration panel. Adjust lift power, horizontal speed, turn rate, gyro strength, and yaw damping with sliders.
• Inflated wool blocks — 16 dye colors. Craft wool into inflated wool, press it back into regular wool, or dye it with dye items.

What's New in 1.0.8

• Drag speed cap — fixed the issue where small structures would disappear when quickly dragging them with the physical staff

What's New in 1.0.7p3

• CC:Tweaked native API — call balloon.ascend() directly from any computer on a Sable structure. No peripheral.wrap() or peripheral.find() required. Old peripheral approach still works for backward compatibility.

• getHeight() added — returns the Y coordinate of the first balloon on the structure.

• Gyroscope angular impulse cap — prevents PD controller runaway on tiny structures (< 20 mass). Restoring and damping torque combined magnitude clamped to mass × 0.5 per tick. Large structures unaffected.

• Debug logging overhaul —

  • Session archive naming uses readable timestamps (debug-2026-07-03_15-30-00.log).
  • latest-debug.log — tail view of current session (last 5000 lines), crash-safe, always the file you check first.
  • latest-debug-throttled.log — same tail view but PHY entries throttled to 1 Hz for quick browsing.
  • Full per-session log written to timestamped archive (never deleted, never truncated).

• Example scripts updated — all use new native API syntax. balloon_test_all.lua added for full API testing.

• HotAirBalloonBlock entity state cleanup — movement flags now reset on controller stop/remove.

• CC:Tweaked Usage

Both approaches work. Choose whichever you prefer:

-- New: native global API (works from any computer on the structure)
balloon.ascend()
balloon.descend()
balloon.hover()
balloon.forward()
balloon.back()
balloon.turnLeft()
balloon.turnRight()
balloon.stop()
balloon.count()
balloon.isActive()
balloon.getHeight()

-- Old: peripheral wrapping (backward compatible, computer next to balloon/controller)
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()
-- Note: getHeight() is native API only

-- Create Balloon CC API Test
-- Put on Sable 

print("==== Create Balloon API Test ====")
print()

-- 1. count / getHeight / isActive
local n = balloon.count()
local h = balloon.getHeight()
local a = balloon.isActive()
print(string.format("[STATUS] balloons=%d  height=%d  active=%s", n, h, tostring(a)))
if n == 0 then
    error("No balloons found on this structure. Place balloon blocks first.")
end

-- 2. ascend
print("[TEST] ascend()")
balloon.ascend()
sleep(3)
print("  height after 3s: " .. balloon.getHeight())

-- 3. hover
print("[TEST] hover()")
balloon.hover()
sleep(3)
print("  height after 3s: " .. balloon.getHeight())

-- 4. descend
print("[TEST] descend()")
balloon.descend()
sleep(3)
print("  height after 3s: " .. balloon.getHeight())

-- 5. forward
print("[TEST] forward()")
balloon.forward()
sleep(2)
balloon.hover()
print("  moved forward 2s")

-- 6. back
print("[TEST] back()")
balloon.back()
sleep(2)
balloon.hover()
print("  moved back 2s")

-- 7. turnLeft
print("[TEST] turnLeft()")
balloon.turnLeft()
sleep(2)
balloon.hover()
print("  turned left 2s")

-- 8. turnRight
print("[TEST] turnRight()")
balloon.turnRight()
sleep(2)
balloon.hover()
print("  turned right 2s")

-- 9. stop
print("[TEST] stop()")
balloon.stop()
sleep(1)
print("  active: " .. tostring(balloon.isActive()))

-- 10. hover -> ascend -> stop cycle
print("[TEST] ascend→hover→stop cycle")
balloon.ascend()
sleep(2)
balloon.hover()
sleep(1)
balloon.stop()
sleep(1)
print("  all stopped")

print()
print("==== All tests passed ====")
print(string.format("  final: balloons=%d  height=%d  active=%s",
    balloon.count(), balloon.getHeight(), tostring(balloon.isActive())))

What's New in 1.0.7p2

• WASD directional control — controller supports W (forward), S (back), A (turn left), D (turn right) in addition to Space (ascend) and V (descend). Like Valkyrien Skies / Eureka.
• Config organized — sections for Lift, Gyroscope, Movement, Debug with usage warnings.
• gyroStrength config — adjust stabilization strength (0.1-5.0, default 1.5). Warning: >2.0 may cause instability.
• moveSpeed / turnSpeed config — horizontal speed (default 1.0) and rotation speed (default 0.5). Warning: turnSpeed >1.0 may cause uncontrollable spinning.
• Controller also acts as CC:Tweaked peripheral — place computer next to controller (not just balloon) to control all balloons on the structure.
• CC:Tweaked API expanded — forward(), back(), turnLeft(), turnRight() added.
• baseKpg marked "not recommended to change" — empirically tuned for Sable.

• CC:Tweaked Usage

-- Place computer next to a balloon block or controller block
local b = peripheral.find("balloon")
-- Vertical
b.ascend()       -- rise
b.descend()      -- fall
b.hover()        -- hold altitude
-- Horizontal
b.forward()      -- go (controller facing direction)
b.back()         -- reverse
-- Rotation
b.turnLeft()     -- rotate counter-clockwise
b.turnRight()    -- rotate clockwise
-- Stop & info
b.stop()         -- stop all movement
b.count()        -- balloon count on structure
b.isActive()     -- whether any control is active

What's New in 1.0.7p1

• Create: Aeroworks gyroscope compatibility — automatically disables the balloon's gyro when a Create: Aeroworks gyroscope is active on the same structure, and re-enables it when the Create: Aeroworks gyro stops. No config needed, fully automatic.
• Full block collision — balloon blocks now use a full cube hitbox (was 12x14x12)
• Drive-By-Wire crash fix — DBW signals now use reflection, no crash when DBW is not installed
• Gyro toggle config — gyroEnabled in create_balloon-common.toml

What's New

• Crafting recipes — craft balloons from Aeronautics envelopes, dye them any color, wash clean with fans, press back into envelopes, or inflate with a Deployer holding a bucket or glass bottle
• Controller recipe rebalanced — now requires White Sail + Shaft + Brass Sheet
• Gyro toggle — gyroEnabled config option to enable/disable gyroscope stabilization
• Config cleanup — removed landHoldTime (hardcoded to 1 second)
• Fixed colored balloon item names — now correctly display color prefixes in inventory

Recipes (97 total)

Credits

Gyro stabilization adapted from Create: Aeroworks by mred231 (MIT License, v1.2.10).

What's New

• Drive-By-Wire support — controllers now respond to Drive-By-Wire wire signals (ascend/descend)
• Colored balloon items — all 16 dye colors available directly from the creative inventory, with proper models and localized names. Colored items place the corresponding colored block.
• 12 languages — en_us, en_gb, ru_ru, hi_in, de_de, fr_fr, es_es, pt_br, ja_jp, ko_kr, zh_cn, zh_tw. Non-English translations are machine-generated and may contain errors.

Credits

Gyro stabilization adapted from Create: Aeroworks by mred231 (MIT License, v1.2.10).