mirror of https://github.com/bsnes-emu/bsnes.git
149 lines
4.2 KiB
Markdown
149 lines
4.2 KiB
Markdown
The Tools window
|
|
appears when you choose
|
|
one of the items at the bottom of
|
|
[the Tools menu](higan.md#the-tools-menu).
|
|
|
|
The window has a tab for each tool:
|
|
|
|
The Cheat Editor
|
|
================
|
|
|
|
For some consoles,
|
|
higan supports applying temporary changes to the code of a running game.
|
|
For example,
|
|
you could disable the code that detects when the player takes damage,
|
|
resulting in an "invulnerability" mode.
|
|
Currently,
|
|
higan supports cheats for the following consoles:
|
|
|
|
- Famicom
|
|
- Super Famicom
|
|
- Game Boy
|
|
- Master System
|
|
- PC Engine
|
|
- Wonder Swan
|
|
|
|
To add a new cheat,
|
|
select an unused row in the list,
|
|
then type the relevant codes in the "Code(s)" field at the bottom,
|
|
and a description in the "Description" field.
|
|
See [Cheat code formats](#cheat-code-formats)
|
|
for a description of the codes higan understands.
|
|
|
|
To enable or disable an existing cheat,
|
|
tick the checkbox in the first column of the list.
|
|
The change should take effect immediately.
|
|
|
|
To clear out an existing cheat,
|
|
select it from the list
|
|
and click the "Erase" button in the bottom right,
|
|
or just manually delete
|
|
the contents of the "Code(s)" and "Description" fields.
|
|
|
|
To clear out all existing cheats,
|
|
click the "Reset" button in the bottom right.
|
|
|
|
Changes made in the Cheat Editor are saved to disk
|
|
when the game is unloaded,
|
|
or when higan exits.
|
|
higan stores the known cheats for a particular game
|
|
in `higan/cheats.bml`
|
|
inside the game's [game folder](../concepts/game-folders.md).
|
|
|
|
If your copy of higan includes a cheat database
|
|
(a file named `cheats.bml`
|
|
in the same folder as `Super Famicom.sys`
|
|
and the other `*.sys` folders),
|
|
you can click the "Find Codes ..." button in the bottom left
|
|
to load all known cheats for the currently-running game.
|
|
|
|
Cheat code formats
|
|
------------------
|
|
|
|
A cheat code of the format `addr=data`
|
|
will cause the emulated console to obtain `data`
|
|
whenever it reads from memory address `addr`.
|
|
A cheat code of the format `addr=comp?data`
|
|
will cause reads from `addr` to obtain `data`,
|
|
but only if the true value at `addr` is `comp`.
|
|
In both formats,
|
|
`data` is a single byte expressed as two hexadecimal digits,
|
|
`comp` is also a single byte expressed as two hexadecimal digits,
|
|
and `addr` is a memory address in the emulated console,
|
|
expressed as however many hexadecimal digits are required
|
|
for the console in question
|
|
(typically 4 for 8-bit CPUs,
|
|
6 for 16-bit CPUs,
|
|
and 8 for 32-bit CPUs).
|
|
|
|
For compatibility with older versions of higan,
|
|
the older syntaxes of `addr/data` and `addr/comp/data`
|
|
are still supported.
|
|
|
|
For cheats that require more than a single-byte change,
|
|
higan allows multiple codes to be combined with `+`
|
|
so that all of them can have a single description
|
|
and be toggled with a single click.
|
|
For example,
|
|
in Super Mario World,
|
|
you can lock the time to 999 with these codes:
|
|
`7e0f31=09+7e0f32=09+7e0f33=09`.
|
|
|
|
The State Manager
|
|
=================
|
|
|
|
The State Manager allows you to create,
|
|
load,
|
|
and remove Manager states.
|
|
For more information on Manager states,
|
|
quick states,
|
|
saved games
|
|
and how they compare,
|
|
see [Save States](../concepts/save-states.md).
|
|
|
|
To save the current state of the loaded game
|
|
in a new slot,
|
|
or to replace the contents of an existing slot,
|
|
select the slot in the list
|
|
then click "Save" in the bottom-left corner.
|
|
You can then type a description in the "Description" field,
|
|
to help you find the state again later.
|
|
|
|
To rename a state,
|
|
select the slot in the list
|
|
and edit the "Description" field.
|
|
|
|
To load a state,
|
|
select the slot in the list
|
|
and click "Load" in the bottom-left corner,
|
|
or just double-click the slot.
|
|
|
|
To clear the state out of a slot,
|
|
select the slot in the list
|
|
and click "Erase" in the bottom-right corner.
|
|
|
|
To clear all the slots at once,
|
|
click "Reset" in the bottom-right corner.
|
|
|
|
The Manifest Viewer
|
|
===================
|
|
|
|
As described in
|
|
[Game Manifests](../concepts/manifests.md),
|
|
higan uses a "manifest" to
|
|
describe how the various parts of a game cartridge
|
|
are wired up together.
|
|
The Manifest Viewer lets you examine
|
|
the configuration higan is using for the loaded game.
|
|
|
|
Game Notes
|
|
==========
|
|
|
|
The Game Notes tab
|
|
is a place where you can write whatever you want
|
|
about the running game.
|
|
This information is automatically stored inside
|
|
the [game folder](../concepts/game-folders.md)
|
|
and loaded back into this tab
|
|
every time the game is loaded.
|