Skip to content

pnmcguire480/STARS-2026

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

41 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒŒ STARS 2026

The legendary 1995 4X strategy game Stars! โ€” reborn for the modern web.

Browser-native ยท Deterministic ยท Multiplayer-ready ยท Mobile-bound

Status Stack Frontend License PRs Welcome

A clean-room remake of the classic space 4X. No emulators. No Windows 3.1. No DOSBox tricks. Just open a tab and conquer the galaxy.


๐Ÿš€ What is STARS 2026?

STARS 2026 is an open-source, IP-clean, modern reimagining of Stars! โ€” the cult-classic 4X turn-based strategy game by Jeff Johnson and Jeff McBride (Empire Interactive, 1995). Considered by many veterans to be the deepest 4X ever made, the original has been trapped on 16-bit Windows for three decades. We're freeing it.

๐Ÿ’ก Same legendary gameplay. All-original code. Every PRT, every LRT, every formula faithfully recreated from public documentation. Designed to run anywhere a browser lives.

Why this exists

  • ๐Ÿšซ The original Stars! is abandonware that won't run on modern 64-bit Windows without arcane hacks
  • ๐Ÿ“ฑ No mobile version exists โ€” anywhere
  • ๐Ÿ’€ Every existing clone (craig-stars, Stars Nova, FreeStars, Thousand Parsec) is incomplete or stalled
  • โณ The classic PBEM async multiplayer model takes weeks per game in 2026
  • ๐ŸŽฏ The Stars! community has been waiting 30 years for a proper remake

STARS 2026 fixes all of it.


โœจ Features

v0.1 โ€” Core (in progress)

  • ๐ŸŒ  Procedural galaxy generation โ€” Tiny to Huge, deterministic seeds
  • ๐Ÿงฌ Race designer โ€” Primary Racial Traits + Lesser Racial Traits, point-balanced
  • ๐Ÿช Planet colonization โ€” habitability, terraforming, mining, production queues
  • ๐Ÿ”ฌ 6-field tech tree โ€” Energy, Weapons, Propulsion, Construction, Electronics, Biotech
  • ๐Ÿšข Ship designer โ€” hull + components โ†’ derived stats
  • โš”๏ธ Tactical combat โ€” beams, torpedoes, shields, armor, the canonical Stars! battle resolution
  • ๐ŸŽฏ AI opponents โ€” rule-based, faithful, never cheats
  • ๐Ÿ’พ Browser saves โ€” IndexedDB, instant load
  • ๐Ÿ‘ฅ Hotseat multiplayer โ€” local, no server needed
  • ๐ŸŽฎ Faithful 1995 pixel art at modern resolution

v0.2 โ€” Networked Multiplayer

  • ๐ŸŒ 1โ€“16 players per game (any mix human + AI)
  • โšก Speed modes: Blitz (5 min) ยท Daily (24 hr) ยท Marathon (72 hr)
  • ๐Ÿค– AI takeover on missed deadlines โ€” you never get booted from a game
  • ๐Ÿ–๏ธ Vacation mode โ€” pause your empire safely, immune to attack
  • ๐Ÿ”„ Substitute players โ€” drop-in replacement for abandoned empires
  • ๐Ÿ“ฒ Push notifications โ€” Web Push, FCM, APNs
  • ๐Ÿ” Determinism gate โ€” server and client produce byte-identical state, every turn

v0.3 โ€” Everywhere

  • ๐Ÿ“ฑ iOS & Android via Capacitor
  • ๐Ÿ–ฅ๏ธ Native desktop via Tauri (Windows ยท macOS ยท Linux)
  • โ˜๏ธ Offline-first single-player

v1.0 โ€” Full Game

  • ๐ŸŽญ All 10 Primary Racial Traits + complete LRT roster
  • ๐Ÿ’ฃ Minefields & ๐Ÿš€ Mass Driver Packets
  • ๐Ÿ† Balance pass verified across 1000 AI matches
  • ๐ŸŽจ Final art by hand, in Aseprite

