✨ Features
- Time-Based Flight: Players can fly for a limited duration
- Double-Jump Activation: Players can double-jump to start/stop flying
- Beautiful Particle Trails: Customize your flight with various particle effects
- Sound System: Immersive sound effects that change based on altitude
- Performance Optimized: Built for high-performance with minimal server impact
- WorldGuard Integration: Control flight in specific regions
- PlaceholderAPI Support: Use flight data in other plugins
- Intuitive Commands: Easy to use for both players and admins
- Developer API: Extend functionality with your own plugins
Installation
- Download the latest version of NusaTempFly
- Place the JAR file in your plugins folder
- Restart your server
- Edit the configuration file to your liking
- Reload the plugin with /tempfly reload
Commands
Player Commands
- /tempfly or /fly - Check remaining flight time
- /tempfly on - Enable flight
- /tempfly off - Disable flight
- /trail - View current flight trail
- /trail list - List available trails
- /trail set <trail> - Set your flight trail
Admin Commands
- /tempfly check <player> - Check another player's flight time
- /tempfly add <player> <time> - Add flight time to a player
- /tempfly set <player> <time> - Set a player's flight time
- /tempfly reload - Reload the plugin configuration
- /tempfly reset <player> - Reset a player's flight data
Permissions
Basic Permissions
- nusatempfly.use - Allows use of temporary flight
- nusatempfly.trail - Allows changing flight trails
- nusatempfly.bypass.combat - Bypass combat restrictions
- nusatempfly.bypass.damage - Bypass damage restrictions
Admin Permissions
- nusatempfly.admin - Access to all admin commands
- nusatempfly.check - Check other players' flight time
- nusatempfly.add - Add flight time to players
- nusatempfly.set - Set players' flight time
- nusatempfly.reload - Reload the plugin
- nusatempfly.reset - Reset players' flight data
Trail Permissions
- nusatempfly.trail.<trailname> - Access to specific trails
- Example: nusatempfly.trail.flame
⚙️ Configuration
NusaTempFly offers extensive configuration options:
Code (Text):
# Default flight duration in seconds (5 minutes)
default-duration: 300
# Whether to save flight data when players log out
save-on-logout: true
# Whether to show notifications to players
enable-notifications: true
# Action bar notifications
action-bar:
enabled: true
update-interval: 20 # Ticks between updates (20 = 1 second)
only-when-flying: true
# Whether to disable flight when a player takes damage
disable-on-damage: true
# Whether to allow flight during combat
allow-flight-in-combat: false
# WorldGuard integration
worldguard:
allow-flight-by-default: true
# Flight trails
trails:
enabled: true
default: none
render-distance: 32
per-player-visibility: true
# Sound effects
sounds:
enabled: true
events:
takeoff:
enabled: true
sound: ENTITY_BLAZE_SHOOT
volume: 0.5
pitch: 1.0
# Performance settings
performance:
player-batch-size: 5
player-batch-interval: 2
auto-save-interval: 300
PlaceholderAPI Integration
NusaTempFly provides several placeholders:
- %nusatempfly_time% - Formatted remaining flight time
- %nusatempfly_time_seconds% - Remaining flight time in seconds
- %nusatempfly_status% - Current flight status (Flying/Paused/Disabled)
- %nusatempfly_has_time% - Whether player has flight time (Yes/No)
- %nusatempfly_can_fly% - Whether player can fly (Yes/No)
- %nusatempfly_region% - Current WorldGuard region name
️ WorldGuard Integration
NusaTempFly adds three custom WorldGuard flags:
- allow-tempfly - Allows flight in the region
- no-tempfly - Disallows flight in the region
- no-tempfly-timer - Stops flight time from decreasing in the region
Example usage:
Code (Text):
/rg flag <region> allow-tempfly true
/rg flag <region> no-tempfly true
/rg flag <region> no-tempfly-timer true
✨ Flight Trails
Available trails (customizable in config):
- None (default)
- Flame
- Heart
- Smoke
- Magic
- Water
Each trail has configurable settings like particle count, spread, and speed.