AURA ESSENTIALS - Looking for Beta Testers

[AuraSoftware]

Hi All!

I am currently working on a new Essentials Alternative, Aura Essentials!

This plugin is going to include the majority of Features in Essentials and work across multiple instances by utilizing Redis & MongoDB. I am looking for a few users to help me test this plugin, iron out bugs and suggest new features for me to implement prior to launch.

Anyone who participates will receive a free vouch copy on launch of the plugin! Reply with your discord below if you're interested, bonus if you have a small to mid sized server to test it in a real scenario!

Plugin Information:

AuraEssentials

A comprehensive multi-server essentials plugin for Minecraft servers running Spigot/Paper 1.21+. Features MongoDB storage, Redis cross-server messaging, a full permission/roles system, economy, shop, kits, staff tools, and modern Adventure API text formatting.

Features

Permission & Role System

• Role Management: Create global (network-wide) or local (server-specific) roles
• Permission Inheritance: Roles can inherit permissions from parent roles
• Wildcard Support: Full * wildcard permission support (grants ALL permissions)
• Negation Support: Negate permissions with -permission.node
• Weight System: Higher weight roles take priority for prefix/suffix/chat color display
• Chat Colors: Configure chat message colors per role
• Default Roles: Automatically assign roles to new players
• User-Specific Permissions: Grant individual permissions directly to players (global or local)
• Grant GUI: Visual interface for managing player roles and permissions

Economy System

• Multi-Currency Support: Configure multiple currencies with custom names and symbols
• Vault Integration: Full Vault API support for compatibility with other plugins
• Cross-Server Sync: Balances sync across all servers via MongoDB/Redis
• Transaction History: Track all money transfers and changes
• Balance Leaderboard: View top balances with /baltop
• Admin Controls: Give, take, set, and reset player balances

Shop System

• Category-Based GUI: Organized shop with configurable categories
• Buy & Sell: Players can buy items and sell items back
• Bulk Transactions: Purchase/sell multiple items at once
• Command Items: Sell commands/services through the shop
• Permission-Based: Restrict categories/items by permission
• Configurable Prices: Set buy and sell prices independently

Kit System

• Kit GUI: Visual kit selector with cooldown display
• Cooldowns: Configurable cooldown per kit
• Permission-Based: Restrict kits by permission
• Admin Commands: Create, edit, delete, and give kits
• Inventory Preview: See kit contents before claiming

Staff Tools

• Staff Mode: Enter moderation mode with saved inventory, configurable hotbar items
• Staff Chat: Private cross-server staff communication with @ prefix or /staffchat
• Vanish: Hide from players, tab list, and silently join/leave
• Stream Mode: Hide sensitive information when streaming

Punishment System

• Punishment Types: Warn, Kick, Mute, Ban (temporary or permanent)
• Punishment GUI: Click-to-punish interface with configurable options
• History GUI: View player punishment history with pagination
• Pardon GUI: Review and pardon active punishments
• Cross-Server: Punishments sync across all servers via MongoDB/Redis
• IP Bans: Automatic IP logging for ban enforcement

Chat & Messaging

• Chat Channels: Configurable global, local, and custom chat channels
• Private Messaging: Cross-server /msg and /reply commands
• Social Spy: Monitor private messages between players
• Modern Formatting: Supports MiniMessage gradients, hex colors, and legacy codes
• Broadcast: Server-wide and network-wide announcements

Scoreboard & Tab

• Custom Scoreboard: Fully configurable sidebar scoreboard
• Tab List: Custom header, footer, and player display formatting
• PlaceholderAPI Support: Use any placeholder in scoreboard/tab
• Per-World Configuration: Different scoreboards per world (optional)
• Toggle Command: Players can toggle scoreboard visibility

Admin Features

• Gamemode GUI: Visual gamemode selector with /gamemode command
• Fly Toggle: Persistent fly state with /fly command
• Vanish Toggle: Full invisibility with /vanish command
• Player List: View online players across all servers with /list

Integrations

• PlaceholderAPI: Expose role prefixes, suffixes, economy data, and more
• Vault: Economy provider for third-party plugin compatibility
• MongoDB: Primary data storage with async operations
• Redis: Real-time cross-server messaging and caching
• YAML Fallback: Standalone mode when databases unavailable

---

Commands

