Q商店附加组件 Confluence兼容

Q Shop Confluence Currency Bridge [Q Shop Addon Confluence Compat]

将一个 QShop 货币绑定到 Confluence: Otherworld 的钱币系统。QShop 商店、命令、任务和脚本都可以使用同一余额，而玩家则以 Confluence 钱币的形式携带这些钱。

功能

• 单一共享余额： QShop 交易使用配置的 Confluence 关联货币。玩家携带的 Confluence 钱币会反映在该余额中。
• 安全溢出： 无法放入物品栏或 Confluence 钱币槽的钱币保留在 QShop 钱包中，并在有空间时转换为实体钱币。
• 物品栏同步： 拾取、丢弃、使用钱币或通过容器移动钱币时，会更新关联余额。
• 离线余额支持： QShop 钱包更改会被保存，并在玩家返回时进行对账。
• Sell Box 集成（可选）： 使用 Confluence 的面额和颜色显示关联货币价格和出售消息。堆叠价格按完整物品堆叠计算。玩家还可以将 Sell Box 定价的物品出售给 Confluence NPC。
• 存钱罐支持： 选择 Confluence 存钱罐是否计入关联余额（默认启用）。

要求

• Minecraft 1.20.1 + Forge 或 Minecraft 1.21.1 + NeoForge
• QShop 1.8.0 或更高版本 — 必需
• Confluence: Otherworld 1.2.0 或更高版本 — 货币桥接所需。该附加模组可以在没有 Confluence 的情况下加载，但其桥接功能将保持未激活状态。
• QShop Sell Box 1.5.0 或更高版本 — 可选；与 Confluence 一起安装后，可使用 Sell Box 价格格式化、出售消息，以及将 Sell Box 定价的物品出售给 Confluence NPC。

共享的 QShop 到 Confluence 余额、实体钱币同步、存钱罐支持和离线对账需要同时安装 QShop 和 Confluence。如果没有 Confluence，QShop 将继续正常工作，并且此附加模组不会将 QShop 余额转换为 Confluence 钱币。

设置

在 config/qshop-confluence-common.toml 中将 bridge.currencyId 设置为你的商店和 Sell Box 价格规则所使用的 QShop 货币 ID。默认值为 coins。如果该货币条目尚不存在，桥接会自动创建它。

bridge.includePiggyBank 控制是否包含存钱罐中的钱（默认：true）。sellbox.confluencePriceFormat 控制 Confluence 风格的 Sell Box 价格显示（默认：true）。

管理员可以使用 /qshopconfluence status 检查桥接及其余额，或使用 /qshopconfluence set <amount> 设置其关联余额。

余额说明

• 配置的 QShop 货币是共享余额。Confluence 钱币是其可携带的实体部分；无法放入的部分保留在 QShop 钱包中。
• Confluence 钱币仍然遵循 Confluence 的死亡掉落行为。默认情况下，桥接会跳过 QShop 对关联货币的单独死亡货币扣除，以避免重复扣费。
• QShop 支持小数价格。任何小于一枚铜币的金额都会作为小数余额保留在 QShop 钱包中。

许可证：ARR — 保留所有权利。

---

QShop Confluence Currency Bridge

将一个 QShop 货币绑定到 Confluence: Otherworld 的钱币系统。QShop 商店、指令、任务和脚本可以共用同一余额，玩家则以 Confluence 钱币的形式携带其中一部分。

功能

• 共用余额： QShop 交易使用已绑定的货币；玩家身上的 Confluence 钱币也计入该余额。
• 安全处理溢出： 背包或 Confluence 钱币栏装不下的钱保留在 QShop 钱包中，有空间时再转换为实体钱币。
• 同步钱币变动： 拾取、丢弃、使用钱币或通过容器移动钱币时，绑定余额会同步更新。
• 支持离线余额： QShop 钱包变化会保存下来，并在玩家重新加入时对账同步。
• 出售箱联动（可选）： 绑定货币的价格和出售消息使用 Confluence 的面额与颜色；价格按整组物品计算。玩家也可以向 Confluence NPC 出售由出售箱定价的物品。
• 支持存钱罐： 可设置是否将 Confluence 存钱罐余额计入绑定余额（默认开启）。

依赖

• Minecraft 1.20.1 + Forge 或 Minecraft 1.21.1 + NeoForge
• QShop 1.8.0 或更新版本 — 必需
• Confluence: Otherworld 1.2.0 或更新版本 — 货币桥接功能必需。未安装时模组仍可加载，但桥接功能不会启用。
• QShop Sell Box 1.5.0 或更新版本 — 可选；安装 Confluence 和 Sell Box 后，才能使用出售箱价格格式、出售提示格式，以及向 Confluence NPC 出售出售箱定价物品的功能。

QShop 与 Confluence 都安装时，才能使用共用余额、实体钱币同步、存钱罐支持和离线余额对账。缺少 Confluence 时，QShop 仍可正常运行，但本模组不会把 QShop 余额转换为 Confluence 钱币。

配置

在 config/qshop-confluence-common.toml 中，将 bridge.currencyId 设为商店和出售箱价格规则使用的 QShop 货币 ID。默认值是 coins；如果货币条目不存在，桥接会自动创建。

bridge.includePiggyBank 控制是否计入存钱罐余额（默认：true）。sellbox.confluencePriceFormat 控制出售箱是否使用 Confluence 的价格格式（默认：true）。

管理员可在游戏中使用 /qshopconfluence status 查看桥接状态和自己的余额，或使用 /qshopconfluence set <amount> 设置自己的绑定余额。

余额说明

• 已绑定的 QShop 货币是共用余额；Confluence 钱币是其中可随身携带的部分，放不进背包或钱币栏的金额保留在 QShop 钱包中。
• Confluence 钱币仍按 Confluence 的规则掉落。默认情况下，桥接会跳过 QShop 对绑定货币的死亡扣除，避免同一笔钱被重复扣除。
• QShop 价格可以包含小数；不足一枚铜币的部分会作为小数余额保存在 QShop 钱包中。

许可证：ARR（保留所有权利）。