Beetleball Sandbox

A creative MelonLoader menu for the Beetleball Demo IL2CPP build. It provides local sandbox tuning, host tools, camera controls, announcements, player utilities, and Beetle Egg quality-of-life options.

Intended for offline play and consensual private/custom servers. Respect the lobby host and other players.

Installation

Install with Thunderstore Mod Manager or r2modman. The package declares MelonLoader 0.7.3 as a dependency.

For a manual installation, install MelonLoader 0.7.3 first and place BeetleballSandbox.dll in the game's Mods folder.

Opening the menu

• Press F5 or Insert to open or close the menu.
• The menu locks Beetleball's gameplay input while open, preventing menu clicks and typing from moving the camera or beetle.
• Use the PLAYER, BALL, SERVER, PLAYERS, MESSAGE, and EGGS tabs.

Features

• Player movement, sprint, jump, gravity, size, flight/glide speed, cooldown, and anti-stun tuning.
• Ball mass, gravity, freeze, scale, launch, spin, recall, stop, spawn, and loose-dung controls.
• Global ball sizing, all-player cooldown controls, hosted match reset/restart, spectator spawning, team selection, and player freeze/scale tools.
• FOV, manual camera distance, and automatic camera distance for very large beetles.
• Local XP and exact-level controls, including a persistent local display override when Steam rejects an unusually high value.
• Local Beetle Egg rarity override and accelerated hatch animation.
• Connected-session messages through Beetleball's all-player chat, with on-screen popup mirroring when the receiving client also runs Beetleball Sandbox.
• Saved local privacy/display options for lobby notices, leaderboard visibility, and the connected player board.

Multiplayer behavior

• Local and owner-safe settings apply immediately.
• Shared world changes remain subject to Beetleball's server authority. A vanilla host can accept only the game's own permitted RPCs; mod-specific requests require a modded host.
• The modded host's custom joined-client relay is session-only and OFF by default. A host must explicitly enable it on the SERVER tab before modded joined clients can request shared world/admin changes.
• Unmodified clients can receive built-in chat announcements and server-synchronized world changes. Arbitrary on-screen popup text requires this mod on the receiving client because Beetleball has no stock text-popup ClientRpc.
• Persistent XP, levels, skins, and currency belong to each player's local Steam profile service and cannot be granted remotely to an unmodified client.
• The package does not bypass kicks, bans, Steam lobby ownership, connection approval, or host migration.

Compatibility and safety

• Built for the current Beetleball Demo IL2CPP release and MelonLoader 0.7.3.
• Game updates may require a new build because generated IL2CPP wrappers can change.
• No installer, native executable, telemetry, or external web service is bundled. The archive contains only documentation, the icon, manifest, and managed mod DLL.
• Custom host relay access uses secure defaults: disabled for every new session unless the host knowingly opts in.
• Extreme physics values can destabilize a match. Use large multipliers carefully and only where everyone has agreed to sandbox play.

Troubleshooting

Check Beetleball Demo/MelonLoader/Latest.log for Beetleball Sandbox loaded. MelonLoader mods cannot be hot-reloaded, so close and restart Beetleball after replacing the DLL.

Credits

Created by cody with Codex-assisted development.

Changelog

0.3.5

• Prepared the first Thunderstore package with a MelonLoader dependency, upload documentation, and an original 256×256 icon.
• Removed dormant destructive test routines, including server-update flooding, automatic match disruption, and bulk item duplication.
• Changed the mod-specific joined-client world/admin relay to a visible, session-only host opt-in that defaults to disabled.
• Retained the normal sandbox, host-admin, camera, announcement, spectator, progression, and Beetle Egg tools.

0.3.4

• Removed the ineffective client-side kick/ban interception that caused false host-migration timeouts after the host had already removed the Steam/Netcode connection.
• Restored Beetleball's normal clean removal flow.

0.3.3

• Mirrored labeled server/custom chat messages into Beetleball's local on-screen popup system for clients running the mod.
• Added duplicate suppression when the direct modded popup route and built-in chat route both arrive.

0.3.2

• Removed the unstable experimental match-XP multiplier.
• Improved spectator team spawning, infinite flight/glide behavior, privacy/display settings, egg tools, and scene-transition safety.