Admin Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /auraessentials reload | Reload plugin configuration | auraessentials.admin.reload |
| /vanish [player] | Toggle vanish mode | auraessentials.vanish |
| /fly [player] | Toggle fly mode | auraessentials.fly |
| /gamemode <mode> [player] | Change gamemode (opens GUI if no mode) | auraessentials.gamemode |
| /gmc [player] | Creative mode shortcut | auraessentials.gamemode.creative |
| /gms [player] | Survival mode shortcut | auraessentials.gamemode.survival |
| /gma [player] | Adventure mode shortcut | auraessentials.gamemode.adventure |
| /gmsp [player] | Spectator mode shortcut | auraessentials.gamemode.spectator |
| /broadcast <message> | Broadcast message to server | auraessentials.broadcast |
| /broadcast -g <message> | Broadcast message to all servers | auraessentials.broadcast.global |
| /list | View online players | - |

Economy Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /balance [player] | Check balance | auraessentials.balance |
| /pay <player> <amount> | Pay another player | auraessentials.pay |
| /baltop [page] | View balance leaderboard | auraessentials.baltop |
| /eco give <player> <amount> | Give money to player | auraessentials.eco.give |
| /eco take <player> <amount> | Take money from player | auraessentials.eco.take |
| /eco set <player> <amount> | Set player balance | auraessentials.eco.set |
| /eco reset <player> | Reset player balance | auraessentials.eco.reset |

Shop Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /shop | Open the shop GUI | auraessentials.shop |

Kit Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /kit | Open kit GUI | auraessentials.kit |
| /kit <name> | Claim a specific kit | auraessentials.kit.<kitname> |
| /kit list | List all available kits | auraessentials.kit.list |
| /kit give <player> <kit> | Give a kit to a player | auraessentials.kit.give |
| /kit create <name> | Create a kit from inventory | auraessentials.kit.admin |
| /kit delete <name> | Delete a kit | auraessentials.kit.admin |

Punishment Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /punish <player> | Open punishment GUI | auraessentials.punish |
| /history <player> | View punishment history | auraessentials.history |
| /pardon <player> | Open pardon GUI | auraessentials.pardon |
| /unban <player> | Remove active ban | auraessentials.unban |
| /unmute <player> | Remove active mute | auraessentials.unmute |

Messaging Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /msg <player> <message> | Send private message | auraessentials.msg |
| /reply <message> | Reply to last message | auraessentials.reply |
| /socialspy | Toggle social spy to see private messages | auraessentials.socialspy |

Staff Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /staffmode | Toggle staff mode | auraessentials.staffmode |
| /staffchat <message> | Send message to staff chat | auraessentials.staffchat |
| /streammode | Toggle stream mode (hide sensitive info) | auraessentials.staffmode |

Role Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /role create <id> <local/global> | Create a new role | auraessentials.role.create |
| /role delete <role> | Delete a role | auraessentials.role.delete |
| /role edit <role> | Open role editor GUI | auraessentials.role.edit |
| /role list | List all roles | auraessentials.role.list |
| /role info <role> | View role details | auraessentials.role.info |
| /role setprefix <role> <prefix> | Set role prefix | auraessentials.role.edit |
| /role setsuffix <role> <suffix> | Set role suffix | auraessentials.role.edit |
| /role setchatcolor <role> <color> | Set role chat color | auraessentials.role.setchatcolor |
| /role setweight <role> <weight> | Set role weight/priority | auraessentials.role.edit |
| /role addpermission <role> <perm> | Add permission to role | auraessentials.role.edit |
| /role removepermission <role> <perm> | Remove permission from role | auraessentials.role.edit |
| /role inherit <role> <parent> | Add role inheritance | auraessentials.role.edit |
| /role uninherit <role> <parent> | Remove role inheritance | auraessentials.role.edit |
| /role setdefault <role> | Set as default role | auraessentials.role.edit |
| /grant <player> | Open grant GUI for player | auraessentials.grant |

User Permission Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /userperm add <player> <perm> [global/local] | Add permission to player | auraessentials.userperm.add |
| /userperm remove <player> <perm> [global/local] | Remove permission from player | auraessentials.userperm.remove |
| /userperm list <player> [global/local/all] | List player's permissions | auraessentials.userperm.list |
| /userperm clear <player> [global/local/all] | Clear player's permissions | auraessentials.userperm.clear |

Scoreboard Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /scoreboard | Toggle scoreboard visibility | - |

---

Permissions

