Spawn Elytra

Changelog

Added

Setup & Configuration

• Setup Wizard - New command /spawnelytra setup

  • Interactive setup process for defining spawn areas
  • Set position 1 and position 2 for rectangular areas
  • Choose activation mode: double_jump, auto, sneak_jump, or f_key
  • Save or cancel with immediate config update
  • Exit anytime with /spawnelytra setup exit

• Settings Menu - /spawnelytra settings

  • Change language and message style in-game
  • /spawnelytra set language <en|de|es|fr> - Set language
  • /spawnelytra set style <classic|small_caps> - Set message style

• Area Visualization - /spawnelytra visualize [seconds]

  • Optional duration argument to specify how long to show particles (default: 30 seconds)
  • Configurable vertical range for particle display
  • Additional vertical range for corner/cardinal pillars
  • Particle update frequency control (ticks between updates)
  • Particle size multiplier for better visibility from distance
  • Enhanced particles option for brighter colors and additional effects

• First Install Welcome

  • Automatic welcome message on first installation
  • Interactive prompts to select language and message style
  • Option to start quick setup wizard immediately
  • Dismissible with /spawnelytra dismiss command
  • I tried to make this as non-invasive as possible. I'd appreciate feedback.

Per-World Configuration

• World-Specific Settings under worlds.<world>
  • Configure different settings for each world
  • Enable/disable elytra per world
  • Different activation modes per world
  • World-specific spawn areas and boost settings

Spawn Area Options

• Flexible Area Definition
  • spawn_area.mode: Choose between auto (uses world spawn) or advanced (custom coordinates)
  • spawn_area.area_type: Define areas as circular or rectangular
  • Circular areas: Use center point (x, y, z) with radius
  • Rectangular areas: Use two corner points (x, y, z) and (x2, y2, z2)

Hunger Consumption System (Off by default)

• Optional Hunger Cost - hunger_consumption.enabled
  • Multiple consumption modes: activation, distance, or time
  • Activation mode: Consume hunger each time elytra activates
  • Distance mode: Consume hunger based on blocks traveled
  • Time mode: Consume hunger based on flight duration
  • Configurable minimum food level protection
  • Adjustable hunger cost for each mode

Message & Display Options

• Message Style Settings - messages.style

  • classic: Normal message formatting
  • small_caps: Small caps text style

• Message Toggles

  • messages.show_press_to_boost: Toggle boost activation messages
  • messages.show_boost_activated: Toggle boost confirmation messages
  • messages.show_creative_disabled: Show actionbar when elytra is disabled in creative mode

Game Mode Restrictions

• Adventure Mode Control - game_modes.disable_in_adventure
  • Option to disable elytra in adventure mode (in addition to existing creative mode toggle)
  • Prevents elytra activation in adventure mode when enabled

Multi-Language Support

• Four Languages Included
  • English (en)
  • German (de)
  • Spanish (es)
  • French (fr)

Migration

Automatic Data Migration

• Plugin automatically migrates settings from the now legacy folder CraftAttackSpawnElytra
• Migration is triggered when the old plugin folder is detected on startup
• Existing configuration data is migrated and backed up to plugins/SpawnElytra/backups/<timestamp>
• Language files are not migrated due to completely different formatting (MiniMessage vs legacy)
  • Old language files are preserved in the backup folder if needed

Important Note
This plugin checks for the CraftAttackSpawnElytra directory on startup. If files are found, they are moved to SpawnElytra and backed up. To prevent this behavior, add prevent-spawnelytra-from-migrating: true to config.yml before starting the server.

Changed

• Plugin Name: CraftAttackSpawnElytra → SpawnElytra
• Maven Artifact: craftattackspawnelytra → spawnelytra
• Package Structure: Reorganized into logical subpackages
  • command - Command handling
  • config - Configuration management and updates
  • data - Player data management
  • integration - Third-party integrations (PlaceholderAPI)
  • listener - Event listeners (core elytra mechanics)
  • setup - Setup wizard and session management
  • util - Utility classes (messaging, scheduling, backups, updates)

Default Settings

• Default Language: Changed from German (de) to English (en)
  • Users can still select German or other languages via config or settings command or the first install message

Dependencies & Build

• Maven Shade Plugin: Updated from 3.5.3 to 3.6.0
• Adventure API: Added complete MiniMessage support
  • adventure-api: 4.17.0
  • adventure-text-minimessage: 4.17.0
  • adventure-text-serializer-plain: 4.17.0
  • adventure-platform-bukkit: 4.3.4
