PlaceryGrab

PlaceryGrab

The building tool your players always wished Rust had.

PlaceryGrab gives your players a custom toolgun that lets them move, rotate, flip, scale, and fine-tune supported entities they own directly in the world.

No more destroying a perfectly good setup because a deployable is slightly out of place. No more rebuilding an interior because one object was placed badly. Players can correct their own placements, improve their builds, and create far more detailed bases while you stay in control of what they are allowed to edit.

PlaceryGrab is built for PvE servers, roleplay communities, creative builders, housing systems, and servers looking for a useful builder or VIP perk.

IMPORTANT INFORMATION

PlaceryGrab is made for player use. It is not an unrestricted admin move tool handed to everyone.

You control access through permissions, timed use, cooldowns, ownership checks, Tool Cupboard authorization rules, entity category access, grab blacklists, and scaling blacklists.

Players can be limited to editing their own valid entities within the rules you choose for your server.

This means PlaceryGrab can be offered as:

• A general PvE quality-of-life feature
• A VIP builder perk
• A reward for trusted players
• A roleplay housing tool
• A creative building permission
• A progression or donor benefit

WHAT CAN PLAYERS DO?

With access to the Placery Toolgun, players can:

• Grab and reposition supported owned entities
• Rotate entities and make fine placement adjustments
• Flip supported entities
• Scale supported deployables
• Push and pull entities into better positions
• Raise or lower supported placements
• Edit supported doors and ladder hatches in place
• Save their placement changes directly in the world
• Undo or revert changes while editing
• Use helpful in-game UI and messages while building

The tool makes decorating, interior design, utility placement, and detailed PvE building much easier without removing server control.

WHY SERVER OWNERS USE IT

Rust building can be unforgiving. A player places a furnace, storage box, switch, decorative object, door, or deployable slightly wrong and their only normal option is often to remove it and try again.

PlaceryGrab changes that.

Players can select their own supported entity, adjust it in place, then save the final position when they are happy with it.

This is especially useful for:

• Detailed home interiors
• Decorative builds
• Roleplay locations
• Clean utility rooms
• Better electrical layouts
• Custom shops and community builds
• Polished PvE bases and compounds

MAIN FEATURES

• Custom player toolgun system
• Free Move mode for repositioning entities
• Rotate mode with fine control
• Scaling mode for supported deployables
• Direct Edit mode for supported non-door entities
• Door and ladder hatch editing support
• Flip support for compatible entities
• Undo and revert handling while editing
• Ownership and Tool Cupboard authorization rules
• Timed access permissions
• Command cooldown permissions
• Tracked entity persistence
• Restart-safe handling
• Preview image and preview text UI options
• Configurable controls, release behavior, snapping, scaling, and blacklists

PLAYER COMMANDS

/placerygrab
Activates or deactivates PlaceryGrab mode.

/placerygrabhelp
Shows the player help menu and access information.

/placeryui on
Enables the hammer and entity information UI.

/placeryui off
Disables the hammer and entity information UI.

ADMIN COMMANDS

/placeryfixscale
Administrative scale maintenance command.

/placerycleardata confirm
Clears PlaceryGrab tracked data.

/placeryreloadimages
Reloads configured preview images.

DEFAULT CONTROLS

Left Click
Grab an entity or perform the primary action.

Right Click
Use the secondary edit action.

E
Save or release the current entity.

R
Cycle between available edit modes.

Shift
Use smart collide or fine adjustment behavior.

Middle Mouse
Flip a supported entity.

Hold Right Click
Undo or revert while grabbing.

Controls and behavior can be adjusted in the configuration.

PERMISSIONS

Basic Access

PlaceryGrab.grab.use
Standard player access to PlaceryGrab.

PlaceryGrab.grab.use.admin
Administrative access.

Timed Access

PlaceryGrab.grab.use.unlimited
Unlimited tool access.

PlaceryGrab.grab.use.30s
30 seconds of tool access.

PlaceryGrab.grab.use.60s
60 seconds of tool access.

PlaceryGrab.grab.use.120s
120 seconds of tool access.

Cooldown Permissions

PlaceryGrab.use.commandcooldown20s
20 second command cooldown.

PlaceryGrab.use.commandcooldown40s
40 second command cooldown.

PlaceryGrab.use.commandcooldown60s
60 second command cooldown.

PlaceryGrab.use.commandnocooldown
No command cooldown.

SPECIAL ENTITY ACCESS

Additional access can be configured for supported categories such as:

• Resources
• Animals
• NPC-related entities
• Vehicles
• Nature Deployables bypass support

This lets you keep ordinary player access limited while offering wider editing options to selected groups or staff.

CONFIGURATION

PlaceryGrab includes settings for:

• Chat messages
• Grab distance and movement smoothness
• Rotation behavior
• Ownership checks
• Tool Cupboard authorization rules
• Release and snapping settings
• Scaling limits
• Grab blacklists
• Scaling blacklists
• Custom controls
• UI and game tips
• Preview image and preview text settings
• Tracked entity handling
• Tool Cupboard grace period behavior

You can keep the plugin tightly restricted as a simple placement correction tool, or open up more functionality for dedicated builder ranks and creative communities.

BLACKLIST FORMAT

Grab and scaling blacklists use entity or deployable short names, not full prefab paths.

Valid examples:

door.hinged.toptier
wall.frame.garagedoor
andswitch.entity
generator.small
storageadaptor.deployed
industrialcrafter.deployed

Do not use full prefab paths such as:

assets/prefabs/deployable/playerioents/storageadapter/storageadaptor.deployed.prefab

Use the short entity name format when blocking entities from grabbing or scaling.

BUILT FOR PLAYER CREATIVITY, CONTROLLED BY THE SERVER OWNER

PlaceryGrab gives builders a tool that feels genuinely useful without turning normal players into unrestricted admins.

Players get more freedom to improve their own builds. Server owners keep control through permissions, cooldowns, ownership rules, Tool Cupboard checks, blacklists, and configuration.

For PvE, roleplay, housing, creative building, or builder perk servers, PlaceryGrab adds a feature players will actually notice and enjoy using.

CREDITS

Special thanks to @ninitsukino for the amazing images of her builds created with PlaceryGrab.

A huge thank you to @ilineus for the dedicated testing, feedback, and ideas throughout the development of PlaceryGrab. Your input has had a major impact on the plugin, and it would not be what it is today without your help.

Thanks as well to the test players at J.A.R.V.I.S Rust PvE Server for helping test the plugin and sharing their feedback.

SUPPORT AND UPDATES

PlaceryGrab Discord:
https://discord.gg/rN7gSb98

Plugins By Duff:
https://discord.gg/2KBPH7hXb7