SF:商店

SF:商店

🛒 为Minecraft提供的方块商店:出售物品换取金钱(CobbleDollars)或以物易物。玩家商店和无限库存的管理员商店。Fabric和NeoForge。

🛒 可放置在任意位置的商店:出售换钱或交换物品。

SkyFramework Shops 为 Minecraft 1.21.1 添加了两种商店方块:玩家商店(拥有真实库存,任何人都可以合成)和管理员商店(库存无限,适合大厅和出生点)。每笔交易都使用金钱(来自经济模组,如果你安装了的话)或通过物品以物易物来支付。

它在有或没有 Cobblemon 的情况下都能工作:不需要经济模组,在未安装任何经济模组时,商店直接使用以物易物。

ℹ️ 这是由 SkyFramework 制作的第三方模组。它不是 Cobblemon 或 CobbleDollars 的官方项目。

✨ 特性

  • 🧑‍🌾 玩家商店:可合成并放置在任意位置。放置它的玩家即为所有者,只有所有者(或管理员)才能打开其管理面板或破坏它。
  • ♾️ 管理员商店:库存无限,不可合成(通过命令给予或从创造模式标签页获取)。非常适合出生点和大厅商店。
  • 💰 每笔交易可选金钱或以物易物:使用金钱(CobbleDollars 及其他支持的经济模组)支付,或每笔交易最多使用 3 种不同物品支付。
  • 📦 真实库存:所有者填充 54 格库存。当某笔交易售罄时,顾客仍能看到它,但按钮会被锁定并显示 "Sin stock" / "Out of stock"(缺货),如果所有者在线上还会收到聊天警告。
  • 🔢 一次购买多个:使用 −、+ 和 Max 选择购买数量,并在付款前查看总价。
  • ✅ 付款前确认:在你按下 确认购买 之前不会扣费,因此你不会误购。
  • 🗃️ 收入箱:顾客支付的款项(金钱和以物易物换来的物品)即使所有者在离线时也会保存在商店中。所有者可以收取物品并提取金钱。收入箱有 54 格。
  • 🛡️ 破坏商店不会丢失任何东西:商店物品内部保留其交易、库存和收入(类似潜影盒),并直接进入你的背包。再次放置即可恢复一切。
  • 🌍 英语和西班牙语翻译。

🎮 使用方法

所有者(玩家商店)

  1. 合成一个商店并放置它。
  2. 右键点击它打开管理面板。
  3. 使用 + 创建一笔交易。将要出售的物品放在顶部槽位(它是模板,因此不会消耗你的物品)。
  4. 选择价格:金钱(输入金额并按 Fix)或 物品(最多 3 个模板槽位)。
  5. 填充库存:Shift + 点击背包中的物品,将其送入库存。
  6. 随时打开 收入箱 收取你的收益。

顾客

  1. 右键点击商店查看它出售的所有物品。
  2. 在某笔交易上按 购买,使用 − / + / Max 选择数量,并核对总价。
  3. 按 确认购买。

🛠️ 合成配方(玩家商店)

 E      E = 绿宝石
PCP     P = 任意木板,C = 木箱,G = 玻璃块
PGP

配方可以通过数据包更改(data/sf_shops/recipe/player_shop.json)。

💬 命令(权限等级 2)

命令 作用
/sf_shops give admin [players] [amount] 给予管理员商店
/sf_shops give player [players] [amount] 给予玩家商店
/sf_shops reload 重新加载配置并再次检测经济模组
/sf_shops economy 显示当前使用的经济模组

管理员商店:右键点击浏览,空手 Shift + 右键点击进行管理(仅限管理员)。

⚙️ 配置

配置文件:config/sf_shops.json(Fabric 和 NeoForge 格式相同)。

选项 作用
maxOffers 每个商店的最大交易数
moneyEnabled false 完全禁用金钱支付
economy auto、cobbledollars、common_economy_api、numismatic 或 none
commonEconomyCurrency 使用 Common Economy API 时的货币 id
barterMatchComponents 精确以物易物(物品 + 组件)或仅物品类型
notifyOwnerOutOfStock 交易售罄时向所有者发送聊天警告
explosionProof 玩家商店抵抗爆炸(管理员商店始终抵抗)
purchaseCooldownTicks 同一玩家两次购买之间的最小刻数

💱 支持的经济模组

以下全部为可选并自动检测:

  • CobbleDollars(Fabric 和 NeoForge)
  • Common Economy API(Fabric):任何实现它的金钱模组均可使用
  • Numismatic Overhaul(NeoForge)

🔒 安全购买

  • 所有内容都在服务端计算和检查。客户端只请求 "购买交易 N,数量 Q"。
  • 每笔购买都是原子操作:要么完全成功,要么不产生任何变化。
  • 如果买家的背包已满,购买会被阻止,且不会掉落任何物品到地上。
  • 防连点保护,商店在重启和区块卸载后仍能保留。
  • 漏斗无法插入或提取物品。活塞永远不会移动商店,凋灵和末影龙也无法破坏它们。

📦 需求

Minecraft 1.21.1 和 Java 21。安装在服务端和客户端。Fabric 和 NeoForge 有各自独立的文件。

🧵 Fabric

  • Fabric Loader 0.19.3+
  • Fabric API

🔥 NeoForge

  • NeoForge 21.1+

不需要其他模组。Cobblemon 和经济模组均为可选。

📝 说明

  • 没有经济模组时,金钱选项会被隐藏,只能使用以物易物。
  • 两个版本行为相同,并共享相同的配置格式。

📄 许可证

GPL-3.0。