Super Enquiry Simulator

On the basis that a similar code dump for the Xenoxxx Funtime Show was of niche interest, tidying this one up is a low priority. However, it's fine if you just want to browse the raw pictures and text, and should you want to go deeper, most of the explanation from the earlier game still applies.

The following software is provided with no warranty, no guarantee of fitness for purpose, and may contain stupid bugs that will destroy your files, even if they haven't destroyed mine so far.

Disclaimer done. Here are the files.

Old versions:

• Version 1.00 (05-11-2019).

Docs

The Docs folder contains these spreadsheets:

• Bytecode commands, for reference when writing game logic.
• Graphics, describing most of the image files.
• Nodes, an overview of the game logic blocks.
• Text Tokens, which can be inserted into certain lines of text.
• Tone Calculator, for calculating frequency values.
• Variables, as used by the game logic.

None of these files are required to compile the game, but some of them make it easier to understand what does what.

Game

The Game folder contains the Data subfolder, and a bunch of source code.

SES.asm is the main code file. All the other .asm files, and the contents of the Data subfolder, will automatically be included when you compile SES.asm (I use zDevStudio.)

Game/Data

The Data folder contains:

• .png files, images with up to three colours (black, white, magenta.)
• .txt files, containing game words and logic.
• .asm files, automatically included when compiling SES.asm.

The folder does not contain any .bin files. You will need to generate these yourself, as described in the next section.

Utilities

The Utilities folder contains Python software that converts images, text, and game logic to .bin data files that the ZX Spectrum code can understand.

• txtlib.py and zxasmlib.py, library files used by other modules.
• ZX_Image_Compiler.py, converts images to compressed binary data.
• ZX_Node_Compiler.py, converts logic instructions to bytecode.
• ZX_Text_Compiler.py, formats and compresses ASCII text.
• ZX_Text_Compiler_config.py, configuration file for the above.

Copy all these files to Game/Data, then run them from there. When prompted to enter hex addresses:

• For ZX_Image_Compiler, enter AD01.
• For ZX_Node_Compiler.py, enter 7820.
• For ZX_Text_Compiler.py, the address is already set in ZX_Text_Compiler_config.py.

You should now have all the necessary .bin files in Games/Data.

Further information

Many instructions for modifying the Xenoxxx Funtime Show still apply. However:

• The image and text compilers are not compatible.
• The memory map is different, and has far less free space for modification.
• Some node commands have been removed or renumbered.

Questions, comments, bug reports? Please send them all to: comments at arbitraryfiles.com.

Revised 19-11-2019.