• Gson: Added for Modrinth JSON handling and update checking
• Improved Relocations: Better dependency shading for bStats and Adventure libraries

Configuration Format

• Restructured Config Layout
  • Clearer organization with global settings and world-specific sections
  • More detailed comments explaining each option
  • Grouped related settings (game_modes, fireworks, messages, visualization, hunger_consumption)
  • Spawn area settings nested under spawn_area with mode and area_type options

Fixed / Improved

Cleanup & Stability

• Better Cleanup on Disable: Properly cancels visualization tasks and clears player data when plugin is disabled
• Better Logout Handling: Removes player-specific data and tasks when players disconnect
• Visualization Task Management: Prevents memory leaks from lingering particle tasks

Messaging System

• MiniMessage Format: All messages now use MiniMessage for text formatting
  • Support for colors, gradients, hover text, and click actions
  • Legacy color codes are no longer used

Changelog

Added

• Sneak + Jump Mode: Hold sneak while (double) jumping to activate elytra flight

• F-Key Mode: Press F (swap hands) to activate elytra with an upward launch boost

• Firework disabler: Disable the use of fireworks while in spawn elytra without having an real elytra eqquiped (This isn't enabled by default!) - suggestion by MYNTAX on github, if you also have an suggestion, please feel free to create an suggestion "issue" on github!

# Disable fireworks when using spawn elytra (players can still use fireworks if they have a real elytra equipped)
disable_fireworks_in_spawn_elytra: false

Changed

• Fixed Rectangular Area Config: Define custom spawn areas using two coordinate points
• New: Area Visualization: New /spawnelytra visualize command to see your configured area with particles (client side, green particles for the border, end rod particles for the center)
• 1.20-1.20.6 support
• 1.21.6 support
• Boost Direction Control: Choose between forward momentum (default) or upward boost
• Performance Optimizations: More efficient area checking and event handling
• I also reduced the frequency in update checks from every hour to every six hours, as it gets annoying very fast.

Note: The config has been restructured. They should be automatically migrated.

That's all for today!

# Spawn Elytra Plugin by Blaxk_
# Plugin Version: 1.2
# Modrinth: /plugins/spawn-elytra

# Activation mode for elytra:
# double_jump: Player needs to double-press space to activate elytra
# auto: Automatically activates elytra when player has air below and is in spawn area
activation_mode: double_jump

# Mode options: 'auto' or 'advanced'
# auto: Uses the world spawn point
# advanced: Uses custom spawn coordinates defined below
mode: auto

# The radius around spawn where elytra boosting is enabled
# (only used in auto mode or if x2, y2, z2 are all set to 0)
radius: 100

# The strength of the boost when pressing the boost key
strength: 2

# The world where the spawn elytra feature is enabled
world: world

# Custom spawn coordinates and dimensions (used when mode is 'advanced')
spawn:
  # First point of the elytra area
  x: 0
  y: 64
  z: 0

  # Second point of the elytra area
  # Setting all x2/y2/z2 to 0 will use the radius-based circular area instead
  # Example: Using x=0, y=64, z=0 and x2=100, y2=128, z2=100 creates a rectangular area
  # between those two coordinate points
  x2: 0  # Second X coordinate
  y2: 0  # Second Y coordinate
  z2: 0  # Second Z coordinate

# Boost sound effect - can be any sound from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
# Examples: ENTITY_BAT_TAKEOFF, ENTITY_FIREWORK_ROCKET_BLAST, ITEM_ELYTRA_FLYING
boost_sound: ENTITY_BAT_TAKEOFF

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

# Automatically disable elytra when player enters creative mode (This prevents buggy flying in Creative)
disable_in_creative: true

# Message settings
messages:
  # Set to false to disable the "press to boost" message
  show_press_to_boost: true
  # Set to false to disable the "boost activated" message
  show_boost_activated: true
  # Set to true to use custom messages below instead of language file messages
  use_custom_messages: false

  # Custom messages
  # {key} is used represent the offhand key (F by default)
  # Due to limitations from minecraft, you cant enter any key you want.
  # Legacy color codes (&a, &e, etc.) are supported
  press_to_boost: '&6Press &6&l{key} &6to boost yourself.'
  boost_activated: '&a&lBoost activated!'

# Plugin from Blaxk_
radius: 50
strength: 2
world: world
# Defines the language of the plugin. You can change it to 'de' for german, or 'en' for english.
language: de