TruckLoot

Description

TruckLoot lets you keep your valuable items between levels by saving them in your truck. Only the host needs to have the mod installed. No more losing your prized possessions when changing locations - items stay exactly where you left them in the truck, making item collection and management more immersive and rewarding!

Features

• 📦 Persistent Valuables: Items in your truck remain there between level transitions
• 🔄 Precise Positioning: Items maintain their exact position between levels
• 💰 Value Preservation: Item values are maintained perfectly between levels
• 🔍 Auto-Discovery: Items are automatically marked as discovered when they persist
• 🛡️ Improved Placement: Significantly reduced item loss with better position tracking
• 🛒 Selling Items: Items can be sold at extraction points (not in Service Station/Shop level)
• 🎮 Multiplayer Support: Fully compatible with multiplayer sessions
• 🧩 Mod Compatibility: Works with REPOLib

Installation

Requirements

• BepInEx 5.4.x or later
• REPOLib 1.4.2 or later (recommended, but mod will work without it)

Installation Steps

1. Make sure BepInEx is installed
2. Install REPOLib (optional but recommended for full functionality with modded items)
3. Extract the mod archive into your BepInEx/plugins folder
4. Launch the game and enjoy persistent items in your truck!

How It Works

1. Place valuable items inside your truck
2. When changing levels, TruckLoot will save the state of those items
3. Upon returning to the truck in a new level, your items will appear exactly as you left them
4. If items somehow end up in invalid positions, TruckLoot will automatically find safe positions for them

Mod Behavior

• Items are only saved if they are inside the truck when you leave a level
• Items are not saved when failing a level or entering an arena/boss level
• The mod automatically handles multiplayer sessions, ensuring items appear for all players
• Items persist with their exact values and can be sold at extraction points
• Important: Items cannot be sold at the Service Station/Shop level, but can be sold at the extraction point in the next level

Compatibility

This mod should be compatible with most other mods as it only affects the persistence of valuable items. It works in both single-player and multiplayer.

REPOLib Compatibility

TruckLoot has special integration with REPOLib to support modded items.

Known Issues (FIXME)

• Items cannot be sold directly at the Service Station/Shop level - you must bring them to the next level to sell
• Items values reset to their max price upon entering new level, they still take physics damage in the truck

Tips

• Keep valuable items away from the truck edges for best persistence
• Organize items in the center of the truck for maximum reliability
• To sell your persistent items, take them to a level with an extraction point (not the Service Station/Shop level)

Credits

• Created by Maflingus
• Thanks to the REPOLib team for their valuable item framework
• Thanks to the BepInEx team for their amazing modding framework

Changelog

v1.0.4

• Significantly improved item positioning accuracy
• Fixed most issues with items disappearing between levels
• Added support for selling items at extraction points (non-Shop levels)
• Better handling of truck orientation differences between levels
• Improved error handling and logging

v1.0.3

• Various bug fixes

v1.0.2

• Various bug fixes

v1.0.1

• Various bug fixes

v1.0.0

• Initial release
• Added item persistence between levels
• Added safe positioning system
• Added arena level detection
• Added REPOLib integration for modded items
• Added multiplayer support

License

This mod is released under the MIT License. See LICENSE file for details.

Support

If you encounter any issues or have suggestions, please submit bug reports to @Maflingus on Discord.

Enjoy keeping your treasures! 💎