# Installation

### Requirements <a href="#requirements" id="requirements"></a>

* **Java Version:** 21 or newer
* **Server Software**: Spigot, Paper, Purpur
* **Server Version**: 1.21 or newer
* **Optional:** [PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI/releases)

### Installation Steps

1. **Download the Plugin**
   * Visit the [Modrinth page](https://modrinth.com/plugin/spawn-elytra#download)
   * Download the latest version of Spawn Elytra (or the one fitting your server version)
2. **Install the Plugin**
   * Place the downloaded `.jar` file in your server's `plugins` folder
   * Restart your server
3. **Initial Setup**
   * The plugin will automatically create:
     * `plugins/SpawnElytra/config.yml`
     * `plugins/SpawnElytra/lang/` directory with language files
     * `plugins/SpawnElytra/playerdata/` directory for player statistics
4. **Verify Installation**
   * Check console for: `[Spawn Elytra] Spawn Elytra Plugin {Version} enabled`
   * Run `/se info` to confirm the plugin is working

### First-Time Setup

When you first join as an operator, you'll see a welcome message with options to:

* Choose your preferred language
* Start the interactive setup wizard

The setup wizard (`/spawnelytra setup`) guides you through defining the spawn area.

### Optional Dependencies

#### PlaceholderAPI

If you want to use placeholders in other plugins:

1. Install [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
2. Restart your server
3. The Spawn Elytra placeholders will automatically register

### First-Time Configuration

After installation:

1. Run `/spawnelytra setup` to define your spawn area, or
2. Review the default `config.yml` file
3. Adjust the spawn radius and world settings
4. Choose your preferred activation mode
5. Use `/spawnelytra reload` to apply changes (some features require a restart)

### Default Configuration

By default, the plugin:

* Works in the "world" world
* Uses a 100 block radius around world spawn
* Uses double-jump activation mode
* Has boost enabled (press F while gliding)

### Updating

To update the plugin:

1. Download the new version
2. Stop your server
3. Replace the old `.jar` file with the new one
4. Start your server
5. The plugin will automatically update your configuration if needed

{% hint style="info" %}
You can also use the Auto Update feature, added in version 1.4. When an update is available, operators will see clickable buttons to auto-update.
{% endhint %}

> **Note**: Your configuration will be preserved during updates. The plugin creates backups before making any changes.

### Next Steps

Once installed, proceed to:

* [Getting Started](https://blaxk.gitbook.io/spawnelytra/readme) - Basic usage guide
* [Configuration](https://blaxk.gitbook.io/spawnelytra/configuration) - Detailed configuration options
* [Commands](https://blaxk.gitbook.io/spawnelytra/commands) - Available commands and their usage