OPAC-Create-Big-Canons-Compat

An Open Parties and Claims (OPAC) addon for Create: Big Cannons (CBC).

Create: Big Cannons destroys blocks and damages entities through its own projectile impact code, which bypasses the normal block-break / explosion events that OPAC listens to. As a result, plain OPAC never sees cannon fire and cannot protect claims from it. This mod is a bridge: it routes CBC's destruction through OPAC's protection API so that OPAC's existing per-claim options decide what happens.

Disclaimer: Yes this Mod was made using AI, as this Description too. AI was used for the code, specs and tests where done by me. Security audit was done by AI.

How it works

This mod has no config of its own. Simply installing it activates the bridge: CBC block destruction and entity damage are routed through OPAC. All of the granular control lives in OPAC itself — the per-claim block/entity protection toggles, the wilderness / server-claim / expired-claim settings, and admin-defined exception groups (see the Recommended OPAC server config section below). If you previously turned the bridge off through this mod's config, that is no longer possible; uninstall the mod instead.

Fired projectiles are tagged with the player who fired them (CBC leaves them anonymous), so OPAC's party/ally exceptions and owner redirection apply to cannon fire the same way they do to any other player action.

CBC's damage sources are wrapped the same way. OPAC independently re-checks every entity hurt on the server (its LivingIncomingDamageEvent handler) using the entities carried by the damage source — and CBC's CannonDamageSource carries none, so that final check used to see every cannon hurt as anonymous and block it in any protected claim, no matter what the claim's options or the bridge's own checks said. The bridge wraps CBC's damage sources so they carry the projectile (and its owner, when attributed), which makes OPAC's final check consult the same exception groups and owner redirection as the rest of the bridge. Armor-bypass behaviour of the original CBC source is preserved.

Recommended OPAC server config

To let cannons fire freely inside your own claim while still protecting other players' claims, add CBC's entities to OPAC's exception groups in serverconfig/openpartiesandclaims-server.toml:

blockAccessEntityGroups = [ "CBC{createbigcannons:*}" ]
entityAccessEntityGroups = [ "CBC{createbigcannons:*}" ]

With the projectile owner attributed, OPAC treats a cannon shot like an action by its firer, so these groups grant the firer's own claim access while everyone else's claims stay protected.

These two lists create per-claim options that appear in the claim config UI as:

• "Blocks (CBC)" – from blockAccessEntityGroups: which players' CBC projectiles may break blocks in the claim.
• "Entities By (CBC)" – from entityAccessEntityGroups: which players' CBC projectiles may damage entities in the claim.

The lists take entity IDs. Take care not to put the entry into blockExceptionGroups instead — that list takes block IDs and creates a "Blocks (CBC)" option, which controls who may break CBC's own blocks (cannon parts) in the claim and has no effect on what cannon fire can destroy.

These group options are checked in addition to OPAC's general exception options. Because projectiles are redirected to their firing player, the general "Allow Blocks By Players" / "Allow Entities By Players" options also apply to cannon fire: if one of those is set to Everyone, cannon damage is allowed regardless of the CBC group options. The CBC options only grant extra access (e.g. "Mine (CBC): Everyone" lets anyone's cannons break blocks even while "Allow Blocks By Players" is Nobody); they cannot revoke access granted by a general option.

Note that adding a group to the server config only creates the per-claim option — its value still defaults to Nobody. After a restart, open the claim config and set "Block (CBC)" / "Entity By (CBC)" to the players you want to allow.

By default the new options are grayed out in the claim config UI, meaning players cannot change them. To let claim owners toggle them, add the option IDs to the playerConfigurablePlayerConfigOptions list in the same file:

playerConfigurablePlayerConfigOptions = [
    # ... existing entries ...
    "claims.protection.exceptions.groups.entity.blockAccess.CBC", 
    "claims.protection.exceptions.groups.entity.entityAccess.CBC"
]