**FancyWarp | 高级 & 可定制传送插件**
FancyWarp 是一个全面的、高度可定制的 Minecraft 服务器传送插件，适用于运行 Paper 1.21.4（以及潜在的更新的 1.21.x 版本）。它通过命令和直观的 GUI 为玩家和管理员提供了一个强大的系统，用于创建、管理和传送到各种类型的传送点。
**主要特性：**
- **多种传送点类型:**
- **SERVER 传送点:** 可供所有玩家使用的标准传送点。
- **ADMIN 传送点:** 仅限工作人员使用的传送点，非常适合员工专用地点。
- **PLAYER 传送点:** 允许单个玩家设置自己的个人传送点，非常适合家园或商店。
- **直观的 GUI:** 只需输入 /warp 即可访问简洁的游戏内图形用户界面，轻松浏览并传送到传送点。
- **全面的命令:** 使用全面的命令管理您的传送点：
- /warp create : 创建一个 SERVER 传送点。
- /warp admincreate : 创建一个 ADMIN 传送点（需要权限）。
- /warp pcreate : 创建一个 PLAYER 传送点（需要权限）。
- /warp delete : 删除一个 SERVER 传送点。
- /warp admindelete : 删除所有类型的传送点（需要管理员权限）。
- /warp pdelete : 删除你自己的 PLAYER 传送点。
- /warp tp 或 /warp : 直接传送到一个传送点。
- /warp list: 查看所有可用的传送点。
- /warp fav : 管理你个人的收藏传送点。
- /warp reload: 重新加载插件的配置文件。
- 粒度权限: 使用详细的权限节点完全控制谁可以创建、删除和传送到特定类型的传送点。
- 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
...等等！(请参阅 **_plugin.yml_** 获取完整的权限列表)。
```
# **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: / [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
```
- **完全可定制的消息 & GUI:** 通过 **config.yml** 文件修改每个插件消息，包括前缀、错误和 GUI 标题。 支持颜色代码 (&) 和占位符。
```
**# FancyWarp 插件配置文件/Config.yml**
# 通用设置
settings:
# 是否启用或禁用插件。
# 如果设置为 false，插件将无法工作。
enabled: true
# 消息设置
# 使用 '&' 代表颜色代码。
# 占位符:
%warp% - 传送点的名称（用于传送点消息）
%type% - 传送点的类型 (SERVER/ADMIN/PLAYER)
%count% - 列表中项目的数量
messages:
Prefix 附加到所有插件消息的前缀。
prefix: "&8[&bFancyWarp&8]"
# 一般消息
no-permission: "&c你没有使用该命令的权限。"
player-only: "&c只有玩家才能使用此命令。"
plugin-enabled: "&aFancyWarp 插件已启用！"
plugin-reloaded: "&a FancyWarp 配置文件和传送点已重新加载！"
# 传送点创建/删除消息
warp-created: "&a传送点 &6%warp% &a(&e%type%&a) 创建成功！"
warp-exists: "&c传送点 &6%warp% &a已经存在。"
warp-deleted: "&a传送点 &6%warp% &a已删除！"
warp-not-found: "&c传送点 &6%warp% &c未找到。"
warp-invalid: "&c传送点 &6%warp% &c当前无效（世界可能不存在）。"
invalid-delete-type-server: "&c你只能使用 /warp delete 删除 SERVER 传送点。 使用 /warp admindelete 删除 ADMIN 传送点。"
invalid-delete-type-admin: "&c你只能使用 /warp admindelete 删除 ADMIN 传送点。 使用 /warp delete 删除 SERVER 传送点。"
not-your-player-warp: "&c你只能删除你自己的 PLAYER 传送点！"
# 传送到消息
teleporting: "&a传送到传送点 &6%warp%&a..."
# 传送点列表消息
no-warps-set: "&e尚未设置传送点。"
warp-list-header: "&b--- 可用的传送点 (%count%) ---"
warp-list-entry-server: "&e- &6%warp% &7[&fSERVER&7]" # SERVER 类型的传送点
warp-list-entry-admin: "&e- &6%warp% &7[&5ADMIN&7]" # ADMIN 类型的传送点
warp-list-entry-player: "&e- &6%warp% &7[&bPLAYER&7]" # PLAYER 类型的传送点
warp-list-footer: "&b------------------------"
# 收藏传送点消息
fav-added: "&a传送点 &6%warp% &a已添加到你的收藏。"
fav-already-added: "&e传送点 &6%warp% &a已经在你的收藏中。"
fav-removed: "&a传送点 &6%warp% &a已从你的收藏中移除。"
fav-not-in-list: "&e传送点 &6%warp% &a没有在你的收藏中。"
# **用法消息（用于命令帮助/语法）**
usage-create: "&e用法: /warp create <传送点名称>"
usage-admincreate: "&e用法：/warp admincreate <传送点名称>"
usage-pcreate: "&e用法: /warp pcreate <传送点名称>" # PLAYER 创建用法
usage-delete: "&e用法: /warp delete <传送点名称>"
usage-admindelete: "&e用法: /warp admindelete <传送点名称>"
usage-pdelete: "&e用法: /warp pdelete <传送点名称>" # PLAYER 删除用法
usage-teleport: "&e用法: /warp tp <传送点名称>"
usage-fav: "&e用法: /warp fav <传送点名称>"
usage-teleport-shorthand: "&e或者，只需输入 /warp <传送点名称>。"
# GUI 设置（用于库存标题，等）
gui:
main-title: "&8[&bFancy Warps&8]" # 主 GUI 标题
section-title-player-warps: "&9&lPlayer Warps" # Player Warps 区域标题
section-title-server: "&2&lServer Warps"
section-title-admin: "&5&lAdmin Warps"
section-title-favorites: "&6&lMy Favorites"
# Shops 区域标题已删除
section-back-button-name: "&e&lBack"
section-back-button-lore:
- "&7返回主菜单。"
main-close-button-name: "&c&lClose"
main-close-button-lore:
- "&7点击关闭此菜单。"
# 传送点物品显示名称和 Lore 在 GUI 中
warp-item-name-player: "&1&l%warp%" # Player 传送点物品名称
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 传送点类型 Lore
warp-item-lore-invalid: "&c位置数据无效！"
warp-item-lore-click-teleport: "&e点击传送到！"
warp-item-lore-right-click-fav: "&7右键添加到收藏。"
warp-item-lore-right-click-unfav: "&7右键从收藏中移除。"
warp-item-error: "&c错误: 传送点 &6%warp% &c无效或不再存在。"
```
- **智能 Tab 补全:** 命令易于使用，并且自动完成传送点名称和子命令，非常便于操作。
- **数据持久性:** 所有传送点位置和玩家收藏会自动保存和加载，确保您的数据在服务器重启后安全。
FancyWarp 旨在成为服务器所有传送需求的强大而用户友好的解决方案，为社区传送点和玩家拥有的位置提供灵活性。