BurglinSpawns

BurglinSpawns is a lightweight, reflection-based utility mod and spawn menu designed for Burglin' Gnomes. It gives players and hosts the ability to search, spawn, and directly add items, vehicles, furniture, or networked prefabs straight into the game world or inventory with zero hardcoded game dependencies.

Features

• In-Game Spawner Window: Press F6 (configurable) to toggle the clean, user-friendly graphical menu.
• Dual Spawning Modes:
  • Spawn: Drops items, props, or networked entities directly in front of your camera.
  • Give: Instantly places supported items straight into your character's inventory (host/equipment path supported).
• Comprehensive Cataloging: Automatically scans both the game's item lists and NetworkManager registries at runtime.
• Multiplayer Support: Host-authoritative design allows clients to request spawns or items safely via Netcode for GameObjects custom messaging channels.
• Log Filtering: Intentionally suppresses and swallows noisy out-of-flow exception spam (such as uninitialized room warnings or car suspension traces) to keep your BepInEx console clean.
• Zero External References: Built entirely using BepInEx and reflection to resolve classes at runtime, requiring no game DLL references for compilation.

Note on Prefabs: Several raw prefabs found in the network registry are not inherently meant to be spawned manually outside of their normal game flow. Attempting to spawn certain objects or spawning large numbers of them at once may cause console errors or unexpected behavior.

Installation

1. Ensure you have BepInEx installed correctly for Burglin' Gnomes.
2. Download the latest release of BurglinSpawns.dll.
3. Drop the DLL file into your BepInEx/plugins/ directory.
4. Launch the game and join a run or lobby to populate the item registry.

Usage

• Toggle Menu: Press F6 during gameplay to open or close the spawner window.
• Rescan: If items or prefabs do not appear immediately, join an active game session and click the Rescan button in the top left of the menu.
• Search & Select: Type keywords into the search bar to filter through available items and prefabs, then click an entry to select it.
• Spawn / Give: Adjust the desired quantity using the numeric input field and click Spawn to drop items in front of you, or Give to add them to your inventory.
• Clear Spawned: Hosts can click Clear spawned to clean up objects spawned during the session.

Configuration

The mod generates a configuration file at BepInEx/config/com.odinplus.burglinspawns.cfg upon first launch. You can customize the following settings using any text editor or a configuration manager mod:

• ToggleKey: The keyboard shortcut used to open and close the spawner window (Default: F6).
• Distance: How far in front of the player's camera items will spawn (Default: 2.5f).
• MaxAmount: The safety cap limit on the number of items that can be spawned in a single click (Default: 50).