小队付款集成
IsekaiTweaks如何连接异界扩展付款与Open Parties and Claims的小队存款。
异界扩展服务通过IsekaiCore的Numismatic门面付款,可选的小队存款桥接由IsekaiTweaks提供;玩家规则见小队付款。本文记录外部集成,不增加异界扩展API。
它做什么
IsekaiTweaks中的NumismaticCompatMixin包装Core的NumismaticCompat.canAfford与tryPay。ITMixinPlugin仅在IsekaiCore、Numismatic Overhaul和Open Parties and Claims同时存在时启用它。Core源码不变,getTotal仍表示个人背包货币与钱囊余额之和。
异界扩展的TradeTransaction、BlacksmithService和StructureSpaceService使用这些付款入口。LodgingDialogue展示房间报价时也调用canAfford,预览与实际付款遵循同一规则。桥接不修改Numismatic钱囊余额的含义,也不覆盖所有第三方货币操作。
运行时模型
Tweaks内部集成服务PartyPayments查询付款人的当前队伍。PartyPaymentPlan用减法计算个人部分和差额,避免合计余额溢出。队伍资产仍由已有的计分板组件保存,没有新增持久字段或迁移逻辑。
Core原付款方法先扣个人部分,顺序为背包钱币、钱囊;成功后桥接才扣金库并同步队伍资产。PartyMessageUpdater向其他在线队友发送可翻译的付款人、支出及余额消息。普通队伍聊天仍向发送人回显。
约定
桥接在服务端线程执行。个人资金足够时直接使用原方法;合计不足时在修改前拒绝,个人扣款失败也不会动用存款。扣款使用付款人的当前队伍,不要求其为队长。
OpacCompat.Server.donateAssets先确认个人资金足以完成整笔捐献。个人余额查询仍只计算个人资金,因此不能循环挪用金库。其他准入、报价、交付和归属校验仍由调用方的异界扩展服务负责。
已按IsekaiTweaks工作区源码、IsekaiCore 0.4.0-build69及Numismatic Overhaul 0.2.18+1.20-fabric核对这些行为。外部事实记录注明了所属源码。
扩展方式
异界扩展代码继续调用Core的NumismaticCompat.canAfford和tryPay。不要在商店、委托或房间服务中另写队伍查询和金库扣款。个人余额显示不能当作合计资金的支付资格判断。
验证
两个仓库分别运行./gradlew.bat compileJava。在实际整合包中检查个人优先、混合资金、纯金库支付、余额不足、溢出及个人扣款失败。
在实际整合包中分别用队长和普通成员验证上述情况。成功使用金库时,其他在线队友各收到一次通知;付款人、离线成员和其他队伍不应收到。重新打开队伍界面并重启服务端,检查余额保持正确。即使金库存款足够,个人资金不足的捐献仍须拒绝;个人资金足够的捐献应成功。退出队伍后,再检查原付款流程。