lawless-legends/Platform/Apple/README.md

36 lines
1.3 KiB
Markdown
Raw Normal View History

2016-05-31 14:45:49 +00:00
Building a game disk image for the Apple II Platform
====================================================
2013-08-12 14:14:08 +00:00
2016-05-31 14:45:49 +00:00
1. Install dependencies
2013-08-12 14:14:08 +00:00
2016-05-31 14:45:49 +00:00
The platform build for the Apple II requires only two dependencies. You will need to install these and have them in your path before you try to build.
2013-09-13 15:46:47 +00:00
2016-05-31 14:45:49 +00:00
- Java 8 (or higher). You can use either OpenJDK 1.8+ or Sun JDK 1.8+
- Apache ant 1.9 (or higher)
2013-09-13 15:46:47 +00:00
2016-05-31 14:45:49 +00:00
You can check if you already have them this way:
- `java -version` # should show "1.8.xxx"
- `ant -version` # should show "1.9.x"
2013-09-13 15:46:47 +00:00
2016-05-31 14:45:49 +00:00
2. Build the tools
2013-08-12 14:14:08 +00:00
2016-05-31 14:45:49 +00:00
- `cd Platform/Apple`
- `ant`
2013-08-12 14:14:08 +00:00
2016-05-31 14:45:49 +00:00
3. Put scenario files in place
2013-08-12 14:14:08 +00:00
You will need acquire and place three scenario files into the appropriate subdirectories of `Platform/Apple/virtual/` as follows:
- `Platform/Apple/virtual/data/world/world.xml`
- `Platform/Apple/virtual/data/world/enemies.tsv`
- `Platform/Apple/virtual/data/fonts/font.bin`
2016-05-31 14:45:49 +00:00
4. Build a game disk
- `cd Platform/Apple/virtual`
- `ant`
- The resulting disk image will be `Platform/Apple/Virtual/game.2mg`. Just boot it in an emulator or copy to a real Apple II, and have fun.
5. Rinse and repeat
- Change any of the code files in virtual/src, or update the world.xml file using Outlaw
- Go to step 4. The system uses incremental building for speedy turnaround.