Skip to content
← All documentation

/// SUPPORTED THIRD-PARTY PLUGIN

TruePVE

Free guide for configuring this third-party plugin in the Hub. To install it, use its plugin page or official source.

Prepare your file

  1. Check the installed version

    This guide describes TruePVE 2.4.6. Use the same version in the configurator.

  2. Get the settings

    Choose your server: its settings are retrieved automatically. An existing draft is kept. You can also import files from this device or use the defaults.

  3. Edit and apply

    Adjust settings, fix errors, then apply files to the selected server. A conflict blocks sending until you choose how to resolve it. You can still export only the files you need.

A configuration linked to the server has private backups when files are sent. Unsent edits remain in the editor. Keep your export too, to resume without connecting to the server.

Settings for this version

General 31
Configuration version
Text · required

Version marker rewritten by the plugin during config migration; keep the generated value.

JSON pathConfig Version
Default rule set
Text · required

Rule-set name used outside zones or when no zone mapping applies.

JSON pathDefault RuleSet
Zone mappings
JSON value · required

Free-form zone key to rule-set name or “exclude”; allzones has global behavior.

JSON pathMappings
Rule sets
Object list · required
JSON pathRuleSets
Entity groups
Object list · required
JSON pathEntity Groups
Allow killing sleepers
On / off · required

Allows attackers to kill sleeping players.

JSON pathAllow Killing Sleepers
Allies only
On / off · required

Allows only allies to kill a sleeping player.

JSON pathAllow Killing Sleepers (Ally Only)
Offline delay (hours)
Number · required

Allows damage to sleepers after this many offline hours; 0 disables this threshold.

JSON pathAllow Killing Sleepers (After X Hours Offline)
Allowed Steam IDs
List · required

SteamIDs of attackers allowed to kill sleepers independently of the other exceptions.

JSON pathAllow Killing Sleepers (Allowed steam ids)
Ignore firework damage
On / off · required

Ignores damage caused by fireworks in PVE rules.

JSON pathIgnore Firework Damage
Ignore campfire damage
On / off · required

Ignores damage caused by campfires in PVE rules.

JSON pathIgnore Campfire Damage
Ignore ladder damage
On / off · required

Ignores damage caused by ladders in PVE rules.

JSON pathIgnore Ladder Damage
Ignore sleeping bag damage
On / off · required

Ignores damage caused by sleeping bags in PVE rules.

JSON pathIgnore Sleeping Bag Damage
Players trigger traps in monument topology
On / off · required

Allows traps in monument topology to hurt players.

JSON pathPlayers Can Trigger Traps In Monument Topology
Players can hurt traps in monument topology
On / off · required

Allows players to damage traps in monument topology.

JSON pathPlayers Can Hurt Traps In Monument Topology
Players trigger turrets in monument topology
On / off · required

Allows turrets in monument topology to hurt players.

JSON pathPlayers Can Trigger Turrets In Monument Topology
Players can hurt turrets in monument topology
On / off · required

Allows players to damage turrets in monument topology.

JSON pathPlayers Can Hurt Turrets In Monument Topology
Players trigger SAM sites in monument topology
On / off · required

Allows static SAM sites in monument topology to target players.

JSON pathPlayers Can Trigger SAM Sites In Monument Topology
Players can hurt SAM sites in monument topology
On / off · required

Allows players to damage SAM sites in monument topology.

JSON pathPlayers Can Hurt SAM Sites In Monument Topology
Prevent hackable crate timer reset
On / off · required

Prevents damage from resetting a hackable crate countdown.

JSON pathPrevent hackable crate timer from resetting when attacked
Block scrap transport helicopter damage
On / off · required

Blocks damage caused by scrap transport helicopters.

JSON pathBlock Scrap Heli Damage
Prevent elevator crushing
On / off · required

Briefly moves a player upward to prevent elevator crushing.

JSON pathPrevent elevator from crushing players by using a short upward teleport
Block igniter damage
On / off · required

Blocks damage caused by igniters.

JSON pathBlock Igniter Damage
Block wallpaper damage
On / off · required

Blocks damage caused by wallpaper.

