GateTools - 传送门插件

一个功能强大的Minecraft Paper服务器传送门插件，支持区域传送和权限管理。

注意：本插件由 AI 辅助开发

功能特性

• 区域传送: 通过设定矩形区域创建传送门
• 交互式确认: 玩家进入传送区域时显示确认界面
• 条件系统: 支持经验、权限、金钱等传送条件
• 免费传送权限: "gatetools.free"权限节点，管理员免费传送 🆕
• 传送门所有者系统: 支持多所有者收益分配机制 🆕
• 传送凭证系统: 生成防复制的传送完成凭证 🆕
• 收款账户系统: 传送费用可转账到指定玩家账户
• 智能内存管理: 精确监控插件内存使用，自动清理优化
• 异步操作: 关键操作异步执行，避免服务器卡顿
• 权限管理: 完整的权限节点系统
• 数据持久化: 自动保存和手动保存功能
• Vault集成: 支持经济系统集成

服务器要求

• 服务器: Paper 1.20.1
• Java版本: Java 17+
• 可选依赖: Vault（用于经济功能）

安装方法

1. 下载 GateTools-1.3.jar 文件
2. 将文件放入服务器的 plugins 文件夹
3. 重启服务器
4. 插件将自动生成配置文件

命令使用

基础命令

• /gatetools help - 显示帮助信息
• /gatetools reload - 重载配置文件
• /gatetools save - 手动保存数据

传送门管理

• /gatetools set <角点1> <角点2> <配置名> <显示名> - 创建传送区域
• /gatetools edit <配置名> <配置项> [判断器] [值] - 编辑传送区域
• /gatetools edit <配置名> owner <玩家1> [玩家2] - 设置传送门所有者 🆕
• /gatetools edit <配置名> log <enable|disable> - 启用/禁用传送凭证 🆕
• /gatetools delete <配置名> - 删除传送区域
• /gatetools confirm - 确认删除操作

注意: teleport配置项直接接坐标，不需要判断器

命令示例

创建传送门

/gatetools set world,100,64,200 world,110,74,210 gate1 传送门1

设置传送目标

/gatetools edit gate1 teleport world,300,64,400

设置权限要求

/gatetools edit gate1 permission set = teleport.gate1

设置金钱费用

/gatetools edit gate1 money cost 100

设置经验要求

/gatetools edit gate1 experience set >= 10

设置传送门所有者 🆕

# 设置单个所有者
/gatetools edit gate1 owner Player1

# 设置两个所有者（收益平分）
/gatetools edit gate1 owner Player1 Player2

# 清除所有者
/gatetools edit gate1 owner clear

启用传送凭证 🆕

# 启用传送凭证功能
/gatetools edit gate1 log enable

# 禁用传送凭证功能
/gatetools edit gate1 log disable

权限节点

管理权限

• gatetools.command.set - 创建传送区域
• gatetools.command.edit - 编辑传送区域
• gatetools.command.delete - 删除传送区域
• gatetools.command.reload - 重载配置
• gatetools.command.save - 保存数据

使用权限

• gatetools.use - 使用传送门（默认为true）
• gatetools.command - 使用基础命令
• gatetools.free - 免费传送权限，跳过所有费用扣除 🆕

配置文件

config.yml

主配置文件，包含插件设置、内存管理、经济系统等配置。

收款账户配置 🆕

economy:
  # 收款账户设置 - 可以是玩家名或UUID，插件会自动识别
  # 留空则禁用收款功能（费用直接扣除不转账）
  recipient-account: ""

  # 是否启用转账日志
  transfer-logging: true

  # 是否在转账时通知收款账户玩家（如果在线）
  notify-recipient: true

收款账户格式支持：

• 玩家名：recipient-account: "PlayerName"
• UUID（带连字符）：recipient-account: "550e8400-e29b-41d4-a716-446655440000"
• UUID（不带连字符）：recipient-account: "550e8400e29b41d4a716446655440000"

内存管理配置 🆕

memory:
  # 插件内存使用限制（MB）
  limit: 32

  # 内存泄漏检测阈值（MB）
  leak-threshold: 16

  # 内存监控间隔（秒）
  monitor-interval: 300

  # 是否启用自动内存清理
  auto-cleanup: true

  # 内存清理间隔（分钟）
  cleanup-interval: 10

data.yml

数据文件，存储所有传送门信息（自动生成）。

messages.yml

消息配置文件，包含所有插件消息的本地化配置。

故障排除

如果传送功能不工作，请按以下步骤检查：

1. 启用调试模式: 在config.yml中设置debug: true
2. 检查传送目标: 确保使用正确的命令格式设置传送目标

   /gatetools edit <传送门名> teleport <世界名>,<x>,<y>,<z>
   

3. 检查权限: 确保玩家有gatetools.use权限
4. 查看控制台: 调试模式下会输出详细的日志信息
5. 重载插件: 使用/gatetools reload重载配置

条件系统

支持的配置项

