BuildingGrenade

Features

• Deploy complete predefined buildings by throwing a specially configured construction capsule.
• Automatically positions structures at the capsule’s landing point and aligns them with the player’s viewing direction.
• Optional animated construction places large buildings progressively instead of spawning everything at once.
• Pack existing bases into reusable deployment capsules.
• Copy buildings without removing the original structure.
• Captures building blocks, deployables, inventories, locks, electrical entities, and connected base components.
• Saved bases can be named, listed, renamed, and distributed as unique non-stackable capsules.
• Configurable Tool Cupboard authorization, ownership, building-privilege, and building-blocked checks.
• Automatic ground detection and stability handling for reliably deployed structures.
• Undo function removes the most recently deployed base and returns its capsule.
• Dedicated maintenance commands can clean invalid electrical connections and invisible locks.
• Direct BKits integration allows saved buildings to be included in equipment kits.

Chat Commands

Command / Description

/bgive [building] [amount] → Gives the administrator deployment capsules for a configured building.
/bpack [amount] → Gives the administrator capsules used to pack existing bases.
/back → Removes the player’s most recently deployed base and returns its capsule.
/Bcopy [name] → Copies the targeted base and creates a named deployment capsule without removing the original.
/Bcopy here [name] → Copies the base at the administrator’s current position.
/bcopy → Lowercase alias for /Bcopy.

/bgrenade → Displays the BuildingGrenade command overview.
/bgrenade help → Displays the BuildingGrenade command overview.
/bgrenade list → Lists all predefined buildings from the configuration.
/bgrenade saved → Lists all saved or packed bases with their names and IDs.
/bgrenade give <name|id> [amount] → Gives deployment capsules for a saved base.
/bgrenade givepacked <name|id> [amount] → Alternative command for giving saved-base capsules.
/bgrenade rename <name|id> <new name> → Renames a saved base.
/bgrenade packhere [name] → Packs the base at the administrator’s current position without throwing a capsule.
/bgrenade packtarget [name] → Packs the currently targeted base without throwing a capsule.
/bgrenade reload → Reloads the plugin configuration.
/bgrenade fixio [radius] → Removes invalid electrical connections and orphaned IO ports within the selected radius.
/bgrenade fixlocks [radius] [force] → Removes invisible or invalid locks within the selected radius.

Permissions

buildinggrenade.use – allows players to throw construction capsules and use /back.
buildinggrenade.admin – allows access to capsule distribution, base packing, copying, saved-base management, configuration reload, and maintenance commands.

Rust administrators can be granted automatic access through the plugin configuration.

Players with buildinggrenade.admin should also receive buildinggrenade.use if they are not Rust administrators and need to deploy capsules themselves.

Usage

Grant the player buildinggrenade.use and grant administrators buildinggrenade.admin.
Use /bgive [building] [amount] to receive a deployment capsule for a configured structure.
Equip the capsule, face the desired construction direction, and throw it at a valid location.
When the capsule lands, the selected building is positioned and constructed at the impact point.

Use /bpack to receive a packing capsule.
Throw it at an authorized base to capture the connected structure and receive a reusable deployment capsule.
The packed base can include its building blocks, deployables, inventories, locks, and supported electrical components.

Administrators can use /Bcopy [name] while targeting a base to create a reusable copy without removing the original.
Use /bgrenade saved to find the saved base name or ID and /bgrenade give <name|id> to create additional deployment capsules.
If the last deployed building was placed incorrectly, use /back to remove it and recover the capsule.