📖 插件简介

PaiTransactionShop 是一款基于GUI的商店交易系统插件，支持多种交易条件、次数限制、NPC绑定等高级功能。 插件提供了完善的可视化编辑系统，无需手动编辑配置文件，全程GUI操作，让商店配置变得简单高效。 支持物品、金钱、等级、经验、权限等多维度交易条件，满足各种复杂的交易需求。

✨ 核心特色

• 🎯 完全GUI操作 - 无需手动编辑YAML，全程可视化配置商店和交易
• 🔐 多维度交易条件 - 支持物品、金钱、等级、经验、权限等多种条件组合
• 📊 灵活的次数限制 - 支持全局次数和玩家个人次数双重限制
• 💾 双存储支持 - YAML文件存储 / MySQL数据库存储，灵活选择
• 🎭 NPC/实体/方块绑定 - 支持绑定Citizens NPC、实体、方块，右键打开商店
• ⚙️ 高级交易设置 - 支持交易后执行指令、自定义物品判断、GUI控制等
• 🌐 多语言支持 - 中文（zh_CN）/ 英文（en_US）可切换
• 🔌 PlaceholderAPI集成 - 执行指令支持PAPI变量
• ⚡ 跨版本支持 - 使用PaiDaXingPlugins支持 Minecraft 1.12.x - 1.21.x
• 💎 完整NBT支持 - 完整保留物品的附魔、属性、自定义名称等所有数据
• 🔄 实时保存 - 所有修改实时保存，无需重启服务器
• 🎨 自定义物品判断 - 可选择是否检查物品NBT数据，灵活匹配

🎮 功能详解

1. 🎯 完善的GUI编辑系统

• 商店编辑界面 - 6行54格箱子界面，自由放置和移除商品
• 可视化配置 - 无需手动编辑YAML配置文件
• 物品管理 - 直接在GUI中添加、删除、修改交易物品
• 交易设置 - 右键物品即可打开交易条件设置界面
• 实时保存 - 所有修改实时保存，关闭界面自动保存
• 权限控制 - 仅商店创建者和管理员可编辑

2. 🔐 多维度交易条件

基础条件

• 金钱条件 - 需要消耗金钱（Vault经济系统），左键+100，右键-100
• 等级条件 - 需要玩家达到指定等级，左键+1，右键-1
• 经验条件 - 需要消耗经验值，左键+10，右键-10
• 权限条件 - 需要特定权限节点，点击后在聊天中输入

物品条件

• 条件物品 - 需要玩家背包中有指定物品（最多18种）
• 数量要求 - 支持设置每种物品的数量要求
• NBT检测 - 支持完整NBT数据匹配（附魔、属性、自定义名称等）
• 灵活匹配 - 可选择仅检查物品类型或完整检查

组合条件

• 支持多个条件同时生效
• 所有条件必须同时满足才能交易
• 实时显示玩家当前状态和条件满足情况

3. 📊 智能次数限制系统

全局次数限制

• 全服共享 - 所有玩家共享的交易总次数
• 限量商品 - 适合限量稀有物品销售
• 灵活设置 - 左键+1，右键-1，中键重置
• 实时显示 - 显示剩余次数和总次数
• 0表示无限 - 设置为0表示不限制

玩家次数限制

• 个人限制 - 单个玩家的交易次数上限
• 防刷机制 - 防止玩家重复购买
• 灵活设置 - 左键+1，右键-1，中键重置所有玩家
• 实时显示 - 显示玩家剩余次数
• 管理员重置 - 支持重置指定玩家或所有玩家

4. ⚙️ 高级交易设置

• 完整物品判断 - 开启/关闭NBT数据检查，灵活匹配物品
• 执行指令 - 交易成功后由控制台执行指令，支持%player%和PlaceholderAPI变量
• 给予物品 - 可选择是否给予展示的交易物品
• 关闭GUI - 交易成功后是否自动关闭商店界面
• 自定义奖励 - 通过执行指令实现各种自定义奖励

5. 🎭 NPC/实体/方块绑定系统

• Citizens NPC绑定 - 支持绑定Citizens插件的NPC
• 实体绑定 - 支持绑定任意实体
• 方块绑定 - 支持绑定任意方块
• 右键打开 - 玩家右键绑定目标即可打开商店
• 多对一绑定 - 多个NPC/实体/方块可以绑定同一个商店
• 绑定管理 - 支持查看和管理所有绑定关系

6. 💾 数据存储系统

YAML模式（默认）

• 文件存储，无需数据库
• 数据结构清晰，易于备份
• 适合中小型服务器

MySQL模式

• 数据库存储，更可靠
• 支持多服数据共享
• HikariCP连接池，性能优异
• 适合大型服务器

