PEAK Tool Belt
Open up your tool belt and use some items accessible at any time!PEAK Tool Belt 🛠️🎒
Original intended to only be used to pull out items that youd like to have for the climb but not the pain of using inventory slots for them.
By default it has: Binoculars, Bugle, Compass and the Guidebook. These items are not OP to have at all times but can be useful or fun to have for the climb HOWEVER, this mod will allow the host to also set it up to work like a starter kit that doesnt effect weight untill you spawn the item. Kind of like my Custom Starter Kits mod sort of.
Use the new mod menu to setup the toolbelt!
Works in solo and multiplayer. The host's belt list is the one everyone sees.
Questions, bugs, or appreciation → Peak Modding Discord
Features
- Vanilla like inventory slots
- Hold T, hover a slot, release T to take that item (same as the backpack). Click still works if you want it. Number keys only switch your real inventory
- New items are one-time. Mark one Protected and it never leaves the belt
- Unprotected items have a Uses count (default 1). Three aloe uses one slot, then the slot disappears after the third take
- Protected items are marked. Dropping or throwing them does not leave a copy in the world. Taking the slot again puts that same item back in your hand or pocket, or spawns a replacement if it was destroyed
- Empty / spent slots hide themselves
- Live item list includes vanilla items and late-loading mod items (PEAKLib, Luggage Items extras, and so on)
- Named presets for custom games (save / load / delete)
- Host extras sync with Photon RaiseEvent 165 (no room CustomProperties)
- Clients stay locked out in a lobby whose host does not have the mod
Setup menu
Open with Ctrl+J. The item list loads from the live game database when the menu opens. A pause-menu button is optional and off by default.
From that menu you can set:
- Every item on the belt
- Protected (stays on the belt, infinite, cannot be dumped into the world)
- Uses for unprotected items (1–99, one slot, restocks on Airport / biome)
- Belt hold key
- Menu hotkey and pause-menu button
- Slots per row
- Reset defaults or clear the belt
- Presets — save, load, and delete named belts for custom games. Closing the menu updates
default
Search filters the list. Hosts lock the item list for the lobby; clients can still change their own keys.
The live belt is saved to BepInEx/config/tony4twentys.PEAK_Tool_Belt.items.json. Named presets live in a Presets folder next to the plugin DLL.
Usage
- Set the belt up in the menu (or keep the default tools)
- Start a run (Airport or a biome)
- Hold T to open the belt above your hotbar (cursor unlocks, like a backpack)
- Hover a slot
- Release T to take that item and close the belt
Unprotected slots disappear after their uses are spent. Protected slots always stay.
Uses restock on the next Airport / biome scene.
Default items
Binoculars, bugle, compass, and guidebook. All four start Protected.
Anything you add later starts unprotected with 1 use. Reset defaults restores those four.
Config
The menu is the supported way. Hand-edits go in BepInEx/config/tony4twentys.PEAK_Tool_Belt.cfg under [General].
| Setting | Default | Description |
|---|---|---|
OpenToolBelt |
T | Hold to open the belt, hover a slot, release to take it |
MenuKey |
J | Setup menu key |
MenuModifier |
Left Ctrl | Used with MenuKey when RequireMenuModifier is on |
RequireMenuModifier |
true | Off = J alone opens the menu |
ShowPauseMenuButton |
false | Pause menu entry |
Columns |
5 | Slots per row |
Multiplayer
- Solo and host: belt is ready as soon as you are in Airport or a biome
- Clients: wait for the host handshake, then use the host's list
- If the host does not have the mod, the belt stays closed (no free items in a vanilla lobby)
Installation
- Download via a mod manager or drop the
.dllintoBepInEx/plugins/ - Run the game. Open the menu with Ctrl+J
Dependencies
PhotonCustomPropsUtils is no longer required.
What changed in 2.0
The original 1.x belt drew its own canvas, spawned a dummy Stone to force a selector, wiped matching items out of pockets and backpacks, and synced over room CustomProperties. That stack broke after game and Photon updates.
2.0 keeps the same idea — a run-long tool row you can pull from — and rebuilds the rest on current PEAK patterns: vanilla HUD slots, name-based item lookup, grant-or-equip instead of inventory wipes, a Luggage Items-style setup menu, Protected + per-item uses, and a RaiseEvent handshake.
Feedback
Suggestions or issues: PEAK Modding Discord
Created by tony4twenty
Other PEAK mods