⚙️ Main Configuration (config.json)

Hot Reload

Most changes can be applied without restarting the server using /essentialsplus reload

File Information

📁 File Location: mods/fof1092_EssentialsPlus/config.json
🔙 Back to Configuration Overview

The config.json is the main configuration file for EssentialsPlus. It contains all plugin features, settings, and customization options. This file can be manually edited to customize your server's behavior.

📋 Configuration Structure

The main configuration file for Essentials Plus.

Example:

json

{
  "version": "1.15.1",
  "debugMode": false,
  "firstJoin": {
    "enabled": true,
    "messages": [
      "<#f495ee>==============================</#FFAA00>",
      "<#f495ee>Welcome to the Server, {player}!</#FFAA00>",
      "<#f495ee>This is your first time joining us.</#FFAA00>",
      "<#f495ee>We hope you enjoy your stay!</#FFAA00>",
      "<#f495ee>==============================</#FFAA00>"
    ],
    "broadcastToAll": true,
    "showMotdIfEnabled": true,
    "kits": [
      "firstjoin"
    ],
    "runAsServer": [],
    "runAsPlayer": [],
    "teleport": {
      "enabled": false,
      "warpName": "firstjoin"
    }
  },
  "joinandquit": {
    "enabled": true,
    "joinMessage": "<#55FF55><bold>+ </bold></#55FF55><#FFAA00><bold>{player} joined the server.</bold></#FFAA00>",
    "quitMessage": ""
  },
  "chat": {
    "enabled": true,
    "ignoreChatCancellations": true,
    "groups": {
      "adventure": "<#00AA00><bold>[<#FFFFFF>Player</#FFFFFF>] {player}: </bold></#00AA00><#AAAAAA>{message}</#AAAAAA>",
      "op": "<#FF5555><bold>[<#FFFFFF>OP</#FFFFFF>] {player}: </bold></#FF5555><#AAAAAA>{message}</#AAAAAA>",
      "default": "<#00AA00><bold>[<#FFFFFF>Default</#FFFFFF>] {player}: </bold></#00AA00><#AAAAAA>{message}</#AAAAAA>",
      "moderator": "<#5555FF><bold>[<#FFFFFF>Moderator</#FFFFFF>] {player}<#FF5555>: </bold></#5555FF><#AAAAAA>{message}</#AAAAAA>",
      "admin": "<#FF5555><bold>[<#FFFFFF>Admin</#FFFFFF>] {player}: </bold></#FF5555><#AAAAAA>{message}</#AAAAAA>",
      "vip": "<#e89d1f><bold>[<#FFFFFF>VIP</#FFFFFF>] <gradient:#e89d1f:#e4e95d:#e89d1f>{player}</gradient>: </bold></#e89d1f><#AAAAAA>{message}</#AAAAAA>"
    }
  },
  "msg": {
    "senderFormat": "<#FFFF55><bold><italic>MSG</italic></bold></#FFFF55><#55FF55><bold> > </bold></#55FF55><#FFAA00><bold>{receiver} </bold></#FFAA00><#FFFFFF><italic>{message}</italic></#FFFFFF>",
    "receiverFormat": "<#FFFF55><bold><italic>MSG</italic></bold></#FFFF55><#FF0000><bold> < </bold></#FF0000><#FFAA00><bold>{sender} </bold></#FFAA00><#FFFFFF><italic>{message}</italic></#FFFFFF>"
  },
  "ignore": {
    "enabled": true,
    "silentModeDefault": false,
    "duration": {
      "default": "1d",
      "maximum": "30d"
    },
    "blockedInteractions": {
      "chat": true,
      "messages": true,
      "mail": true,
      "tpa": true
    }
  },
  "homes": {
    "limitsEnabled": false
  },
  "near": {
    "radius": 50.0,
    "showDistance": true
  },
  "motd": {
    "messages": [
      "<rainbow>==============================</rainbow>",
      "<bold><gradient:#e89d1f:#e4e95d:#e89d1f>Message of the Day</gradient></bold>",
      "<#FFFFFF>Welcome to our server!</#FFFFFF>",
      "<#FFFFFF>Have fun and follow the <green>/rules</green> !</#FFFFFF>",
      "<#FFFFFF>Visit us on <#7289DA><bold>Discord</bold></#7289DA>:</#FFFFFF> <url:https://discord.gg/w2XqCBfsnx><gradient:#00acf2:#7289DA:#00acf2>https://discord.gg/w2XqCBfsnx</gradient></url>",
      "<rainbow>==============================</rainbow>"
    ],
    "enabled": true
  },
  "groupSystem": {
    "syncWithLuckPerms": true,
    "fallbackGroup": "default",
    "groups": [
      {
        "name": "op",
        "priority": 100,
        "prefix": "<#FF5555>",
        "suffix": "</#FF5555>",
        "tag": "<#FF5555><bold>[<#FFFFFF>OP</#FFFFFF>]</bold></#FF5555>"
      },
      {
        "name": "admin",
        "priority": 90,
        "prefix": "<#FF5555>",
        "suffix": "</#FF5555>",
        "tag": "<#FF5555><bold>[<#FFFFFF>Admin</#FFFFFF>]</bold></#FF5555>"
      },
      {
        "name": "moderator",
        "priority": 80,
        "prefix": "<#5555FF>",
        "suffix": "</#5555FF>",
        "tag": "<#5555FF><bold>[<#FFFFFF>Moderator</#FFFFFF>]</bold></#5555FF>"
      },
      {
        "name": "vip",
        "priority": 50,
        "prefix": "<#e89d1f>",
        "suffix": "</#e89d1f>",
        "tag": "<#e89d1f><bold>[<#FFFFFF>VIP</#FFFFFF>]</bold></#e89d1f>"
      },
      {
        "name": "adventure",
        "priority": 10,
        "prefix": "<#00AA00>",
        "suffix": "</#00AA00>",
        "tag": "<#00AA00><bold>[<#FFFFFF>Player</#FFFFFF>]</bold></#00AA00>"
      },
      {
        "name": "default",
        "priority": 0,
        "prefix": "<#00AA00>",
        "suffix": "</#00AA00>",
        "tag": "<#00AA00><bold>[<#FFFFFF>Default</#FFFFFF>]</bold></#00AA00>"
      }
    ]
  },
  "rtp": {
    "maxRadius": 500,
    "minRadius": 100,
    "maxChecks": 10,
    "enabledWorlds": [
      "*"
    ],
    "defaultWorld": {
      "enabled": true,
      "name": "default"
    }
  },
  "broadcast": {
    "format": "<bold><gradient:#f83d5c:#f83d5c:#fd4b2f>[BROADCAST]</gradient></bold> "
  },
  "spawn": {
    "perWorldSpawn": false
  },
  "discord": {
    "link": "https://discord.gg/yourserver"
  },
  "protections": {
    "enabled": true,
    "spawn": {
      "enabled": true,
      "radius": 0,
      "pvp": false
    }
  },
  "economy": {
    "enabled": true,
    "startBalance": 0.0,
    "minBalance": 0.0,
    "maxBalance": 1.0E8,
    "transactionLogging": true,
    "currencySymbol": "$",
    "currencyNameSingular": "Dollar",
    "currencyNamePlural": "Dollars"
  },
  "mail": {
    "limit": {
      "enabled": true,
      "count": 50
    },
    "spamProtection": {
      "enabled": true,
      "cooldownSeconds": 60,
      "similarityCheck": {
        "enabled": true,
        "threshold": 0.8
      }
    }
  },
  "customCommands": {
    "commands": [
      {
        "command": "/lobby",
        "description": "Teleport to the server lobby",
        "aliases": [
          "/hub"
        ],
        "runAsServer": [],
        "runAsPlayer": [
          "/warp spawn"
        ],
        "messages": [
          "<gradient:#00acf2:#7289DA>Teleporting to lobby...</gradient>"
        ]
      },
      {
        "command": "/ticket",
        "description": "Provides information on how to submit a support ticket",
        "aliases": [
          "/support"
        ],
        "runAsServer": [],
        "runAsPlayer": [],
        "messages": [
          "<gold>Need help? Submit a support ticket at:</gold>",
          "<yellow><url:https://support.example.com>https://support.example.com</url></yellow>",
          "<gray>Our team will assist you as soon as possible!</gray>"
        ]
      },
      {
        "command": "/gmc",
        "description": "Set your gamemode to creative",
        "aliases": [],
        "runAsServer": [],
        "runAsPlayer": [
          "/gamemode creative"
        ],
        "messages": []
      },
      {
        "command": "/gma",
        "description": "Set your gamemode to adventure",
        "aliases": [
          "/gms"
        ],
        "runAsServer": [],
        "runAsPlayer": [
          "/gamemode adventure"
        ],
        "messages": []
      },
      {
        "command": "/bonus",
        "description": "Claim your daily bonus",
        "aliases": [],
        "runAsServer": [
          "/kit bonus {player}",
          "/eco give {player} 25",
          "/broadcast <gold>{player}</gold> <white>has bonus the daily bonus! <yellow>/bonus</yellow></white>"
        ],
        "runAsPlayer": [],
        "messages": [
          "<gray>You received your bonus reward!</gray>"
        ]
      }
    ]
  },
  "commandInterceptions": {
    "commands": [
      {
        "command": "/home",
        "price": 0.0,
        "cooldown": "0s",
        "warmup": "0s",
        "warmupMovementAllowed": true
      },
      {
        "command": "/warp",
        "price": 0.0,
        "cooldown": "0s",
        "warmup": "0s",
        "warmupMovementAllowed": true
      },
      {
        "command": "/rtp",
        "price": 0.0,
        "cooldown": "0s",
        "warmup": "0s",
        "warmupMovementAllowed": true
      },
      {
        "command": "/spawn",
        "price": 0.0,
        "cooldown": "0s",
        "warmup": "0s",
        "warmupMovementAllowed": true
      },
      {
        "command": "/tpa",
        "price": 0.0,
        "cooldown": "0s",
        "warmup": "0s",
        "warmupMovementAllowed": true
      },
      {
        "command": "/back",
        "price": 0.0,
        "cooldown": "0s",
        "warmup": "0s",
        "warmupMovementAllowed": true
      },
      {
        "command": "/bonus",
        "price": 0.0,
        "cooldown": "24h",
        "warmup": "0s",
        "warmupMovementAllowed": true
      }
    ]
  },
  "disabledCommands": [],
  "afk": {
    "enabled": true,
    "autoAFKTime": "10m",
    "broadcast": true,
    "enableAutoAFKPermissionBypass": false,
    "kick": {
      "enabled": false,
      "autoKickTime": "30m"
    }
  }
}