⌨️ 指令系统

玩家命令

/pts 或 /paitransactionshop

玩家指令列表

管理员命令

/pts 或 /paitransactionshop

管理员指令列表

权限节点

⚙️ 配置说明

基础配置（config.yml）

# 存储配置
storage:
  type: YAML  # 存储类型: YAML 或 MYSQL
  
  # MySQL 配置
  mysql:
    host: localhost
    port: 3306
    database: paitransactionshop
    username: root
    password: ''
    pool:
      maximum-pool-size: 10
      minimum-idle: 2
      connection-timeout: 30000
      idle-timeout: 600000
      max-lifetime: 1800000

# 语言设置 (zh_CN 或 en_US)
language: zh_CN

# 调试模式
debug: false

📥 安装方法

1. 下载插件
   • 在PaiDaXingPlugins授权器中输入插件授权码
2. 安装依赖插件
   • PaiDaXingPlugins - 提供跨版本支持（必需）
   • Vault - 支持金钱条件（必需）
   • PlaceholderAPI - 支持变量功能（可选）
   • Citizens - 支持NPC绑定（可选）
3. 启动服务器
   • 插件会自动生成配置文件
4. 配置插件
   • 编辑 plugins/PaiTransactionShop/config.yml 配置基础设置
   • 选择存储方式（YAML或MySQL）
   • 选择语言（中文或英文）
5. 开始使用
   • 使用 /pts create 我的商店 创建商店
   • 使用 /pts edit 我的商店 编辑商店
   • 使用 /pts bind 我的商店 绑定NPC/实体/方块
   • 玩家右键绑定目标即可打开商店！

🚀 快速开始教程

创建你的第一个商店（5分钟上手）

1. 创建商店

   /pts create 新手商店

2. 在打开的编辑界面中放入商品
   • 在槽位0放入: 钻石剑 x1
   • 在槽位1放入: 附魔金苹果 x5
   • 在槽位2放入: 经验瓶 x10
3. 设置第一个交易（钻石剑）
   • 右键点击钻石剑，打开交易设置界面
   • 左键点击"金钱"按钮10次（设置为1000金币）
   • 关闭界面自动保存
4. 绑定商店到NPC

   /pts bind 新手商店

   • 在10秒内右键点击要绑定的NPC/实体/方块
5. 完成！
   • 玩家现在可以右键NPC打开商店购买了！

进阶示例：设置复杂交易

1. 材料兑换物品
   • 右键点击目标物品
   • 在上方（槽位0-17）放入所需材料：钻石x64、金锭x32、末影珍珠x16
   • 设置金钱: 5000
   • 设置等级: 30
   • 关闭保存
2. VIP专属商品
   • 右键点击VIP物品
   • 点击"权限"按钮
   • 在聊天中输入: vip.diamond
   • 设置其他条件
   • 关闭保存
3. 限购商品
   • 右键点击稀有物品
   • 设置全局次数: 100（左键点击100次）
   • 设置玩家次数: 1（每人只能买1次）
   • 关闭保存
4. 购买后传送
   • 右键点击传送券
   • 点击"执行指令"按钮
   • 在聊天中输入: tp %player% 100 64 100
   • 将"给予物品"设置为关闭
   • 将"关闭GUI"设置为开启
   • 关闭保存

📷 插件截图展示

商店编辑界面 - 6行54格，自由放置商品

交易设置界面 - 可视化配置所有交易条件

商店购买界面 - 实时显示条件满足情况

🔧 技术特性

性能优化

• ✅ 异步数据库操作，不阻塞主线程
• ✅ 商店数据缓存机制
• ✅ HikariCP连接池（MySQL模式）
• ✅ 异步聊天输入处理

兼容性

• ✅ 支持 Minecraft 1.12.x - 1.21.x 全版本
• ✅ 兼容 Spigot、Paper、Bukkit、Catserver、Mo、F 等服务端
• ✅ 与主流插件完美兼容（Vault、PlaceholderAPI、Citizens等）
• ✅ 支持自定义物品（NBT、Lore、附魔等）

💰 购买信息

• 💬 购买联系方式
• QQ：2776901795
• 定价：58 元
• 包含内容：
  • ✅ 插件本体（支持1.12.x - 1.21.x全版本）
  • ✅ 完整的GUI编辑系统
  • ✅ 多维度交易条件
  • ✅ 终身免费更新
  • ✅ 技术支持
  • ✅ 配置协助
  • ✅ 示例配置文件
• 可选服务：
  • 🎯 定制功能开发：价格面议

售后服务

• ✅ 免费安装指导
• ✅ 免费配置协助
• ✅ 免费BUG修复
• ✅ 免费功能更新
• ✅ 优先功能建议采纳