Skip to content

Special Values

Matt Nadareski edited this page Sep 19, 2025 · 10 revisions

Special Values

For a lot of fields, there are specific sets of values that are required or accepted in order for them to work properly with other programs. This document has a list of the most common sets of values along with descriptions, where available.

Chip Types

Below is a list of chip types and a brief description of each:

Value Description
cpu Represents a CPU chip on a machine
audio Represents an audio processing chip on a machines

Control Types

Below is a list of control types and a brief description of each:

Value Description
joy There is no information available at this time.
stick There is no information available at this time.
paddle There is no information available at this time.
pedal There is no information available at this time.
lightgun There is no information available at this time.
positional There is no information available at this time.
dial There is no information available at this time.
trackball There is no information available at this time.
mouse There is no information available at this time.
only_buttons There is no information available at this time.
keypad There is no information available at this time.
keyboard There is no information available at this time.
mahjong There is no information available at this time.
hanafuda There is no information available at this time.
gambling There is no information available at this time.

If you have more information on any of the above values, please open a GitHub issue or a pull request.

Device Types

Below is a list of device types and a brief description of each:

Value Description
unknown There is no information available at this time.
cartridge There is no information available at this time.
floppydisk There is no information available at this time.
harddisk There is no information available at this time.
cylinder There is no information available at this time.
cassette There is no information available at this time.
punchcard There is no information available at this time.
punchtape There is no information available at this time.
printout There is no information available at this time.
serial There is no information available at this time.
parallel There is no information available at this time.
snapshot There is no information available at this time.
quickload There is no information available at this time.
memcard There is no information available at this time.
cdrom There is no information available at this time.
magtape There is no information available at this time.
romimage There is no information available at this time.
midiin There is no information available at this time.
midiout There is no information available at this time.
picture There is no information available at this time.
vidfile There is no information available at this time.

If you have more information on any of the above values, please open a GitHub issue or a pull request.

Display Types

Below is a list of display types and a brief description of each:

Value Description
raster Machine uses raster graphics
vector Machine uses vector graphics
lcd Machine uses an LCD display
svg Machine uses an SVG overlay
unknown Display type is unknown

Endianness

Below is a list of endianness values and a brief description of each:

Value Description
big Represents big-endian architecture
little Represents little-endian architecture

Feature Statuses

Below is a list of feature statuses and a brief description of each:

Value Description
unemulated This feature is considered entirely unemulated.
imperfect This feature has issues with emulation.

Feature Types

Below is a list of feature types and a brief description of each:

Value Description
protection There is no information available at this time.
palette There is no information available at this time.
graphics There is no information available at this time.
sound There is no information available at this time.
controls There is no information available at this time.
keyboard There is no information available at this time.
mouse There is no information available at this time.
microphone There is no information available at this time.
camera There is no information available at this time.
disk There is no information available at this time.
printer There is no information available at this time.
lan There is no information available at this time.
wan There is no information available at this time.
timing There is no information available at this time.

If you have more information on any of the above values, please open a GitHub issue or a pull request.

Item Statuses

Below is a list of item statuses and a brief description of each:

Value Description
good Item is considered to be a good dump of the original media
baddump Item is considered to be a bad dump of the original media
nodump Item has not been dumped (or properly dumped) from the original media
verified Item is considered to be a good dump and verified against other dumps of the same media

Item Types

Below is a list of item types and a brief description of each:

Value Description
adjuster Analog Adjusters for a game.
analog Analog mask of a port.
archive Archive name.
biosset BIOS sets for a device.
blank Internal type used as a placeholder.
chip CPU and Sound chips used by a game.
condition Condition required to use I/O port field/setting.
configuration Output configuration information.
control Single controller information for a machine.
dataarea There is no information available at this time.
device Single device for a machine.
device_ref Subdevice for a machine.
dipswitch Dipswitch configuration information.
disk CHD file information.
diskarea There is no information available at this time.
display Machine display information.
driver Driver status.
extension Extension value for filtering.
feature Emulation features of a machine.
info There is no information available at this time.
input Represents a single input for a machine.
instance Image device instance.
location Location information for a dipswitch (diplocation) or configuration (conflocation).
media Aaruformat file information.
part There is no information available at this time.
partfeature There is no information available at this time.
port Input ports in the driver.
ramoption RAM options for a system.
release There is no information available at this time.
rom Represents generic file information
sample Reference to a specific (usually WAV-formatted) sample file
setting Setting information for a dipswitch (dipvalue) or configuration (confsetting).
sharedfeat There is no information available at this time.
slot Represents a single slot on a machine, such as a cartridge or controller slot
slotoption Represents a single option for a given slot, contains name of another set representing the option
softwarelist Software list associated with the machine
sound Speakers for a machine