Forever

  • ๐Ÿ“ฆ DLC framework โ€” new races, hulls, scenarios ship as data/*.json + sprite packs. Engine never forks.

๐Ÿ—๏ธ Tech Stack

One Rust engine. Two compile targets. Identical bits.

Layer Choice Why
Game engine ๐Ÿฆ€ Rust Determinism, performance, single source of truth
Browser delivery ๐Ÿ•ธ๏ธ WebAssembly (wasm-bindgen + wasm-pack) Native browser speed, no plugin
Multiplayer server (v0.2) ๐Ÿฆ€ Same Rust crate, native target + Axum Byte-identical determinism client โ†” server
Frontend โšก SvelteKit + TypeScript Fast, modern, small bundles
Styling ๐ŸŽจ Tailwind CSS Rapid iteration
Galaxy renderer ๐Ÿ–ผ๏ธ HTML5 Canvas Pixel-perfect 2D
Local saves ๐Ÿ’พ IndexedDB Browser-native, offline
Multiplayer DB ๐Ÿ˜ PostgreSQL + Redis State + realtime fanout
Mobile (v0.3) ๐Ÿ“ฑ Capacitor iOS + Android from one codebase
Desktop (v0.3) ๐Ÿ–ฅ๏ธ Tauri Rust-native shell
Build ๐Ÿ“ฆ Cargo + โšก Vite Standard
Test ๐Ÿงช cargo test + Vitest + Playwright Unit ยท Component ยท E2E
Art ๐ŸŽจ Aseprite Pixel art standard

๐Ÿ“– Full technical details: SPEC.md ยท ARCHITECTURE.md


๐ŸŽฏ Project Status

๐ŸŒฟ Phase 0: Skeleton (complete)

  • โœ… 10 governance documents
  • โœ… Cargo workspace + engine crate (sentinel test green)
  • โœ… SvelteKit frontend scaffold (svelte-check clean)
  • โœ… Git history initialized

๐ŸŒฑ Phase 1: Engine Foundation (next)

  • โณ Type system, RNG, galaxy generator, race system

๐Ÿ›ฃ๏ธ Roadmap

Version Scope ETA
v0.1 Single-player + hotseat, core loop, deterministic engine TBD
v0.2 Networked multiplayer 1โ€“16 players, speed modes, AI takeover After v0.1
v0.3 Capacitor mobile + Tauri native desktop After v0.2
v1.0 Full 10 PRTs + LRTs + minefields + packets + final art After v0.3
DLC New races, hulls, scenarios via data packs Ongoing

๐Ÿงญ Design Principles

  1. Faithful, not slavish โ€” same gameplay, modernized UX, zero changes to combat math
  2. Determinism is law โ€” same seed + same orders = byte-identical outcome
  3. Sniff test after every function โ€” no shortcuts, no batching, no "I'll test it later"
  4. Clean room โ€” formulas sourced from public FAQ/wiki only, never decompiled binaries
  5. No microtransactions, no AI art, no Web3, no real-time mode โ€” ever

๐Ÿ“– Read the full design doctrine โ†’


๐Ÿค Contributing

We're in Phase 0. Issues, ideas, and Stars! veterans welcome.

  • ๐Ÿ“‹ SPEC.md โ€” full functional spec
  • ๐Ÿ›๏ธ ARCHITECTURE.md โ€” system design
  • ๐Ÿงช SCENARIOS.md โ€” holdout test scenarios
  • ๐Ÿ“ CODEGUIDE.md โ€” Rust + TypeScript conventions
  • ๐Ÿ” SNIFFTEST.md โ€” the mandatory test protocol
  • ๐ŸŽจ ART.md โ€” pixel art bible
  • ๐Ÿ‘ฅ AGENTS.md โ€” the specialist council

Stars! veterans: if you remember the canonical formulas, open an issue โ€” we'd love your knowledge.


๐Ÿ”— Reference Material

External references โ€” studied, never copied:


โ“ FAQ

Is this legal?

Yes. STARS 2026 is a clean-room implementation. Zero original code is used. All formulas come from publicly documented community sources (FAQ, wiki, manuals, decades of forum discussion). No binaries are decompiled. No assets are extracted.

Will it run on my phone?

That's the goal. v0.1 targets desktop browsers. v0.3 ships iOS + Android via Capacitor.

Why Rust + WASM instead of Go like craig-stars?

Two reasons: (1) the same Rust crate compiles to both browser WASM and native multiplayer server, guaranteeing byte-identical determinism. (2) Rust's type system makes it nearly impossible to accidentally introduce non-determinism into game logic.

How is this different from craig-stars?

craig-stars is excellent and we respect it deeply. Differences: (1) different language stack (Rust vs Go), (2) browser-first architecture, (3) mobile-bound from day one, (4) hard determinism contract from line one of the engine, (5) multiplayer designed around modern async/notifications instead of PBEM.

Will my single-player saves work in multiplayer?

No โ€” they're different game types. But the engine is the same code, so a single-player game has the exact same physics as a multiplayer one.

How can I help right now?

Star the repo. Watch for v0.1. If you played the original and remember a formula, file an issue. If you draw pixel art, watch ART.md.


๐Ÿ“œ License

TBD โ€” will be a permissive open-source license (MIT or Apache 2.0) confirmed before v0.1 release.

โš ๏ธ Not Affiliated

STARS 2026 is not affiliated with, endorsed by, or derived from the source code of the original Stars! by Jeff Johnson, Jeff McBride, or Empire Interactive / indiePub Entertainment. It is a clean-room implementation based on publicly documented gameplay mechanics. Stars! is a trademark of its respective owners.


๐ŸŒŸ If you played the original, you know why this matters. ๐ŸŒŸ

โญ Star the repo ยท ๐Ÿ‘๏ธ Watch for v0.1 ยท ๐Ÿฆ Share with your old PBEM crew

Built with love by @pnmcguire480 ยท Powered by Rust ๐Ÿฆ€ + SvelteKit โšก

stars-game stars-1995 4x-strategy space-strategy turn-based-strategy webassembly rust sveltekit space-4x pbem remake clean-room open-source-game browser-game pixel-art

About

๐ŸŒŒ Modern reimagining of Stars! (1995) โ€” the legendary 4X space strategy game. Browser-native, deterministic, multiplayer-ready. Built with Rust + WASM + SvelteKit.

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages