Skip to content

HyperPerms v2.8.0 - API v2, PlaceholderAPI, Templates & Analytics

Choose a tag to compare

View all tags
@derrickmehaffy derrickmehaffy released this 05 Mar 23:09
· 153 commits to main since this release
v2.8.0
a43561e

HyperPerms v2.8.0

Stable release consolidating all improvements since v2.7.0. This release introduces the API v2 foundation, PlaceholderAPI integration, permission templates, analytics system, and significant performance improvements.

Highlights

  • API v2 Foundation: Overhauled event system, async permission methods, query API, metrics tracking
  • PlaceholderAPI Integration: Native support for faction, group, and prefix/suffix placeholders
  • Permission Templates: 11 pre-built server configurations (factions, survival, creative, and more)
  • Analytics & Auditing: Track permission usage and audit change history (requires SQLite)
  • 84% Smaller JAR: Reduced from ~15MB to ~2.4MB with optional SQLite driver
  • Cloudflare Workers API: Split architecture for better performance and reduced costs
  • 90%+ CPU Reduction: Fixed permission cache bypass in HyperPermsPermissionSet.contains()

New Features

HyperPerms API v2

Complete developer API overhaul:

  • 9 new event types with cancellable support and priority ordering
  • Async permission methods: hasPermissionAsync(), getPermissionValueAsync()
  • Fluent query builder: api.checkAsync(uuid).permission("node").inWorld("world").result()
  • Metrics tracking for permission operations

PlaceholderAPI Integration

Works with PlaceholderAPI and WiFlow PlaceholderAPI:

  • Faction placeholders for scoreboards, holograms, and chat
  • Group/rank and prefix/suffix placeholders

Permission Templates

11 built-in templates for quick server setup:

/hp template list
/hp template preview <name>
/hp template apply <name>
/hp template export <name>

Templates: factions, survival, creative, minigames, smp, skyblock, prison, rpg, towny, vanilla, staff

Analytics System

Track permission health and usage patterns (requires SQLite):

/hp analytics summary
/hp analytics hotspots [limit]

Performance & Infrastructure

  • Permission Cache Fix: HyperPermsPermissionSet.contains() was bypassing Caffeine cache — 90%+ CPU reduction
  • Optional SQLite: JAR reduced from ~15MB to ~2.4MB
  • Cloudflare Workers API: Game server traffic routed through api.hyperperms.com
  • LuckPerms H2 Migration: Complete support with dynamic driver loading

Bug Fixes

  • Fixed async threading issue in permission checks
  • Group weight now used as default prefix/suffix priority
  • Improved error messaging for empty web editor changes
  • Better Windows H2 file lock error handling

Full Changelog: https://github.com/HyperSystemsDev/HyperPerms/blob/main/CHANGELOG.md

Assets 3
Loading