Configuration Options:

General Settings

version - Configuration version (automatically managed)
debugMode - Enable debug logging (default: false)

First Join System (`firstJoin`)

Unified first join system combining welcome messages, kits, commands, and more.

First join welcome screen with custom formatted title and chat messages

Basic Settings

enabled - Enable first join system (default: true)
messages - Array of welcome messages shown on first join
- Supports hex colors (e.g., <#ffffff>text</#ffffff>)
- Supports gradients, rainbow effects, and all text formatting
- Use {player} placeholder for player name
- All PlaceholderAPI placeholders are supported
broadcastToAll - Broadcast to all players instead of just the joining player (default: true)
showMotdIfEnabled - Show MOTD message if enabled (default: true)

Kits (kits)

Array of kit names to give to the player on first join.

json

"kits": ["firstjoin", "starter"]

Kits are given with a 1 second delay to ensure inventory is ready
Kit must exist in the kits/ directory
No error message is shown to the player if kit doesn't exist (logged to console)

Teleport on First Join (teleport)

enabled - Enable teleportation to a warp on first join (default: false)
warpName - Name of the warp to teleport to (default: "firstjoin")

Command Execution

Execute commands when a player joins for the first time.

Run as Server (runAsServer):

Commands executed with server/console permissions
Supports {player} and all PlaceholderAPI placeholders
Executed with a 1.5 second delay

json

"runAsServer": [
  "/broadcast <gold>{player}</gold> joined for the first time!",
  "/eco give {player} 1000"
]

Run as Player (runAsPlayer):

Commands executed as if the player typed them
Player's permissions apply
Supports {player} and all PlaceholderAPI placeholders
Executed with a 1.5 second delay

json

"runAsPlayer": [
  "/rules"
]

Join/Quit Messages (`joinandquit`)

enabled - Enable join/quit messages (default: true)
joinMessage - Message format when player joins
- Use {player} placeholder for player name
quitMessage - Message format when player quits
- Use {player} placeholder for player name

Chat Format (`chat`)

Chat format example showing rank-based prefixes and colored names Advanced chat formatting with gradient colors and custom formatting tags

enabled - Enable custom chat formatting (default: true)
ignoreChatCancellations - Ignore chat cancellations from other plugins, ensuring EssentialsPlus chat formatting is always applied (default: true)
groups - Map of permission groups to chat formats
- Basic placeholders: {player} (player name), {message} (chat message), {group} (permission group)
- World & Location: {world} (world name), {x}, {y}, {z} (coordinates)
- Player info: {uuid} (player UUID), {language} (player language)
- Time & Date: {time} (HH:mm:ss), {date} (yyyy-MM-dd)
- Supports hex colors

Private Messages (`msg`)

Private message conversation between two players

senderFormat - Message format for sender
- Use {receiver} placeholder for receiver name
- Use {message} placeholder for message content
receiverFormat - Message format for receiver
- Use {sender} placeholder for sender name
- Use {message} placeholder for message content

Ignore System (`ignore`)

enabled - Enable/disable ignore system (default: true)
silentModeDefault - Default silent mode for new ignores (default: false)
duration - Ignore duration settings
- default - Default ignore duration (default: "1d")
- maximum - Maximum ignore duration (default: "30d")
blockedInteractions - What interactions should be blocked
- chat - Block chat messages (default: true)
- messages - Block private messages (default: true)
- mail - Block mail (default: true)
- tpa - Block TPA requests (default: true)

Homes System (`homes`)

limitsEnabled - Enable home limits per permission group (default: false)

Note: Warmup, cooldown, and prices for home commands are configured in the commandInterceptions section.

Near Command (`near`)

radius - Search radius in blocks (default: 50.0)
showDistance - Show distance to nearby players (default: true)

MOTD (`motd`)

enabled - Enable /motd command (default: true)
messages - Array of messages shown with /motd command
- Supports hex colors
- Use {player} placeholder for player name

Group System (`groupSystem`)

syncWithLuckPerms - Automatically synchronize groups with LuckPerms on server start and reload (default: true)
- When enabled, groups are synced with LuckPerms:
  - New LuckPerms groups are automatically added
  - Groups not in LuckPerms are removed
  - Priority is always synced from LuckPerms weight
  - Prefix/suffix/tag are only set when group is first created
fallbackGroup - Default group name to use when player has no group or group not found (default: "Default")
groups - Array of group configurations

Group Configuration

Each group in the groups array has the following properties:

name - Group name (must match LuckPerms group name if using LuckPerms)
priority - Priority value (higher = higher priority)
prefix - Color/format applied before player name (e.g., "<red>")
suffix - Color/format applied after player name (e.g., "</red>")
tag - Optional tag displayed in chat (e.g., "<red>[Admin]</red>")

Available placeholders in chat formats (chat.groups):

{player} - Player name
{prefix} - Player's prefix from group
{suffix} - Player's suffix from group
{tag} - Player's tag from group
{displayName} - Formatted player name: prefix + player + suffix
{message} - Chat message content
{group} - Player's group name

Example configuration:

json

"groupSystem": {
  "syncWithLuckPerms": true,
  "fallbackGroup": "Default",
  "groups": [
    {
      "name": "Admin",
      "priority": 100,
      "prefix": "<red>",
      "suffix": "</red>",
      "tag": "<red>[Admin]</red>"
    },
    {
      "name": "VIP",
      "priority": 50,
      "prefix": "<#e89d1f>",
      "suffix": "</#e89d1f>",
      "tag": "<#e89d1f>[VIP]</#e89d1f>"
    },
    {
      "name": "Default",
      "priority": 0,
      "prefix": "<green>",
      "suffix": "</green>",
      "tag": ""
    }
  ]
}

Example chat format using new placeholders:

json

  "chat": {
    "enabled": true,
    "ignoreChatCancellations": true,
    "groups": {
      "adventure": "<#00AA00><bold>[<#FFFFFF>Player</#FFFFFF>] {player}: </bold></#00AA00><#AAAAAA>{message}</#AAAAAA>",
      "op": "<#FF5555><bold>[<#FFFFFF>OP</#FFFFFF>] {player}: </bold></#FF5555><#AAAAAA>{message}</#AAAAAA>",
      "default": "<#00AA00><bold>[<#FFFFFF>Default</#FFFFFF>] {player}: </bold></#00AA00><#AAAAAA>{message}</#AAAAAA>",
      "moderator": "<#5555FF><bold>[<#FFFFFF>Moderator</#FFFFFF>] {player}<#FF5555>: </bold></#5555FF><#AAAAAA>{message}</#AAAAAA>",
      "admin": "<#FF5555><bold>[<#FFFFFF>Admin</#FFFFFF>] {player}: </bold></#FF5555><#AAAAAA>{message}</#AAAAAA>",
      "vip": "<#e89d1f><bold>[<#FFFFFF>VIP</#FFFFFF>] <gradient:#e89d1f:#e4e95d:#e89d1f>{player}</gradient>: </bold></#e89d1f><#AAAAAA>{message}</#AAAAAA>"
    }
  },

Random Teleport (`rtp`)

maxRadius - Maximum distance in blocks from spawn point (default: 500)
minRadius - Minimum distance in blocks from spawn point (default: 100)
maxChecks - Maximum number of attempts to find a safe location (default: 10)
enabledWorlds - List of worlds where RTP is permitted
- Use ["*"] to allow all worlds (default)
- Use ["world", "world_nether"] to allow specific worlds
- Empty list allows all worlds
defaultWorld - Fallback world configuration when current world is not enabled
- enabled - Enable automatic fallback to default world (default: false)
- name - Name of the default world to use for fallback (default: "default")

Note: Warmup, cooldown, and prices for the RTP command are configured in the commandInterceptions section.

Example configuration:

json

  "rtp": {
    "maxRadius": 500,
    "minRadius": 100,
    "maxChecks": 10,
    "enabledWorlds": [
      "*"
    ],
    "defaultWorld": {
      "enabled": true,
      "name": "default"
    }
  },

Broadcast System (`broadcast`)

Server broadcast message with custom formatting displayed to all players

format - Prefix format for broadcast messages
- Supports hex colors and gradients
- Example: <bold><gradient:#e89d1f:#e4e95d:#e89d1f>[EssentialsPlus]</gradient></bold>

Spawn System (`spawn`)

perWorldSpawn - Whether /spawn should teleport to the current world's spawn instead of the main spawn (default: false)

Note: Warmup, cooldown, and prices for spawn/teleportation commands are configured in the commandInterceptions section.

Discord Integration (`discord`)

link - Discord server invite link (default: "https://discord.gg/yourserver")

Protection System (`protections`)

enabled - Enable/disable protection system (default: true)
spawn - Spawn protection settings
- enabled - Enable/disable spawn protection (default: true)
- radius - Protection radius in blocks from spawn point (default: 0)
  - Players cannot break or place blocks within this radius
  - Set to 0 to disable protection
- pvp - Allow PvP in spawn protection area (default: false)
- Bypass permission: essentialsplus.protection.bypass

Mail System (`mail`)

limit - Mail limit settings
- enabled - Enable mail limit per player (default: true)
- count - Maximum number of mails a player can have (default: 50)
spamProtection - Spam protection settings
- enabled - Enable spam protection (default: true)
- cooldownSeconds - Cooldown in seconds between sending mails (default: 60)
- similarityCheck - Similarity check settings
  - enabled - Enable similarity check to prevent duplicate mails (default: true)
  - threshold - Similarity threshold (0.0-1.0, higher = stricter) (default: 0.8)

Economy System (`economy`)

enabled - Enable/disable economy system (default: true)
startBalance - Starting balance for new players (default: 0.0)
minBalance - Minimum allowed balance (default: 0.0)
maxBalance - Maximum allowed balance (default: 100000000.0)
transactionLogging - Enable transaction logging (default: true)
currencySymbol - Currency symbol (default: "$")
currencyNameSingular - Singular currency name (default: "Dollar")
currencyNamePlural - Plural currency name (default: "Dollars")

Features:

Complete economy system with transaction logging
Configurable currency names and symbols
Balance limits to prevent exploits
Built-in Economy API for other plugins
Player-to-player money transfers

Related Commands:

/money - View your balance
/money <player> - View another player's balance
/money send <player> <amount> - Send money
/money top - View richest players
/pay <player> <amount> - Quick payment

Custom Commands System (`customCommands`)

The Custom Commands system allows server administrators to create custom commands without modifying the plugin code.

commands - Array of custom command definitions

Command Definition Properties:

Each command in the commands array supports:

command - Command name with / (e.g., "/lobby", "/help") (required)
description - Brief description of the command (optional)
aliases - Array of alternative command names (optional)
runAsServer - Array of commands executed as console/server (optional)
runAsPlayer - Array of commands executed as the player (optional)
messages - Array of messages sent to the player (optional)

Available Placeholders:

{player} - Player name
{uuid} - Player UUID
{world} - Current world name
{x}, {y}, {z} - Player coordinates
{language} - Player language
{time} - Current time (HH:mm:ss)
{date} - Current date (yyyy-MM-dd)
All PlaceholderAPI placeholders (if PlaceholderAPI is installed)

Example Custom Commands:

json

  "customCommands": {
    "commands": [
      {
        "command": "/lobby",
        "description": "Teleport to the server lobby",
        "aliases": [
          "/hub"
        ],
        "runAsServer": [],
        "runAsPlayer": [
          "/warp spawn"
        ],
        "messages": [
          "<gradient:#00acf2:#7289DA>Teleporting to lobby...</gradient>"
        ]
      },
      {
        "command": "/gmc",
        "description": "Set your gamemode to creative",
        "aliases": [],
        "runAsServer": [],
        "runAsPlayer": [
          "/gamemode creative"
        ],
        "messages": []
      },
      {
        "command": "/bonus",
        "description": "Claim your daily bonus",
        "aliases": [],
        "runAsServer": [
          "/kit bonus {player}",
          "/eco give {player} 25",
          "/broadcast <gold>{player}</gold> <white>has bonus the daily bonus! <yellow>/bonus</yellow></white>"
        ],
        "runAsPlayer": [],
        "messages": [
          "<gray>You received your bonus reward!</gray>"
        ]
      }
    ]
  }

Security Notes:

Commands in runAsServer execute with full server privileges
Test custom commands thoroughly before production use
Use permissions to restrict access to powerful commands

Permissions:

Each custom command automatically gets: essentialsplus.customcommands.<name>
Example: A command named "lobby" requires essentialsplus.customcommands.lobby

Command Interception System (`commandInterceptions`)

Universal warmup, cooldown, and price system for any command.

Command Interception allows you to add warmup times, cooldowns, and prices to any command (including EssentialsPlus commands and commands from other plugins) without modifying code.

Configuration Format:

json

  "commandInterceptions": {
    "commands": [
      {
        "command": "/home",
        "price": 0.0,
        "cooldown": "0s",
        "warmup": "0s",
        "warmupMovementAllowed": true
      },
      {
        "command": "/warp",
        "price": 0.0,
        "cooldown": "0s",
        "warmup": "0s",
        "warmupMovementAllowed": true
      }
    ]
  }

Interception Properties:

command - Command name to intercept (with or without /) (required)
price - Cost in economy currency to use command (default: 0.0)
cooldown - Time between command uses (e.g., "30s", "5m", "1h") (default: "0s")
warmup - Delay before command execution (e.g., "5s", "10s") (default: "0s")
warmupMovementAllowed - Allow movement during warmup (default: true)

Time Format:

Supports multiple time units:

s - Seconds (e.g., "30s")
m - Minutes (e.g., "5m")
h - Hours (e.g., "1h")
d - Days (e.g., "7d")
Combinations: "1h30m", "2d12h"

Features:

Works with any command (EssentialsPlus or external plugins)
Automatic alias detection (e.g., /ehome matches /home)
Movement detection during warmup (cancels teleport if player moves)
Per-player cooldown tracking
Economy integration for command prices

Example Use Cases:

Prevent Teleport Spam:

json

{
  "command": "/warp",
  "cooldown": "30s",
  "warmup": "5s",
  "warmupMovementAllowed": false
}

Premium Command with Price:

json

{
  "command": "/jumpto",
  "price": 50.0,
  "cooldown": "10s",
  "warmup": "2s",
  "warmupMovementAllowed": true
}

Instant Command with Cooldown:

json

{
  "command": "/kit",
  "cooldown": "1h",
  "warmup": "0s",
  "warmupMovementAllowed": true
}

Permissions:

Interception reductions are available through permissions:

essentialsplus.interception.<command>.warmup.<percentage> - Reduce warmup time
essentialsplus.interception.<command>.cooldown.<percentage> - Reduce cooldown time
essentialsplus.interception.<command>.price.<percentage> - Reduce price
Add .infinite suffix to bypass completely (e.g., essentialsplus.interception.home.cooldown.infinite)

Disabled Commands (`disabledCommands`)

Disable specific EssentialsPlus commands without editing code.

The disabledCommands array allows you to disable individual EssentialsPlus commands that you don't want available on your server.

How it works:

Add command names (without /) to the array
Commands will not be registered when the plugin starts
Aliases are also disabled automatically
Does NOT affect commands from other plugins

Example - Disable Creative-Mode Commands:

json

  "disabledCommands": [
    "/fly",
    "/god",
    "/more",
    "/repair"
  ]

Notes:

Use command names exactly as they appear in Commands Documentation
Changes require server restart to take effect
Disabled commands will not appear in tab completion

Common use cases:

Disable commands that conflict with other plugins
Remove commands that don't fit your server's gameplay
Disable admin commands on public servers
Simplify command list for players

AFK System (`afk`)

The AFK (Away From Keyboard) system automatically marks players as inactive and optionally kicks them.

enabled - Enable/disable the AFK system (default: true)
autoAFKTime - Time of inactivity before auto-marking as AFK (e.g., "10m") (default: "10m")
broadcast - Broadcast AFK status changes to all players (default: true)
enableAutoAFKPermissionBypass - Allow permission-based bypass for auto-AFK (default: false)
kick - Auto-kick configuration
- enabled - Enable automatic kick for AFK players (default: false)
- autoKickTime - Time in AFK status before kick (e.g., "30m") (default: "30m")

Features:

Automatic AFK detection based on player inactivity
Optional broadcast of AFK status changes
Optional auto-kick for AFK players
Permission bypass for auto-AFK and auto-kick
Integration with /list, TPA, and messaging systems

⚙️ Configuration

🎓 Tutorials

⚙️ Main Configuration (config.json)

📋 Configuration Structure

General Settings

First Join System (`firstJoin`)

Join/Quit Messages (`joinandquit`)

Chat Format (`chat`)

Private Messages (`msg`)

Ignore System (`ignore`)

Homes System (`homes`)

Near Command (`near`)

MOTD (`motd`)

Group System (`groupSystem`)

Random Teleport (`rtp`)

Broadcast System (`broadcast`)

Spawn System (`spawn`)

Discord Integration (`discord`)

Protection System (`protections`)

Mail System (`mail`)

Economy System (`economy`)

Custom Commands System (`customCommands`)

Command Interception System (`commandInterceptions`)

Disabled Commands (`disabledCommands`)

AFK System (`afk`)

⚙️ Main Configuration (config.json) ​

📋 Configuration Structure ​

General Settings ​

First Join System (firstJoin) ​

Join/Quit Messages (joinandquit) ​

Chat Format (chat) ​

Private Messages (msg) ​

Ignore System (ignore) ​

Homes System (homes) ​

Near Command (near) ​

MOTD (motd) ​

Group System (groupSystem) ​

Random Teleport (rtp) ​

Broadcast System (broadcast) ​

Spawn System (spawn) ​

Discord Integration (discord) ​

Protection System (protections) ​

Mail System (mail) ​

Economy System (economy) ​

Custom Commands System (customCommands) ​

Command Interception System (commandInterceptions) ​

Disabled Commands (disabledCommands) ​

AFK System (afk) ​

⚙️ Main Configuration (config.json)

📋 Configuration Structure

General Settings

First Join System (`firstJoin`)

Join/Quit Messages (`joinandquit`)

Chat Format (`chat`)

Private Messages (`msg`)

Ignore System (`ignore`)

Homes System (`homes`)

Near Command (`near`)

MOTD (`motd`)

Group System (`groupSystem`)

Random Teleport (`rtp`)

Broadcast System (`broadcast`)

Spawn System (`spawn`)

Discord Integration (`discord`)

Protection System (`protections`)

Mail System (`mail`)

Economy System (`economy`)

Custom Commands System (`customCommands`)

Command Interception System (`commandInterceptions`)

Disabled Commands (`disabledCommands`)

AFK System (`afk`)