PEAK Tool Belt 🛠️🎒

This mod adds a customizable tool belt that allows you to quickly access and spawn items during your PEAK runs.
Perfect for quick access to compasses, binoculars, flares, and other survival gear without needing to constantly carry them in your main inventory or backpack.

You can also add more items or custom items from mods! Also there is a weird moment when you open the toolbelt for the first time after scene changes see Technical Notes further down.

Be careful when selecting items. IF an item that is in the toolbelt is in your inventory, it will be destroyed when selecting a new item from the tool belt to spawn. So say if you have rope in your tool belt and you also have rope in your inventory, selecting ANY item from the toolbelt will destroy the rope. However if the item doesnt currently exist within the toolbelt, this will not happen. So still be careful and drop any items you need to before spawning new ones! This is a feature to allow hotswapping toolbelt items that are NOT one time use to prevent clutter.

Items that are spawnable infinitly by default: Binoculars, Bugle, Compass, Conch, Guidebook, Megaphone, Passport, Seagull Flag, Turtle Flag

Items that are spawnable ONLY ONCE by default: Flare, Frisbee, Lantern, Piton, Rope Spool, Sports Drink, Trail Mix

🛠️ Features

• ✅ Quick Item Access - Toggle tool belt with T key to browse and spawn items
• 🎯 Smart Selection - Navigate with arrow keys, select with Enter
• 🔄 One-Time Use Items - Flares, pitons, and consumables automatically remove from belt after use
• 🎨 Customizable UI - Configurable colors, borders, and backgrounds
• 📦 Custom Items - Add your own items via JSON config
• 🌐 Multiplayer Sync - Host's custom items sync to all players automatically
• 🎮 Scene Management - Tool belt restocks on scene changes
• ⚡ Auto-Fix Selector - Automatically fixes UI selector visibility issues

⚙️ Config Options

You can change these in the mod's config file at: BepInEx/config/tony4twentys.PEAK_Tool_Belt.cfg

Keybinds

UI Colors (Hex Format: #RRGGBBAA)

UI Display

General

📦 Installation

1. Download via Thunderstore manually.
2. Drop the .dll file into: /PEAK/BepInEx/plugins/
3. Run the game to generate config!

🔥 Or use Thunderstore Mod Manager for easy install 🔥

💡 Usage

1. Start a run in Airport or Level scenes
2. Press T to open the tool belt (or whatever config you choose for it)
3. Use [ ] or - + to navigate items (or whatever configs you choose for it)
4. Press Enter to spawn the selected item (or whatever config you choose for it)
5. One-time use items automatically remove from the belt
6. Press T again to close the tool belt (or whatever config you choose for it)

Adding Custom Items

1. Open the config file: BepInEx/config/tony4twentys.PEAK_Tool_Belt.cfg
2. Find the CustomItems setting
3. Add items in JSON format:

[{"itemID": 47, "isOneTimeUse": true}, {"itemID": 77, "isOneTimeUse": false}]

1. Save and restart the game NOTE - you can enter in the same items more than once to spawn them multiple times but not infinitly!

🎨 Customization

Custom Sprites

These files may be interchangeable with your own as long as they are 64x64 but I didnt try swapping:

• Boarder.png - Custom border for tool belt slots
• Slot Background.png - Custom background for tool belt slots

UI Layout

• Items are arranged in a 5-column grid
• First row appears at the bottom of the screen
• Items are sorted alphabetically (except Stone for technical reasons)
• UI scales automatically with screen resolution

🌐 Multiplayer

• Host Authority - Only the host's custom items config is used (hopefully)
• Auto-Sync - Clients automatically receive host's custom items (hopefully)
• Scene Restocking - Tool belt restocks when changing scenes
• No Cheating - Clients cannot use their own custom items in multiplayer (hopefully)

📦 Dependencies

• BepInExPack_PEAK
• PhotonCustomPropsUtils (for multiplayer sync)

🔧 Technical Notes

• Host Handshake - Requires host to have the mod for multiplayer functionality (hopefully)
• Item Spawning - Items spawn directly in your hand
• Inventory Management - Selecting new items removes previous tool belt items
• Auto-Fix System - Automatically resolves UI selector visibility issues
• Stone Item - its used for a temporary fix. As client when joining host, for some reason the item selector was visible but still useable, this item is automatically added to toolbelt and on the first time its opened after scene change, the stone is selected, destroyed and the UI toolbelt reopened correcting the issue.

📣 Feedback

Suggestions, ideas, or issues?
Reach out via the PEAK Modding Discord

👤 Author

Created by tony4twenty
See all my PEAK mods here

🛠️ Stay organized. Stay prepared.