Getting Started with EssentialsC

Overview

EssentialsC is a modern essentials suite designed for Paper, Spigot, and Purpur servers. It provides a complete set of tools for server management including economy, teleportation, GUI systems, and player utilities. This guide will help you get the plugin installed and configured properly.

Download Options

EssentialsC is distributed through multiple official channels. All versions are identical and automatically updated across platforms.

Prerequisites & Dependencies

EssentialsC runs independently but unlocks additional functionality with these optional plugins:

• Vault (Optional but Recommended) - Enables full economy integration, shop systems, and balance management. Without Vault, economy features automatically disable.
• LuckPerms (Highly Recommended) - Provides robust permission management. Use /lp editor for visual permission configuration.
• PlaceholderAPI (Optional) - Adds dynamic placeholders to messages and GUIs. Enhances customization without affecting core functionality.

Installation Walkthrough

Follow these steps for a complete installation:

1. Download - Get the EssentialsC JAR from your preferred platform above
2. Dependencies - Optionally download Vault, LuckPerms, and PlaceholderAPI
3. Deploy - Place all JAR files into your server's /plugins directory
4. First Start - Start your server to generate default configuration files
5. Configure - Stop the server and edit config.yml and other files
6. Finalize - Restart the server to load your custom configuration

Configuration Structure

After first launch, EssentialsC creates a complete directory structure. Understanding this layout helps with troubleshooting and customization.

plugins/EssentialsC/
├── databases/          # SQLite databases (auto-managed)
│   ├── economy.db      # Balance and transaction data
│   ├── homes.db        # Player home locations
│   ├── warps.db        # Server warp points
│   └── ...
├── kits/               # Kit definition files
│   ├── starter.yml     # Default starter kit
│   └── daily.yml       # Daily reward kit
├── lang/               # Message translations
│   ├── en.json         # English (default)
│   ├── fr.json         # French translation
│   ├── de.json         # German translation
│   └── ...
├── shop/               # Shop item configurations
├── storage/            # Binary data and caches
├── .installed          # Installation marker (do not delete)
├── config.yml          # Core plugin settings
├── daily.yml           # Daily reward configuration
├── FJ.yml              # First join player settings
├── placeholders.yml    # Custom placeholder definitions
└── rules.yml           # Server rules configuration

Key Configuration Files

config.yml - Master configuration controlling feature toggles, system limits, and integration settings. Review all options carefully.

daily.yml - Configure daily reward schedules, items, and cooldown periods. Supports per-rank rewards.

FJ.yml - Define what new players receive on first join including items, money, and welcome messages.

placeholders.yml - Register custom placeholders for use in messages and GUIs. Requires PlaceholderAPI.

rules.yml - Create enforceable server rules that players must accept. Includes acceptance tracking.

Permission Setup

EssentialsC uses standard Bukkit permission nodes. The recommended workflow with LuckPerms:

1. Run /lp editor in-game or console to open the web interface
2. Navigate to the group or player you want to modify
3. Add permission nodes following the pattern essentialsc.command.<commandname>
4. Save changes and apply the generated command
5. Test permissions with /lp user <name> permission check essentials.command.home

Configuration Reloading

Understanding what can be reloaded without restart:

Common Issues & Solutions

Plugin Won't Load

• Verify Java 17+ is installed with java -version
• Confirm server version is 1.18 or newer
• Check console for dependency errors during startup
• Re-download the JAR if file size seems incorrect

Commands Not Responding

• Use LuckPerms verbose mode: /lp verbose on essentials
• Check for plugin conflicts using /pl or /plugins
• Verify command isn't disabled in config.yml
• Look for errors in console when running the command

Language Customization Not Applying

• Ensure JSON syntax is valid (use a JSON validator)
• Confirm file is saved as UTF-8 encoding
• Run /language reload and check console for errors
• Test with a simple message change to verify the file loads

Economy Features Disabled

• Install Vault and restart the server
• Check that an economy provider is installed (EssentialsX, CMI, etc.)
• Verify enable-economy: true in config.yml
• Look for economy-related errors in startup logs

Next Steps

Once installation is complete, explore these advanced topics:

• Configuration Deep Dive - Master all config options and optimization
• Command Reference - Complete list of commands with examples
• Permission Nodes - Full permission documentation for ranks
• Developer API - Integrate EssentialsC into your plugins