Addict-O-Flight

Immersive 3D Flight Fast-Travel Network with Bezier Trajectories!


? What is Addict-O-Flight?
Addict-O-Flight introduces a complete, professional fast-travel transportation network to your server. Players can travel between registered flight stations by riding a giant phantom that flies smoothly through the skies following advanced 3D Bezier curve trajectories.

Administrators can build stations using interactive sign boards or link Citizens NPCs directly to destinations, offering a premium and highly interactive travel experience.

? Key Features

• Fluid 3D Flying Mechanics: Traveling uses physical velocity mechanics combined with Bezier curves, eliminating client-side rubberbanding.
  
• Interactive Sign Creation: Easily place sign boards to register flight points. Displays coordinates, name, and travel cost automatically.
  
• Proximity Restrictions: Features a strict 300-block distance limit between stations to prevent destination clutter and flight collisions.
  
• Citizens NPC Integration: Bind travel menus directly to Citizens NPCs. Players can right-click NPCs to travel! Includes dynamic distance safety checks.
  
• Economy Support (Vault): Set custom base costs for stations. Travel costs are calculated dynamically based on distance.
  
• Anti-Exploit Security: Players are immune to fall/suffocation damage in flight. Logging out returns players safely to their origin station.
  
• Sign Parsing Backward Compatibility: Supports both legacy sign headers and rebranded ones so older stations don't break.
  
• Optional ModelEngine Support (up to 1.20): Replace the default Phantom appearance with any custom 3D model from ModelEngine! Just set the model ID in config.yml — no code changes needed. Works seamlessly without ModelEngine installed. (Note: ModelEngine currently supports Spigot up to 1.20)
  
• Full Translation Support (i18n): English & French dictionaries pre-configured with automatic fallbacks.
  

Commands & Permissions

Commands:

• /flight list - Lists all registered flight stations, coordinates, and links.
  
• /flight create [name] [cost] - Creates a virtual flight station at your location.
  
• /flight delete [name] - Deletes the specified flight station.
  
• /flight connect [point_A] [point_B] - Establishes a two-way travel link.
  
• /flight disconnect [point_A] [point_B] - Removes the connection.
  
• /flight npc link [station] - Links the selected Citizens NPC to a station.
  
• /flight npc unlink - Unlinks the selected Citizens NPC.
  
• /flight reload - Reloads configurations and travel databases.
  [/LIST>
  
  Permissions:
  [LIST]
  
• addictoflight.use - Allows using the flight travel network. (Default: op, child of admin)
  
• addictoflight.admin - Access to all administration and setup commands. (Default: op)
  

?? Installation Instructions

• Make sure Vault (and optionally Citizens and/or ModelEngine) are installed on your server.
  
• Download Addict-O-Flight-1.1.jar and place it in /plugins/.
  
• Restart your server.
  
• Create stations by placing a sign with [Flight] on the first line, the station name on the second, and cost on the third.
  
• (Optional) Set flight-model: "your_model_id" in config.yml to replace the Phantom with a ModelEngine custom model.
  
• Connect stations using /flight connect [A] [B] and start flying!