# 🚀  Installation & Setup

1.

    #### Quick Start Guide

    1. **Download the Plugin**
       * Obtain the latest `CodellaCells-x.x.x.jar` file from the resource page
    2. **Install Dependencies**
       * **Required:**
         * [NBT API](https://www.spigotmc.org/resources/nbt-api.7939/) - Essential for all NBT data operations
       * **Optional (for enhanced features):**
         * [Citizens](https://www.spigotmc.org/resources/citizens.13811/) - Enables all NPC functionalities
         * [Vault](https://www.spigotmc.org/resources/vault.34315/) - Required for economy-based upgrades
         * PlaceholderAPI - Reserved for future integrations
    3. **Server Installation**
       * Place the `CodellaCells-x.x.x.jar` file in your server's `/plugins/` directory
       * Start or restart your Minecraft server
       * The plugin will generate default configuration files
    4. **License Activation**
       * **CRITICAL:** Open `config.yml` and enter your unique license key in the `license:` section
       * Restart the server after adding the key
    5. **Initial Configuration**
       * Customize the settings in the configuration files to match your server's theme and needs
       * No manual world creation is needed - CodellaCells automatically creates and manages the void world

    #### Configuration Files Overview

    | File                  | Purpose                                                     |
    | --------------------- | ----------------------------------------------------------- |
    | `config.yml`          | Core settings, generation parameters, permissions, upgrades |
    | `messages.yml`        | All player-facing text (supports HEX colors)                |
    | `gui.yml`             | Interface customization for all menus                       |
    | `titles.yml`          | Action bar and title message configuration                  |
    | `player_settings.yml` | Individual player preferences storage                       |
