Weights Rebalanced

Customize item weights in kilograms with full multiplayer synchronization, preset system, and hot reload support.

Features

Core Functionality

• Kilogram Display - All weights shown in kg instead of pounds
• Per-Item Configuration - Customize weight for every item in the game
• Automatic Item Detection - Works with vanilla and modded items automatically
• Config Validation - Prevents invalid weights (0.1-500 kg range)

Multiplayer Support

• Host-to-Client Sync - Host's weights automatically sync to all clients
• Late Join Support - Players joining mid-game receive correct weights
• Hot Reload - Change weights mid-game and see instant results
• Auto-Restore - Clients restore their local config on disconnect

Quality of Life

• Preset System - Save and load weight configurations
• Import/Export - Share presets with friends
• Enhanced Descriptions - Config shows vanilla weights and valid ranges
• Diagnostic Tools - Check item detection and network status

Optional LethalConfig Integration

If you have LethalConfig installed, you get:

• In-game GUI for all settings
• Sliders for easy weight adjustment
• Buttons for presets, diagnostics, and network status
• No restart needed for changes

Installation

Automatic (Mod Manager)

1. Install via r2modman or Thunderstore Mod Manager
2. Launch game - config will be generated automatically

Manual

1. Install BepInEx 5.4.21
2. Download WeightsRebalanced.zip
3. Extract to Lethal Company folder
4. Launch game

Configuration

Config File Location

BepInEx/config/com.weights.rebalanced.cfg

Example Configuration

[General]
# Enable/disable weight modifications
EnableWeightModifications = true

[Scrap Items]
# Weight in kilograms
# Vanilla weight: 1.5 kg
# Valid range: 0.1-500 kg
Whoopie cushion = 1.5

# Make valuable items heavier for balance
Gold bar = 25.0

Item Categories

Items are automatically organized into sections:

• Scrap Items - Collectible scrap (Whoopie cushion, Gold bar, etc.)
• Equipment - Tools and gear (Flashlight, Shovel, Walkie-talkie, etc.)
• Store Items - Purchasable items (TZP-Inhalant, Lockpicker, etc.)
• Modded Items - Items from other mods (auto-detected)

Usage

Changing Weights

1. Via LethalConfig (if installed):

   • Press F1 in-game
   • Navigate to Weights Rebalanced
   • Adjust sliders
   • Changes apply instantly

2. Via Config File:

   • Edit BepInEx/config/com.weights.rebalanced.cfg
   • Change values (in kg)
   • Save file
   • Changes apply on next item spawn (or use hot reload)

Using Presets

Save Current Weights

F1 → Weights Rebalanced → Presets → Save Current as Preset

Preset saved to: BepInEx/config/WeightsRebalanced/Presets/Custom_YYYY-MM-DD_HH-mm.txt

Load Vanilla Weights

F1 → Weights Rebalanced → Presets → Load Vanilla Weights

Share Presets

1. Navigate to BepInEx/config/WeightsRebalanced/Presets/
2. Copy your .txt preset file
3. Share with friends
4. They copy it to their Presets folder

Multiplayer

As Host

• Your weights automatically sync to all clients
• Clients see your configured weights
• Change weights mid-game - clients receive updates instantly

As Client

• Automatically receive host's weights on connect
• Your local config is temporarily overridden
• Original config restores when you disconnect
• Check sync status: F1 → Network Sync Status

Commands & Diagnostics

Check Network Status

F1 → Weights Rebalanced → Network Sync Status

Shows:

• "Using HOST'S weights" - Client synced to host
• "You are HOST" - Your weights control the server
• "Not in multiplayer" - Using local config

Print Item Detection

F1 → Weights Rebalanced → Diagnostic: Print Item Detection

Logs all items with their detected origin (Vanilla/Modded) and category.

Reset All Weights

F1 → Weights Rebalanced → Reset All Weights

Resets all items to vanilla values.

Compatibility

Supported

