All Activity

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 Dynamic PvE/PvP selection per monument UI selection when entering an unclaimed monument Runtime PvE and PvP mode per monument Automatic reset when the claiming player leaves the monument Cooldown system to prevent immediate re-claiming Traveler option for players who do not want to claim a monument Separate traveler cooldown Configurable monument blacklist Automatic monument detection using Rust monument data Support for duplicate monuments on the same map PvP damage only between players inside the same PvP monument Teleport blocking inside active PvP monuments Bypass permission for admins or special roles English and German language messages 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.