HyperPerms

Overview

Major feature release introducing the Permission Templates system, Analytics & Auditing, and significant JAR size reduction through optional SQLite.

Highlights

• Permission Templates: 11 pre-built server configurations (factions, survival, skyblock, etc.)
• Analytics System: Track permission usage, view hotspots, audit change history
• 84% Smaller JAR: Reduced from ~15MB to ~2.4MB with optional SQLite
• Console Improvements: Clickable hyperlinks in supported terminals

New Features

Permission Templates

Quickly set up your server with pre-built role configurations:

/hp template list                    # View available templates
/hp template preview <name>          # Preview before applying
/hp template apply <name>            # Apply a template
/hp template export <name>           # Export current setup as template

11 Built-in Templates:

Custom Templates: Create your own by placing JSON files in the templates/ folder.

Analytics System

Track permission usage and audit changes (requires SQLite):

/hp analytics summary                # Overview of permission health
/hp analytics hotspots [limit]       # Most frequently checked permissions
/hp analytics unused [days]          # Permissions not checked recently
/hp analytics audit [holder]         # Permission change history
/hp analytics export [format]        # Export to JSON or CSV

Enable in config:

{
  "analytics": {
    "enabled": true,
    "trackChecks": true,
    "trackChanges": true,
    "retentionDays": 90
  }
}

Console Clickable Links

Modern terminals now support clickable hyperlinks:

• Web editor URLs are clickable in iTerm2, Windows Terminal, GNOME Terminal, and more
• Automatic detection of supported terminals
• Fallback to plain URLs for unsupported terminals

Optional SQLite Driver

SQLite is no longer bundled to reduce JAR size:

• Before: ~15MB (native libraries for 20+ platforms)
• After: ~2.4MB (84% reduction)

To enable SQLite features:

1. Download from sqlite-jdbc releases
2. Place in mods/com.hyperperms_HyperPerms/lib/
3. Restart server

Without SQLite: Everything works - analytics disabled, JSON storage used.

Installation

1. Download HyperPerms-2.7.7.jar from this release
2. Place in your server's mods folder
3. Start the server

Quick Setup with Templates

/hp template apply staff             # Set up admin/mod/helper groups
/hp template apply survival          # Add survival gameplay permissions
/hp user YourName parent add admin   # Make yourself admin

Technical Changes

v2.7.7

• SQLiteDriverLoader utility for dynamic driver loading
• Analytics commands show clickable download links when driver missing
• Changed sqlite-jdbc to compileOnly (not bundled)
• Removed slf4j-nop dependency
• Redesigned README with screenshot and wiki link

v2.7.6

• Removed Class.forName fallback for CurseForge compliance
• H2 migration loads driver exclusively from LuckPerms libs

v2.7.5

• Permission Templates system with 11 bundled templates
• Analytics system with SQLite storage
• Console hyperlink support (OSC8)
• Config version migrations