Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Olaneria

The all new modern permissions system.

Report OlaPermissions?

R

1.0.0

[1.0.0] - Official Release (Current)

Architectural Overhaul

  • Node-Based Multi-Group Architecture: Deprecated the rigid single primary_group system. Groups are now dynamically resolved by looking for active personal permission nodes starting with group.<name>.
  • Multi-Group Merging: If a player holds multiple groups (e.g., group.vip and group.mod), the engine seamlessly merges both groups and their inheritance trees, automatically prioritizing prefixes based on group weights.
  • Contextual Groups: Full native support for Server-Specific groups and Temporary Ranks (all utilizing native permission node logic).

Performance Upgrades

  • O(1) Permission Caching: Integrated a blazing-fast memory cache directly into the User model. Bukkit and Velocity now instantly resolve permission queries (hasPermission()) by checking the memory cache, completely bypassing expensive Regex evaluation and node parsing.
  • Optimized Footprint: Reduced the compiled plugin JAR size by over 84% (from 17MB down to 2.8MB) by switching heavy SQLite and MariaDB drivers to compileOnly, leveraging the server's native runtime libraries instead.

Command Overhauls

  • Group Management: Completely replaced the old /ola user <name> parent set <group> command suite with a far more powerful node-based command suite:
    • /ola user <name> group add <group> [duration] [server]
    • /ola user <name> group remove <group> [server]
    • /ola user <name> group list
  • Quality of Life: Added deletion and inspection commands:
    • /ola group <name> delete
    • /ola track <name> delete
    • /ola group list
    • /ola track list
  • Tab-Completer AI: Fully rewrote the auto-completion logic to guide users through the new Multi-Group syntax perfectly.

Developer API & Integrations

  • Platform-Agnostic Event Bus: Engineered a comprehensive custom Event Bus into the OlaPermissionsAPI.
  • 30 Granular Events: Developers can now listen to an unprecedented level of engine detail on both Paper and Velocity, including:
    • Track progression (UserPromoteEvent, UserDemoteEvent)
    • Node manipulation (NodeAddEvent, NodeRemoveEvent)
    • Cross-server networking (NetworkSyncEvent)
    • Context recalculations (ServerContextSwitchEvent, WorldContextSwitchEvent)
    • Infrastructure sweeps (MigrationCompleteEvent)
  • OlaVaultChatProvider: Natively integrated Vault chat formatting hooks. External chat formatting plugins (like EssentialsChat) will now automatically traverse a user's multi-group inheritance tree to find and display the prefix with the highest weight.

Information

Published
September 5, 2026
Author
2Downloads

Platforms

Paper
Paper
1.20–26.2
Velocity
Velocity
4.1.1

Dependencies

PaperPaper

Dependencies: Paper

Plugins and libraries a server needs for this version to run.

No dependencies

Add anything a server has to install alongside this version.