# PeakItemRandomizer
A configurable item randomizer mod for **PEAK** that allows almost any vanilla item to spawn across the map.
This mod combines the idea of random item spawning and luggage randomization into one configurable package, while keeping PEAK's multiplayer compatibility and vanilla gameplay structure.
---
## Features
### Randomized Item Spawns
Items can spawn outside of their normal locations.
Examples:
- Rescue Claws spawning in luggage
- Medical items spawning in nature loot pools
- Tools spawning where food normally appears
- Rare items appearing in unexpected places
---
### Full Per-Item Spawn Configuration
Every supported vanilla item gets its own toggle in ModConfig.
Enable or disable any item individually.
Examples:
- Enable normal Rescue Claw
- Disable Golden Rescue Claw
- Disable Chess Pieces
- Disable developer/debug items
- Disable props
- Enable only survival items
No manual blacklist typing required.
---
### Nature Randomization
Bushes, berry vines, and supported nature spawners are randomized.
Behavior is intentionally consistent with vanilla-style spawning:
A nature source picks **one random item** and spawns multiple copies of that item.
Example:
✅ Bush spawns 4 Bugles
✅ Berry vine spawns 3 Anti Rope Spools
Not:
❌ Bugle + Berry + Rope all from the same bush
---
### Randomized Luggage
Luggage can spawn randomized items instead of vanilla loot.
Supports:
- Beach luggage
- Jungle luggage
- Tundra luggage
- Caldera luggage
- Ancient luggage
- Cursed luggage
- Mesa luggage
- Roots luggage
- Climber luggage
---
### Respawn Chests Stay Vanilla
Respawn chests / revive coffins are intentionally untouched by default.
This prevents breaking revive gameplay.
---
### Host-Side Multiplayer Support
Only the host needs the mod installed.
Clients will still receive the spawned items normally through PEAK networking.
---
## Dependencies
Required:
- BepInExPack PEAK
- ModConfig
Thunderstore dependencies:
- BepInEx-BepInExPack\_PEAK-5.4.2403
- PEAKModding-ModConfig
---
## Installation
Install with Thunderstore Mod Manager **or manually**.
Manual install:
1. Install BepInEx for PEAK
2. Install ModConfig
3. Place:
```text
PeakItemRandomizer.dll
```
into:
```text
PEAK/BepInEx/plugins/
```
4. Launch the game
---
## Configuration
This mod is configured **in-game** using ModConfig.
Open the PEAK mod settings menu.
You will see:
```text
PeakItemRandomizer
```
---
### Main Settings
#### Enable Mod
Turns the entire mod on/off.
---
#### Equal Chance
When enabled:
Every allowed item has the same spawn chance.
Example:
- Rope = same chance as Medkit
- Medkit = same chance as Rescue Claw
When disabled:
future weighted behavior may be used.
---
#### Randomize Luggage
Enable/disable randomized luggage contents.
---
#### Randomize Nature
Enable/disable randomized bushes/vines/nature loot.
---
#### Keep Respawn Statues Vanilla
Keeps revive chests unchanged.
Recommended: ON
---
## Item Toggles
Every supported item appears as a true/false toggle.
Examples:
```text
Rescue Claw (RescueClaw) [ID:45] = true
Golden Rescue Claw (GoldenRescueClaw) [ID:112] = false
Chess Piece White King = false
Anti Rope Spool = true
Bugle = true
```
Set:
```text
true
```
to allow spawning
Set:
```text
false
```
to block spawning
---
## Logging / Debugging
BepInEx logs mod activity for debugging.
Log file:
```text
PEAK/BepInEx/LogOutput.log
```
Useful for reporting:
- missing spawns
- broken luggage
- invalid items
- patch failures
---
## Known Notes
- Only vanilla PEAK items are supported
- Host settings control multiplayer spawns
- Clients do not need the mod installed
- Config changes may require restarting the run
---
## Credits
## Author
**TheAsianRicePicker**
