Kzeroko KTM2

鉴定水晶球资产

重建方块式底座、球形 OBJ 与有限时长的鉴定辉光。

更新于 2026/10/19 5 分钟阅读

鉴定水晶球以一个静态 OBJ 组合方块式底座与平滑球体。方块调用现有天赋显现组件和有限时长的 Effekseer 特效,不使用方块实体或逐刻动画。

你要做的东西

方块与物品共用 isekaiexpansion:appraisal_status_globe。运行时模型为 assets/isekaiexpansion/models/block/appraisal_status_globe.obj、对应 MTL 与模型 JSON;物品模型引用此方块模型。

tools/art/appraisal_globe/build_model.py 维护几何源,同时导出运行时 OBJ 与可编辑的 appraisal_status_globe.bbmodel。底座由 26 个未旋转长方体组成。球体采用 48 段、24 环,半径为 4.75 个模型单位。全部坐标保持在一个 16 单位方块内。

前置要求

构建包含 io.github.fabricators_of_create.Porting-Lib:obj_loader:2.3.4+1.20.1;Fabric 要求 porting_lib_obj_loader 至少为 2.3.4。模型声明 porting_lib:obj,缺失加载器会导致此 OBJ 模型无法加载。

五张材质贴图位于 textures/block/appraisal_status_globe/:plinth、structure、ornament、gold 与 crystal。每张为 32×32,使用最近邻采样。底座各面按每模型单位 2 个纹理像素映射,包括旋转后的基座侧面。这是生成器与审查采用的创作约束,不是加载器的通用限制。

原生特效为 isekaiexpansion:studio/appraisal_bloom/appraisal_bloom,编译目标为 Effekseer 运行时版本 1810。四张依赖贴图保留在导出的 resources/ 目录中;单独移动文件会破坏原生依赖路径。当前构图使用原生飘带、程序化模型与柔光精灵,不包含绘制的魔法阵或地面法印。

步骤

  1. 准备材质。将生成图集与提示词保留在 tools/art/appraisal_globe/。运行 python tools/art/appraisal_globe/prepare_textures.py,裁切已审查的材质区域、缩至 32×32,并量化到固定调色板。球体材质单独保留。

  2. 构建并检查。运行 python tools/art/appraisal_globe/build_model.py,再运行 python tools/art/appraisal_globe/render_preview.py。检查 preview.png 的四个视角,确认没有拉伸、接缝或共面重叠。软件预览读取导出的几何与 UV,并非 Minecraft 截图。

  3. 重建特效。在 KTM2EffekStudio 中使用项目 appraisal-globe,运行 python examples/systems/appraisal/author.py。经浏览器审查的候选修订为 3fb23d72129a:144 帧(2.4 秒)、23 个原生节点(含控制节点),无触发器。创作脚本保留 Oni 的原生聚拢运动与材质变化,再加入水晶光芒和金色微光。通过官方编译器导出,安装清单中的完整依赖集,并保留署名及许可声明。tools/art/appraisal_globe/appraisal_bloom.efkproj 是可编辑源快照,贴图路径在本仓库内解析;旁边的配方与 vfx-manifest.json 记录来源和交付信息。

声明它

IsekaiBlocks 注册非不透明方块,发光等级为 7,硬度为 3.5。IsekaiBlockItems 注册物品;镐标签与生成的战利品表处理采集。OBJ 模型启用 flipV、shadeQuads、emissiveAmbient,关闭自动面剔除。仅水晶材质提供环境发光。

AppraisalStatusGlobeBlock.onUse 在服务端执行显现。已经完成鉴定的玩家只收到反馈,不重复播放特效或音效。首次鉴定调用 TalentRevealer.revealAll 与内部呈现辅助类 AppraisalFx。特效生成在方块底部中心向上 0.68 处。聚拢外壳的创作直径与目标直径均为 3.6 格;柔光衰减区域可延伸到外壳之外。动态输入 1 控制大小。构图占据三维空间,柔光精灵朝向观看相机,因此不再需要让固定平面魔法阵转向交互玩家。

音效使用现有共享播放 API 与刻任务管理器。链条碰撞和紫水晶共鸣立即开始;识别帧 30,即 10 刻(0.5 秒)时,以正常音高播放 UI_CHANGE_ORIGIN,并叠加轻微的链条断裂声。紫水晶铃音在第 54 帧,即 18 刻(0.9 秒)跟进。延迟音效跳过未加载区块,不会主动加载区块。这些是服务端声音事件,不是原生特效内嵌音频。

服务端在改变显现状态前,先为该水晶球位置取得使用权。所有玩家共用的冷却时长为 AppraisalFx.durationTicks():将 144 个特效帧换算为 48 刻(正常刻速下为 2.4 秒),包含余辉。其他玩家只收到忙碌提示,不会完成鉴定,也不会延长计时;到期当刻即可开始下一次鉴定。不同水晶球与世界互不影响。内部 AppraisalCooldown 按到期顺序保存使用记录,并在交互时清理到期项;世界使用弱引用键,避免阻止已卸载世界释放。无需方块实体或逐刻扫描。

检查清单

  • 确认 OBJ 顶点位于方块内,所有材质引用均能解析。
  • 在世界和物品 GUI 中检查方块式底座与平滑球体,确认最近邻采样有效,镶座不闪烁。
  • 在深浅背景及大小输入 0.5、1、2 下检查辉光聚拢、峰值和消散。
  • 从正面和侧面检查三维能量流,确认没有加载已退役的魔法阵或地面法印。
  • 按导出清单校验安装文件,并保留原生特效的贴图依赖。
  • 同一玩家先鉴定一次,再次使用:显现状态应保留,第二次不能重播辉光。
  • 两名尚未鉴定的玩家同时使用同一水晶球:仅一人开始,另一人可在第 48 刻开始;期间另一颗水晶球应仍可使用。

原生编译、依赖校验和浏览器审查记录位于 tools/art/appraisal_globe/review/2026-10-19/。Minecraft 渲染、地面遮挡及组合音效的节奏仍需游戏内冒烟测试。先前的圆环方案已被否定,不能作为视觉验收依据。

相关页面

保存的显现状态见天赋运行时;鉴定玩法见天赋。