ShopTracker

ShopTracker

有用的PW商店库存跟踪工具,带角色和区域功能。

ShopTracker

一个面向 MysticMC 的客户端商店管理模组。

ShopTracker 专为服务器商店主打造,可监控库存水平、管理多个玩家商店,并在物品库存不足时通过 Discord 发送提醒——全程无需亲自逐个打开箱子查看。


功能

📦 库存扫描

  • 无需与木桶交互,自动从商店告示牌读取库存水平
  • 扫描渲染距离内所有匹配你商店主名称的告示牌
  • 当库存低于设定阈值时发送 Discord webhook 提醒
  • 支持按物品和按区域自定义阈值
  • 可配置提醒冷却时间以防止刷屏

🗺️ 区域小地图

  • 自定义游戏内小地图,显示周围环境的俯视地形视图
  • 可直接在地图上绘制商店区域,或在世界中沿角落行走来划定区域
  • 区域以多边形渲染,完全遵循你绘制的形状
  • 库存状态以颜色标记覆盖——绿色(有货)、橙色(库存低)、红色(缺货)
  • 单击选择区域,Ctrl+单击多选
  • 使用区域限定扫描仅扫描特定区域

🏪 多 PW 管理

  • 注册多个玩家传送点(PW),每个均可拥有独立管理器
  • 每个区域可拥有各自独立于全局设置的监控店主名称

👥 角色系统

  • 管理员 — 完全控制权,可通过游戏内管理面板管理所有 PW 和玩家
  • 经理 — 管理其被分配的 PW,添加补货员并控制其权限
  • 补货员 — 默认可以扫描和查看库存,并可由其经理授予额外可选权限
  • 角色通过后端 API 持久化存储并绑定至 Minecraft 账户
  • 管理员可预览任意角色,以测试经理和补货员能看到的内容

设置

  1. 将模组安装到你的 Fabric mods 文件夹
  2. 启动游戏一次以生成 config/shoptracker.json
  3. 填写你的配置:
    • watchedOwner — 你的游戏内用户名(商店告示牌上的名称)
    • webhookUrl — 用于库存提醒的 Discord webhook URL
    • defaultThreshold — 触发提醒的库存水平
    • apiUrl — 你的 ShopTracker 角色 API URL(可选,用于多用户配置)

按键

按键 操作
V 扫描渲染距离内所有告示牌
M 打开区域小地图
N 打开管理面板(仅管理员)
B 打开经理面板(仅经理)

所有按键均可在 Minecraft 的控制设置中修改。


命令

命令 描述
/shoptracker scan 扫描所有告示牌
/shoptracker map 打开小地图
/shoptracker owner <name> 设置监控的店主
/shoptracker threshold <amount> 设置默认阈值
/shoptracker zone start <name> 开始定义区域
/shoptracker zone corner 在当前位置添加一个角落点
/shoptracker zone finish 保存区域
/shoptracker zone list 列出所有区域
/shoptracker zone assign <zone> <item> 为区域分配物品
/shoptracker exportzones 将区域导出为分享代码
/shoptracker importzones <code> 从分享代码导入区域
/shoptracker manager 打开经理面板
/shoptracker stopreview 停止角色预览模式

要求

  • Minecraft 1.21.8
  • Fabric Loader
  • Fabric API