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

1. Set the belt up in the menu (or keep the default tools)
2. Start a run (Airport or a biome)
3. Hold T to open the belt above your hotbar (cursor unlocks, like a backpack)
4. Hover a slot
5. 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].

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

1. Download via a mod manager or drop the .dll into BepInEx/plugins/
2. Run the game. Open the menu with Ctrl+J

Dependencies

• BepInExPack_PEAK

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

Changelog

[2.0.0] - 2026-09-18

Complete rewrite. The old custom canvas, Stone selector hack, inventory wipes, and Photon room CustomProperties are gone.

Belt

• Vanilla InventoryItemUI slots used to create toolbar now instead of .png's shipped with the mod.
• Hold T to open (cursor unlocks like the backpack), hover a slot, release T to take that item
• Empty / spent slots hide themselves
• Does not wipe matching items out of your pockets or backpack

Setup menu

• In-game overlay (Ctrl+J by default). Pause-menu button is optional and off
• Live item catalog from the game — vanilla plus late-loading mod items (PEAKLib and others)
• Search, check items onto the belt, reset defaults, or clear the belt
• Remap the belt hold key, menu hotkey, and slots per row
• Named presets (save / load / delete) in a Presets folder next to the plugin, same idea as Luggage Items. Closing the menu updates default

Protected and uses

• Defaults are binoculars, bugle, compass, and guidebook — all Protected
• New picks start unprotected with 1 use (1–99 per slot)
• Protected items stay on the belt. Taking the slot again reuses the same marked copy (hand, pocket, backpack, or world) instead of spawning extras
• Dropping or throwing a protected belt item does not leave a grief copy in the world
• Unprotected uses restock on the next Airport / biome

Multiplayer

• Host handshake + belt list via Photon RaiseEvent 165 (tony4twentys.PEAK_Tool_Belt)
• No room CustomProperties
• If the host does not have the mod, clients stay locked out
• PhotonCustomPropsUtils is no longer a dependency

Config

• One [General] section: OpenToolBelt, MenuKey, MenuModifier, RequireMenuModifier, ShowPauseMenuButton, Columns
• RequireMenuModifier is on by default (Ctrl+J). Turn it off to open the setup menu with J alone
• Title / main menu no longer gets cursor or window-flag changes from the belt

[1.0.0] - 2025-09-15

• Initial release.