Permissions

Complete guide to AnnouncementGUI's permission system.

🔐 Permission Overview

AnnouncementGUI uses a simple permission system with a single main permission node.

📋 Permission Nodes

Permission	Description	Default
announcegui.admin	Full access to all plugin features	op

🎯 Permission Details

announcegui.admin

Description: Grants complete access to AnnouncementGUI features.

Allows:

• Opening the announcement GUI (/announcegui)

• Creating new announcements

• Editing existing announcements

• Deleting announcements

• Toggling announcement status (enable/disable)

• Exporting announcements (/announcegui export)

• Importing announcements (/announcegui import)

• Managing all announcement properties

Default: Operators (OP) only

Permission Type: Single-node (all-or-nothing)

⚙️ Setting Up Permissions

Using LuckPerms (Recommended)

Grant to Individual User:

/lp user <username> permission set announcegui.admin true

Grant to Group:

/lp group admin permission set announcegui.admin true

Remove Permission:

/lp user <username> permission unset announcegui.admin

Check User Permissions:

/lp user <username> permission check announcegui.admin

Examples:

# Give permission to user "Steve"
/lp user Steve permission set announcegui.admin true

# Give permission to Admin group
/lp group admin permission set announcegui.admin true

# Add user to Admin group
/lp user Steve parent add admin

Using PermissionsEx (PEX)

Grant to User:

/pex user <username> add announcegui.admin

Grant to Group:

/pex group <groupname> add announcegui.admin

Remove Permission:

/pex user <username> remove announcegui.admin

Examples:

# Give permission to user "Alex"
/pex user Alex add announcegui.admin

# Give permission to Moderator group
/pex group moderator add announcegui.admin

Using GroupManager

Grant to User:

/manuaddp <username> announcegui.admin

Grant to Group:

/mangaddp <groupname> announcegui.admin

Remove Permission:

/manudelp <username> announcegui.admin

Examples:

# Give permission to user "Bob"
/manuaddp Bob announcegui.admin

# Give permission to Staff group
/mangaddp staff announcegui.admin

Manual Configuration (permissions.yml)

If you're using Bukkit's built-in permissions system, edit permissions.yml:

users:
  YourUsername:
    permissions:
      announcegui.admin: true

groups:
  admin:
    permissions:
      announcegui.admin: true
  moderator:
    permissions:
      announcegui.admin: true

🏗️ Permission Structure Examples

1

Basic Server Setup

Goal: Only admins can manage announcements.

# LuckPerms
/lp creategroup admin
/lp group admin permission set announcegui.admin true
/lp user YourUsername parent add admin

2

Staff Hierarchy

Goal: Admins and moderators both have access.

# LuckPerms - Create groups
/lp creategroup moderator
/lp creategroup admin

# Grant permission to both
/lp group moderator permission set announcegui.admin true
/lp group admin permission set announcegui.admin true

# Add users
/lp user Moderator1 parent add moderator
/lp user Admin1 parent add admin

3

Temporary Permission

Goal: Give temporary access for testing.

# LuckPerms - 24 hour temporary permission
/lp user TestUser permission settemp announcegui.admin true 24h

4

Multi-Server Network

Goal: Different permissions per server.

# LuckPerms - Grant only on specific server
/lp user Manager permission set announcegui.admin true server=lobby
/lp user Manager permission set announcegui.admin true server=survival

🎭 Permission Scenarios

1

Full Admin Access

Who: Server owners, head admins Permission: announcegui.admin

/lp group owner permission set announcegui.admin true

Access: Everything - create, edit, delete, import, export

2

Moderator Access

Who: Trusted moderators Permission: announcegui.admin

/lp group moderator permission set announcegui.admin true

Access: Same as admins (currently no granular permissions)

3

No Access

Who: Regular players Permission: None

Players without the permission cannot:

• Open the announcement GUI

• Use any /announcegui commands

• See or interact with announcement management

4

Testing/Trial Access

Who: New staff being tested Permission: Temporary announcegui.admin

# 7-day trial
/lp user NewStaff permission settemp announcegui.admin true 7d

🔒 Security Best Practices

Principle of Least Privilege

Only grant announcegui.admin to trusted staff who need to manage announcements.

