A terminal (TUI) space trading game in Java, continuing SpaceTrader for Java with a Lanterna interface (GPL-3.0-or-later)
See the codeSee what people are saying
README
___ ___ _____
| _ ) __|_ _|
| _ \__ \ | |
|___/___/ |_|
Beyond
Space Trader
Beyond Space Trader
A Java port of the classic Palm OS game Space Trader, played entirely in a terminal with a Lanterna UI and structured around Model-View-Presenter. Trade between star systems, upgrade your ship, take on quests, dodge pirates and police, and try to retire to your own moon in Utopia.
🎮 Download and play (no Java needed)
- Open the latest release
and download the zip for your system:
BeyondSpaceTrader-Linux.ziporBeyondSpaceTrader-Windows.zip. - Unzip it anywhere: the package carries its own trimmed runtime.
- Run it:
- Linux/macOS:
./bin/beyond-space-trader.sh - Windows:
bin\beyond-space-trader.bat
- Linux/macOS:
# To play in Spanish (English is the fallback):
./bin/beyond-space-trader.sh --lang es
The game needs a terminal of at least 60×15 (100×30 or more is recommended; 120×30 fits the encounter scene comfortably).
📖 Documentation
- User Manual: English · Español
- Cheat sheet: English · Español
- Online documentation: https://antoniovazquezaraujo.github.io/beyond-space-trader/
- Developer documentation: docs/developer/README.md (architecture, ship art, encounters, design and release process; the technical guides are in English and the ADRs in Spanish).
🛠️ Build from source
Requires JDK 17 and Maven 3.9+.
mvn package # build the jar
./run.sh # build and run the terminal UI
./run.sh --lang es # ... and start it in Spanish
mvn -B -ntp -Pquality verify # tests + SpotBugs (what CI runs)
mvn clean package -DskipTests # self-contained package in output/BeyondSpaceTrader
run-fixed-font.sh is a development helper that starts the game in a terminal
with a fixed monospace font (kitty, xfce4-terminal or alacritty), so the charts
keep their proportions whatever the desktop font is.
🧭 Status
Work in progress, and playable: the whole UI runs on Lanterna, the model is decoupled from the views through presenters and the releases ship standalone packages for Linux and Windows. The roadmap lives in the developer documentation.
🧾 Provenance
This repository starts from the upstream snapshot spacetraderjava-code-r69
(tag upstream-r69). The old Swing/JWinForms front-end was removed in the
Lanterna port and is preserved under the tag swing-final. See the
NOTICE file for the full provenance chain:
- Original game: Space Trader (Palm OS), by Pieter Spronck, with artwork by Alexander Lawrence.
- Windows port: Space Trader for Windows, by Jay French, with additional coding by David Pierron; original coding by Pieter Spronck, Sam Anderson, Samuel Goldstein and Matt Lee.
- Java port: SpaceTrader for Java, by Aviv Eyal and contributors (the upstream snapshot this repository continues).
⚖️ License
GNU General Public License v3.0 or later (GPL-3.0-or-later). See
LICENSE for the license text and NOTICE for the upstream
copyright and provenance chain.
Similar repos
A terminal (TUI) space trading game in Java, continuing SpaceTrader for Java with a Lanterna interface (GPL-3.0-or-later)
See the codeSee what people are saying
README
___ ___ _____
| _ ) __|_ _|
| _ \__ \ | |
|___/___/ |_|
Beyond
Space Trader
Beyond Space Trader
A Java port of the classic Palm OS game Space Trader, played entirely in a terminal with a Lanterna UI and structured around Model-View-Presenter. Trade between star systems, upgrade your ship, take on quests, dodge pirates and police, and try to retire to your own moon in Utopia.
🎮 Download and play (no Java needed)
- Open the latest release
and download the zip for your system:
BeyondSpaceTrader-Linux.ziporBeyondSpaceTrader-Windows.zip. - Unzip it anywhere: the package carries its own trimmed runtime.
- Run it:
- Linux/macOS:
./bin/beyond-space-trader.sh - Windows:
bin\beyond-space-trader.bat
- Linux/macOS:
# To play in Spanish (English is the fallback):
./bin/beyond-space-trader.sh --lang es
The game needs a terminal of at least 60×15 (100×30 or more is recommended; 120×30 fits the encounter scene comfortably).
📖 Documentation
- User Manual: English · Español
- Cheat sheet: English · Español
- Online documentation: https://antoniovazquezaraujo.github.io/beyond-space-trader/
- Developer documentation: docs/developer/README.md (architecture, ship art, encounters, design and release process; the technical guides are in English and the ADRs in Spanish).
🛠️ Build from source
Requires JDK 17 and Maven 3.9+.
mvn package # build the jar
./run.sh # build and run the terminal UI
./run.sh --lang es # ... and start it in Spanish
mvn -B -ntp -Pquality verify # tests + SpotBugs (what CI runs)
mvn clean package -DskipTests # self-contained package in output/BeyondSpaceTrader
run-fixed-font.sh is a development helper that starts the game in a terminal
with a fixed monospace font (kitty, xfce4-terminal or alacritty), so the charts
keep their proportions whatever the desktop font is.
🧭 Status
Work in progress, and playable: the whole UI runs on Lanterna, the model is decoupled from the views through presenters and the releases ship standalone packages for Linux and Windows. The roadmap lives in the developer documentation.
🧾 Provenance
This repository starts from the upstream snapshot spacetraderjava-code-r69
(tag upstream-r69). The old Swing/JWinForms front-end was removed in the
Lanterna port and is preserved under the tag swing-final. See the
NOTICE file for the full provenance chain:
- Original game: Space Trader (Palm OS), by Pieter Spronck, with artwork by Alexander Lawrence.
- Windows port: Space Trader for Windows, by Jay French, with additional coding by David Pierron; original coding by Pieter Spronck, Sam Anderson, Samuel Goldstein and Matt Lee.
- Java port: SpaceTrader for Java, by Aviv Eyal and contributors (the upstream snapshot this repository continues).
⚖️ License
GNU General Public License v3.0 or later (GPL-3.0-or-later). See
LICENSE for the license text and NOTICE for the upstream
copyright and provenance chain.