FancyWarp | 高级且可自定义的传送插件
FancyWarp 是一款功能全面且高度可定制的传送插件,适用于运行 Paper 1.21.4(以及可能的更高 1.21.x 版本)的 Minecraft 服务器。它为玩家和管理员提供了一个强大的系统,通过命令和直观的图形用户界面(GUI)来创建、管理和传送到各种类型的传送点。
主要特性:
...还有更多!(请参阅 plugin.yml 以获取完整的权限列表)。
# **plugin.yml**
此文件定义了你 Paper 插件的元数据。
它向服务器告知插件的名称、版本、主类、命令和权限。
name: **FancyWarp**
version: 1.0.0
main: com.dark.Main
api-version: 1.21
authors: [YourName] # 将 YourName 替换为你的实际名称或别名
description: 一款功能强大且华丽的 Paper 1.21.4 传送插件,支持玩家传送点。
# Commands section: 定义由你的插件处理的命令。
commands:
warp:
description: 主传送命令和 GUI。
usage: /<command> [create|delete|tp|list|admincreate|admindelete|pcreate|pdelete|fav|reload]
aliases: [warps, fw, fwarp]
permission: fancywarp.command.warp
permission-message: 你没有权限使用此命令。
# **Permissions section: 定义你插件的自定义权限。**
每个权限都有描述和默认访问级别。
permissions:
fancywarp.command.warp:
description: 允许访问主 /warp 命令和 GUI。
default: true
fancywarp.command.warp.gui:
description: 允许打开传送 GUI。
default: true
# 传送点创建/删除权限**
fancywarp.command.warp.create:
description: 允许创建 SERVER 传送点。
default: op
fancywarp.command.warp.delete:
description: 允许删除 SERVER 传送点。
default: op
fancywarp.command.warp.admincreate:
description: 允许创建 ADMIN 传送点。
default: op
fancywarp.command.warp.admindelete:
description: 允许删除 ADMIN 传送点(作为管理员也可删除任何玩家/服务器传送点)。
default: op
fancywarp.command.warp.pcreate: # 玩家传送点创建
description: 允许创建 PLAYER 传送点。
default: true
fancywarp.command.warp.pdelete: # 玩家传送点删除(仅限自己的传送点)
description: 允许删除自己的 PLAYER 传送点。
default: true
# 传送权限(更细粒度)
fancywarp.warp.teleport.server:
description: 允许传送到 SERVER 类型传送点。
default: true
fancywarp.warp.teleport.admin:
description: 允许传送到 ADMIN 类型传送点。
default: op # 通常只有 OP 或特定等级才能使用管理员传送点
fancywarp.warp.teleport.player: # 玩家传送点传送权限
description: 允许传送到 PLAYER 类型传送点。
default: true # 通常对所有玩家为真,以便访问其他玩家的商店/家园
fancywarp.command.warp.list:
description: 允许通过命令列出传送点。
default: true
fancywarp.command.warp.fav:
description: 允许添加/移除收藏传送点。
default: true
fancywarp.command.warp.reload:
description: 允许重新加载插件配置。
default: op
- 完全可定制的消息与 GUI: 通过 config.yml 文件修改每条插件消息,包括前缀、错误信息和 GUI 标题。支持颜色代码 (&) 和占位符。
**# FancyWarp 插件配置/Config.yml**
# 常规设置
settings:
# 是否启用或禁用该插件。
# 如果设置为 false,插件将不起作用。
enabled: true
# 消息设置
# 使用 '&' 表示颜色代码。
# 占位符:
%warp% - 传送点的名称(用于传送点消息)
%type% - 传送点的类型 (SERVER/ADMIN/PLAYER)
%count% - 列表中项目的数量
messages:
Prefix prepended to all plugin messages.
prefix: "&8[&bFancyWarp&8] "
# 常规消息
no-permission: "&c你没有权限使用该命令。"
player-only: "&c只有玩家才能使用此命令。"
plugin-enabled: "&aFancyWarp 插件已启用!"
plugin-reloaded: "&aFancyWarp 配置和传送点已重新加载!"
# 传送点创建/删除消息
warp-created: "&a传送点 &6%warp% &a(&e%type%&a) 创建成功!"
warp-exists: "&c传送点 &6%warp% &c已存在。"
warp-deleted: "&a传送点 &6%warp% &a删除成功!"
warp-not-found: "&c未找到传送点 &6%warp%。"
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% &e已在您的收藏夹中。"
fav-removed: "&a已从您的收藏夹中移除传送点 &6%warp%。"
fav-not-in-list: "&e传送点 &6%warp% &e不在您的收藏夹中。"
# **使用消息(用于命令帮助/语法)**
usage-create: "&e用法:/warp create <传送点名称>"
usage-admincreate: "&e用法:/warp admincreate <传送点名称>"
usage-pcreate: "&e用法:/warp pcreate <传送点名称>" # 玩家创建用法
usage-delete: "&e用法:/warp delete <传送点名称>"
usage-admindelete: "&e用法:/warp admindelete <传送点名称>"
usage-pdelete: "&e用法:/warp pdelete <传送点名称>" # 玩家删除用法
usage-teleport: "&e用法:/warp tp <传送点名称>"
usage-fav: "&e用法:/warp fav <add|remove> <传送点名称>"
usage-teleport-shorthand: "&e或者,直接输入 /warp <传送点名称>。"
# GUI 设置(用于物品栏标题等)
gui:
main-title: "&8[&bFancy Warps&8]" # 主 GUI 标题
section-title-player-warps: "&9&l玩家传送点" # 玩家传送点区域标题
section-title-server: "&2&l服务器传送点"
section-title-admin: "&5&l管理员传送点"
section-title-favorites: "&6&l我的收藏"
# 商店区域标题已移除
section-back-button-name: "&e&l返回"
section-back-button-lore:
- "&7返回主菜单。"
main-close-button-name: "&c&l关闭"
main-close-button-lore:
- "&7点击关闭此菜单。"
# 在 GUI 中扭曲物品的显示名称和描述
warp-item-name-player: "&1&l%warp%" # 玩家传送点物品名称
warp-item-name-server: "&b&l%warp%"
warp-item-name-admin: "&d&l%warp%"
warp-item-name-favorite: "&e&l%warp% &6(★ 收藏)"
warp-item-lore-world: "&7世界: &f%world%"
warp-item-lore-coords: "&7坐标: &f%x%, %y%, %z%"
warp-item-lore-type-server: "&7类型: &b服务器"
warp-item-lore-type-admin: "&7类型: &d管理员"
warp-item-lore-type-player: "&7类型: &b玩家" # 玩家传送点类型描述
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无效或已不存在。"
FancyWarp 旨在成为满足您服务器所有传送需求的强大且用户友好的解决方案,为社区传送点和玩家拥有的位置提供灵活性。
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.
-
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