If you have more information on any of the above types, please open a GitHub issue or a pull request.

Loadflags

Below is a list of loadflags and a brief description of each:

Value Description
load16_byte There is no information available at this time.
load16_word There is no information available at this time.
load16_word_swap There is no information available at this time.
load32_byte There is no information available at this time.
load32_word There is no information available at this time.
load32_word_swap There is no information available at this time.
load32_dword There is no information available at this time.
load64_word There is no information available at this time.
load64_word_swap There is no information available at this time.
reload There is no information available at this time.
fill There is no information available at this time.
continue There is no information available at this time.
reload_plain There is no information available at this time.
ignore There is no information available at this time.

If you have more information on any of the above values, please open a GitHub issue or a pull request.

Log Levels

Below is a list of log levels and a brief description of each:

Value Description
verbose All logs (default)
user No verbose logs
warning Only warnings and errors
error Only errors

Machine Types

Below is a list of machine types and a brief description of each:

Value Description
bios BIOS set, usually something like original hardware that other software ran on but is useless by itself
device Device set, usually a peripheral or other "device" that could be attached to another machine
mechanical Mechanical set, usually a machine with no screen or otherwise logic only. Sometimes applied to pinball machines

Nodump Modes

Below is a list of nodump modes and a brief description of each:

Value Description
obsolete There is no information available at this time.
required There is no information available at this time.
ignore There is no information available at this time.

If you have more information on any of the above values, please open a GitHub issue or a pull request.

openMSX Subtypes

Below is a list of openMSX subtypes and a brief description of each:

Value Description
rom There is no information available at this time.
megarom There is no information available at this time.
sccpluscart There is no information available at this time.

If you have more information on any of the above values, please open a GitHub issue or a pull request.

Packing Modes

Below is a list of packing modes and a brief description of each:

Value Description
zip This mode instructs the program to rebuild all sets to named archives.
unzip This mode instructs the program to rebuild all sets to named folders.
partial This mode instructs the program to rebuild all sets that have more than one item to named folders, with the rest rebuilt to the output folder without named subfolders.
flat This mode instructs the program to rebuild all sets to the output folder without named subfolders.

Please note that both partial and flat are not common and may not be supported as header flags in all programs.

Prefix and Postfix Replacement Strings

Below is a list of strings that can be used to act as placeholders for prefix and postfix additions. If the field in question does not exist, it will replace it with an empty string instead:

Value Description
%game%, %machine% Replaced with the game/machine name
%name% Replaced with the item name
%manufacturer% Replaced with game/machine manufacturer
%publisher% Replaced with game/machine publisher
%category% Replaced with game/machine category
%crc% Replaced with item CRC32 hash
%md5% Replaced with item MD5 hash
%ripemd160% Replaced with item RIPEMD160 hash (Only available in .NET Framework 4.8 builds)
%sha1% Replaced with item SHA-1 hash
%sha256% Replaced with item SHA-256 hash
%sha384% Replaced with item SHA-384 hash
%sha512% Replaced with item SHA-512 hash
%size% Replaced with item size
%spamsum% Replaced with item SpamSum fuzzy hash

More fields may be supported in the future. Please open a GitHub issue or a pull request to add them.

Relations

Below is a list of relations and a brief description of each:

Value Description
eq Equals
ne Not equals
gt Greater than
le Not greater than
lt Less than
ge Not less than

SoftwareList Statuses

Below is a list of softwarelist statuses and a brief description of each:

Value Description
original This software list represents original media for a machine.
compatible This software list represents media that is compatible with the machine.

Support Statuses

Below is a list of support statuses and a brief description of each:

Value Description
good Item is properly supported.
imperfect Item is partially supported.
preliminary Item either has no support or a skeleton.

Supported

Below is a list of supported values and a brief description of each:

Value Description
no Machine is not supported currently.
partial Machine is in partially runnable state.
yes Machine should be fully supported.

Clone this wiki locally