JSON pathBlock Wallpaper Damage
Block radioactive water damage
On / off · required

Blocks damage caused by radioactive water.

JSON pathBlock Radioactive Water Damage
Block vehicle decay damage
On / off · required

Blocks decay damage to vehicles.

JSON pathBlock Decay Damage To Vehicles
Block spray can in safe zones
On / off · required

Prevents spray-can use in safe zones.

JSON pathBlock Spray Can In Safe Zones
Prevent helicopter strafing near safe zones
On / off · required

Prevents helicopter strafing inside the protected safe-zone radius.

JSON pathPrevent heli from strafing in the inner radius of safe zones
Prevent throwing water in freezing biomes
On / off · required

Prevents players from throwing water in arctic and tundra biomes.

JSON pathPrevent players from throwing water in arctic and tundra biome
Prevent ragdoll on vehicle impact
On / off · required

Prevents ragdolling when a player is struck by another vehicle.

JSON pathPrevent ragdolling when struck by another vehicle
Experimental ZoneManager PvE zones
On / off · required

Enables experimental ZoneManager PVE-zone support; requires that integration on the server.

JSON pathExperimental ZoneManager support for PVE zones
Boat authorization 2
Required entities (tugboat)
Whole number

Minimum tugboat entity count before a sleeper may be killed aboard it.

JSON pathAllow Killing Sleepers (Player Boat And Tugboat) → Amount of entities required (Tugboat)
Required entities (player boat)
Whole number

Minimum player-made boat entity count before a sleeper may be killed aboard it.

JSON pathAllow Killing Sleepers (Player Boat And Tugboat) → Amount of entities required (Player-made Boat, must not be in edit mode)
Tool cupboard authorization 1
Minimum entity count
Whole number

Minimum building entity count before a cupboard-authorized player may kill a sleeper.

JSON pathAllow Killing Sleepers (TC Auth Only) → Amount of entities required (50 or higher recommended)
Plugin options 23
Enable damage handling
On / off

Enables TruePVE damage hooks; rules do not block damage when this handling is off.

JSON pathConfiguration Options → handleDamage
Use ZoneManager/LiteZones
On / off

Uses zone mappings only when ZoneManager or LiteZones is available.

JSON pathConfiguration Options → useZones
Skins allowed to deal damage
List

Allows damage from an entity with this skin ID despite PVE rules.

JSON pathConfiguration Options → Entities with these skin ID's can hurt anything
Trace to player console
On / off

Shows decision traces in the console of the player who enabled tracing.

JSON pathConfiguration Options → Trace To Player Console
Trace to server console
On / off

Shows TruePVE decision traces in the server console for diagnosis.

JSON pathConfiguration Options → Trace To Server Console
Write trace to file
On / off

Writes TruePVE decision traces to a log file for diagnosis.

JSON pathConfiguration Options → Log Trace To File
Maximum trace distance
Number

Maximum distance between the player who enabled tracing and the examined entity.

JSON pathConfiguration Options → Maximum Distance From Player To Trace
Prevent water extinguishing ovens
On / off

Prevents water from extinguishing base ovens.

JSON pathConfiguration Options → Prevent Water From Extinguishing BaseOven
Prevent hostile status
On / off

Prevents player hostility state from actions handled by TruePVE.

JSON pathConfiguration Options → Prevent Players From Being Marked Hostile
Allow PvP in deep sea
On / off

Allows player-versus-player damage in the deep sea.

JSON pathConfiguration Options → Allow PVP Damage In Deep Sea
Allow raiding in deep sea
On / off

Allows raid damage in the deep sea.

JSON pathConfiguration Options → Allow Raiding In Deep Sea
PvP lower height
Number

Height below which PVP damage is allowed.

JSON pathConfiguration Options → Allow PVP Below Height
PvP upper height
Number

Height above which PVP damage is allowed.

JSON pathConfiguration Options → Allow PVP Above Height
Other damage lower height
Number

Height below which other damage is allowed.

JSON pathConfiguration Options → Allow Other Damage Below Height
Other damage upper height
Number

Height above which other damage is allowed.

JSON pathConfiguration Options → Allow Other Damage Above Height
Cold damage
On / off

