ApartmentController

Take control of Rust’s Apartment Complex monument.

ApartmentController gives server owners a much better way to manage apartments, master keys, break-ins, raid protection, rentable shops, item recovery, and monument settings.

Rust’s native Apartment monument is useful, but server owners normally have very limited control over it. This plugin expands the monument into something you can actually manage, balance, protect, and build server features around.

Use it for PvE servers, RP servers, VIP apartments, protected player housing, controlled shop rentals, custom economy balancing, or simply to make the Apartment monument cleaner and easier to administrate.

What It Does

ApartmentController lets you control how the Apartment Complex works on your server.

You can change apartment prices, adjust rent, control master keys, protect rooms from break-ins, manage rentable shops, recover player items after evictions, and give admins useful tools for handling the monument without relying only on native Rust behavior.

Players get clearer messages, safer paid actions, confirmation prompts, and a recovery command for saved items.

Admins get proper commands to inspect rooms, assign apartments, evict rooms, check shops, close shops, apply turret skins, and manage the monument much more easily.

Features

• Custom apartment purchase and upgrade control
• Configurable apartment prices and daily rent
• Confirmation UI before paid apartment actions
• Chat fallback confirmation with /apt confirm
• Optional teleport after buying or upgrading an apartment
• Security NPC master key control
• Security NPC paid-door control
• Custom master key pricing
• Master key cooldown, window, and wipe limits
• Permission-based apartment raid protection
• Permission-based rentable shop raid protection
• Protected break-in blocking
• Optional owner notifications when protected rooms or shops are attacked
• Rentable shop admin tools
• Rentable shop item recovery before forced closure
• Apartment item recovery before eviction
• /apt recover for saved apartment and shop items
• Login reminders for pending recoveries
• Configurable recovery expiry
• Overflow item drop support
• Vending machine item restriction support
• Apartment monument turret skinning
• Room entity modifier support
• Cleaner chat output with prefix, colors, and optional SteamID icon
• Admin test tools for safe local testing

Apartment Control

ApartmentController lets you decide how apartment renting should work on your server.

You can keep native Rust behavior, or enable custom handling for more control.

You can configure:

• Basement apartment price
• Medium apartment price
• Penthouse apartment price
• Upgrade prices
• Daily rent values
• Free rent hours
• Rent scaling
• Eviction delay
• Purchase and upgrade confirmation
• Player teleport after purchase or upgrade

This makes it much easier to balance apartments around your server economy.

Confirmation UI

Important paid actions can use a clean confirmation UI before scrap is taken.

This helps prevent accidental purchases and makes apartment actions feel more polished for players.

The confirmation UI can be used for:

• Buying apartments
• Upgrading apartments
• Buying master keys from the Security NPC
• Opening the Security NPC paid door

If you do not want to use the UI, players can confirm through chat using /apt confirm.

Security NPC Control

ApartmentController gives you more control over the Apartment monument Security NPC.

You can decide whether players are allowed to buy master keys, whether they need permission, how much keys cost, and how often players can receive them.

You can also control the paid security door, including custom price, permission requirement, and how long the door stays open.

This is useful if you want master keys to be rare, VIP-only, limited per wipe, or balanced around your server economy.

Master Key Limits

Master keys can be powerful, so ApartmentController includes limit options.

You can limit master keys by:

• Cooldown
• Purchase window
• Wipe limit
• Permission bypass
• Refund behavior when blocked

This helps prevent players from stacking too many master keys or bypassing your intended apartment raiding balance.

Raid Protection

ApartmentController can protect apartments from break-ins when the owner has permission.

This is useful for PvE servers, VIP housing, RP apartments, staff housing, or any server where some apartments should not be raidable.

Raid protection can:

• Block protected apartment break-ins
• Prevent master key consumption when blocked
• Cancel break-ins immediately
• Force-close the apartment door
• Eject raiders from protected rooms
• Notify owners when someone tries to break in

Rentable shops can also be protected with their own permission-based raid protection.

Rentable Shop Control

ApartmentController also gives admins better control over the rentable shops at the Apartment Complex.

Admins can list shops, inspect shop state, close shops, evict shops, check owners, and create item recoveries before forced closures.

You can control shop-related settings such as:

• Rent per hour
• Initial shop fee
• Takeover protection
• Stored item reclaim time
• Shop raid protection
• Shop robbery behavior
• Vending machine restrictions

This gives server owners much more control over how the Apartment monument shops are used.

Item Recovery

One of the most useful parts of ApartmentController is the recovery system.

When configured, the plugin can save items before forced apartment evictions or forced shop closures. Players can then claim those saved items with /apt recover.

This helps prevent unfair item loss when admins need to clean up apartments or close shops.

Recovery supports:

• Apartment eviction recovery
• Rentable shop recovery
• Saved item data
• Item contents
• Skins and custom names
• Expiry timers
• Login reminders
• Inventory-first delivery
• Drop overflow at player feet
• Automatic cleanup after successful recovery

Apartment Monument Turret Skinning

Admins can apply a saved skin to Apartment monument turrets.

This is useful for servers that want the monument to match a theme, VIP area, city zone, RP district, or custom server style.

Commands allow admins to set or clear the turret skin, and the plugin can reapply the saved skin after restart or when turrets spawn.

Room Entity Modifiers

