# Configuration

### Configuration File

The main configuration file is located at `plugins/CraftAttackSpawnElytra/config.yml`.

### Basic Settings

#### Activation Mode

```yaml
# double_jump: Player needs to double-press space
# auto: Automatically activates when conditions are met
activation_mode: double_jump
```

#### Spawn Area Mode

```yaml
# auto: Uses the world spawn point
# advanced: Uses custom coordinates
mode: auto
```

#### World and Radius

```yaml
# The world where the feature is enabled
world: world

# Radius around spawn (only used in auto mode)
radius: 100
```

#### Height Restriction

```yaml
# Minimum Y-level for activation (-64 or below to disable)
min_activation_height: -64
```

### Advanced Spawn Configuration

When using `mode: advanced`, you can define a custom rectangular area:

```yaml
spawn:
  # First corner of the area
  x: 0
  y: 64
  z: 0
  
  # Second corner of the area
  x2: 100
  y2: 128
  z2: 100
```

If all `x2`, `y2`, `z2` are set to 0, the plugin uses radius-based area instead.

### Boost Configuration

```yaml
boost:
  # Modes: forward, upward, combined
  mode: forward
  
  # Strength for forward movement
  forward_strength: 2
  
  # Strength for upward movement
  upward_strength: 1.5
```

#### Boost Modes Explained

* **forward**: Boosts in the direction player is looking
* **upward**: Boosts straight up
* **combined**: Combines forward and upward boost

### Sound Effects

```yaml
# Sound played when boosting
# See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
boost_sound: ENTITY_BAT_TAKEOFF
```

Popular alternatives:

* `ENTITY_FIREWORK_ROCKET_BLAST`
* `ITEM_ELYTRA_FLYING`
* `ENTITY_ENDER_DRAGON_FLAP`

### Particle Effects

```yaml
particles:
  # Enable/disable particles
  enabled: false
  
  # Particle when activating elytra
  activation_particle: CLOUD
  
  # Particle when boosting
  boost_particle: FLAME
  
  # Number of particles
  count: 15
```

Available particles: [Bukkit Particle Types](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html)

### Language Settings

```yaml
# Available: en, de, es, fr, hi, zh, ar
language: en
```

### Creative Mode

```yaml
# Automatically disable in creative mode
disable_in_creative: true
```

### Messages Configuration

```yaml
messages:
  # Toggle specific messages
  show_press_to_boost: true
  show_boost_activated: true
  
  # Use custom messages instead of language files
  use_custom_messages: false
  
  # Custom message content
  press_to_boost: '&6Press &6&l{key} &6to boost yourself.'
  boost_activated: '&a&lBoost activated!'
```

### Complete Example Configuration

```yaml
# Activation settings
activation_mode: double_jump
mode: advanced

# World settings
world: world
radius: 100

# Advanced spawn area
spawn:
  x: -50
  y: 60
  z: -50
  x2: 50
  y2: 120
  z2: 50

# Height restriction
min_activation_height: 60

# Boost settings
boost:
  mode: combined
  forward_strength: 2.5
  upward_strength: 1.0

# Effects
boost_sound: ENTITY_FIREWORK_ROCKET_BLAST
particles:
  enabled: true
  activation_particle: CLOUD
  boost_particle: FIREWORK_SPARK
  count: 20

# Language and messages
language: en
disable_in_creative: true
messages:
  show_press_to_boost: true
  show_boost_activated: true
  use_custom_messages: true
  press_to_boost: '&b&lPress {key} for TURBO!'
  boost_activated: '&a&lTURBO ACTIVATED!'
```

### Configuration Tips

1. **Performance**: Larger areas and more particles can impact performance
2. **Balancing**: Adjust boost strength based on your server's needs
3. **Testing**: Use `/spawnelytra reload` to test changes without restarting
4. **Backups**: The plugin automatically backs up config during updates

### Color Codes

Messages support color codes:

![](https://1967146270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7JWTZZCFRJAB2QxkQ8hI%2Fuploads%2FzVAMTGLX0S5HVum6qiHF%2Fimage.png?alt=media\&token=4c5710df-2f5b-42a7-9f57-80a3ac5d850d)

[`Source`](https://abstractmenus.github.io/docs/general/text_colors.html)

### Troubleshooting Config Issues

* **Changes not applying**: Use `/se reload` or restart the server
* **Invalid values**: Check console for error messages
* **Missing options**: Delete config.yml to regenerate with defaults
* **Syntax errors**: Use a YAML validator online

### See Also

* [Commands](https://claude.ai/chat/commands.md) - Command reference
* [Permissions](https://claude.ai/chat/permissions.md) - Permission nodes
* [Language Support](https://claude.ai/chat/languages.md) - Localization options
