鞣革运行时
持续保存的皮革几何、工作站持有与服务端接触判定。
鞣革采用持续保存的世界加工流程。HideWork 是纯材料状态机,HideWorkpiece 将其保存到随身物品,TanningStationOperations 执行服务端工作站操作。
共用注液逻辑计算可容纳的整桶数前,也会计入已扣除且正在浸淬的一次用水量。
它做什么
鞣革桶在装入时扣除水、鞣剂和生皮。刮皮台接触会去除残膜或实际皮面格。绷皮架的张力和已加载世界晾干会影响精整前的皮面损伤。皮革鞣制说明玩家操作顺序。
运行时模型
ise_hidework 保存配方 ID、制作者、色调、阶段、完好与残膜位图、四角张力、缺陷次数、已完成的边段数(finished_sides)、涂蜡与晾干进度。64 位网格表示 8×8 皮面。SOAK、FLESH、STRETCH、FINISH、DONE、RUINED 是显式阶段。无效存档几何会判为报废,不会恢复材料。
工作站状态保存浸泡时间和操作节奏,随身状态保存永久损伤和晾干进度。转移不能复制材料或清除缺陷。浸泡和晾干仅在加载时推进,不会通过离线补算悄悄完成或损坏皮革。
约定
使用操作要求主手、非旁观者、服务端判定及权限检查。服务端重新构造 5 格接触射线,客户端坐标不能指定皮面格。工作站一般有 4 刻使用间隔。空手搅拌从上次有效转桨起单独计时 20 刻。只有刮膜使用重复的 40 刻节奏。服务端和叠加界面共用 TanningBath 的木桨就绪与提皮判定。
BeamFinishing 将原版主手持续使用动作绑定到台上的皮张。服务端每刻核对玩家、工具、权限以及完好皮面上的实际接触点。LeatherPattern 定义加工轮廓。每圈有 8 段,每完成一段就将进度写入皮张。客户端收到当前边段的起始时间,据此播放工具动作。读档后工作台处于松手状态。每圈最后一段完成时才扣工具耐久。
原版主手持续使用状态由服务端启动。旁观客户端根据同步的边段绘制工具动作。即使玩家在收到持具确认前松手,客户端也会发出原版停止使用数据包。
取回时先清空工作站,再交付物品堆。成品取回只触发一次 PlayerTanningEvents.ON_LEATHER_TANNED 和任务配方记录,结果等级由当前配方封顶;该事件仍属于内部入口。工作站替换时散落所存工件,没有临时玩家会话持有生皮。
ArtisanTanningOverlay 在游戏线程采集不可变快照,并将更新合并提交至 ModernUI 线程。不可聚焦窗口沿用原有绘制进度槽与游标,隐藏后停止动画重绘;不拦截攻击或使用输入,也不提交小游戏动作。WorkpieceMesh 在动画 workpiece 骨骼上仅绘制完好皮面格;绳结骨骼反映已存张力。这是已编排骨骼动画配合几何变化,不是布料模拟。
ArtisanInteractions 在原版持物潜行跳过方块交互之前处理工作站操作。服务端接触与叠加提示共用 ArtisanCoordinates.rackCorner。绷皮架使用贴近悬挂平面的薄轮廓;绳结索引考虑 GeckoLib 的 X 轴镜像。晾干要求张力均衡,放松不会增加损伤。
扩展方式
通过鞣革配方数据定义生皮、用量、等级上限、难度和色调,通过物品标签添加鞣剂。不可逆材料变化放在 HideWork,工作站策略放在 TanningStationOperations,渲染不得更改玩法状态。
验证
运行 gradlew.bat -I tools/artisan/gametest.gradle runArtisanTest,检查已加载世界中的材料扣除、方块实体与锻钳存档、掉落守恒及完整制革工序。还覆盖四个绷皮架朝向的实际使用回调、容器精确转移及一个液体源对应一桶的守恒。完整工序还检查立即起桨、延后搅拌、松手中断、单人持具、裁边存档和工具磨损。
运行 gradlew.bat -I tools/forgery/verify.gradle checkArtisanLogic。检查无损完成、各阶段损伤、四角绳结、暂停后时机、存读档、工作站替换和玩家间转移。检查四个朝向的世界接触和不同 GUI 比例下的复用叠加提示;在游戏中观察悬挂皮革的实际孔洞与工具提示。