ApartmentController can modify selected room entities after a player receives or upgrades an apartment.

This can be used to give better apartments better room setups.

The default idea is simple:

• Medium apartments can receive a Workbench Level 2
• Penthouse apartments can receive a Workbench Level 3
• Permissions can be required for these upgrades

This gives server owners another way to make apartment tiers feel more valuable.

Commands

Player Commands

/apt recover
Recover pending apartment or shop items.

/apt confirm
Confirm a pending paid action when chat confirmation is used.

Main Admin Commands

/apt help
Show the main ApartmentController command overview.

/apt status
Show cached apartments, shops, and buildings.

/apt list
List apartment rooms.

/apt info <room>
Show details about a specific apartment room.

/apt player <player>
Find a player's apartment.

/apt cancelraid <room>
Cancel an active apartment break-in.

/apt owner <add/remove> <room> <player>
Add or remove room owners.

/apt tp <room>
Teleport to an apartment room.

/apt evict <room>
Evict a room using configured cleanup/recovery behavior.

/apt give <player> <room>
Assign a room to a player.

/apt key <player> [amount]
Give master keys to a player.

/apt prices
Show apartment price information.

/apt furniture <room>
Dump room furniture information to console.

/apt setturretskins <skinId>
Apply and save a monument turret skin.

/apt clearturretskins
Clear the saved monument turret skin.

/apt prefab
Debug the entity you are looking at.

/apt convodump
Dump apartment vendor conversation data to console.

/apt reload
Reload settings, rebuild cache, and reapply plugin changes.

Rentable Shop Commands

/aptshop help
Show shop command help.

/aptshop list
List rentable shops.

/aptshop info <shopNumber>
Show details about a rentable shop.

/aptshop close <shopNumber> confirm
Close a shop and create recovery data if enabled.

/aptshop evict <shopNumber> confirm
Evict/close a shop and create recovery data if enabled.

/aptshop clearintruders <shopNumber>
Show intruder cleanup support state.

/aptshop intruder <add/check> <shopNumber> <player>
Add or check shop intruder state.

/aptshop renttick
Run the native shop rent tick.

Development Test Commands

ApartmentController includes optional test commands for setup and local testing.

These are disabled unless enabled in the config.

/apttest fakerent <room>
Create a fake apartment tenant.

/apttest fakeowner <room>
Create a fake apartment owner.

/apttest fakeevict <room>
Test apartment eviction cleanup.

/apttest rentdue <room>
Simulate native rent eviction checkout.

/apttest raidstart <room>
Start a test apartment break-in.

/apttest raidcancel <room>
Cancel a test apartment break-in.

/apttest protect <room>
Add raid protection to fake apartment owners.

/apttest unprotect <room>
Remove raid protection from fake apartment owners.

/apttest info <room>
Show test room information.

/apttest cleanup
Clean up fake test players and test data.

/aptshop test fakerent <shopNumber>
Create a fake shop tenant.

/aptshop test intruder <shopNumber>
Add yourself as a shop intruder.

/aptshop test renttick confirm
Run shop rent tick test.

/aptshop test close <shopNumber> confirm
Close a fake test shop.

/aptshop test protect <shopNumber>
Add fake shop raid protection.

/aptshop test unprotect <shopNumber>
Remove fake shop raid protection.

/aptshop test info <shopNumber>
Show test shop information.

/aptshop test cleanup
Clean up fake shop and apartment test data.

Permissions

apartmentcontroller.use
Allows access to basic ApartmentController commands.

apartmentcontroller.admin
Allows main apartment admin commands.

apartmentcontroller.bypass
Bypass/admin access used by plugin checks.

apartmentcontroller.raidprotect
Allows apartment raid protection.

apartmentcontroller.masterkey
Master key-related permission.

apartmentcontroller.masterkey.bypasscooldown
Bypasses master key cooldown and limit checks.

apartmentcontroller.shop.admin
Allows rentable shop admin commands.

apartmentcontroller.shop.breakin
Permission used for shop break-in/robbery behavior.

apartmentcontroller.security.masterkey
Allows Security NPC master key purchase when permission is required.

apartmentcontroller.security.door
Allows Security NPC paid-door use when permission is required.

apartmentcontroller.roomentity.mediumworkbench2
Allows configured Medium apartment workbench replacement.

apartmentcontroller.roomentity.penthouseworkbench3
Allows configured Penthouse workbench replacement.

apartmentcontroller.test
Allows development test commands when test tools are enabled.

Why Use ApartmentController?

ApartmentController is made for server owners who want the Apartment Complex monument to be more useful, more controllable, and easier to manage.

Instead of leaving the monument mostly locked to native Rust behavior, this plugin gives you the tools to shape it around your server.

You can use it to create protected apartments, VIP housing, balanced apartment pricing, controlled shop rentals, safer evictions, cleaner recoveries, and better admin control over one of Rust’s newest monument systems.

If your server uses the Apartment Complex, this plugin gives you the control that the native monument is missing.

Futher Information:

ApartmentController is built with live-server performance in mind. It uses cached monument entities, targeted hooks, pooled lookups where needed, configurable logging, and cleanup on unload to avoid unnecessary background work.

Support

For setup help, updates, and support, join my Discord:

Plugins By Duff
https://discord.gg/jewGrSqHB4