GWarp - Warp / Home Plugin - GWarp - 传送与家园插件

GWarp 是一款功能全面的传送点（Warp）与个人家（Home）管理插件，拥有大量可自定义的设置与功能，所有内容均可通过插件配置和语言文件进行调整。目前支持从 Minecraft 1.7 到 1.21 的版本。

💡核心特性

• 100% 可定制：通过配置文件深度自定义所有消息、权限和功能。
• 卓越性能：优化良好，对服务器负担小。
• 安全传送（Safe-Warp）：可选的传送安全检查功能，防止玩家传送到危险位置（如陷阱、岩浆中）。
• 丰富的设置选项：包括传送冷却、粒子效果、传送音效、传送点密码、命令补全等。
• 传送点排行榜（Warp-Top）：根据访问次数显示最受欢迎的传送点。
• 传送点列表：分页查看所有可用传送点。
• 访问计数器：记录每个传送点的访问人数。
• 欢迎消息：可为每个传送点设置自定义的传送欢迎语。
• 无限设置：可设置无限数量的公共传送点（Warp）和私人家庭（Home）。

安全传送（Safe-Warp）说明

此功能可在配置文件中启用或禁用。启用后，插件会在玩家传送前检查目标点是否安全。

• 安全条件：传送点所在位置下方一格必须是固体方块，且前后左右上下六个方向至少各有一格是空气（非实体方块）。
• 作用：有效防止玩家被传送到陷阱、岩浆或虚空等致命位置。

🎮命令列表

主要命令 (/gwarp 或 /warp)

• /gwarp <传送点名> - 传送到指定公共传送点。
• /gwarp help - 显示帮助信息。
• /gwarp top - 显示传送点访问排行榜。
• /gwarp list <页码> - 分页列出所有传送点。
• /gwarp set <传送点名> - 设置一个公共传送点。
• /gwarp delete <传送点名> - 删除一个公共传送点。
• /gwarp update <传送点名> - 更新当前位置到一个已存在的传送点。
• /gwarp welcome <传送点名> <文本>/clear - 设置或清除该传送点的欢迎消息。
• /gwarp warps [<玩家名>] - 查看自己（或指定玩家）拥有的传送点。
• /gwarp lock <传送点名> - 锁定或解锁一个传送点（仅所有者和管理员可用）。
• /gwarp owner <传送点名> - 查看一个传送点的所有者。
• /gwarp password <传送点名> [<密码>/clear] - 为传送点设置或清除密码。
• /gwarp effect [<传送点名>] [<效果名>/clear] - 设置或清除传送时的粒子效果。
• /gwarp sound [<传送点名>] [<音效名>/clear] - 设置或清除传送时的音效。

管理员命令 (/agwarp 或 /awarp)

• /agwarp help - 显示管理员帮助。
• /agwarp version - 检查插件版本。
• /agwarp warp <玩家名> <传送点名> - 将指定玩家传送到某个传送点。
• /agwarp set <传送点名> <玩家名> - 以管理员身份为玩家设置一个传送点。
• /agwarp delete <传送点名> - 强制删除一个传送点。
• /agwarp welcome <传送点名> <文本>/clear - 管理传送点欢迎消息。
• /agwarp lock <传送点名> - 管理传送点锁定状态。
• /agwarp setowner <传送点名> <玩家名> - 更改传送点的所有者。
• /agwarp reset <传送点名>/all - 重置单个或所有传送点的访问计数。
• /agwarp password <传送点名> [<密码>/clear] - 管理传送点密码。
• /agwarp effect [<传送点名>] [<效果名>/clear] - 管理传送点粒子效果。
• /agwarp sound [<传送点名>] [<音效名>/clear] - 管理传送点音效。
• /agwarp count <传送点名> - 查看传送点的访问次数。

家庭命令 (/ghome 或 /home)

• /ghome <家名称> - 传送到指定的个人家。
• /ghome set <家名称> - 在当前位置设置一个个人家。
• /ghome delete <家名称> - 删除一个个人家。
• /ghome update <家名称> - 更新一个已存在的家的位置。
• /ghome homes - 列出你所有的家（默认命令）。
• /ghome back - 传送回上一个位置。

快捷命令

• /setgwarp <传送点名> 或 /setwarp - 快速设置传送点。
• /deletegwarp <传送点名> 或 /deletewarp 或 /delwarp - 快速删除传送点。
• /updategwarp <传送点名> 或 /updatewarp - 快速更新传送点。

重载命令

• /gwarpreload 或 /gwrl - 重载插件的配置和语言文件。

⭐权限节点

全局权限

• GWarp.* - 拥有所有权限（OP默认）。
• GWarp.Update - 接收版本更新通知。

传送点（Warp）权限