• experience - 经验等级
• permission - 权限节点
• money - 金钱（需要Vault）
• teleport - 传送目标

判断器类型

• set - 设定判断条件
• cost - 设定花费（仅experience、money可用）

比较操作符

• = - 等于
• ! - 不等于
• > - 大于（仅数值类型）
• >= - 大于等于（仅数值类型）
• < - 小于（仅数值类型）
• <= - 小于等于（仅数值类型）

开发信息

• 作者: NSrank, Augment
• 版本: 1.3
• 许可证: MIT
• 源码: https://github.com/NSrank/GateTools

更新日志

v1.3 🎯 功能增强版

• 免费传送权限 🎫: 新增"gatetools.free"权限节点
  • 拥有此权限的管理员/玩家可以免费传送
  • 跳过所有金钱和经验费用扣除
  • 支持调试日志记录免费传送操作
• 传送门所有者系统 👥: 多所有者收益分配机制
  • 支持为每个传送门设置至多2位所有者
  • 传送费用自动平分到所有者账户
  • 命令: /gatetools edit <配置名> owner <所有者1ID> [所有者2ID]
  • 支持清除所有者: /gatetools edit <配置名> owner clear
  • 未设置所有者时收益归默认账户
• 传送凭证系统 📜: 传送完成凭证生成
  • 命令: /gatetools edit <配置名> log enable/disable
  • 生成带有"保护1"附魔和高修复费用的纸质凭证
  • 凭证内容包含：操作者、传送门名、传送时间、花费金额
  • 防复制设计，确保凭证唯一性和安全性
  • 智能背包管理，满背包时自动掉落
• 命令系统增强 🔧: 扩展edit命令功能
  • 新增owner和log配置项支持
  • 完善的tab补全功能，支持玩家名自动补全
  • 详细的使用说明和错误提示
  • 兼容现有的传统配置项

v1.2 🚀 重大更新

• 收款账户系统 💰: 传送费用可转账到指定玩家账户
  • 支持UUID和玩家名格式的收款账户配置
  • 自动识别账户格式，智能转账处理
  • 包含转账日志和收款通知功能
  • 支持转账失败时的安全回滚机制
• 内存管理优化 🧠: 重构内存监控系统
  • 修复内存监控显示服务器内存而非插件内存的问题
  • 实现基于插件实际使用量的精确内存监控
  • 添加可配置的内存限制和自动清理机制
  • 智能内存回收，包括空间索引重建和垃圾回收
• 异步操作优化 ⚡: 全面异步化关键操作
  • 传送执行、条件检查、费用扣除异步处理
  • 自动保存和内存清理异步执行
  • 避免主线程阻塞，提升服务器性能
• 传送门条件显示 📋: 新增条件信息显示功能
  • 玩家进入传送门时自动显示使用条件
  • 智能判断是否显示条件信息
  • 支持权限、金钱、经验等条件的格式化显示

v1.1

• 修复消息配置重复问题
• 将所有自定义消息统一到messages.yml文件
• 移除config.yml中的重复消息配置
• 优化消息管理系统

v1.0

• 初始版本发布
• 实现基础传送门功能
• 支持条件系统
• 集成Vault经济系统
• 完整的权限管理

支持

如果您遇到问题或有建议，请在GitHub上提交Issue。

---

English Version Below

GateTools - Teleportation Gate Plugin

A powerful Minecraft Paper server teleportation gate plugin with region-based teleportation and permission management.

Features

• Region Teleportation: Create teleportation gates using rectangular regions
• Interactive Confirmation: Display confirmation interface when players enter teleportation areas
• Condition System: Support for experience, permission, money and other teleportation conditions
• Permission Management: Complete permission node system
• Data Persistence: Auto-save and manual save functionality
• Vault Integration: Economy system integration support

Server Requirements

• Server: Paper 1.20.1
• Java Version: Java 17+
• Optional Dependencies: Vault (for economy features)

Installation

1. Download the GateTools-1.2.jar file
2. Place the file in your server's plugins folder
3. Restart the server
4. The plugin will automatically generate configuration files

Commands

Basic Commands

• /gatetools help - Show help information
• /gatetools reload - Reload configuration files
• /gatetools save - Manually save data

Gate Management

• /gatetools set <corner1> <corner2> <config_name> <display_name> - Create teleportation area
• /gatetools edit <config_name> <config_item> <judge_type> [value] - Edit teleportation area
• /gatetools delete <config_name> - Delete teleportation area
• /gatetools confirm - Confirm deletion operation

Permissions

Administrative Permissions

• gatetools.command - Use basic commands
• gatetools.command.set - Create teleportation areas
• gatetools.command.edit - Edit teleportation areas
• gatetools.command.delete - Delete teleportation areas
• gatetools.command.reload - Reload configuration
• gatetools.command.save - Save data

Usage Permissions

• gatetools.use - Use teleportation gates (default: true)

Development Information

• Authors: NSrank, Augment
• Version: 1.2
• License: MIT
• Source Code: https://github.com/NSrank/GateTools