❌ Don't: Give to all moderators if they don't manage announcements ✅ Do: Only give to staff responsible for server announcements

Audit Permission Usage

Regularly review who has the permission:

# LuckPerms - List users with permission
/lp search announcegui.admin

Use Groups Instead of Individual Permissions

❌ Don't: Grant permission directly to each user ✅ Do: Create groups and assign users to groups

# Better approach
/lp group announcement-managers permission set announcegui.admin true
/lp user Steve parent add announcement-managers

Monitor Permission Changes

Enable permission logging in your permission plugin to track who changes permissions.

Temporary Permissions for Trials

Use temporary permissions when testing new staff:

/lp user NewMod permission settemp announcegui.admin true 14d

Remove Permissions When Staff Leave

Always remove permissions when staff members leave:

/lp user FormerStaff permission unset announcegui.admin

# Or remove from group
/lp user FormerStaff parent remove admin

🚫 Permission Denied Messages

When a player lacks the required permission:

Without Permission:

[Announcements] You don't have permission.

Console Execution:

[Announcements] Only players can use this.

These messages can be customized in gui-messages.yml:

command:
  noPermission: "&cYou don't have permission."
  playerOnly: "&cOnly players can use this."

🔧 Troubleshooting Permissions

Issue: Permission not working

1

Verify permission is granted:

/lp user <username> permission check announcegui.admin

2

Check if user is online:

• Have the user rejoin the server

• OR reload permissions: /lp user <username> reload

3

Check permission plugin:

• Ensure permission plugin is loaded

• Check console for permission plugin errors

4

Verify exact spelling:

• Permission: announcegui.admin (all lowercase)

• Must be exact match

Issue: User has permission but can't use command

1

Player must relog after permission change

2

Check conflicts with other permission plugins

3

Verify plugin is enabled:

/plugins

AnnouncementGUI should be green

4

Check server logs for errors

Issue: OP users can't use command

Possible Causes:

1. Server on Offline Mode - May have permission issues

2. Permission plugin override - Some permission plugins override OP permissions

3. Default permissions disabled - Check permission plugin config

Solution:

# Explicitly grant permission to OP group
/lp group op permission set announcegui.admin true

Issue: Permission works on one server but not others (BungeeCord/Velocity)

Solution:

1. Check each server has the plugin installed

2. Verify permission plugin is synced across servers

3. Grant on specific servers:

/lp user <username> permission set announcegui.admin true server=lobby

📊 Permission Audit Checklist

Use this checklist to audit your permission setup:

• Only trusted staff have announcegui.admin

• Permissions are granted via groups, not individuals

• Former staff have permissions removed

• Temporary permissions have expiration dates

• Permission changes are logged

• Regular permission audits are scheduled

• Backup admins exist in case of emergency

🔮 Future Permission Nodes (Planned)

The following permission nodes may be added in future versions:

• announcegui.create - Only create announcements

• announcegui.edit - Only edit existing announcements

• announcegui.delete - Only delete announcements

• announcegui.toggle - Only enable/disable announcements

• announcegui.export - Only export announcements

• announcegui.import - Only import announcements

• announcegui.view - Only view announcements (read-only)

Note: These are not currently implemented. Currently, only announcegui.admin exists.

📝 Permission Plugin Compatibility

AnnouncementGUI is compatible with all major permission plugins:

Plugin	Compatibility	Notes
LuckPerms	✅ Full	Recommended
PermissionsEx	✅ Full	Legacy, still supported
GroupManager	✅ Full	Legacy, still supported
PowerfulPerms	✅ Full	Modern alternative
bPermissions	✅ Full	Less common
Bukkit/Spigot Default	✅ Full	Basic support
UltraPermissions	✅ Full	Modern alternative

🆘 Getting Help

If you're having permission issues:

1. Check this guide first

2. Review server logs for errors

3. Test with OP - If it works with OP, it's a permission issue

4. Check permission plugin docs for your specific plugin

5. Ask for help on GitHub Issues with:

   • Permission plugin name and version

   • Exact permission configuration

   • Server logs (if errors)

   • Steps to reproduce the issue

---

Related Documentation:

• Commands Guide - Available commands

• Installation Guide - Setting up the plugin

• Configuration Guide - Plugin configuration

• Troubleshooting - Common issues