Skip to main content

Commands

CocoAntiVPN provides a single command with multiple subcommands for complete control over the plugin.

Main Command

CommandDescription
/antivpnMain command for CocoAntiVPN
/avpnAlias for /antivpn
/cocoantivpnFull alias for /antivpn

Subcommands

Help Command

/antivpn help

Displays all available commands with their descriptions.

Permission: antivpn.command.help


Enable Protection

/antivpn enable

Enables VPN/proxy protection. Players using VPNs will be kicked.

Permission: antivpn.command.enable

Example:

/antivpn enable
> [CocoVPN] AntiVPN enabled.

Disable Protection

/antivpn disable

Temporarily disables VPN/proxy protection. All players can join regardless of VPN usage.

Permission: antivpn.command.disable

Example:

/antivpn disable
> [CocoVPN] AntiVPN disabled.
warning

Disabling protection allows all VPN users to join. Only disable temporarily for maintenance or testing.


Reload Configuration

/antivpn reload

Reloads the configuration file without restarting the server.

Permission: antivpn.command.reload

Example:

/antivpn reload
> [CocoVPN] Config reloaded.

Unban IP

/antivpn unban <ip>

Removes an IP address from the blacklist, allowing them to connect again.

Permission: antivpn.command.unban

Arguments:

  • <ip> - The IP address to unban

Example:

/antivpn unban 192.168.1.100
> [CocoVPN] IP address 192.168.1.100 successfully removed from blacklist!
tip

Use this command when a player was incorrectly flagged as using a VPN or their VPN usage is now allowed.


Bypass Commands

Manage the bypass list to allow specific players to use VPNs.

Add Bypass

/antivpn bypass add <player>

Adds a player to the bypass list. They can join even when using a VPN.

Permission: antivpn.command.bypass.add

Arguments:

  • <player> - The player's username (case-insensitive)

Example:

/antivpn bypass add Notch
> [CocoVPN] Notch added to bypass list.

Remove Bypass

/antivpn bypass remove <player>

Removes a player from the bypass list.

Permission: antivpn.command.bypass.remove

Arguments:

  • <player> - The player's username (case-insensitive)

Example:

/antivpn bypass remove Notch
> [CocoVPN] Notch removed from bypass list.

List Bypasses

/antivpn bypass list

Shows all players currently in the bypass list.

Permission: antivpn.command.bypass.list

Example:

/antivpn bypass list
> [CocoVPN] Bypasses: Notch, jeb_, Dinnerbone

Command Summary Table

CommandPermissionDescription
/antivpn helpantivpn.command.helpShow help message
/antivpn enableantivpn.command.enableEnable protection
/antivpn disableantivpn.command.disableDisable protection
/antivpn reloadantivpn.command.reloadReload configuration
/antivpn unban <ip>antivpn.command.unbanRemove IP from blacklist
/antivpn bypass add <player>antivpn.command.bypass.addAdd player to bypass
/antivpn bypass remove <player>antivpn.command.bypass.removeRemove from bypass
/antivpn bypass listantivpn.command.bypass.listList all bypasses

Tab Completion

All commands support tab completion for easier usage:

  • /antivpn <TAB> - Shows: help, enable, disable, reload, unban, bypass
  • /antivpn bypass <TAB> - Shows: add, remove, list
  • /antivpn bypass remove <TAB> - Shows list of bypassed players