⚔️ Open Parties and Claims: Warfare
Turn your peaceful Open Parties and Claims (OPaC) server into an epic arena of territorial conquest, tactical sieges, and diplomatic warfare!
Open Parties and Claims: Warfare bridges the gap between peaceful claim protection and thrilling faction PvP. Players can declare wars against rival claims, engage in dynamic chunk-by-chunk sieges, track active conflicts on their minimap, and fight for land while keeping offline bases safe with configurable raid windows.
📚 Guides & Documentation
- 🔄 Migration & Upgrade Guide (1.x to 2.0) — Step-by-step upgrade instructions from 1.x (1.6.7.2) or early 2.0 builds.
- 📖 Server Admin Guide — Installation, lifecycle, raid hours, and live server operations.
- ⚙️ Configuration Reference — Complete options reference, allowed ranges, and defaults for
opac_warfare-*.toml. - 🧩 Companion Mod: Better Protection — Mechanical contraption protection (Create drills/saws), cannon impacts, and
/claimrules. - ⚔️ Companion Mod: Combat Log (Modrinth / CurseForge) — Prevents combat logging and blocks fleeing into safe territories during PvP and sieges.
- 🏗️ Architecture & WarfareBridge — Developer notes, platform abstraction, and external mod integration.
🌟 Key Features
🚩 Tactical Chunk Wars & Conquest
- Border-Based Warfare: Declare war on neighboring hostile claims from the border. Deep core territory cannot be bypassed without securing border chunks first!
- Sector Wedge Conquest: Take control of strategic wedges of connected territory in a single, hard-fought campaign.
🛡️ Balanced Capture & Anti-Zerg Mechanics
- Presence-Driven Capture: Attackers advance the siege progress bar by holding the contested zone; defenders push it back by defending the territory.
- Anti-Zerg Protection: Diminishing returns prevent massive zergs from instantly steamrolling smaller, well-fortified teams. Skill and endurance decide the victor!
- AFK Protection: Idle players do not contribute to siege progress.
⏰ Fair-Play Raid Windows & Cooldowns
- No 4 AM Offline Raids: Define exact server raid hours (e.g.,
18:00 - 22:00) so battles only happen when players are online and ready to fight. - Strategic Cooldowns: Configurable attack and defense cooldowns prevent spam declarations and give defeated parties time to regroup.
❤️ War Lives & Live Scoreboard
- High-Stakes Combat: Every warrior receives limited war lives per siege. Lose your lives, and you're out of the battle!
- Sidebar HUD: Real-time scoreboard display keeps everyone informed of remaining lives and combat status.
🗺️ Full Xaero's Map Integration
- Fair-Play War Markers: View active conflict zones and timers directly on Xaero's Minimap and Xaero's World Map.
- Right-Click War Start: Simply right-click any eligible enemy border chunk directly on Xaero's World Map to initiate a siege!
🔔 Discord Webhooks
- Automatically broadcast war declarations, phase transitions, and final siege outcomes directly to your server's Discord channel with rich embeds.
⚔️ How Sieges Work
[ /war start ] ────► [ Preparation Phase ] ────► [ Active Battle ] ────► [ Resolution ]
Target border chunk Defenders & attackers Fight for zone; 100% = Captured!
or Xaero right-click gear up & rally drain enemy lives Timeout = Defended!
- Declaration: A party declares war on an adjacent rival chunk using
/war startor the Xaero World Map menu. - Preparation: A countdown gives defenders time to rally their allies, build fortifications, and prepare gear.
- Active Phase: The chunk becomes contested! Normal claim restrictions relax for combatants:
- Stand inside the zone to capture or defend.
- Watch the capture bossbar and sidebar lives.
- Glowing effects keep combatants visible and prevent hiding in corners.
- Resolution:
- If attackers reach 100% progress, the chunk is claimed by the attackers!
- If defenders hold out until time expires or deplete enemy lives, the siege fails and peace is restored.
🧩 Mod Compatibility & Ecosystem
🛡️ Official Companion Mod: Better Protection
Looking for Create contraption support, cannon warfare, and custom block-damage rules during sieges? 👉 Open Parties and Claims: Better Protection
- When installed together, siege zones automatically allow Create drills, cannon impacts (Create Big Cannons), and tactical breaching in actively contested chunks while keeping peaceful claims 100% secure!
⚔️ Official Companion Mod: Combat Log
Prevent combat logging and tactical escapes into safe territory during wars and PvP: 👉 Open Parties and Claims: Combat Log (Modrinth | CurseForge)
- Anti-Safezone Fleeing: Blocks tagged players from retreating into safe claims, peaceful territories, or non-PvP zones mid-fight.
- Fair Sieges: Tags combatants during PvP and territorial wars, punishing combat logging and ensuring contested battles are fought to the finish!
🌍 Multi-Loader & Multi-Version
Warfare supports your favorite mod loader and version out of the box:
- Minecraft 1.20.1: Forge & Fabric
- Minecraft 1.21.1: NeoForge & Fabric
- Minecraft 26.1: NeoForge
📦 Installation & Requirements
- Install Open Parties and Claims (CurseForge / Modrinth) for your loader and Minecraft version.
- Download the matching Open Parties and Claims: Warfare jar:
opac-warfare-1.20.1-forge.jaropac-warfare-1.20.1-fabric.jaropac-warfare-1.21.1-neoforge.jaropac-warfare-1.21.1-fabric.jaropac-warfare-26.1-neoforge.jar
- Drop the jar into your server's (and client's)
mods/directory. - (Optional) Install Xaero's Minimap or Xaero's World Map for waypoint and map features.
📖 Commands & Guides
| Command | Permission | Description |
|---|---|---|
/war start |
opac.warfare.start |
Declare war on the eligible border chunk you are standing in. |
/war status |
opac.warfare.status |
Display status and capture progress of your active wars. |
/war list |
opac.warfare.status |
Show active wars and ongoing sieges visible to you. |
/war near [radius] |
opac.warfare.status |
Find wars within a chunk radius (default: 8, max: 32). |
/waradmin list |
opac.warfare.admin |
View all active and preparing wars across all dimensions. |
/waradmin stop <uuid\|chunk> |
opac.warfare.admin |
Force stop a war and restore claims to original owners. |
/waradmin setprogress <uuid\|chunk> <0-100> |
opac.warfare.admin |
Administratively modify capture progress. |
/waradmin skip_preparation <chunk> |
opac.warfare.admin |
Skip the preparation countdown and activate the siege immediately. |
(Legacy `customclaims.` permissions remain supported as aliases for backwards compatibility).*
For advanced server configuration, raid window setups, and permission nodes, check our Documentation Wiki.
How to Install Open Parties and Claims: Warfare (Mod)
Open Parties and Claims: Warfare by svinpepe is verified for Fabric, Forge, Neoforge across Minecraft versions 1.20, 1.20.1, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3 (latest release: 2.0.0+1.20.1-forge, file size: 206 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.20, 1.20.1, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3) and platform (Fabric, Forge, Neoforge).
- Make sure you have the compatible loader or environment installed for Fabric, Forge, Neoforge.
- Move the downloaded Open Parties and Claims: Warfare file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version### Changed
- Updated the mod version to
1.6.7.1. - Updated Minecraft version metadata to
[1.21.1,)to add support for Minecraft1.21.11+and subsequent releases under the new versioning system. - Updated NeoForge version metadata to
[21.1.232,)to remove obsolete assumptions about hypothetical1.22/1.23release numbering and the outdated27.0ceiling. - Updated compatibility, development, and administration documentation to align with current versioning.
### Added
- Added configurable contested-war entity interaction exceptions through
entity_interaction.contested_exceptions. - Added
corpse:corpseas the default exception, allowing attacking and defending war participants to right-click Corpse entities in the target entity's contested chunk without OPaC blocking the interaction. - Added support for additional exact
namespace:pathentity IDs; setting the list to[]disables the feature. - Added optional anonymous dedicated-server heartbeat metrics.
- Added
metrics.enabledandmetrics.endpointconfiguration options for controlling metrics collection and delivery. - Added a persistent random anonymous
server_idstored inworld/customclaims/metrics/server-id.txt. - Metrics heartbeats report only the CustomClaims, Minecraft, and NeoForge versions, online player count, and presence flags for OPaC, Create, CBC, Aeronautics/Offroad, Xaero, and Corpse.
### Changed
- Updated the mod version to
1.6.7. - Entity interaction exception checks now use the target entity's chunk and the current config value, so config reloads take effect immediately.
- Eligible interactions reuse the existing temporary OPaC full-pass mechanism and clear it on the next server tick.
### Notes
- Corpse remains an optional dependency; the default
corpse:corpseentry is harmless when Corpse is not installed. - The exception applies only to attacking and defending participants in an active contested chunk. Outsiders, peaceful claims, unclaimed chunks, and finished wars keep normal OPaC behavior.
- Corpse ownership and access restrictions are still respected.
- Other mods' canceled interaction events are not uncanceled.
- Attacking an entity does not grant the bypass.
- Metrics run only on dedicated servers and send at most one asynchronous heartbeat every 30 minutes.
metrics.endpointis empty by default, so no metrics request is sent until a server owner configures an endpoint.- Metrics never include the server IP or hostname, player names, world seed, or other identifying data.
- Set
metrics.enabled = falseand restart the server to disable metrics completely.
### Added
- Persistent attack and defense cooldown windows for war declarations, including saved slot usage after restarts.
- Configurable cooldown durations and target-chunk limits for each role.
war/side-cooldowns.datfor persisted cooldown state.- A separate
/claimrules assemblyrule for Create and Sable contraption assembly. - Settings for global war notifications, bossbars, and Xaero markers.
### Changed
- Updated the mod version to
1.6.6. - Daily outgoing and incoming war-start limits are disabled by default (
0) but remain available as optional additional quotas. - Post-war protection now applies to all claims owned by the defending side rather than individual chunks.
- Replaced
max_active_wars_per_partywith role-specific cooldown limits; a side cannot attack and defend at the same time. /claimrules createnow covers only Create and Offroad mining machines; assembly is controlled through/claimrules assembly.- Removed storage-specific protection, leaving container access and breaking behavior to vanilla and OPaC.
- Villager, wandering trader, and Wither protections are disabled by default and remain configurable opt-ins.
- War notifications, bossbars, and Xaero markers for active/preparing wars are visible to all compatible players by default; settings can restore side-, admin-, and radius-based filtering.
### Fixed
- Fixed denied Sable assemblies potentially leaving an orphan sub-level and causing a critical server error.
- Fixed Sable assembly bounds detection, removing misleading reflection warnings and unnecessary fallback handling.
- Create and Sable assemblies now validate all eight source AABB corners when crossing claims.
### Notes
- The first successful declaration starts fixed windows:
2hours for the attacker and1hour for the defender by default. - Later successful starts consume slots without extending the window.
- A duration of
0disables only the timed quota, not the concurrent-war limit. - Xaero markers contain active-war metadata only and never expose a global claim-owner map.
### Added
- Added a separate
/claimrules assemblyrule for Create and optional Sable contraption assembly. - Added assembly status/toggle permissions and a dedicated Claim Rules GUI control.
- Added optional Sable
2.0.3assembly protection compatibility.
### Changed
- Kept
/claimrules createfor Create and Offroad drills and saws only. - Create and Sable assembly now validates all eight source AABB corners when a structure reaches claims; all corners must be peaceful claims of one side with assembly enabled.
- Fully unclaimed structures remain assemblable, while active contested-war chunks retain their previous behavior.
- Existing
createsettings and cooldowns are copied to the newassemblyrule on first upgrade. - Updated the optional claim-rules GUI protocol to version 2 and documented keybind reassignment through Minecraft controls.
Small balance and compatibility update focused on daily war limits.
### Added
- Daily limit for how many territory fights one attacking side can start.
- Daily limit for how many incoming territory fights one defending side can receive.
- New config options:
war.daily_start_limit.max_started_chunks_per_attacker_sidewar.daily_start_limit.max_accepted_chunks_per_defender_side
### Changed
- Updated version to
1.6.3. - Expanded metadata for experimental same-jar compatibility beyond the tested
1.21.1baseline. - Updated README and docs for daily war limits and compatibility policy.
### Notes
- Default attacker limit:
5chunks per day. - Default defender incoming limit:
10chunks per day. - Set a limit to
0to disable it. - Daily reset uses the configured raid-window timezone.
Compatibility and usability update focused on Xaero, Aeronautics support, and release polish.
### Added
- Support for starting wars directly from the Xaero World Map right-click menu.
- Xaero temporary war waypoints for visible active wars.
- Aeronautics/Offroad bore protection on claimed territory.
- Client keybind for opening the claim rules GUI.
### Changed
- Updated README to better explain installation and optional integrations.
- Improved Xaero waypoint behavior and cleanup.
### Fixed
- Improved claim rules GUI opening from the client.
- Improved safety of optional mod integrations when target mods are not installed.
- Improved error handling for Xaero map war-start actions.
First public Modrinth release of **Open Parties and Claims: Warfare**.
This is an unofficial warfare addon for **Open Parties and Claims**, adding chunk wars, contested claims, raid windows, protection rules, Create integration, Create Big Cannons protection, and optional Xaero war waypoints.
### Added
- Single-jar distribution as
opac-warfare. - Open Parties and Claims territory and party integration.
- Chunk wars for party and personal claims.
- Preparation and active war phases.
- Contested chunks with capture progress.
- Claim transfer on successful capture.
- Original claim owner restore on cancelled or failed wars.
- Raid window support.
- AFK defender checks.
- Bossbar, actionbar, chat notifications, and war lives.
- Post-war protection.
- Claim protection rules for explosions, storage, villagers, and Withers.
/warplayer commands./waradminadmin commands./claimrulescommands for explosion and Create machine rules.- Create contraption, drill, saw, and block-breaking protection.
- Create Big Cannons projectile launch blocking and terrain-damage protection.
- Optional Xaero temporary war waypoints.
### Required
- Minecraft 1.21.1
- NeoForge 21.1.232+
- Java 21
- Open Parties and Claims 0.27.5+
### Optional integrations
- Create 6.0.9+
- Create Big Cannons 5.11.7+
- RPL 2.1.2+
- Xaero's Minimap for Minecraft 1.21.1
- Xaero's World Map for Minecraft 1.21.1
### Installation note
Install only:
``
text
opac-warfare-1.6.1.jar
`
Do not install the separate customclaims_* module jars together with opac-warfare`, because the single jar already contains all OPaC Warfare modules.### Notes
- This is an unofficial addon for Open Parties and Claims.
- This is the first public Modrinth release.
- Earlier versions were internal development builds.
- Server owners should make backups before using this on production worlds.
- Configs, balancing, and compatibility behavior may change in future versions.