qShadowTrader

插件

· 作者 qustan

qShadowTrader 添加了一位秘密商人,他会随机出现在玩家附近,并在短时间内提供有限的稀有物品。旨在打造动态的黑市和独特的服务器经济体系。

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

最新 1.0.0 · 1.21.4 · Paper / Spigot

一键开服(送7天)

qShadowTrader


主要功能

  • 在有效的玩家附近随机生成商人。
  • 可配置生成间隔、概率和距离。
  • 按世界(blocked-worlds)进行生成限制,并支持可选的白名单(allowed-worlds)。
  • trades.yml 中可配置的商品:
    • 普通物品(material, amount),
    • 自定义物品(item.*: name/lore/model-data/enchantments/flags/unbreakable)。
  • 每个商品的全局购买上限(limit),显示在描述文本中。
  • 购买时执行命令([console] / [player])。
  • 双击购买保护。
  • 商人生成/消失时的聊天通知。
  • 玩家在 data.yml 中的冷却时间持久化存储。

商人生命周期

  1. 插件会在 spawn.interval-min 到 spawn.interval-max 之间的随机间隔等待。
  2. 在每个周期,它会进行 spawn.chance 的概率判定。
  3. 选择一个随机的有效玩家:
    • 在线且存活,
    • 不在创造模式或旁观者模式,
    • 所在世界不在 spawn.blocked-worlds 中,
    • 如果设置了 allowed-worlds,则世界必须在该列表中,
    • 满足 player-cooldown 条件。
  4. 商人在该玩家附近的安全位置生成(spawn-distance)。
  5. 根据 trades.yml 中使用加权 chance 值生成商品列表。
  6. 商人经过 lifetime 时间后消失,或者当所有可用商品都被买光时消失(如果 despawn-when-empty: true)。

命令

  • /shadowtrader spawn — 在自己附近生成(如果是玩家执行)或在随机有效目标附近生成(如果是控制台执行)。
  • /shadowtrader spawn random — 强制使用有效目标规则随机生成。
  • /shadowtrader spawn <player> — 在特定玩家附近生成(包含所有验证)。
  • /shadowtrader despawn — 移除当前活跃的商人。
  • /shadowtrader reload — 重新加载插件配置。
  • /shadowtrader info — 显示商人状态。
  • 别名:/st

权限

  • qshadowtrader.use
  • qshadowtrader.admin
  • qshadowtrader.spawn
  • qshadowtrader.reload

配置 (config.yml)

关键部分:

  • spawn — 自动生成逻辑(间隔、概率、世界)。
  • player-cooldown — 同一玩家再次被选中前的冷却时间。
  • spawn-distance — 距目标玩家的最小/最大距离。
  • messages — 聊天消息。
  • lifetime — 商人存在时间(秒)。
  • despawn-when-empty — 当所有商品售罄时消失。
  • trader — 实体行为/选项。
  • menu — GUI 设置。
  • protection.double-click-window-ms — 防双击窗口期(毫秒)。

商品列表 (trades.yml)

每个商品定义在 items.<id> 下,并支持:

  • material / amount(简写格式),或
  • item.*(高级自定义物品格式),
  • limit — 本次商人会话的最大购买次数,
  • chance — 生成权重,
  • lore — 在 GUI 中显示的商品描述,
  • commands — 购买时执行的命令。

商品描述占位符

  • %CURR_LIMIT% — 当前已购买数量
  • %MAX_LIMIT% — 该商品的最大限制

命令前缀

  • [console] command — 以控制台身份执行
  • [player] command — 以玩家身份执行
  • 无前缀 — 以控制台身份执行

命令中支持的占位符:<player>, %player%


商品示例

totem:
  material: TOTEM_OF_UNDYING
  amount: 1
  limit: 1
  chance: 10
  lore:
    - ""
    - "&7价格: &62500"
    - "&7限购: %CURR_LIMIT%/%MAX_LIMIT%"
    - ""
  commands:
    - "[console] eco remove <player> 2500"

注意事项

  • 商人受到伤害/燃烧保护。
  • 每次生成新商人时,商品限购重置。
  • 如果自动生成不生效,请检查 spawn.enabled、世界过滤器(allowed/blocked)以及是否存在有效的在线玩家。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源