Magic Pockets Installer Script Format

From ModdingWiki
Jump to navigation Jump to search

The install.txt file shipped with Magic Pockets is a short installer configuration and command script. It is the only uncompressed file in the analysed data directory; it is not an RNC stream. The checked copy is 382 bytes of ASCII text with CR LF line endings.

File format

Each line contains a directive and optional arguments, separated by spaces or a tab in the supplied sample. The file has an initial configuration block ending with end_init, followed by command lines. The original installer's parser has not been reverse engineered, so the following describes observed syntax and values, not a complete command-language specification.

Directive Observed arguments Interpretation / evidence
disk_space 737280 Numeric disk-space setting; exact enforcement not established
name Magic Pockets Displayed product-name setting
ininame Pockets Configuration-name setting
target c Target setting
setnoFkey None Flag directive; effect not established
id D ID setting; this value also appears on line 4 of pockets.ini
key action label,key label,decimal code Five control definitions, comma-separated
end_init None End of the configuration block
copy Source and target expressions File-copy command lines; switch grammar unverified
md Target expression Directory-creation command line
print Message text Display-message command line
wait None Wait command line

These interpretations follow the text and directive names; runtime effects and a general grammar are not verified. A line beginning 'source and a line consisting of an apostrophe also occur; whether the apostrophe is a comment marker is not established by a decoded consumer.

Key definitions

The sample lists five keys in Up, Down, Left, Right, Fire order. Arrow codes are 18432, 20480, 19200 and 19712. Its Fire definition uses j with DOS code 9322 (0x246A), whereas the checked pockets.ini uses Space. The two files should not be assumed to contain identical control defaults.

The numeric codes combine a scan code in the high byte and an ASCII byte in the low byte. There is no binary header, fixed-size record structure or embedded palette.

Source code

From re-magicpockets, the open-source browser port and reverse-engineering project:

Credits

This file format was reverse engineered by VorticonCmdr. Please credit this work in projects that use it; a link back to this wiki is appreciated.