Luckperms-Supporter

LuckPerms Supporter

A small Minecraft Paper server plugin that acts as a LuckPerms Addon, it adds permission scanning, simple snapshot/backup functionality and a permissions quick-add to your server.

Features

Permission Scanning

• /lps scanperm - Scan all loaded plugins for permission nodes and register them with LuckPerms

Snapshot System

• /lps snapshot [name] - Create a full backup of all LuckPerms data (users, groups, tracks) with optional custom name
• /lps snapshots - List all available snapshots with details (creator, date, user/group/track counts)
• /lps loadsnapshot <file> [confirm] - Restore a snapshot (requires confirmation to prevent accidental data loss)
• /lps deletesnapshot <file> - Delete a snapshot file

Permission Management

• /lps addperm <player> <perm1,perm2,...> - Add one or multiple comma-separated permissions to a player

Utility

• /lps help - Show available commands

Permissions

Installation

1. Download the latest release JAR
2. Place it in your server's plugins/ folder
3. Ensure LuckPerms is installed and running
4. Restart the server or run /lps reload

Requirements

• Built against Paper Minecraft 26.1.2
• LuckPerms 5.4+
• Java 17+

Configuration

The plugin creates config.yml in plugins/LuckPermsSupporter/ on first run:

# Snapshot settings
snapshots:
  directory: "snapshots"
  auto-cleanup: false
  max-snapshots: 50

# Command settings
commands:
  prefix: "&8[&bLPS&8] &r"

Snapshot Format

Snapshots are stored as JSON files in plugins/LuckPermsSupporter/snapshots/ containing:

• Users: UUID, username, primary group, all permission nodes
• Groups: Name, display name, weight, parent groups, permission nodes
• Tracks: Name, ordered group list
• Metadata: Timestamp, creator, custom name

License

MIT License