https://github.com/sherfert/textadventuremaker
Create your own console-based adventures with an intuitive graphical interface.
https://github.com/sherfert/textadventuremaker
game game-development textbasedgame
Last synced: 11 months ago
JSON representation
Create your own console-based adventures with an intuitive graphical interface.
- Host: GitHub
- URL: https://github.com/sherfert/textadventuremaker
- Owner: sherfert
- License: gpl-3.0
- Created: 2017-06-14T11:50:32.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-06-21T18:24:37.000Z (about 9 years ago)
- Last Synced: 2025-05-22T06:45:18.493Z (about 1 year ago)
- Topics: game, game-development, textbasedgame
- Language: Java
- Size: 981 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# TextAdventureMaker
With TextAdventureMaker you can build your own text-based adventures. And all this without coding. An intuitive graphical interface will help you to create persons and items, put them into rooms and connect everything in your game.
## Setup
First you should clone the repository. TextAdventureMaker is built with maven. So all you need to do after downloading is running `mvn package`. Afterwards you will find a `TextAdventureMaker-version.jar` in the `target` folder. Double-click that to launch the program, or run `java -jar TextAdventureMaker-version.jar` (and adjust the actual version number, of course).
## Building your own game
Click `File->New Game` and start off from there. Currently there is no documentation on how to use TextAdventureMaker. This will follow. Important to know is that everything you change is saved automatically. You can always try your latest changes by clicking `Game->Play game`.
## Share your amazing game with your friends
Click `File->Export runnable game` to obtain a standalone executable JAR file, that you can send to your friends, or publish wherever you like.
## Contribute
TextAdventureMaker is under irregular development and any ideas and contributions are more than welcome. Clone the repository and fire up your favorite IDE. Eclipse project files are included. The following list tells you all the main entry points you need to know and their roles.
The folder where savegames, configuration files and logs end up is `$HOME/.textAdventureMaker`.
- `persistence.Main`
Creates a game that contains every single data class and can be used to play around without having to create a new game from scratch. In Unix it will be placed in : `~/.textAdventureMaker/Test-Adventure.mv.db`
- `mvn package`
Creates a file called `Game_missing_db.jar`, which still needs to be augmented with a game database to be executable. This file must be present before exporting to a runnable JAR works. Also creates a `TextAdventureMaker-.jar` executable JAR file with `gui.MainWindow` as main class.
- `playing.menu.LoadSaveManager`
Actually starts playing a game.
- If run in eclipse or from the command line: Needs as argument the name of the game you want to play, e.g. "Test-Adventure", and a corresponding file must exist in `~/.textAdventureMaker`
- If run from a JAR file: Takes the game.db that is present in the JAR as the game.
- `gui.MainWindow`
Shows the main window of the application.