Skip to content

02 5 Quick Start BurgerTime

Jump to bottom
evets17 edited this page Mar 13, 2026 · 2 revisions

Quick Start: BurgerTime

This page explains the game-level cheat setup used for BurgerTime.

Config file used

  • {usb_root}\boosted\BurgerTime_boost.toml

What this example demonstrates

This example highlights how to apply memory-based cheats using Sprint Boost:

  • Reading game memory values with game_info
  • Updating those memory values from menu actions
  • Updating those memory values from hotkeys during play

BurgerTime game-level config

# -------------GAME INFO-------------
# Player 1 Values
[game_info.values.p1_lives]
label = "P1 Lives"
address = "0x017D"
decode = "u16"
[game_info.values.p1_lives.transform]
op = "offset"
value = -1

[game_info.values.p1_peppers]
label = "P1 Peppers"
address = "0x017B"
decode = "u16"

# Player 2 Values
[game_info.values.p2_lives]
label = "P2 Lives"
address = "0x017E"
decode = "u16"
[game_info.values.p2_lives.transform]
op = "offset"
value = -1

[game_info.values.p2_peppers]
label = "P2 Peppers"
address = "0x017C"
decode = "u16"

# -------------Hotkeys-------------
[[input.hotkeys.binding]]
keys = ["C1_9"]
duration_ms = 0
menu_enabled = true
on_press = { command = "offset_game_info", game_info = "p1_peppers", value = 1, max_value = 10 }

[[input.hotkeys.binding]]
keys = ["C2_9"]
duration_ms = 0
menu_enabled = true
on_press = { command = "offset_game_info", game_info = "p2_peppers", value = 1, max_value = 10 }

# -------------Menu-------------
[menu.menus.cheat]
allow_directional_nav = true
header = "Cheats"
footer = "Press 'clear' to go back"

[menu.menus.cheat.item1]
label = "Set P1 Lives To 10"
action = { command = "set_game_info", game_info = "p1_lives", value = 10 }

[menu.menus.cheat.item2]
label = "Set P2 Lives To 10"
action = { command = "set_game_info", game_info = "p2_lives", value = 10 }

[menu.menus.pause.item9]
label = "Cheats"
action = { command = "show_menu", menu = "cheat" }

How the cheats work

  • game_info defines where BurgerTime stores lives and peppers in memory.
  • The Cheats menu can directly set lives for P1 or P2.
  • Hotkeys on each controller (C1_9 and C2_9) add one pepper at a time, up to 10.
  • The pause menu is extended with item9 so Cheats can be opened without replacing the shared base pause menu.

Important behavior notes

Important

When memory is adjusted this way, BurgerTime does not always update the on-screen value immediately. The new value appears only after the game reaches a point where it re-reads that value.

Note

Triggering these cheats currently has no extra Sprint Boost confirmation message or visual feedback. This is a current limitation.

Why this is useful

This pattern gives a practical template for lightweight cheats in games where lives, inventory-style values, or counters can be safely updated through known memory addresses.

Next step

Continue to another game example:

Clone this wiki locally