ClaimSystem

插件

· 作者 avaliberty

ClaimSystem 是一款适用于 Minecraft 1.8 的 Bukkit/Spigot 插件,允许服务器管理员为玩家管理物品认领系统,使玩家能够认领物品,并在玩家在线或离线时进行分发。

0 本站下载 0 关注 更新于 1 个月前

最新 1.1 · 1.8.9 · Bukkit / Spigot

一键开服(送7天)

TebexClaimSystem

TebexClaimSystem 是一个适用于 Minecraft 1.8 Bukkit/Spigot 的插件,允许玩家通过自定义图形用户界面(GUI)在游戏内认领 Tebex 购买的商品,并让玩家在下一次上线时领取这些商品。

功能说明

  • 接受来自控制台的类 Tebex 交付风格命令:tebexclaimsystem add <username> <productName> <quantity>
  • 将待处理的认领记录存储在扁平化的 YAML 文件中,以确保重启后数据不丢失
  • 当玩家拥有待处理物品时,在加入服务器时通知玩家
  • 每 30 分钟向有待处理认领记录的在线玩家发送提醒消息
  • 打开一个 GUI,其中包含每个待处理商品的一个条目以及一个全部领取按钮
  • 在认领前检查空闲的物品栏空间
  • 执行可配置的商品命令,支持 {player} 占位符
  • 记录每次认领的时间戳、玩家、商品和数量

安装步骤

  1. 构建插件 jar 文件。
  2. 将 jar 文件放入服务器的 plugins/ 文件夹中。
  3. 启动或重启服务器。
  4. 编辑 plugins/TebexClaimSystem/config.yml 以匹配你的商品/命令设置。
  5. 配置文件更改后重新加载或重启服务器。

命令

  • /tebexclaimsystem - 为玩家打开认领 GUI。
  • 别名:/tcs, /claimstore, /claims, /webstoreclaim, /wsc。
  • tebexclaimsystem add <username> <productName> <quantity> - 仅限控制台使用的命令(旨在用于 Tebex 交付)。
  • /tebexclaimsystem reload - 无需重启服务器即可重新加载 config.yml(权限节点为 tebexclaimsystem.reload,默认为 op)。

Tebex 示例

tebexclaimsystem add Notch vip_rank 1
tebexclaimsystem add Notch starter_kit 2

配置

主配置文件:plugins/TebexClaimSystem/config.yml

products

通过 ID 定义每个可认领的商品。ID 必须与 Tebex 发送的 <productName> 完全匹配。

  • displayName - GUI 中显示的名称
  • itemMaterial - GUI 图标的材质
  • requiredSlotsPerUnit - 每购买单位所需的空格检查数量
  • commands - 认领时执行的命令(支持 {player} 和 {quantity})

示例:

products:
  vip_rank:
	displayName: "&6VIP Rank"
	itemMaterial: "EMERALD"
	requiredSlotsPerUnit: 1
	commands:
	  - "lp user {player} parent set vip"
  starter_kit:
	displayName: "&bStarter Kit"
	itemMaterial: "CHEST"
	requiredSlotsPerUnit: 2
	commands:
	  - "give {player} diamond_sword 1"
	  - "give {player} bread 16"

gui

  • title - 物品栏标题
  • size - 物品栏大小(9-54,向上舍入到 9 的倍数)
  • claimAllSlot - “全部领取”按钮的槽位索引
  • claimAllName / claimAllMaterial - “全部领取”按钮的显示名称和材质
  • quantityLore - 数量文本的描述行(Lore)

messages

所有面向玩家的消息和反馈消息均可配置。

  • 前缀令牌:{prefix}
  • 颜色支持:& 颜色代码

运行时数据文件

创建在 plugins/TebexClaimSystem/ 目录下:

  • pending-claims.yml - 每位玩家/每种商品的当前待处理认领记录
  • claim-log.txt - 认领审计日志条目

每当添加或删除认领记录时,pending-claims.yml 会立即更新。

认领系统流程

  1. Tebex(或控制台)运行 tebexclaimsystem add ...
  2. TebexClaimSystem 存储该玩家/商品的待处理数量
  3. 玩家加入服务器,如果存在待处理认领记录则收到通知
  4. 玩家打开 /tebexclaimsystem(或任何配置的别名)
  5. 玩家点击某个商品或全部领取
  6. 插件验证可用的物品栏槽位
  7. 如果有效,则分发商品命令并移除待处理条目
  8. 认领记录写入 claim-log.txt

故障排除

  • unknown product 消息:确保 Tebex 商品 ID 与 products 下的键完全匹配。
  • 玩家因空间不足无法认领:增加空闲物品栏槽位或调整 requiredSlotsPerUnit。
  • 在游戏中拒绝控制台命令:add 命令故意限制为仅由控制台发送者使用。
  • GUI 中没有物品:验证 pending-claims.yml 是否有条目,并且商品 ID 存在于 config.yml 中。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源