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 EssentialsC placeholders (%essc_…%). Requires PlaceholderAPI to be installed.
/essc commands [page] List every command EssentialsC registers, paginated.
/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. Plain /essc backup does the same.
/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 diagnostic information for troubleshooting. It is always saved as JSON to plugins/EssentialsC/dumps/. If you also have essc.dump.upload, it is uploaded and you get a shareable dumps.godlycow.org link to post in an issue or on Discord.

Command Description
/essc dump Collect and generate a full diagnostic dump.
/essc dump <section...> Only include the listed sections: summary, modules, runtime, integrations, config, economy, punishments, homes, warps, spawn, backups, players, logs, health.

The dump includes:

  • Plugin summary and version
  • Enabled modules and their status
  • Runtime environment (Java version, server version, processor, memory)
  • 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.
/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
essc.dump Operators
essc.dump.upload Operators
essentialsc.sudo Operators
essentialsc.smite Operators
essentialsc.spawnentity Operators
essentialsc.spawnentity.* Nobody
essentialsc.spawnentity.bypasslimit Operators
essentialsc.user Operators
essentialsc.user.ip Operators
essentialsc.user.offline Operators
essentialsc.ptime Everyone
essentialsc.pweather Everyone