• ✅ All vanilla items
• ✅ LethalConfig (optional GUI)
• ✅ Modded items (auto-detected)
• ✅ LethalLib custom items
• ✅ Multiplayer (host-client sync)

Known Issues

• None reported yet!

Technical Details

Weight Range

• Minimum: 0.1 kg
• Maximum: 500 kg
• Invalid values are clamped and logged

Performance

• Optimized HUD updates with caching
• Minimal network bandwidth (<1KB/s)
• No FPS impact (<1% overhead)

Network Protocol

• Uses Unity Netcode custom messaging
• Version-checked for compatibility
• Handles late joiners and disconnects gracefully

FAQ

Q: Do clients need the mod installed? A: Yes, all players need the mod for consistent weights.

Q: Can I use different weights than the host? A: No, host's weights override clients in multiplayer.

Q: Will this work with mod X? A: Yes! The mod automatically detects and supports modded items.

Q: Can I make items weightless? A: Minimum weight is 0.1 kg for gameplay balance.

Q: How do I reset one item to vanilla? A: Check the config file - vanilla weight is shown in the description.

Support

Report issues on GitHub or Thunderstore.

Credits

Developed with Claude Code by Anthropic.

Changelog

See CHANGELOG.md for version history.

Changelog

All notable changes to Weights Rebalanced will be documented in this file.

[2.0.1] - 2026-01-10

• Fixed manifest

[2.0.0] - 2026-01-09

Major Features

• Multiplayer Synchronization - Host-to-client weight sync via Unity Netcode
  • Automatic sync on client connect
  • Late joiner support
  • Hot reload broadcasts to all clients
  • Original config restoration on disconnect
• Dynamic Item Detection - Removed hardcoded item lists
  • Assembly-based vanilla vs modded detection
  • Automatic categorization (Scrap/Equipment/Store/Modded)
  • Works with any mod without updates needed
• Preset System - Save and load weight configurations
  • Save current weights as preset
  • Load vanilla weights preset
  • Import/export for sharing with friends
  • Simple text format for easy editing
• Hot Reload - Change weights mid-game without restart
  • Config watcher monitors changes
  • Updates all active items in real-time
  • Broadcasts to clients if host

Improvements

• Config Validation - All weights clamped to 0.1-500 kg range
• Enhanced Descriptions - Config shows vanilla weight and valid range
• Safety Helpers - Comprehensive error handling and validation
• Optimized HUD Updates - Cached inventory hash reduces CPU usage
• Performance - Event-based patching with Update fallback

LethalConfig Integration

• New buttons:
  • Save Current as Preset
  • Load Vanilla Weights
  • Network Sync Status
  • Diagnostic: Print Item Detection
• Updated slider ranges with validation
• Real-time updates without restart

Technical

• Added ConfigValidator.cs - Weight validation system
• Added SafetyHelpers.cs - Error handling utilities
• Added ItemDetection/ namespace:
  • ItemClassifier.cs - Vanilla/modded detection
  • CategoryDetector.cs - Item categorization
  • DiagnosticCommands.cs - Debug tools
• Added Presets/PresetManager.cs - Preset management
• Added HotReload/ConfigWatcher.cs - Real-time config monitoring
• Added Networking/ namespace:
  • WeightSyncManager.cs - Multiplayer synchronization
• Added Patches/NetworkPatches.cs - Network event hooks
• Improved Patches/WeightPatches.cs - Optimized HUD updates

Bug Fixes

• Fixed HUD showing "lb" instead of "kg" in all scenarios
• Fixed potential null reference exceptions
• Fixed item validation edge cases
• Fixed network sync timing issues

Removed

• Hardcoded vanilla item lists (42 scrap, 17 store, 3 equipment items)
• Update-only HUD patching (replaced with hybrid approach)

[1.0.0] - Initial Release

Features

• Customize item weights in kilograms
• Per-item configuration
• LethalConfig integration (optional)
• Weight display in kg instead of pounds
• Basic item categorization

Note: Version 1.0.0 was the initial internal release. Version 2.0.0 is the first public Thunderstore release with major enhancements.