Admin Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.admin | Access to all admin commands | OP |
| auraessentials.admin.reload | Reload plugin configuration | OP |
| auraessentials.vanish | Use vanish command | OP |
| auraessentials.vanish.see | See vanished players | OP |
| auraessentials.vanish.others | Toggle vanish for others | OP |
| auraessentials.fly | Use fly command | OP |
| auraessentials.fly.others | Toggle fly for others | OP |
| auraessentials.gamemode | Use gamemode command | OP |
| auraessentials.gamemode.others | Change others' gamemode | OP |
| auraessentials.gamemode.survival | Change to survival | OP |
| auraessentials.gamemode.creative | Change to creative | OP |
| auraessentials.gamemode.adventure | Change to adventure | OP |
| auraessentials.gamemode.spectator | Change to spectator | OP |
| auraessentials.broadcast | Broadcast to local server | OP |
| auraessentials.broadcast.global | Broadcast to all servers | OP |

Economy Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.balance | Check own balance | true |
| auraessentials.balance.others | Check others' balance | OP |
| auraessentials.pay | Pay other players | true |
| auraessentials.baltop | View balance leaderboard | true |
| auraessentials.eco | Admin economy commands | OP |
| auraessentials.eco.give | Give money to players | OP |
| auraessentials.eco.take | Take money from players | OP |
| auraessentials.eco.set | Set player balance | OP |
| auraessentials.eco.reset | Reset player balance | OP |

Shop Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.shop | Use the shop | true |
| auraessentials.shop.admin | Admin shop commands | OP |

Kit Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.kit | Use kit command | true |
| auraessentials.kit.list | List available kits | true |
| auraessentials.kit.<kitname> | Access specific kit | varies |
| auraessentials.kit.bypass | Bypass kit cooldowns | OP |
| auraessentials.kit.give | Give kits to others | OP |
| auraessentials.kit.admin | Manage kits | OP |

Punishment Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.punish | Use punish command/GUI | OP |
| auraessentials.history | View punishment history | OP |
| auraessentials.pardon | Use pardon command/GUI | OP |
| auraessentials.unban | Unban players | OP |
| auraessentials.unmute | Unmute players | OP |

Messaging Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.msg | Use private messaging | true |
| auraessentials.reply | Use reply command | true |
| auraessentials.socialspy | See others' private messages | OP |

Staff Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.staffmode | Use staff mode | OP |
| auraessentials.staffchat | Use staff chat | OP |
| auraessentials.staffchat.send | Send staff chat messages | OP |
| auraessentials.staffchat.receive | Receive staff chat messages | OP |

Role Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.role | Use role commands | OP |
| auraessentials.role.create | Create new roles | OP |
| auraessentials.role.delete | Delete roles | OP |
| auraessentials.role.edit | Edit role properties | OP |
| auraessentials.role.list | List all roles | OP |
| auraessentials.role.info | View role information | OP |
| auraessentials.role.add | Add roles to players | OP |
| auraessentials.role.remove | Remove roles from players | OP |
| auraessentials.role.setchatcolor | Set role chat color | OP |
| auraessentials.grant | Grant/revoke roles | OP |
| auraessentials.roles.view | View own roles | true |

User Permission Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| auraessentials.userperm | Manage user permissions | OP |
| auraessentials.userperm.add | Add user permissions | OP |
| auraessentials.userperm.remove | Remove user permissions | OP |
| auraessentials.userperm.list | List user permissions | OP |
| auraessentials.userperm.clear | Clear user permissions | OP |

---

PlaceholderAPI

When PlaceholderAPI is installed, the following placeholders are available:

Role Placeholders
| Placeholder | Description |
|-------------|-------------|
| %auraessentials_prefix% | Player's highest weight role prefix |
| %auraessentials_suffix% | Player's highest weight role suffix |
| %auraessentials_chat_color% | Player's highest weight role chat color |
| %auraessentials_role% | Player's highest weight role display name |
| %auraessentials_roles% | Comma-separated list of all role names |
| %auraessentials_role_count% | Number of roles the player has |
| %auraessentials_has_role_<roleid>% | Whether player has a specific role (true/false) |

Economy Placeholders
| Placeholder | Description |
|-------------|-------------|
| %auraessentials_balance% | Player's formatted balance |
| %auraessentials_balance_raw% | Player's raw balance (number only) |
| %auraessentials_currency_name% | Currency name |
| %auraessentials_currency_symbol% | Currency symbol |

---

Requirements

• Java 21+
• Spigot/Paper 1.21+ (Untested on Lower versions currently)
• MongoDB (recommended for multi-server)
• Redis (recommended for cross-server features)
• Vault (optional, for economy compatibility)

---