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 : Create a SERVER warp.
- /warp admincreate : Create an ADMIN warp (permission required).
- /warp pcreate : Create a PLAYER warp (permission required).
- /warp delete : Delete a SERVER warp.
- /warp admindelete : Delete any warp type (admin permission required).
- /warp pdelete : Delete your own PLAYER warp.
- /warp tp or /warp : Teleport directly to a warp.
- /warp list: View all available warps.
- /warp fav <add|remove> : 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.
Data Persistence: 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.

FancyWarp

📖About FancyWarp