sWarps
By SayamDev (SpaceXStudio)

Transform your server's travel with sWarps!
Forget mundane warp commands. sWarps re-imagines warps as collectible Dimensional Shards, accessed through an intuitive and immersive GUI system. Players don't just teleport; they harness the power of interdimensional fragments!

--- Core Features ---

• Dimensional Shard System: Warps are tangible items (Amethyst, Echo Shards, etc.) that players discover or are granted.
  
  
• Immersive Player GUI - "Shard Repository" (/swarps, /warp, /warps):
  
  • Visually appealing GUI showcasing available shards.
    
    
  • Each shard displays its name, stability, visit count (echoes), and description.
    
    
  • Configurable icons and glow effects for popular or special warps.
    
    
  • Teleport with a click!
    
• Personal Player Shards:
  
  • Players can set their own limited number of personal warps.
    
    
  • Manage personal shards directly through their Shard Repository.
    
    
  • Configurable limit and default icons for personal shards.
    
• Admin GUI - "Rift Management Console" (/swarpadmin):
  
  • Comprehensive management interface for server warps.
    
    
  • Attune new shards (create warps) at your location.
    
    
  • Calibrate (edit name, description), Destabilize (delete), and Set Icon for any shard.
    
    
  • Toggle public access or set specific permission nodes for admin warps.
    
    
  • View usage statistics (echoes).
    
• Highly Configurable:
  
  • Customize GUI titles, item materials, names, and lore.
    
    
  • Set teleport delays, sounds, and cancel-on-move behavior.
    
    
  • Extensive message customization with placeholders.
    
    
  • Control personal warp limits and default icons.
    
    
  • Debug mode for detailed logging.
    
• Permission-Based: Fine-grained control over who can use, manage, and set warps.
  
  
• Data Persistence: Warps are securely saved in warps.yml.
  

--- Gameplay Focus ---
sWarps aims to make warping more than just a utility. It adds a layer of collection and lore to your server:

• Exploration & Discovery: Admins can create warps that feel like finding a rare dimensional artifact.
  
  
• Personalization: Players can establish their own stable rifts to their bases and favorite spots.
  
  
• Server Hubs & Points of Interest: Clearly present important server locations through visually distinct shards.
  

--- Commands & Permissions ---
Commands:

• /swarps, /warp, /warps - Opens the player's Shard Repository. (Permission: swarps.use)
  
  
• /swarpadmin - Opens the admin's Rift Management Console. (Permission: swarps.admin)
  

Key Permissions:

• swarps.use - Allows opening and using the player GUI. (Default: true)
  
  
• swarps.admin - Full admin access to manage all warps. (Default: op)
  
  
• swarps.setpersonal - Allows setting personal warps. (Default: true)
  
  
• swarps.deletepersonal - Allows deleting own personal warps. (Default: true)
  
  
• swarps.admin.coords - View coordinates in player GUI lore. (Default: op)
  
  
• swarps.warp.<warp_name_permission_node> - Access to specific permission-locked admin warps.
  (See plugin's plugin.yml or documentation for a full list)
  

--- Configuration ---
sWarps features a detailed config.yml allowing you to tailor almost every aspect of the plugin, from GUI appearance and item settings to teleport behavior and all plugin messages. The warps.yml stores all warp data.

--- Installation ---

1. Download the latest sWarps.jar.
   
   
2. Place it in your server's plugins folder.
   
   
3. Restart or reload your server.
   
   
4. Configure plugins/sWarps/config.yml to your liking!
   

--- Support & Suggestions ---
Found a bug or have a cool idea? Let me know!

Planned Features / Ideas (Maybe!):

• GUI Pagination for many warps.
  
  
• Warp discovery mechanics.
  
  
• Warp stability effects (temporary warps, recharge).
  
  
• More direct GUI editing tools (Anvil GUIs for input).
  
  
• Cost for teleporting or setting warps.
  
  Author --> Sayamdev , Spacexstudio
  Discord --> https://discord.gg/x3pHYtQ9kJ