Skip to content

02 2 Quick Start Pitfall

evets17 edited this page Mar 13, 2026 · 4 revisions

Quick Start: Pitfall

This page explains the game-level override used for Pitfall.

Config file used

  • {usb_root}\boosted\Pitfall_boost.toml

What this example demonstrates

Pitfall is a simple example of overriding the base Quick Start behavior on a per-game basis.

In Quick Start: Base, folder-level config uses boost_mode = "enhanced".

For Pitfall, the game-level file switches that game to basic mode.

That means Pitfall uses basic Sprint Boost behavior instead of enhanced compositor/menu features.

In basic mode, Sprint Boost uses the standard jzintv_sprint emulator path, giving a play experience that is very close to base Sprint behavior (as if enhanced Sprint Boost features were not applied).

Pitfall game-level config

boost_mode = "basic"

[jzintv.flags]
gfx-palette = "{gv.assets_palettes}/pf_palette.txt"

What changes for this game

  • Enhanced mode is disabled for Pitfall only.
  • Basic mode behavior is used for this game.
  • The standard jzintv_sprint emulator is used for this game.
  • A game-specific palette flag is applied.

Why this is useful

This pattern is useful when you want one game to use the standard emulation, while other games in the same boosted folder continue using enhanced features.

"Turning off" enhanced mode this way should be used if a game does not function/perform properly when using "enhanced" mode.

Next step

Continue to another game example:

Clone this wiki locally