GlobalShop 一个为Minecraft服务器提供魔兽世界风格拍卖行功能的插件

Saga

# GlobalShop - 高级Minecraft拍卖行系统

项目已免费开源

## 简介

GlobalShop是一个为Minecraft服务器提供魔兽世界风格拍卖行功能的插件，支持Spigot 1.21.4版本。

关于图片展示由于总是上传失败,后续会添加视频演示.

核心功能

一.拍卖系统

1.物品上架功能

  - 玩家可通过GUI或命令上架物品

  - 支持设置起拍价和一口价

  - 自定义拍卖持续时间（左键+1分钟，右键+1小时，Shift+左键+10分钟，Shift+右键+10小时）

  - 上架数量限制功能，基于配置可设置每位玩家最大上架数

  - 价格位数限制功能，防止超高价格物品

  2.购买与竞价系统

  - 一口价直接购买

  - 竞价购买系统

  - 竞价加价优化，支持预加价按钮

  - 拍卖结束自动结算

  - 完善的交易记录系统，记录买家、卖家、交易时间等信息

  3.物品领取系统

  - 自动处理离线和背包已满玩家的物品

  - 物品安全邮箱功能

  - 命令领取待领取物品

二.经济系统

1.双货币支持

  - 完整Vault经济集成

  - PlayerPoints点券集成（软依赖，不强制安装）

  - 上架时可选择货币类型

  - 交易过程保持货币类型一致

2.手续费系统

  - 可配置的买家/卖家手续费

  - 两种货币各自独立的手续费设置

三GUI系统

  1.主界面

  - 直观的拍卖物品展示

  - 完整的分页系统，每页显示45个物品

  - 简化的操作：左键竞价，右键一口价购买

  2.我的拍卖界面

  - 查看当前上架物品

  - 查看已售出拍卖、显示买家和实际成交价

  - 查看已过期拍卖

  - 显示玩家当前上架数量和最大上限

  3.搜索系统

  - 物品名称模糊搜索

  - 支持带颜色代码的物品名称搜索

  - 搜索历史记录功能

  - 支持中文原版物品名称搜索（如搜索"红石"可找到所有红石相关物品）

四.广播系统

1.多位置广播

  - 聊天框广播

  - Boss栏广播

  - 标题广播

  - 副标题广播

  - 动作栏广播

2.多事件广播

  - 物品上架广播

  - 竞拍成功广播

  - 一口价购买广播

  3.广播优化

  - 聊天框中显示可交互的物品详细信息

  - 鼠标悬停时显示完整物品信息（包括所有渐变色效果）

  - 广播消息完全可自定义

五.多语言支持

  - 完整支持10种语言:

  - 中文、英语、德语、俄语、西班牙语、法语、意大利语、日语、葡萄牙语

  - 部分支持阿拉伯语和印地语

  - 所有GUI文本和消息提示均支持多语言

六.管理功能

  - 强制下架功能（管理员可强制下架任何物品，包括自己的）

  - 配置热重载功能

  - 手动检查过期物品命令

七.命令系统

[CODE=yaml]/auction help - 显示帮助信息

/auction open - 打开拍卖行界面

/auction sell <起拍价> [一口价] [货币类型] - 上架物品 (1=金币, 2=点券)

/auction buy <物品ID> - 购买物品

/auction search <关键词> - 搜索物品

/auction my - 查看我的拍卖

/auction collect - 领取待领取物品

/auction reload - 重新加载配置文件（需要管理员权限）

/auction close - 强制关闭所有拍卖（仅管理员）

/auction checkexpired - 手动检查过期物品（仅管理员）[/CODE]

八.权限节点

[CODE=yaml]globalshop.use - 基础使用权限

globalshop.sell - 上架权限

globalshop.buy - 购买权限

globalshop.admin - 管理员权限[/CODE]

九.技术特点

- SQLite数据库存储，高效可靠

- 完整物品序列化系统，支持所有Minecraft物品类型

- 完全兼容自定义物品（保留所有NBT数据）

- 高度自定义的配置系统

十.配置文件

[CODE=yaml]# GlobalShop 全局拍卖行插件配置文件

# 本配置文件包含插件的所有设置选项，修改后需重启服务器或使用/ah reload命令生效

# 语言设置

language:

  # 选择消息文件的语言版本，可选值：

  # zh_CN - 简体中文（默认）

  # en - English (English)

  # es - Español (Spanish)

  # de - Deutsch (German)

  # ru - Русский (Russian)

  # pt - Português (Portuguese)

  # ja - 日本語 (Japanese)

  # ar - العربية (Arabic)

  # hi - हिन्दी (Hindi)

  # it - Italiano (Italian)

  locale: "zh_CN"

