microPAK File Help

MicroPAK files

MicroPAK files encapsulate other files that pertain to “upcycled” legacy software, or a microM8-native application. They can contain disk images, BASIC or binary code, data files, text files, images, music or audio. They have the extension .PAK

You can “boot” them by selecting them (enter) in the Catalog, or modify their contents via the Control-Shift-O key combination.

In addition to bundling relevant files, there are additional configuration files that allow you to customise the virtual machine. You can also specify additional “control” BASIC programs to run in additional virtual machines which can monitor and modify the state of the “root” program (running in the primary virtual machine, see further in this document for more information.)

You can create a .PAK file using two methods, depending on what you wish to do:

If you wish to start out with a default set of configuration files, you can create a PAK by selecting a DSK, NIB, APL, INT or BIN file in the Catalog (accessible through Shift-Control-~) and pressing Shift-Control-P. It will be created in your /Local file directory.

If you want to create a PAK from a running disk or application and save all of that sessions current settings into the PAK file, press Shift-Control-P outside of the catalog, while the session is running. It will similarly be created in your /Local directory.

Configuration files

Configuration files allow you to change many of the “default” settings of the virtual machine, add backdrops, overlays, sound and music, change colours, specify camera location and much more!

You can edit the files by Control-Shift-O(pening) the PAK file in the Catalog. You will notice the following .cfg files:

audio.cfg
boot.cfg
camera.cfg
control.cfg
input.cfg
palette.cfg
video.cfg

Select the configuration file you would like to edit and press Control-Shift-E. Press Control-Shift-O to save the file once you’re done editing it, or Control-Shift-Q to exit the file editor without saving.

To see your changes take effect, back out of the PAK file and re-select it with the Enter key to “reboot” it.

See the micropak-help.txt file in the /micropaks folder for descriptions of all the config file settings.

Control programs

You can use microM8 @functions to extend Applesoft BASIC and manipulate the virtual machine running the disk / binary / program. microM8 has the ability to run up to 8 concurrent sessions. You can manually switch between them using Shift-Control-1 through Shift-Control-8. Using the @vm.* family of functions (specifically @vm.redirect) you can have a BASIC program in one VM affect the memory and settings of another.

In the case of microPAK files, the root disk / binary / program specified in the boot.cfg ALWAYS loads into slot one. Control programs that you specify in control.cfg load into successive slots two, three and so on.

Look inside the microPAKS in the /micropaks folder (using Control-Shift-O) for example control programs.

You can also do funky things like monitor memory addresses for specific values, or set permanent fixed values (for cheating!) More on this soon.

Configuration file settings descriptions

See the micropak-help.txt file in the /micropaks folder for more information.

Go back in time with the Octalyzer!

Did you know that you can go back in time with the Octalyzer Apple IIe emulator? Its “Live Rewind” feature records your active session to disk and with a simple key combo you can “undo” history, ensuring you’re never on your “last” life — there’s always another chance!

Once you’ve booted into your game, turn on Live Rewind by pressing shift-control-R, releasing all three keys and then pressing W immediately (you should hear a confirmation beep.) Then, whenever you want to go back in time, press shift-control-[ to start rewinding and then you can either press shift-control-] to scan forward (if you overshoot) or press space to exit rewind and continue playing at that point. Simple!

You can rewind and jump back in as many times as you like, making you virtually immortal! No need to save and load snapshots or other tedious methods, Live Rewind takes mere seconds (and it’s also really cool!)

Download the Octalyzer for Windows, Mac or Linux here

“Octalyzed” Pinball!

By changing the aspect ratio to 1:1, switching to voxel rendering, decreasing the depth to 1, tilting the model backwards, and zooming in (see the quick help page for more details on how to do all of these), you can get a 3D experience from classic Apple II pinball games! Check out the screenshots below:

You can find all of these games in the Octalyzer file library (under /appleII/Disk Images/…) Have fun!