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 " usage-admincreate: "&eUsage: /warp admincreate " usage-pcreate: "&eUsage: /warp pcreate " # Player create usage usage-delete: "&eUsage: /warp delete " usage-admindelete: "&eUsage: /warp admindelete " usage-pdelete: "&eUsage: /warp pdelete " # Player delete usage usage-teleport: "&eUsage: /warp tp " usage-fav: "&eUsage: /warp fav <add|remove> " usage-teleport-shorthand: "&eAlternatively, just type /warp ."

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.