# 数据库配置

database:

  # 数据库类型，目前仅支持sqlite

  type: sqlite

  # 数据库文件名，存储在plugins/GlobalShop/目录下

  file: data.db

# 经济系统配置

economy:

  # 买家税率（购买物品时需支付的额外费用百分比）

  # 范围: 0.0-1.0，0表示不收税，0.02表示收取2%的税

  buyer_tax_rate: 0.02

  # 价格最大位数限制

  # 例如: 9表示最大价格为999,999,999

  max_price_digits: 9

  # Vault经济系统配置（金币）

  vault:

    # 货币名称，显示在GUI界面和消息中

    name: "金币"

    # 货币符号，显示在价格前面，支持颜色代码

    symbol: "§6$"

    # 交易手续费比例，卖家出售物品时收取的费用百分比

    # 范围: 0.0-1.0，0.05表示收取5%的手续费

    fee: 0.05

    # 最低手续费金额，即使按比例计算的手续费低于此值，也会收取此金额

    min_fee: 1.0

    # 最低加价比例，竞价时最少需要加价的百分比

    # 范围: 0.0-1.0，0.05表示至少加价5%

    min_bid_rate: 0.05

    # 最低加价金额，竞价时最少需要加价的金额

    min_bid_amount: 1.0

  # PlayerPoints点券系统配置（点券）

  points:

    # 点券名称，显示在GUI界面和消息中

    name: "点券"

    # 点券符号，显示在价格前面，支持颜色代码

    symbol: "§b♦"

    # 点券交易手续费比例，卖家出售物品时收取的费用百分比

    # 范围: 0.0-1.0，0.05表示收取5%的手续费

    fee: 0.05

    # 点券最低手续费金额，即使按比例计算的手续费低于此值，也会收取此金额

    min_fee: 1.0

    # 点券最低加价比例，竞价时最少需要加价的百分比

    # 范围: 0.0-1.0，0.05表示至少加价5%

    min_bid_rate: 0.05

    # 点券最低加价金额，竞价时最少需要加价的金额

    min_bid_amount: 1.0

# 拍卖配置

auction:

  # 默认拍卖持续时间（秒），上架物品的有效期

  # 86400秒 = 24小时

  default_duration: 86400

  # 最短拍卖时间（秒），不能设置比这个更短的拍卖时间

  # 3600秒 = 1小时

  min_duration: 3600

  # 最长拍卖时间（秒），不能设置比这个更长的拍卖时间

  # 604800秒 = 7天

  max_duration: 604800

  # 每个玩家最大上架数量，超过此数量将无法继续上架物品

  max_listings_per_player: 3

  # 检查过期拍卖的间隔时间（秒）

  # 30秒 = 每30秒检查一次过期拍卖

  check_interval: 30

# GUI界面配置

gui:

  # 拍卖行GUI标题，支持颜色代码

  title: "§8[§6拍卖行§8]"

  # GUI大小，必须是9的倍数，最大值为54（6行*9列）

  size: 54

# 广播系统配置

broadcast:

  # 广播系统总开关，设置为false将关闭所有广播

  enabled: true

  # 广播事件配置

  events:

    # 物品上架广播

    item_listed:

      enabled: true

      # 广播位置配置

      locations:

        chat: true           # 聊天框广播

        bossbar: false       # Boss栏广播

        title: false         # 屏幕标题广播

        actionbar: false     # 动作栏广播

        subtitle: false      # 副标题广播

    # 竞拍成功广播

    auction_won:

      enabled: true

      # 广播位置配置

      locations:

        chat: true

        bossbar: true

        title: false

        actionbar: false

        subtitle: false

    # 一口价购买广播

    buy_now:

      enabled: true

      # 广播位置配置

      locations:

        chat: true

        bossbar: false

        title: false

        actionbar: true

        subtitle: false

    # 竞价确认广播（新增）

    bid_confirmed:

      enabled: true

      # 广播位置配置

      locations:

        chat: true

        bossbar: false

        title: false

        actionbar: true

        subtitle: false

  # 广播样式配置

  styles:

    # Boss栏设置

    bossbar:

      color: PURPLE         # 颜色: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE

      style: SOLID          # 样式: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20

      duration: 5           # 持续时间（秒）

    # 标题设置

    title:

      fade_in: 10           # 淡入时间（tick）

      stay: 40              # 停留时间（tick）

      fade_out: 10          # 淡出时间（tick）

# 调试模式 - 设置为true时会在控制台输出调试信息

debug: false [/CODE]