# Getting Started

#### Overview

Spawn Elytra lets players use an invisible elytra within a defined spawn area. Players can activate elytra flight through various methods (double-jump, auto-activation, sneak-jump, or F-key) and boost themselves while gliding.

#### Quick Links

* [Modrinth Page](https://modrinth.com/plugin/spawn-elytra)
* [GitHub Repository](https://github.com/blax-k/SpawnElytra)
* [Support & Issues](https://github.com/blax-k/SpawnElytra/issues)

#### 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)

#### Table of Content

* [Installation](/spawnelytra/installation.md)
* [Configuration](/spawnelytra/configuration.md)
* [Commands](/spawnelytra/commands.md)
* [Permissions](/spawnelytra/permissions.md)
* [PlaceholderAPI Support](/spawnelytra/placeholderapi-support.md)
* [Languages](/spawnelytra/languages.md)

***

#### Main Features

**Core Functionality**

* **Invisible Elytra**: Players can fly without wearing an actual elytra item
* **Spawn Area Control**: Define custom areas where the feature is active (circular or rectangular)
* **Per-World Configuration**: Configure different settings for each world

**Activation Modes**

* **Double Jump**: Double-press space bar to activate
* **Auto**: Automatically activates when player has air below and is in spawn area
* **Sneak Jump**: Sneak while jumping to activate
* **F-Key**: Press F (swap hands) to activate with an upward launch boost

**Boost System**

* Press F key while gliding to boost yourself
* Configurable boost strength and direction (forward or upward)
* Customizable sound effects
* Optional "press to boost" messages

**Additional Features**

* **Particle Visualization**: See spawn area boundaries with `/spawnelytra visualize`
* **Interactive Setup**: Easy setup wizard with `/spawnelytra setup`
* **Hunger Consumption**: Optional hunger cost for using elytra (activation, distance, or time-based)
* **Firework Control**: Option to disable fireworks while using spawn elytra
* **Game Mode Handling**: Automatic disable in creative mode (prevents buggy flying)
* **Multi-language Support**: English, German, Spanish, French, and Polish
* **PlaceholderAPI Integration**: Track usage statistics
* **Auto Updates**: Automatic update notifications and optional auto-update feature

***

#### How It Works

1. Players enter the defined spawn area
2. They activate elytra using the configured activation mode
3. While gliding, they can press F to boost themselves
4. The elytra deactivates when they leave the spawn area or land

#### Support

If you encounter any issues or need help:

1. Review the [Configuration](/spawnelytra/configuration.md) guide
2. Check the [Commands](/spawnelytra/commands.md) reference
3. Report issues on [GitHub](https://github.com/blax-k/SpawnElytra/issues)

***

*Thank you for using Spawn Elytra :)*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://blaxk.gitbook.io/spawnelytra/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
