Permissions

CocoAntiVPN uses a granular permission system that allows fine-grained control over who can access different features.

Permission Nodes

Permission	Description	Default
antivpn.notify	Receive VPN detection notifications	OP
antivpn.command	Access to /antivpn command	OP
antivpn.command.help	View help message	OP
antivpn.command.enable	Enable protection	OP
antivpn.command.disable	Disable protection	OP
antivpn.command.reload	Reload configuration	OP
antivpn.command.unban	Remove IP from blacklist	OP
antivpn.command.bypass.add	Add player to bypass list	OP
antivpn.command.bypass.remove	Remove player from bypass list	OP
antivpn.command.bypass.list	View bypass list	OP

Permission Details

antivpn.notify

Players with this permission receive real-time notifications when a VPN user is detected and kicked.

Notification Format:

[CocoVPN] PlayerName is using a VPN! (IP: xxx.xxx.xxx.xxx)

This is useful for staff members to monitor VPN detection.

---

antivpn.command

This is the base permission required to use any /antivpn command. Without this permission, players cannot access any subcommands.

---

antivpn.command.help

Allows viewing the help message with all available commands.

---

antivpn.command.enable / disable

These permissions control the ability to toggle VPN protection on and off.

Security Note

Be careful who you give antivpn.command.disable to, as it temporarily allows all VPN users to join.

---

antivpn.command.reload

Allows reloading the configuration without server restart. Useful for admins making configuration changes.

---

antivpn.command.unban

Allows removing IP addresses from the blacklist. This is useful when:

• A player was incorrectly flagged
• A staff member needs VPN access temporarily
• An ISP is using proxy-like infrastructure

---

antivpn.command.bypass.*

The bypass permissions control who can manage the bypass list:

Permission	Action
antivpn.command.bypass.add	Add players to bypass list
antivpn.command.bypass.remove	Remove players from bypass list
antivpn.command.bypass.list	View the current bypass list

LuckPerms Examples

Grant all CocoAntiVPN permissions to admins:

/lp group admin permission set antivpn.* true

Allow moderators to view notifications only:

/lp group moderator permission set antivpn.notify true

Allow staff to manage bypasses and unban but not enable/disable:

/lp group staff permission set antivpn.command true
/lp group staff permission set antivpn.command.help true
/lp group staff permission set antivpn.command.unban true
/lp group staff permission set antivpn.command.bypass.add true
/lp group staff permission set antivpn.command.bypass.remove true
/lp group staff permission set antivpn.command.bypass.list true

PermissionsEx Examples

groups:
  admin:
    permissions:
      - antivpn.*
  moderator:
    permissions:
      - antivpn.notify
  staff:
    permissions:
      - antivpn.command
      - antivpn.command.help
      - antivpn.command.unban
      - antivpn.command.bypass.*

BungeeCord Permissions

On BungeeCord, permissions work the same way. Use a BungeeCord permissions plugin like:

• LuckPerms (recommended)
• BungeePerms

Velocity Permissions

On Velocity, use a Velocity-compatible permissions plugin:

• LuckPerms (recommended)
• Velocity default permissions

Configure permissions in your permissions plugin the same way as shown above.