Allows cold to damage players despite PVE protection.

JSON pathConfiguration Options → Allow Cold Metabolism Damage
Heat damage
On / off

Allows heat to damage players despite PVE protection.

JSON pathConfiguration Options → Allow Heat Metabolism Damage
Farmable animal metabolism
On / off

Allows hunger and thirst to damage farmable animals.

JSON pathConfiguration Options → Allow Thirst And Hunger Damage To Farmable Animals
Remove mappings for removed zones
On / off

On restart, removes zone mappings from data when their zones can no longer be found.

JSON pathConfiguration Options → Auto remove mappings from data file that no longer exist on server restart
Vehicles can hurt NPCs
On / off

True lets vehicles hurt NPC players without this option’s extra check; false applies vehicle-damage rules.

JSON pathConfiguration Options → Vehicles can hurt NPC players (true = ignore this option)
Use clans
On / off

Includes Clans relationships in ally checks.

JSON pathConfiguration Options → Use Clans
Use friends
On / off

Includes Friends relationships in ally checks.

JSON pathConfiguration Options → Use Friends
Use teams
On / off

Includes équipes natives relationships in ally checks.

JSON pathConfiguration Options → Use Teams
Schedule 4
Enable schedule
On / off

Applies rule sets from schedule entries instead of remaining on the default set.

JSON pathSchedule → enabled
Use real time
On / off

Evaluates daily schedule entries using real time; when off, uses in-game time.

JSON pathSchedule → useRealtime
Broadcast changes
On / off

Announces rule-set changes triggered by the schedule to players.

JSON pathSchedule → broadcast
Entries (time rule set message)
List

Each entry defines a time and rule set; the clock used depends on useRealtime.

JSON pathSchedule → entries
Apartments 8
Enabled
On / off

Enables apartment-specific damage and access rules.

JSON pathConfiguration Options → Apartment Complex → Enabled
Allow PvP
On / off

Allows PVP damage in apartments under the conditions below.

JSON pathConfiguration Options → Apartment Complex → Allow PVP Damage
Attacker must be alive
On / off

Requires the attacker to be alive to deal PVP damage in an apartment.

JSON pathConfiguration Options → Apartment Complex → PVP Requires Attacker To Be Alive
Same room required
On / off

Requires the attacker to be in the same room as the target.

JSON pathConfiguration Options → Apartment Complex → PVP Requires Attacker In The Same Room
Allow master keys
On / off

Allows purchasing the apartment master key.

JSON pathConfiguration Options → Apartment Complex → Allow Master Key
Allow basement bribes
On / off

Allows bribing the basement security guard.

JSON pathConfiguration Options → Apartment Complex → Allow Bribe In Basement
Allow break-ins (shop)
On / off

Allows breaking into rental shops.

JSON pathConfiguration Options → Apartment Complex → Allow Break In (Rental Shop)
Allow break-ins (room)
On / off

Allows breaking into apartment rooms.

JSON pathConfiguration Options → Apartment Complex → Allow Break In (Apartment Room)
Armor damage 3
Immune skins
List

Excludes the entity with this skin ID from PVE armor-damage handling.

JSON pathConfiguration Options → Armor damage (PVE) → Skin IDs which are immune to damage
Enable NPC armor damage
On / off

Allows NPC hits to damage player armor in PVE.

JSON pathConfiguration Options → Armor damage (PVE) → Enable support for npcs to cause armor damage on hit
Headshot sound
On / off

Plays the headshot sound when an NPC hits a player’s head.

JSON pathConfiguration Options → Armor damage (PVE) → Play headshot sound when a player is headshot by an npc
Livestock 3
Prevent non-allies from leading
On / off

Stops non-allied players from leading animals raised by others.

JSON pathConfiguration Options → Livestock → Prevent non-allies from leading
Prevent non-allies from milking
On / off

Stops non-allied players from milking animals raised by others.

JSON pathConfiguration Options → Livestock → Prevent non-allies from milking
Prevent non-allies from shearing
On / off

Stops non-allied players from shearing animals raised by others.

JSON pathConfiguration Options → Livestock → Prevent non-allies from shearing
Loot protection 15
Automatic locks
JSON value

Each key is a container prefab shortname; values are codelock, keylock, or nothing.

JSON pathConfiguration Options → Loot → Auto lock (codelock, keylock, nothing)
Containers excluded from locking
List

Container prefab excluded from automatic lock settings.

JSON pathConfiguration Options → Loot → Exceptions for locks to various containers option
Enable container locks
On / off

Extends lock handling to supported container types; exceptions are listed separately.

JSON pathConfiguration Options → Loot → Enable support to allow adding locks to various containers
Code-lock anti-raiding
On / off

Blocks non-allies from entering codes on player-owned entity locks, with a shock effect.

JSON pathConfiguration Options → Loot → Enable codelock anti-raiding (team/clan/friend access only)
Protect unlocked tool cupboards
On / off

Protects access to an unlocked tool cupboard from non-allied players.

JSON pathConfiguration Options → Loot → Protect unlocked TC from being accessed by enemy players
Allow authorized players
On / off

Allows a player already authorized on the cupboard even when unlocked-cupboard protection is enabled.

JSON pathConfiguration Options → Loot → Check And Allow When Authed (applies to Protect unlocked TC)
Keep shield on death
On / off

Prevents the equipped shield from dropping on death.

JSON pathConfiguration Options → Loot → Prevent player shield from dropping on death
Keep active item on death
On / off

Prevents the active item from dropping on death.

JSON pathConfiguration Options → Loot → Prevent player active item from dropping on death
Keep Rust backpack on death
On / off

Prevents the Rust backpack from dropping on death.

JSON pathConfiguration Options → Loot → Prevent player backpack from dropping on death (Rust backpack)
Prevent using enemy car lifts
On / off

Prevents players from using enemy car lifts.

JSON pathConfiguration Options → Loot → Prevent players from using enemy car lifts
Protect sleeper loot
On / off

Prevents non-allies from looting sleepers.

JSON pathConfiguration Options → Loot → Prevent non-ally from looting sleepers
Protect corpse loot
On / off

Prevents non-allies from looting corpses.

JSON pathConfiguration Options → Loot → Prevent non-ally from looting corpses
Protect backpacks
On / off

Prevents non-allies from looting backpacks.

JSON pathConfiguration Options → Loot → Prevent non-ally from looting backpacks
Protect planters
On / off

Prevents non-allies from looting planters.

JSON pathConfiguration Options → Loot → Prevent non-ally from looting planters
Invisibility bypasses protection
On / off

Allows invisible or Vanish players to bypass TruePVE loot protection.

JSON pathConfiguration Options → Loot → Invis and vanish bypass loot protection (TruePVE only)
PvP damage reflection 6
Armor protects against reflected damage
On / off

Accounts for armor protection when calculating reflected PVP damage.

JSON pathConfiguration Options → Reflect PVP Damage Multipliers (0 = disabled, 1 = 100%) → Multiplier Allows Armor Protection
Arrow
Number

Share of arrow damage reflected to the attacker; 0 disables reflection, 1 reflects 100%.

JSON pathConfiguration Options → Reflect PVP Damage Multipliers (0 = disabled, 1 = 100%) → Arrow Damage
Blunt
Number

Share of blunt damage reflected to the attacker; 0 disables reflection, 1 reflects 100%.

JSON pathConfiguration Options → Reflect PVP Damage Multipliers (0 = disabled, 1 = 100%) → Blunt Damage
Bullet
Number

Share of bullet damage reflected to the attacker; 0 disables reflection, 1 reflects 100%.

JSON pathConfiguration Options → Reflect PVP Damage Multipliers (0 = disabled, 1 = 100%) → Bullet Damage
Slash
Number

Share of slash damage reflected to the attacker; 0 disables reflection, 1 reflects 100%.

JSON pathConfiguration Options → Reflect PVP Damage Multipliers (0 = disabled, 1 = 100%) → Slash Damage
Stab
Number

Share of stab damage reflected to the attacker; 0 disables reflection, 1 reflects 100%.

JSON pathConfiguration Options → Reflect PVP Damage Multipliers (0 = disabled, 1 = 100%) → Stab Damage
Building damage 13
Apply to twig without flag
On / off

Applies building-block damage rules to brindille blocks.

JSON pathConfiguration Options → TwigDamage (FLAG) → Apply To Twig (no flag required)
Apply to wood
On / off

Applies building-block damage rules to bois blocks.

JSON pathConfiguration Options → TwigDamage (FLAG) → Apply To Wood
Apply to stone
On / off

Applies building-block damage rules to pierre blocks.

JSON pathConfiguration Options → TwigDamage (FLAG) → Apply To Stone
Apply to metal
On / off

Applies building-block damage rules to métal blocks.

JSON pathConfiguration Options → TwigDamage (FLAG) → Apply To Metal
Apply to high quality metal
On / off

Applies building-block damage rules to métal de haute qualité blocks.

JSON pathConfiguration Options → TwigDamage (FLAG) → Apply To HQM
Require TwigDamage flag
On / off

Requires the TwigDamage flag for grades above twig.

JSON pathConfiguration Options → TwigDamage (FLAG) → Require TwigDamage Flag
Block ally damage
On / off

Blocks building damage dealt by an ally.

JSON pathConfiguration Options → TwigDamage (FLAG) → Block Damage From Ally
Allow authorized players
On / off

Allows damage when the attacker is authorized by the cupboard.

JSON pathConfiguration Options → TwigDamage (FLAG) → Check And Allow When Authed
Block when owner is online
On / off

Blocks covered building damage while the owner is online.

JSON pathConfiguration Options → TwigDamage (FLAG) → Block Damage When Owner Is Online
Log offenses
On / off

Logs blocked damage attempts.

JSON pathConfiguration Options → TwigDamage (FLAG) → Log Offenses
Notify offenders
On / off

Notifies attackers when their damage attempt is blocked.

JSON pathConfiguration Options → TwigDamage (FLAG) → Notify Offenders
Reflect damage multiplier
Number

Multiplies damage reflected to the attacker; 0 disables reflection.

JSON pathConfiguration Options → TwigDamage (FLAG) → Reflect Damage Multiplier
Armor protects against reflected damage
On / off

Applies armor protection to reflected building damage.

JSON pathConfiguration Options → TwigDamage (FLAG) → Multiplier Allows Armor Protection

Plugin instructions

TruePVE 2.4.6: configure PvE rules and loot protection

The configurator edits oxide/config/TruePVE.json. Its sections include Default RuleSet, RuleSets, Entity Groups, Mappings, Schedule and Configuration Options. The public overview covers a starter task; use this guide when changing mappings or checking loot protection.

Protect player loot from non-allies

In the TruePVE configurator, open Examples and choose Stop looting between strangers. It turns on Prevent non-ally from looting sleepers, Prevent non-ally from looting corpses and Prevent non-ally from looting backpacks under Configuration Options → Loot. Export and apply the config to a 2.4.6 test server. Reload the plugin and test with non-allied and allied players. The enabled Invis and vanish bypass loot protection (TruePVE only) option lets invisible or vanished players bypass these rules; check it for staff accounts.

Change a damage rule or mapping

Keep Default RuleSet pointing to a real name in RuleSets. A Mappings entry selects a rule set for a mapped context; it does not create a zone or install an integration. If you use zones, check the relevant zone plugin and test damage with the actual attacker, target and location. Schedule is a separate optional way to switch rules; do not assume a schedule entry is active until it has been tested.

The mapping command requires truepve.canmap, granted through server permissions rather than the JSON file. Exporting config does not grant it.

Source and scope

Checked on 2026-10-17 against TruePVE 2.4.6 source and the uMod listing. Test the intended damage and loot interactions in game with your installed integrations.

Install the files

With a connected server, click Apply in the configurator. The result shows whether the files were sent and the plugin reloaded. Without RCON, reload the plugin from your server panel after sending.

Without a connected server: Keep a copy of the current files. Place each export in the folder shown before export, or follow the paths in the ZIP. Do not put data or translation files in the config folder.

Follow the plugin instructions above for dependencies and reloading. Exporting does not connect the site to your server.

Configuration and transfer guide →