Quick Guide

Building the Demo Disks:

Double click the file builder.bat will show an interface for building 8bit-Unity projects including the necessary code and asset files for each platform. Use File > Load to import the project “demos.8bu” and press “Generate Build Scripts”.

There are now 3 batch files in the root folder with names such as “build-demos-apple.bat”. Run each script to build the relevant game disk which will be saved in the folder “[build]”. You can then copy the disk to a floppy or load it in an emulator (AppleWin, Altirra or Vice).

Note: To run the network demo, it is necessary to run the script “udp-server.bat” beforehand on the same machine as the one running the emulator (the localhost IP is used in this demo). Please refer to the section on emulator setup below to configure networking correctly.

 

Contents of the SDK:

/[build]: Empty folder, where temporary build files and compiled disks are generated
/assets: Folder where PNG files for bitmaps and sprites, as well as music tracks, are saved
/config: CC65 memory maps for each platform (Apple, Atari, C64)
/demos: Simple source files of each demo shown in the demos disk
/docs: Very sparse documentation
/unity: Source files of game API (you probably not need to modify these files)
/utils: GIMP, Piskel, Python 2.7, scripts and tools, for converting assets and compiling disks.

 

Emulator Configuration (for networking):

— APPLEWIN —

In order to use ethernet, you will need either to have a Uthernet card in slot 3 of your Apple //e, or at least know how to setup APPLEWIN correctly. Follow these steps CAREFULLY, and you will be running in no time:

(1) APPLEWIN only works over cabled Ethernet. If you are running in Windows 10:
Go to “Control Panel” > “… Network Status…” > “Change Adapter Settings”.
“Right-click” > “disable” every adaptors except your Ethernet Card.

(2) Download and Install WinPCAP (for Ethernet support): https://www.winpcap.org/install/bin/WinPcap_4_1_3.exe

(3) Download APPLEWIN: https://github.com/AppleWin/AppleWin/releases

(4) In APPLEWIN:

Click the “Settings” icon (Joystick and Speaker)
Select “Model”: Apple //e
Click “Ethernet Settings”
– Set “Ethernet” to Uthernet.
– Select the “Interface” (only 1 should be shown as you only have the ethernet enabled).
Go to the “Sound” tab, and select “Mockingboards (in slots 4&5).

Restart APPLEWIN, and try loading this disk: http://8bit-slicks.com/udp-test.dsk

If you did everything correctly, then APPLEWIN will display the list shown at: http://8bit-slicks.com/?page_id=32

— ALTIRRA —

In order to play online, you will need either to have a DragonCart for your Atari XL/XE, or at least know how to setup ALTIRRA correctly. Follow these steps CAREFULLY, and you will be running in no time:

(1) Download ALTIRRA 2.90 (or later): http://www.virtualdub.org/altirra.html

(2) Setup ALTIRRA as follows:
Check “System” > “Hardware” > “600XL/800XL”.
Check “System” > “Video” > “PAL”.
Check “System” > “Video” > “Frame Blending”.
Go to “System” > “Devices”.
– Click “Add”.
– Select “Cartridge devices” > “DragonCart”.
– Set Bridging mode to “NAT”.
– Click “OK”.

Restart ALTIRRA, and try loading this program: http://8bit-slicks.com/udp-test.dsk

If you did everything correctly, then ALTIRRA will display the list shown at: http://8bit-slicks.com/?page_id=32

— VICE —

In order to play online, you will need either to have a RR-Net card for your C64, or at least know how to setup VICE correctly. Follow these steps CAREFULLY, and you will be running in no time:

(1) VICE only works over cabled Ethernet. If you are running in Windows 10:
Go to “Control Panel” > “… Network Status…” > “Change Adapter Settings”.
“Right-click” > “disable” every adaptors except your Ethernet Card.

(2) Download and Install WinPCAP (for Ethernet support): https://www.winpcap.org/install/bin/WinPcap_4_1_3.exe

(3) Download VICE 2.4 (later versions are not working): https://sourceforge.net/projects/vice-emu/files/releases/binaries/windows/WinVICE-2.4-x86.zip/download

(4) In VICE:
Check “Settings” > “Save settings on exit”.
Go to “Settings” > “C64 model settings”.
– Set C64 model to C64C PAL, PAL-G.
Go to “Settings” > “Cartridge/IO Settings” > “Ethernet settings…”.
– Set Ethernet to “RR Net”.
– Set Interface to the only device shown.
– Press “OK”.

Restart VICE, and try loading this program: http://8bit-slicks.com/udp-test.dsk

If you did everything correctly, then VICE will display the list shown at: http://8bit-slicks.com/?page_id=32