OPAC - Essentials

The next generation of OPAC - Better Commands.

OPAC - Essentials is an addon for Open Parties and Claims, developed for the Brassworks SMP.

It adds configurable short commands, party chat, fine-grained claim permissions and a claim search integration for Xaero's World Map.

Important: The UI in version 2.2 and newer requires KotlinForForge.

Features

• Configurable names for every command added by OPAC - Essentials
• Short aliases for commonly used OPAC commands
• Argument-free /claim and /unclaim commands
• Party chat with direct messages, toggle and status commands
• Claim permission interface through /claims permissions
• Claim owner search directly inside Xaero's World Map
• Compatibility with OPAC API v1 and API v2
• Automatic migration of older permission data

Requirements

Required

• Minecraft 1.21.1
• NeoForge 21.1.216 or newer within the 21.1 release line
• Open Parties and Claims 0.25.8 or newer

Client requirements

• KotlinForForge
• Xaero's World Map, only required for the optional claim search interface

Both the client and server need OPAC - Essentials when using the permission UI and its network features.

The Xaero claim search is a client-side World Map integration.

Command Configuration

The names of all commands added by OPAC - Essentials can be changed in:

config/opac_essentials-commands.toml

Default configuration:

[commands]
claims = "claims"
party = "party"
claim = "claim"
unclaim = "unclaim"
party_chat = "pchat"

Command names must meet the following requirements:

• Between 1 and 32 characters
• Only lowercase letters, numbers, underscores and hyphens
• Every configured command must use a unique name
• Commands must not conflict with commands registered by other mods

A full server restart is required after changing the command configuration.

Claim Permissions

Claim owners can grant exceptions for individual registry entries instead of opening an entire claim.

Supported permission targets

• Blocks

  • Interact

  • Break

  • Place

• Block entities

  • Interact

  • Break

• Entities

  • Interact

  • Attack

• Throwable items and projectiles

  • Throw

  • Use

  • Projectile impact

Rules can apply either to all players or to one or more selected players.

To manage permissions, stand inside a claim or subclaim you own and run:

/claims permissions

The permission interface supports:

• Registry search and suggestions

• Multiple actions and players

• Individual player assignments for each target

• Bulk access changes

• Staged editing before changes are saved

Changes are only applied after pressing Save & Done.

Server administrators with permission level 2 can also manage the claim or subclaim in which they are currently standing.

Permissions can additionally be listed, added and removed through the command tree. Older grouped permission data is migrated automatically when loaded.

Party Chat

Using the default command names:

/pchat <message>
/pchat toggle
/pchat status

Party messages use OPAC's native handling and formatting. Errors returned by OPAC are passed directly to the player.

Xaero's World Map Claim Search

When Xaero's World Map is installed, OPAC - Essentials adds a claim search button to the map interface.

Enter a player's name to center the map on their first claim cluster.

Additional controls allow you to:

• Cycle through disconnected claim clusters

• Move to the previous or next cluster

• Highlight the currently selected cluster with a high-visibility outline

Claim snapshots and cluster calculations are processed incrementally and asynchronously to reduce client-side lag when working with large claim counts.

Compatibility

OPAC - Essentials contains a compatibility layer for both OPAC API v1 and API v2.

This keeps older supported OPAC releases using API v1 compatible while allowing newer API v2 releases to work without requiring a separate build.

Legacy Releases

Every release before version 2.0 belongs to the legacy generation of the mod.

Those releases use the old OPAC - Better Commands name and only provide fixed command features. They do not include configurable command names or the current permission system.

Planned Features

The following features are planned and may change during development:

• Complete overhaul of the OPAC claim and party interfaces

• Unified UI for claims, subclaims, parties and permissions

• More permission targets and actions

• Party-, rank- and group-based permission rules

• Permission import, export and advanced migration tools

• Additional admin commands for claim and party management

Roadmap entries are development goals, not guarantees. Their scope and release order may change based on testing, OPAC API changes and community feedback.