• GWarp.Warp.* - 所有传送点相关权限。
• GWarp.WarpAmount.* - 可设置无限个传送点。
• GWarp.WarpAmount.<数量> - 设置可拥有的传送点数量上限，例如 GWarp.WarpAmount.5。
• GWarp.Warp - 使用 /gwarp 传送的基本权限。
• GWarp.WarpTimeIgnore - 无视传送冷却时间。
• GWarp.WarpTop - 使用 /gwarp top 命令。
• GWarp.WarpList - 使用 /gwarp list 命令。
• GWarp.WarpSet - 设置传送点。
• GWarp.WarpDelete - 删除自己设置的传送点。
• GWarp.WarpUpdate - 更新自己设置的传送点。
• GWarp.WarpWelcome - 设置传送点欢迎消息。
• GWarp.WarpWarps - 查看自己拥有的传送点列表。
• GWarp.WarpWarpsOther - 查看其他玩家拥有的传送点列表。
• GWarp.WarpLock - 锁定自己的传送点。
• GWarp.WarpLockIgnore - 无视传送点锁定状态进行传送。
• GWarp.WarpOwner - 查看传送点所有者。
• GWarp.WarpPassword - 为传送点设置密码。
• GWarp.WarpEffect - 设置传送点粒子效果。
• GWarp.WarpSound - 设置传送点音效。
• GWarp.WarpPasswordIgnore - 无视传送点密码进行传送。
• GWarp.WarpSaveIgnore - 无视安全传送（Safe-Warp）检查。

管理员传送点（AWarp）权限

• GWarp.AWarp.* - 所有管理员传送点权限。
• GWarp.AWarp - 使用 /agwarp 命令的基本权限。
• GWarp.AWarpWarp - 使用 /agwarp warp 传送玩家。
• GWarp.AWarpSet - 使用 /agwarp set 为玩家设置传送点。
• GWarp.AWarpDelete - 使用 /agwarp delete 强制删除传送点。
• GWarp.AWarpUpdate - 使用 /agwarp update（同 /gwarp update）。
• GWarp.AWarpWelcome - 管理任何传送点的欢迎消息。
• GWarp.AWarpLock - 管理任何传送点的锁定状态。
• GWarp.AWarpSetOwner - 更改传送点所有者。
• GWarp.AWarpReset - 重置传送点访问计数。
• GWarp.AWarpPassword - 管理任何传送点的密码。
• GWarp.AWarpEffect - 管理任何传送点的粒子效果。
• GWarp.AWarpSound - 管理任何传送点的音效。
• GWarp.AWarpCount - 查看传送点访问计数。

家庭（Home）权限

• GWarp.Home.* - 所有家庭相关权限。
• GWarp.HomeAmount.* - 可设置无限个家。
• GWarp.HomeAmount.<数量> - 设置可拥有的家数量上限，例如 GWarp.HomeAmount.20。
• GWarp.Home - 使用 /ghome 传送回家的基本权限。
• GWarp.HomeTimeIgnore - 无视回家冷却时间。
• GWarp.HomeSet - 设置家。
• GWarp.HomeDelete - 删除家。
• GWarp.HomeUpdate - 更新家的位置。
• GWarp.HomeHomes - 使用 /ghome homes 列出所有家。
• GWarp.HomeBack - 使用 /ghome back 返回上一个位置。

重载权限

• GWarp.GWarpReload - 使用 /gwarpreload 命令重载插件。

🔧配置示例 (config.yml)

Lang:
  lang: en_en

Options:
  use-warp: true
  use-awarp: true
  default-warp-amount: 1
  warp-teleport-cooldown-seconds: 10
  use-safe-warp: false
  use-warp-shortcards: true
  show-all-visitors-reset: true
  warp-list-page-amount: 10
  warp-top-amount: 10
  warp-top-min-visitors: 1
  warp-owner-add-visitor: false
  warp-only-in-world: false
  min-warp-length: 1
  max-warp-length: 20
  min-warp-password-length: 1
  max-warp-password-length: 15
  use-home: true
  default-home-amount: 10
  home-teleport-cooldown-seconds: 0
  min-home-length: 1
  max-home-length: 20

WarpEffectOptions:
  particle-amount: 50
  particle-offset-x: 1.0
  particle-offset-y: 1.0
  particle-offset-z: 1.0
  particle-speed: 0.5

WarpSoundOptions:
  sound-volume: 1.0
  sound-pitch: 1.0

❓常见问题与提示

语言文件

• 更改语言：在 config.yml 中修改 Lang.lang 选项为对应的语言代码（如 zh_cn）。
• 添加新语言：复制一份现有的语言文件，重命名并翻译其中的消息，然后在配置中指向你创建的新文件。

支持版本

本插件支持 Minecraft 1.7, 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20 及 1.21。

错误反馈

目前暂无已知错误。如果你发现了任何漏洞，请在插件讨论区反馈，以便开发者快速修复。

计划功能

未来版本计划添加的功能包括

• /agwarp info <传送点名> - 显示某个传送点的详细信息。

---

提示：如果您喜欢此插件，请为其留下好评以示支持！同时，欢迎查看高级版本 ⭐ GWarpPro ⭐ 以获取更多功能。