Piglintrades

插件

· 作者 CrownForge

生成特殊的猪灵,或者可选地生成普通猪灵,按照你的规则进行交易。提供物品以触发可配置的、加权奖励池,掉落战利品或执行控制台命令;猪灵会欣赏其副手栏中的物品,并且你会获得一个游戏内管理员 GUI 以及一个 si

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

最新 1.1 · 1.21.8 · Paper / Spigot

一键开服(送7天)

PiglinTrades

一个轻量级的 Spigot/Paper 1.21+ 插件,允许特殊猪灵和(可选地)普通猪灵通过完全可配置、带权重的奖励池进行交易。玩家“提供”一件物品,猪灵会欣赏它一小段时间(冷却期),期间会将物品展示在副手中以防止武器丢失,随后根据你的配置掉落奖励。支持物品奖励(包括药水与附魔书)和控制台命令奖励——并可选支持 PlaceholderAPI 占位符。


亮点

  • 特殊猪灵:无敌、不会消失,在“思考”时展示提供的物品,然后支付奖励。
  • 普通猪灵(可切换):保留原版交易或通过在配置中切换让它们使用 PiglinTrades。
  • 副手欣赏:提供的物品显示在副手中,以便猪灵保持主手的武器。
  • 按物品类型分组的奖励池:每个奖励池由玩家提供的MATERIAL键控(例如 GOLD_INGOT)。
  • 权重奖励:每项条目的 weight 控制概率;数量可以是固定值或范围。
  • 奖励类型:
    • 物品(支持附魔;通过基础 PotionType 支持药水; tipped arrows)
    • 附魔书(存储的附魔)
    • 命令(从控制台运行;支持 {player} 和 PlaceholderAPI)
  • 管理员 GUI 与工具:在游戏中添加/编辑奖励池和奖励;模拟器测试概率。

要求

  • 服务器:Spigot/Paper 1.21+
  • Java:21+
  • 可选:PlaceholderAPI(用于命令奖励中的占位符)

安装

  1. 将 PiglinTrades.jar 放入 /plugins 文件夹。
  2. (可选)如果你想在命令奖励中使用占位符,请安装 PlaceholderAPI。
  3. 重启以生成 config.yml 和 rewards.yml。
  4. 自定义设置,然后运行 /pt reload。

快速入门

  1. 使用 /pt spawn 放置一只特殊猪灵。
  2. 在 rewards.yml 中创建一个以玩家将要提供的物品为键的奖励池(例如 GOLD_INGOT)。
  3. 通过右键点击猪灵或在它们附近丢弃物品来提供该物品(消耗 1 个)。
  4. 冷却时间过后,匹配的奖励池中的奖励将出现。

想让普通猪灵也使用此插件?请参阅下面的配置切换选项。


配置

config.yml

  • cooldown-seconds — 猪灵“欣赏”物品后支付奖励前的秒数(默认:3)。
  • allow-vanilla-piglin-barter — 如果为 true,普通猪灵保留原版交易。特殊猪灵始终使用 PiglinTrades。
  • regular-piglins-use-plugin-trades — 如果为 true,普通猪灵也通过 PiglinTrades 进行交易。

这两个布尔值是互斥的。如果两者都为 true,插件会记录警告并禁用原版交易,使普通猪灵使用 PiglinTrades。

示例:

cooldown-seconds: 3
allow-vanilla-piglin-barter: false
regular-piglins-use-plugin-trades: false

rewards.yml(概念)

  • 奖励池由MATERIAL 名称键控(例如 GOLD_INGOT)。
  • 每个奖励池包含以下条目:
    • type: item | enchanted_book | command
    • weight: 越高越可能出现
    • 对于物品:material、amount(数字或 min-max)、可选 enchants、可选 potion
    • 对于附魔书:stored_enchants、amount
    • 对于命令:command(控制台),支持 {player} 和 PlaceholderAPI

提示:使用 /pt simulate <POOL_KEY> <COUNT> 预览结果分布。


命令与权限

  • 基本命令:/piglintrades(别名 /pt)
  • 权限:piglintrades.admin(默认:OP)

子命令:

  • /pt spawn — 生成一只特殊猪灵。
  • /pt reload — 重新加载配置。
  • /pt simulate <POOL_KEY> <COUNT> — 测试加权结果。
  • /pt kill <all|nearest> — 移除特殊猪灵。
  • /pt gui — 打开管理员 GUI。

玩家如何使用

  • 特殊猪灵:右键点击或丢弃已配置的物品;等待冷却时间;收集奖励。
  • 普通猪灵:
    • 如果 allow-vanilla-piglin-barter: true → 它们表现得像原版。
    • 如果 regular-piglins-use-plugin-trades: true → 它们使用与特殊猪灵相同的 PiglinTrades 流程。

注意事项

  • 提供的物品在猪灵“欣赏”期间显示在其副手中(主手装备保持完整)。
  • 如果奖励池没有有效条目或只有非正数的权重,它将不会选择奖励。
  • 请根据 Spigot 枚举验证 MATERIAL 名称和附魔键。

故障排除

  • 普通猪灵仍在进行原版交易 → 设置 allow-vanilla-piglin-barter: false 和 regular-piglins-use-plugin-trades: true,然后执行 /pt reload。如果两者都为 true,请检查控制台是否有互斥性警告。
  • /pt simulate 中出现“未知奖励池” → 验证确切的 MATERIAL 键。
  • 没有奖励掉落 → 检查条目 type、权重和字段。
  • 占位符未应用 → 安装 PlaceholderAPI 及所需的扩展包。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源