CobbleDollarsCommandShop

模组

· 作者 Narrnouille

CobbleDollars 插件,用于配置基于命令的商店,非常适合服务器和基于 NPC 的设置

0 本站下载 0 关注 更新于 3 周前

需要前置:CobbleDollars [Cobblemon Addon]

最新 1.1.1 · 1.21.1 · NeoForge

一键开服(送7天)

CobbleDollars Command Shops

CobbleDollars Command Shops 是 CobbleDollars 的插件。它添加了可通过名称打开、并在服务器端完全管理的命令驱动型商店。该模组专为希望在不将游戏控制权移交至客户端的情况下,更好地控制商店行为、库存管理、访问规则和交易日志记录的服务器而设计。

版本 1.1.0 需要 Minecraft 1.21.1、NeoForge 21.1.230 或更高版本,以及 CobbleDollars 2.0.0+Beta-6.1+1.21.1 或更高版本。请在服务器和管理员客户端安装相同版本的插件;其他玩家无需安装此可选客户端插件即可使用商店。 请参阅 1.1.0 更新日志以获取升级说明。

新增功能

  • 多个自定义商店,包含分类和商品项
  • 每个商品项支持自定义价格和数量
  • 有限商品项的按玩家库存机制
  • 无限或有限库存模式
  • 支持按间隔或每日重置规则的自动补货
  • 可选的大批量购买奖励
  • 针对商店、分类和商品项的访问规则
  • 支持玩家标签(tags)、进度(advancements)、维度、时间范围和记分板数值
  • 所有商店共用一个全局银行,或每个商店使用独立的本地银行
  • 通过 item、stack、tag、mod、match.include 和 match.exclude 实现精确的银行与商店匹配
  • 精确的物品堆叠匹配,包括物品数据/组件
  • 运行时启用/禁用商店的控制功能
  • 完整的商店、银行、反馈和审计设置的管理员编辑器
  • 带有自定义失败消息的有序商店/银行访问条件检查
  • 可搜索的审计浏览器,提供统计信息、交易详情和手动更改历史记录
  • 上下文相关的英文/法文帮助、点击音效和本地反馈音效预览
  • 服务器端验证和持久化库存数据

服务器优先

本模组旨在成为服务器权威系统。

它不替代 CobbleDollars 本身,不替代 CobbleDollars NPC,也不将商店逻辑移至客户端。它仅接管通过此插件打开的商店会话。

如果在客户端安装了相同的 jar 文件,模组还可以提供可选的客户端 UI 增强功能。核心商店逻辑仍保留在服务器上。

命令

公共命令:

  • /cdshops open <shop>

管理员命令(权限等级 2):

  • /cdshops admin(需要管理员客户端安装此插件)
  • /cdshops open <shop> <targets>
  • /cdshops reload
  • /cdshops where

管理员面板列出商店,提供运行时启用/禁用控制,并在Banks之后包含一个Stocks选项卡,用于检查、调整和补货玩家库存。可见性变更和库存操作在服务器上立即生效,独立于配置Save。可见性变更和手动库存管理只能通过 /cdshops admin 获得,这需要权限等级 2 以及管理员客户端上安装的插件。

配置更改在未点击Save之前保持在草稿状态,并经过服务器验证和冲突检测。延迟响应会保留较新的编辑和活动的文本输入。以前的 list、visibility、stock、restock 和 stats 命令已被面板取代。

配置

在首次启动服务器时,模组会在以下位置生成其配置文件:

config/cobbledollarscommandshops/
  CONFIG_GUIDE.md
  audit.json
  feedback.json
  global_bank.json
  shops/
    general_store/
      shop.json
    blacksmith/
      shop.json
    explorer/
      shop.json
    syntax_showcase/
      shop.json
      bank.json

交易审计日志写入到:

logs/cobbledollarscommandshops/audit.jsonl

/cdshops admin 中的Audit选项卡异步读取活动的 audit.jsonl 文件和旋转归档的 .jsonl.zip 文件。它提供摘要、可搜索和排序的商店/玩家/物品/商品项统计信息,以及按最新优先的交易日志。所有视图均支持时间段和记录标识符过滤器、分页、详情页、相关交易链接以及显式刷新。审计浏览器为只读模式,并保留配置草稿。以前的 /cdshops stats 命令已移除。默认情况下,管理员手动库存更改和配置编辑会被记录,并且可以在Settings / Audit下独立切换。它们的日志条目包括管理员、受影响的库存或配置值、先前/新状态和操作 ID。配置状态区分了已准备、已应用、失败或回滚的请求;禁用配置历史的操作会在生效前被记录。自动补货和访问拒绝被排除在外。

编写商店和银行的重要文件

如果您想了解如何编写 shop.json 或 bank.json,请从这些文件开始:

  • config/cobbledollarscommandshops/CONFIG_GUIDE.md
    模组首次启动时生成的主要格式参考。
  • config/cobbledollarscommandshops/global_bank.json
    用作所有商店后备方案的默认银行。
  • config/cobbledollarscommandshops/shops/syntax_showcase/shop.json
    展示支持的匹配语法和条件的完整示例商店。
  • config/cobbledollarscommandshops/shops/syntax_showcase/bank.json
    商店特定银行覆盖的示例。

商店特定的银行文件位于此处:

config/cobbledollarscommandshops/shops/<shop_id>/bank.json

如果不存在商店特定的 bank.json,模组将使用:

config/cobbledollarscommandshops/global_bank.json

支持与问题

如果发现错误,请在评论中报告或提交 issue。您也可以直接在 CurseForge/Modrinth 上联系我以提出更具体的问题! 如果您想使用或修改此代码,请先检查许可证。

测试环境:

  • CobbleDollars-neoforge-2.0.0+Beta-6.1+1.21.1
  • Cobblemon-neoforge-1.8.2+1.21.1
  • CustomNPCs-Unofficial-NeoForge-1.21.1.20251230
  • easy_npc-neoforge-1.21.1-7.15.0
  • easy_npc_config_ui-neoforge-1.21.1-7.15.0
  • easy_model_entities-neoforge-1.21.1-2.5.0
  • Kotlin for Forge 5.12.0

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源