License

Licensed under the Apache License 2.0.

You may use, modify and redistribute this software under the terms of that license.

Credits

• Development and design by DerErneuerer

• Created for Brassworks

• Built as an addon for Open Parties and Claims

Links

• Project repository

• Changelog

• Brassworks website

• Open Parties and Claims repository

• Join the Discord server

OPAC - Essentials is an addon for Open Parties and Claims, developed for the Brassworks SMP. It adds configurable short commands, party chat, fine-grained claim permissions and a Xaero's World Map Claim Search integration.

The UI on version 2.2 or higher requires KotlinForForge

Legacy Releases

Every release before 2.0 belongs to the legacy generation of the mod. Those releases use the old OPAC - Better Commands name and only provide fixed command features. They do not include configurable command names or the current permission system.

Features

• Configurable names for every command added by OPAC - Essentials
• Short aliases for commonly used OPAC commands
• Argument-free /claim and /unclaim commands
• Party chat with direct messages, toggle and status commands
• Claim permission interface through /claims permissions
• Claim owner search directly in Xaero's World Map

Command Configuration

Command names can be changed in:

config/opac_essentials-commands.toml

Default configuration:

[commands]
claims = "claims"
party = "party"
claim = "claim"
unclaim = "unclaim"
party_chat = "pchat"

Command names may contain 1-32 lowercase letters, numbers, underscores or hyphens. Each configured command must use a unique name and must not conflict with a command registered by another mod. A full server restart is required after changing the configuration.

Claim Permissions

Claim owners can grant exceptions for individual registry entries instead of opening an entire claim.

Rules can apply to all players or to one or more selected players. To manage them, stand inside a claim or subclaim you own and run:

/claims permissions

The interface supports search, registry suggestions, multiple actions and players, per-target player assignments and bulk access changes. Edits remain staged until Save & Done is pressed. Server administrators with permission level 2 can also manage the claim or subclaim in which they are standing.

Permissions can also be listed, added and removed through the command tree. Older grouped permission data is migrated automatically when loaded.

Party Chat

Using the default command names:

/pchat <message>
/pchat toggle
/pchat status

Party messages use OPAC's native handling and formatting. Errors returned by OPAC are passed through to the player.

Xaero's World Map Claim Search

When Xaero's World Map is installed, a search button is added to the map interface. Enter a player's name to center the map on their first claim cluster. Previous and next controls cycle through disconnected clusters, while a high-visibility outline marks the current selection.

Claim snapshots and cluster calculations are processed incrementally and asynchronously to reduce client-side lag with large claim counts.

Requirements and Compatibility

• Minecraft 1.21.1
• NeoForge 21.1.216 or newer within the 21.1 release line
• Open Parties and Claims 0.25.8 or newer
• Xaero's World Map for the optional claim search interface
• If on Client, KotlinForForge is required

OPAC - Essentials contains a compatibility layer for both OPAC API v1 and API v2. This keeps older supported OPAC releases using API v1 compatible while allowing newer API v2 releases to work without a separate build.

Both the client and server need the mod when using the permission UI and its network features. The client also needs KotlinForForge. The Xaero claim search itself is a client-side World Map integration.

Planned Features

The following features are planned and may change during development:

• Complete overhaul of the OPAC claim and party interfaces
• A unified UI for claims, subclaims, parties and permissions
• More permission targets and actions
• Party-, rank- and group-based permission rules
• Permission import, export and advanced migration tools
• More admin commands to manage Claim/Party related stuff

Roadmap entries are goals, not guarantees. Their scope and release order may change based on testing, OPAC API changes and community feedback.

License

Licensed under the Apache License 2.0. You may use, modify and redistribute this software under the terms of that license.

Credits

• Development and design by DerErneuerer
• Created for the Brassworks
• Built as an addon for Open Parties and Claims

Links

• Project repository
• Changelog
• Brassworks Website
• Open Parties and Claims repository