PlaceryExtended

Precision deployable placement for creative Rust builds.

PlaceryExtended is a highly configurable Rust plugin that allows players to place deployables on walls, ceilings, terrain, player-built bases, player boats, and other non-standard surfaces. It includes custom alignment, personal placement toggles, cooldowns, authorization rules, blacklist and whitelist controls, NoEscape integration, rotate mode, custom mounting, and underwater IO routing.

Latest Features

• Player boat placement support.
• Cannons can be placed on player bases and mounted using custom mount logic.
• Terrain placement with its own configurable rules.
• Underwater base support.
• Rotate Mode: hold a deployable placed with PlaceryExtended and press R to rotate it.
• Underwater IO Tool support for electrical, industrial, and fluid connections.
• CubeBuild compatibility.

Work in Progress

• Door placement on floor.frame.
• Improved stacking for custom deployables.

Key Features

• Flexible placement: Place supported deployables on walls, ceilings, terrain, bases, boats, and other unconventional surfaces.
• Custom alignment: Deployables are automatically aligned using surface-aware angle logic.
• Mounted furniture support: Chairs, sofas, computer stations, and supported mounted entities can use custom mounting logic.
• Skin support: Placed items retain their skin ID.
• Industrial compatibility: Supports storage adapters and compatible industrial, electrical, and fluid connections.
• Permission-based access: Players require placeryextended.use; administrators can receive separate bypass permissions.
• Personal placement toggle: Players can enable or disable PlaceryExtended for themselves with /toggleplacery.
• Dynamic blacklist management: Administrators can add or remove blocked item shortnames without manually editing the config.
• NoEscape integration: Placement can be blocked while a player is combat-, raid-, or escape-blocked.
• Cooldown and radius controls: Helps prevent spam and exploitative rapid placement.
• Language support: User-facing messages can be customized through the plugin's language file.

How Placement Works

• Use right-click during deployment to invoke PlaceryExtended placement. Holding right-click is also supported.
• Use left-click to continue using Rust's normal placement behavior.
• Players normally need authorization from a nearby Tool Cupboard, according to the selected placement-context rules.
• Administrators with the relevant bypass permission can place deployables without normal Tool Cupboard authorization.

PlaceryExtended extends Rust's placement system without replacing normal left-click placement.

Mounted Chairs, Sofas, and Computer Stations

• Place the entity with PlaceryExtended using right-click.
• Ensure the entity faces outward and is not obstructed.
• Approach it and press E to mount.
• Press E again to dismount.

Permissions

• placeryextended.use - Allows a player to use PlaceryExtended features.
• Administrative bypass permissions can be used for server moderation, events, or creative building workflows.

Commands

Player Commands

• /toggleplacery - Enables or disables PlaceryExtended placement for the player.
• /placeryhelp - Displays available PlaceryExtended commands.

Admin Commands

• /addblacklist <shortname> - Adds an item shortname to the blacklist.
• /removeblacklist <shortname> - Removes an item shortname from the blacklist.
• /getblacklist - Displays all blacklisted items.
• /clearblacklist - Clears the blacklist.
• /reloadplacery - Reloads the plugin configuration.

Compatible Deployables

PlaceryExtended is designed to work with most deployable items, including:

• Furniture: Chairs, beds, sofas, and lockers.
• Doors: Garage doors, double doors, and hinged doors when enabled.
• Electrical: Smart switches, ceiling lights, and other electrical deployables.
• Farming: Seeds and other farming deployables on unconventional surfaces.
• Storage: Coffins, boxes, lockers, and compatible storage containers.
• Defenses: Turrets, barricades, mines, and other defensive deployables when permitted by configuration.

Server owners retain full control through context-specific blacklists, whitelists, surface rules, and authorization settings.

Ideal For

• Creative and build servers.
• PvE servers and custom events.
• PvP and arena maps.
• Roleplay servers.
• Underwater bases.
• Custom player-boat builds.

UberTool may conflict with PlaceryExtended placement behavior. Disable the conflicting functionality if both plugins are installed.

Installation

• Place PlaceryExtended.cs in your server's oxide/plugins directory.
• Allow the plugin to load, or reload it through your framework/server console.
• Edit oxide/config/PlaceryExtended.json as required.
• Reload PlaceryExtended after saving configuration changes.

Configuration

The following is the supplied example configuration:

Extended Placement List

Copy the following array into the appropriate placement section of your configuration if you want to use this extended set:

Developer API Hooks

Before Placement

Called before PlaceryExtended creates and places a deployable.

After Placement

Called after PlaceryExtended successfully creates, spawns, and deploys an entity.

Support

Join the Plugins by Duff Discord for updates and support:

https://discord.gg/2KBPH7hXb7

Build your base your way with PlaceryExtended.