EssentialsC / Admin Guide

Admin Guide

Plugin management, backups, diagnostics, and administrative tools.

Overview

EssentialsC provides a comprehensive set of admin tools for managing the plugin itself - reloading configuration, running backups, generating diagnostic dumps, and troubleshooting issues. The main entry point is the /essc command.

Plugin Command

Subcommand Description
/essc reload Hot-reload all configuration modules - config.yml, commands.yml, kits.yml, spawn.yml, language files, and GUI layouts. No server restart required.
/essc version Display the currently installed EssentialsC version.
/essc debug Toggle verbose debug logging for troubleshooting.
/essc placeholders [page] List all registered PlaceholderAPI placeholders with descriptions.
/essc help Show the plugin command help page.
/essc reload reloads everything at once. Individual components cannot be reloaded separately - the command reloads config, commands, kits, spawn, language, and GUI files in sequence.

Backup System

EssentialsC can create zip backups of its entire data folder, including player data, economy, homes, warps, kits, and configuration. Backups are stored in /plugins/EssentialsC/backups/.

Command Description
/essc backup create Create a new backup with a timestamped filename.
/essc backup list List all existing backups with file sizes and creation dates.
/essc backup delete <filename> Delete a specific backup file.
Config Key Type Default Description
backup.enabled Boolean true Enable or disable the backup system entirely.
backup.keep-last Integer 10 Maximum number of backups to keep. Oldest backups are pruned automatically.
backup.on-shutdown Boolean true Create a backup automatically when the server stops.

Diagnostic Dump

The dump command collects comprehensive diagnostic information for troubleshooting. It can be saved locally or uploaded for remote analysis.

Command Description
/essc dump Collect and generate a full diagnostic dump.

The dump includes:

  • Plugin summary and version
  • Enabled modules and their status
  • Runtime environment (Java version, server version, CPU architecture)
  • Active integrations (Vault, LuckPerms, PlaceholderAPI, etc.)
  • Configuration overview
  • Economy state (total balance, player count)
  • Active punishment counts
  • Home and warp counts
  • Spawn configuration
  • Backup list
  • Online players
  • Recent log output
  • Plugin health checks

Admin Tools

Command Description
/sudo <player> <command|message> Force a player to run a command or send a chat message as themselves.
/smite <player> Strike a player with lightning and deal half a heart of damage.
/spawnentity <entity> [amount] Spawn entities at your location. Supports any Bukkit entity type.
/user <player> [profile|states|punishments|locations|cooldowns|all] View the internal EssentialsC player profile - UUID, stored data, active effects, punishment history, cooldowns, and last known locations.
/ptime [time|day|night|reset] [locked] Set your personal time, visible only to you.
/pweather [clear|rain|storm|reset] Set your personal weather, visible only to you.

Permissions

Permission Default
essentialsc.admin Operators
essentialsc.backup Operators
essentialsc.dump Operators
essentialsc.sudo Operators
essentialsc.smite Operators
essentialsc.spawnentity Operators
essentialsc.user Operators
essentialsc.ptime Everyone
essentialsc.pweather Everyone