FancyWarp | Advanced & Customizable Warp Plugin

FancyWarp is a comprehensive and highly customizable warp plugin for Minecraft servers running Paper 1.21.4 (and potentially newer 1.21.x versions). It empowers players and administrators with a robust system for creating, managing, and teleporting to various types of warps through both commands and an intuitive GUI.

Key Features:

- Multiple Warp Types:

- SERVER Warps: Standard warps accessible to all players.

- ADMIN Warps: Restricted warps, ideal for staff-only locations.

- PLAYER Warps: Allows individual players to set their own personal warps, perfect for homes or shops.

- Intuitive GUI: Access a sleek in-game graphical user interface by simply typing /warp to browse and teleport to warps with ease.

- Comprehensive Commands: Manage your warps with a full suite of commands:

- /warp create <name>: Create a SERVER warp.

- /warp admincreate <name>: Create an ADMIN warp (permission required).

- /warp pcreate <name>: Create a PLAYER warp (permission required).

- /warp delete <name>: Delete a SERVER warp.

- /warp admindelete <name>: Delete any warp type (admin permission required).

- /warp pdelete <name>: Delete your own PLAYER warp.

- /warp tp <name> or /warp <name>: Teleport directly to a warp.

- /warp list: View all available warps.

- /warp fav <add|remove> <name>: Manage your personal favorite warps.

- /warp reload: Reload the plugin's configuration.

- Granular Permissions: Take full control over who can create, delete, and teleport to specific warp types using detailed permission nodes.

- fancywarp.command.warp.create

- fancywarp.command.warp.admincreate

- fancywarp.command.warp.pcreate

- fancywarp.command.warp.delete

- fancywarp.command.warp.admindelete

- fancywarp.command.warp.pdelete

- fancywarp.warp.teleport.server

- fancywarp.warp.teleport.admin

- fancywarp.warp.teleport.player

...and more! (See plugin.yml for a full Permission list).


```
# plugin.yml
This file defines the metadata for your Paper plugin.
It tells the server about your plugin's name, version, main class, commands, and permissions.

name: **FancyWarp**
version: 1.0.0
main: com.dark.Main
api-version: 1.21
authors: [YourName] # Replace YourName with your actual name or alias
description: A powerful and fancy warp plugin for Paper 1.21.4 with player warps.

# Commands section: Defines the commands handled by your plugin.
commands:
warp:
description: Main warp command and GUI.
usage: /<command> [create|delete|tp|list|admincreate|admindelete|pcreate|pdelete|fav|reload]
aliases: [warps, fw, fwarp]
permission: fancywarp.command.warp
permission-message: You do not have permission to use this command.

# Permissions section: Defines custom permissions for your plugin.
Each permission has a description and default access level.
permissions:
fancywarp.command.warp:
description: Allows access to the main /warp command and GUI.
default: true
fancywarp.command.warp.gui:
description: Allows opening the warp GUI.
default: true

# Warp Creation/Deletion Permissions
fancywarp.command.warp.create:
description: Allows creating SERVER warps.
default: op
fancywarp.command.warp.delete:
description: Allows deleting SERVER warps.
default: op
fancywarp.command.warp.admincreate:
description: Allows creating ADMIN warps.
default: op
fancywarp.command.warp.admindelete:
description: Allows deleting ADMIN warps (and any player/server warp as admin).
default: op
fancywarp.command.warp.pcreate: # Player warp creation
description: Allows creating PLAYER warps.
default: true
fancywarp.command.warp.pdelete: # Player warp deletion (own warps only)
description: Allows deleting own PLAYER warps.
default: true

# Teleportation Permissions (More granular)
fancywarp.warp.teleport.server:
description: Allows teleporting to SERVER type warps.
default: true
fancywarp.warp.teleport.admin:
description: Allows teleporting to ADMIN type warps.
default: op # Usually only OPs or specific ranks can use admin warps
fancywarp.warp.teleport.player: # Player warp teleport permission
description: Allows teleporting to PLAYER type warps.
default: true # Usually true for all players to visit others' shops/homes

fancywarp.command.warp.list:
description: Allows listing warps via command.
default: true
fancywarp.command.warp.fav:
description: Allows adding/removing warps from favorites.
default: true
fancywarp.command.warp.reload:
description: Allows reloading the plugin configuration.
default: op

```



- Fully Customizable Messages & GUI: Modify every plugin message, including prefixes, errors, and GUI titles, via the config.yml file. Support for color codes (&) and placeholders is included.


