Skip to content

Latest commit

 

History

History
107 lines (68 loc) · 3.56 KB

File metadata and controls

107 lines (68 loc) · 3.56 KB

Airship Zero

A pixel-perfect, steampunk airship simulator and minigame collection. Fly, manage, explore, and write your own story—all in a cozy, retro world.


🚀 Quickstart

Install python 3.12 (or greater) and UV package manager, then install and run:

uv tool install git+https://github.com/TimelessP/timeless-as0
airshipzero

What is Airship Zero?

  • Fly a classic airship with realistic physics and beautiful retro visuals.
  • Manage every system: engines, fuel, navigation, cargo, and more.
  • Play minigames: cargo winch, map navigation, and more to come.
  • Read and write books: discover lore, keep a journal, or edit manuals in-game.
  • Pixel-perfect UI: Everything is designed for a 320x320 logical screen, scaling up crisp and clean.

🖥️ Scenes & Activities

  • Main Menu: Start, resume, or update your adventure.
  • Bridge: Pilot your airship, use autopilot, and monitor instruments.
  • Engine Room: Tweak throttle, mixture, and propeller for best performance.
  • Navigation: Explore the world map, set waypoints, and track your journey.
  • Fuel Management: Balance tanks, transfer fuel, and keep your engines running.
  • Cargo Bay: Physics-based winch minigame—move crates, balance loads, and master the hold.
  • Library: Browse, read, and edit in-game books and your own journal.
  • Book Reader & Editor: Markdown support, pixel font, and a cozy writing space.
  • Update: Check for new versions right from the game.

✍️ Write Your Own Story

  • The player gets their own personal in-game library.
  • Write, edit, and save your own books and journals.
  • Books that you edit are saved to Documents/AirshipZero/books/ folder in your Home folder.
  • All books are simple Markdown files—easy to share or back up.

🎮 Controls

  • Tab / Shift+Tab: Move focus between UI elements
  • Enter / Space: Activate buttons
  • Arrow Keys: Scene-specific controls (flight, map, cargo, etc.)
  • Escape: Return to menu (auto-saves your game)
  • Mouse: Click, drag, and scroll everywhere

📸 Screenshots

Observatory Navigation Book reader

More screenshots...


💾 Save System

  • Auto-saves on menu and exit
  • One save slot only
  • Save file is portable and cross-platform

🛠️ Requirements


☕ Support the Project

Creating Airship Zero has been an incredible technical adventure - from building a complete 3D terrain system in Pygame to implementing realistic physics and atmospheric effects. If you enjoy flying through our pixel-perfect world, consider supporting continued development:

Buy Me a Coffee

Every contribution helps fund new features, performance improvements, and keeping this passion project alive. Thank you for being part of the Airship Zero community! 🚀✨


❤️ Community & Contributing

  • Fork the project and check out CONTRIBUTORS.md for dev setup, coding style, and more.
  • All are welcome—whether you want to code, write, or just fly!

Ready to take off? Run airshipzero and start your adventure!

Licence

MIT Licence