原创 娱乐 WayPointMaster —— 传送点大师 [1.12 - 1.21.x] 1.1.1

插件主要功能​

1. 传送点设置与管理：
   • 设置传送点：使用命令 /point set <name> <x> <y> <z> [permissionCheck] [permission] [placeholderCheck] [placeholder] 可以在指定坐标创建一个传送点。你还可以为传送点设置权限检查和占位符条件，确保只有符合条件的玩家可以使用这个传送点。
   • 删除传送点：使用命令 /point delete <name> 删除指定的传送点，移除传送点记录。
   • 列出传送点：使用命令 /point list [page] 列出玩家已解锁的传送点，支持分页显示。
   • 传送到传送点：通过命令 /point teleport <name> 立即传送到指定的传送点。
     
2. 传送点解锁：
   • 当玩家移动到某个传送点的附近，并且满足配置的权限和占位符条件时，传送点会自动解锁并记录在玩家的解锁列表中。
   • 
3. 图形用户界面（GUI）：
   • GUI提供了一个直观的界面，让玩家可以查看、传送、编辑和删除已解锁的传送点。
   • 左键点击：在GUI中左键点击传送点物品可以立即传送到该传送点。
   • 中键点击：中键点击传送点物品可进入编辑模式，允许玩家重新命名和设置传送点的位置。
   • 右键点击：右键点击传送点物品将删除该传送点。
   • 翻页按钮：GUI支持分页显示传送点列表。使用箭头按钮翻页查看更多传送点。
     
     
4. 占位符与权限检查：
   • 占位符条件检查：插件支持通过 PlaceholderAPI 插件进行占位符值的检查，允许你根据玩家的动态数据（如健康值、经验值等）来决定传送点的解锁或使用。
   • 权限检查：你可以为传送点配置权限，只有拥有特定权限的玩家才能解锁或使用该传送点。
5. 配置和数据管理：
   • 多语言支持：插件支持多语言配置，通过 messages_<language>.yml 文件自定义插件消息，支持丰富的文本格式和渐变色显示。
   • 数据持久化：传送点数据和玩家解锁记录会自动保存到 points.yml 和 player_data.yml 文件中，确保数据不会丢失。
6. 自动保存与加载：
   • 自动保存：插件会在服务器关闭时自动保存所有传送点和玩家数据，确保数据不会丢失。
   • 自动加载：在服务器启动时，插件会自动加载配置文件和数据文件，恢复传送点和玩家的解锁状态。
7. 编辑传送点：
   • 玩家可以使用GUI中的中键点击功能进入编辑模式，重新设置传送点的名称和位置。
   • 编辑传送点时，玩家需要通过聊天输入新的名称和坐标（格式为：name x y z），并且支持直接替换现有的传送点数据。
8. 重载配置：
   • 使用 /point reload 命令可以重新加载配置文件和数据文件，应用最新的更改。
   • 在重载配置时，插件会检查所有玩家的解锁传送点是否依然符合条件（如权限和占位符检查），并移除不再符合条件的传送点。
9. 消息系统：
   • 插件内置了一个灵活的消息系统，允许管理员通过编辑 messages_<language>.yml 文件来自定义所有提示信息。
   • 支持高级的文本格式化功能，包括颜色、字体样式、渐变效果等。
     
     

points.yml 配置详解​

points:
  point1:
  world: "world"                          # 🌍 传送点所在的世界名
  x: 100                                   # 📍 传送点的X坐标
  y: 65                                    # 📍 传送点的Y坐标
  z: 200                                   # 📍 传送点的Z坐标
  permission_check: true                   # 🛡️ 是否启用权限检查
  permission: "point.use.point1"           # 🔑 所需的权限节点
  placeholder_check: true                  # 📊 是否启用占位符检查
  placeholder: "%player_health%"           # 📈 使用的占位符（由 PlaceholderAPI 提供）
  condition: ">="                          # ⚖️ 占位符检查的条件（可用条件：==, !=, >, <, >=, <=）
  value: 1000                              # 🎯 用于比较的值

  point2:
  world: "world"
  x: 200
  y: 70
  z: 300
  permission_check: false                  # ❌ 如果为false，则不进行权限检查
  permission: ""                           # 🛡️ 没有设置权限时可以留空
  placeholder_check: false                 # ❌ 如果为false，则不进行占位符检查
  placeholder: ""                          # 🛑 如果不使用占位符，可以留空
  condition: "=="                          # ⚖️ 默认为"=="
  value: 0                                 # 🎯 只有在开启占位符检查时，这个值才有意义

支持的条件（Condition）：​

• ==：当占位符的值等于配置的值时，条件通过。
• !=：当占位符的值不等于配置的值时，条件通过。
• >：当占位符的值大于配置的值时，条件通过。
• <：当占位符的值小于配置的值时，条件通过。
• >=：当占位符的值大于或等于配置的值时，条件通过。
• <=：当占位符的值小于或等于配置的值时，条件通过。

示例：​

• 传送点 point1 的配置表示：当玩家的健康值（%player_health%）大于或等于 1000，并且玩家拥有 point.use.point1 权限时，才能解锁和使用此传送点。
• 传送点 point2 的配置表示：任何玩家都可以使用此传送点，因为没有权限和占位符检查。

使用指南​

1. 安装插件：
   • 将插件放置到服务器的 plugins 目录中，并启动服务器。
   • 启动后，插件将自动生成默认的配置文件。
2. 配置插件：
   • 编辑 config.yml 文件，选择所需语言，并自定义插件的基础设置。
   • 编辑 points.yml 文件，预先配置好传送点及其权限和条件检查。
3. 管理传送点：
   • 使用 /point set <name> <x> <y> <z> [permissionCheck] [permission] [placeholderCheck] [placeholder] 来设置新传送点。
   • 使用 /point teleport <name> 命令传送到指定传送点。
   • 使用 /point delete <name> 命令删除不再需要的传送点。
   • 使用 /point list [page] 命令查看已解锁的传送点。
   • 使用 /point gui 命令打开传送点管理的图形界面。
4. 维护与更新：
   • 使用 /point reload 命令重新加载插件配置文件，应用最新的更改。

命令列表​

• /point set <name> <x> <y> <z> [permissionCheck] [permission] [placeholderCheck] [placeholder]
• /point teleport <name>
• /point delete <name>
• /point list [page]
• /point gui
• /point reload

权限列表​

• point.set - 设置传送点的权限。
• point.teleport - 传送到传送点的权限。
• point.list - 列出传送点的权限。
• point.delete - 删除传送点的权限。
• point.reload - 重载配置的权限。
• point.gui - 使用 GUI 的权限。
• point.use 玩家是否允许使用 /point 命令

小贴士​

• 自定义语言：通过编辑 messages_<language>.yml 文件可以自定义插件中的所有消息内容，支持复杂的文本格式和颜色渐变。
  
  
• 动态条件：利用 PlaceholderAPI 插件，可以根据玩家的动态数据（如健康值、等级等）来设置传送点的条件，打造更加个性化的传送体验。