```
# FancyWarp Plugin Configuration/Config.yml

# General Settings
settings:
# Whether to enable or disable the plugin.
# If set to false, the plugin will not function.
enabled: true

# Message Settings
# Use '&' for color codes.
# Placeholders:
%warp% - The name of the warp (for warp messages)
%type% - The type of the warp (SERVER/ADMIN/PLAYER)
%count% - The number of items in a list
messages:
Prefix prepended to all plugin messages.
prefix: "&8[&bFancyWarp&8] "

# General messages
no-permission: "&cYou do not have permission to use that command."
player-only: "&cOnly players can use this command."
plugin-enabled: "&aFancyWarp plugin has been enabled!"
plugin-reloaded: "&aFancyWarp configuration and warps reloaded!"

# Warp Creation/Deletion Messages
warp-created: "&aWarp &6%warp% &a(&e%type%&a) created successfully!"
warp-exists: "&cWarp &6%warp% &calready exists."
warp-deleted: "&aWarp &6%warp% &adeleted successfully!"
warp-not-found: "&cWarp &6%warp% &cnot found."
warp-invalid: "&cWarp &6%warp% &cis currently invalid (world may not exist)."
invalid-delete-type-server: "&cYou can only delete SERVER warps with /warp delete. Use /warp admindelete for ADMIN warps."
invalid-delete-type-admin: "&cYou can only delete ADMIN warps with /warp admindelete. Use /warp delete for SERVER warps."
not-your-player-warp: "&cYou can only delete your own player warps!"

# Teleportation Messages
teleporting: "&aTeleporting to warp &6%warp%&a..."

# Warp List Messages
no-warps-set: "&eThere are no warps set yet."
warp-list-header: "&b--- Available Warps (%count%) ---"
warp-list-entry-server: "&e- &6%warp% &7[&fSERVER&7]" # For SERVER type warps
warp-list-entry-admin: "&e- &6%warp% &7[&5ADMIN&7]" # For ADMIN type warps
warp-list-entry-player: "&e- &6%warp% &7[&bPLAYER&7]" # For PLAYER type warps
warp-list-footer: "&b------------------------"

# Favorite Warps Messages
fav-added: "&aWarp &6%warp% &aadded to your favorites."
fav-already-added: "&eWarp &6%warp% &eis already in your favorites."
fav-removed: "&aWarp &6%warp% &aremoved from your favorites."
fav-not-in-list: "&eWarp &6%warp% &eis not in your favorites."

# **Usage Messages (for command help/syntax)**
usage-create: "&eUsage: /warp create <warpname>"
usage-admincreate: "&eUsage: /warp admincreate <warpname>"
usage-pcreate: "&eUsage: /warp pcreate <warpname>" # Player create usage
usage-delete: "&eUsage: /warp delete <warpname>"
usage-admindelete: "&eUsage: /warp admindelete <warpname>"
usage-pdelete: "&eUsage: /warp pdelete <warpname>" # Player delete usage
usage-teleport: "&eUsage: /warp tp <warpname>"
usage-fav: "&eUsage: /warp fav <add|remove> <warpname>"
usage-teleport-shorthand: "&eAlternatively, just type /warp <warpname>."


# GUI Settings (for inventory titles, etc.)
gui:
main-title: "&8[&bFancy Warps&8]" # Main GUI title
section-title-player-warps: "&9&lPlayer Warps" # Player Warps section title
section-title-server: "&2&lServer Warps"
section-title-admin: "&5&lAdmin Warps"
section-title-favorites: "&6&lMy Favorites"
# Shops section title removed

section-back-button-name: "&e&lBack"
section-back-button-lore:
- "&7Return to main menu."
main-close-button-name: "&c&lClose"
main-close-button-lore:
- "&7Click to close this menu."

# Warp item display names and lore in GUI
warp-item-name-player: "&1&l%warp%" # Player warp item name
warp-item-name-server: "&b&l%warp%"
warp-item-name-admin: "&d&l%warp%"
warp-item-name-favorite: "&e&l%warp% &6(★ Favorite)"
warp-item-lore-world: "&7World: &f%world%"
warp-item-lore-coords: "&7Coords: &f%x%, %y%, %z%"
warp-item-lore-type-server: "&7Type: &bSERVER"
warp-item-lore-type-admin: "&7Type: &dADMIN"
warp-item-lore-type-player: "&7Type: &bPLAYER" # Player warp type lore
warp-item-lore-invalid: "&cInvalid Location Data!"
warp-item-lore-click-teleport: "&eClick to Teleport!"
warp-item-lore-right-click-fav: "&7Right-click to add to favorites."
warp-item-lore-right-click-unfav: "&7Right-click to remove from favorites."
warp-item-error: "&cError: Warp &6%warp% &cis invalid or no longer exists."


```



- Intelligent Tab Completion: Commands are easy to use with helpful tab completions for warp names and subcommands.

- All warp locations and player favorites are automatically saved and loaded, ensuring your data is safe across server restarts.

FancyWarp aims to be a powerful yet user-friendly solution for all your server's warping needs, providing flexibility for both community warps and player-owned locations.