Skip to content

TimelessP/timeless-as0

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

251 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

An airship simulation game.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors