[Beta] MonumentChoice 0.0.36

When a player with permission enters an unclaimed monument, a UI window appears. The player can choose whether the monument should be set to PvE or PvP for the current occupation.

The selected mode stays active as long as the claiming player remains inside the monument. Once that player leaves, the monument is reset and becomes available again after the configured cooldown logic.

Other players inside the same monument are notified about the currently active mode.

Features

1. Dynamic PvE/PvP selection per monument
2. UI selection when entering an unclaimed monument
3. Runtime PvE and PvP mode per monument
4. Automatic reset when the claiming player leaves the monument
5. Cooldown system to prevent immediate re-claiming
6. Traveler option for players who do not want to claim a monument
7. Separate traveler cooldown
8. Configurable monument blacklist
9. Automatic monument detection using Rust monument data
10. Support for duplicate monuments on the same map
11. PvP damage only between players inside the same PvP monument
12. Teleport blocking inside active PvP monuments
13. Bypass permission for admins or special roles
14. English and German language messages
15. Optional MyNotify support

Permissions

The plugin registers the following permissions:

monumentchoice.use

Allows players to use the MonumentChoice system. Only players with this permission receive the selection UI when entering an unclaimed monument.

monumentchoice.bypass

Bypass permission. Players with this permission are ignored by the MonumentChoice system. They do not receive the selection UI and are not restricted by the plugin's PvE/PvP checks.

Configuration

The configuration file is generated automatically at:

oxide/config/MonumentChoice.json

Default Configuration

{ "DecisionCooldownMinutes": 15, "TravelerCooldownMinutes": 5, "UseMyNotify": false, "BlacklistedMonuments": [ "compound", "bandit_town", "fishing_village_a", "fishing_village_b", "fishing_village_c", "large_fishing_village", "small_fishing_village", "stables_a", "stables_b", "ranch", "bandit_camp", "gas_station_1", "supermarket_1", "lighthouse", "mining_quarry_a", "mining_quarry_b", "mining_quarry_c", "substation_a", "substation_b", "substation_c", "swamp_a", "swamp_b", "swamp_c", "ice_lake_1", "ice_lake_2", "ice_lake_3", "ice_lake_4", "power_sub_big_1", "power_sub_big_2", "power_sub_small_1", "power_sub_small_2", "ferryman", "water_well_a", "water_well_b", "water_well_c", "water_well_d", "water_well_e", "cave_small_easy", "cave_small_medium", "cave_small_hard", "cave_medium_easy", "cave_medium_medium", "cave_medium_hard", "cave_large_easy", "cave_large_medium", "cave_large_hard", "cave_large_sewers_hard", "excavator_1", "nuclear_missile_silo", "arctic_research_base_a", "desert_military_base_a", "desert_military_base_b", "desert_military_base_c", "desert_military_base_d" ] }

Configuration Options

DecisionCooldownMinutes

"DecisionCooldownMinutes": 15

Defines how many minutes a player must wait before choosing the same monument again after leaving it.

TravelerCooldownMinutes

"TravelerCooldownMinutes": 5

Defines how long the selection UI is suppressed for a player after choosing "I'm just a traveler".

UseMyNotify

"UseMyNotify": false

Enables optional message output through the MyNotify plugin.

false = use normal chat messages

true = use MyNotify, if the plugin is loaded

BlacklistedMonuments

"BlacklistedMonuments": []

List of monument IDs ignored by the plugin.

Blacklisted monuments:

do not show the selection UI

cannot be claimed as PvE or PvP

are not managed by MonumentChoice

This is useful for safe zones, small monuments, quarries, fishing villages, caves, or other locations that should not be part of the system.

Dependencies

Optional

MyNotify

MyNotify is only required if this configuration option is enabled:

"UseMyNotify": true

If UseMyNotify is set to false, the plugin works without MyNotify.

Public API

Other plugins can call the following methods:

IsPlayerInPvPZone(BasePlayer player)

Returns true if the player is currently inside a monument that is set to PvP.

GetPlayerMonumentMode(BasePlayer player)

Returns the current mode of the player's monument:

Unclaimed PvE PvP

How It Works

A player enters a registered monument.

If the monument is unclaimed, the selection UI appears.

The player chooses one of the following options:

PvE

PvP

Traveler

If PvE or PvP is selected, the player becomes the owner of the monument state.

Players inside the monument are notified.

When the owner leaves the monument, the monument is reset.

The owner receives a cooldown for that monument.

PvP Logic

PvP damage is only allowed when all of the following conditions are true:

the attacker and victim are inside the same monument

that monument is currently set to PvP

neither player has the bypass permission

Outside an active PvP monument, MonumentChoice does not actively allow PvP damage.

Teleport Blocking

When a player is inside an active PvP monument, the plugin blocks teleport attempts through the following hook:

CanTeleport(BasePlayer player)

This prevents players from escaping an active PvP monument by teleporting away.

Notes

MonumentChoice stores monument states only at runtime.

After a server restart or plugin reload, all monuments are unclaimed again.

A selected mode remains active only while the claiming player stays inside the monument.

Blacklisted monuments are ignored during server initialization.

The plugin uses a 1-second position timer to detect monument entry and exit.

Known Limitations

Monument states are not persistent.

There are currently no admin commands to manually reset specific monuments.

UI text is currently hardcoded in the plugin.

PvP/PvE behavior may depend on how other damage or PvE plugins handle CanEntityTakeDamage.