Kzeroko KTM2

Appraisal globe assets

Rebuilding the cuboid pedestal, spherical OBJ and finite appraisal bloom.

Updated Oct 19, 2026 4 min read

The Appraisal Status Globe combines a cuboid pedestal with a smooth sphere in one static OBJ. The block invokes the existing talent reveal component and a finite Effekseer effect; it has no block entity or animation tick.

What you are making

The block and item share isekaiexpansion:appraisal_status_globe. Runtime models are assets/isekaiexpansion/models/block/appraisal_status_globe.obj, its MTL and model JSON; the item model points to that block model.

tools/art/appraisal_globe/build_model.py owns the geometry and exports both the runtime OBJ and an editable appraisal_status_globe.bbmodel. The generated pedestal has 26 unrotated cuboids. The orb uses 48 segments, 24 rings and radius 4.75 model units. Coordinates stay within one 16-unit block.

Requirements

The build includes io.github.fabricators_of_create.Porting-Lib:obj_loader:2.3.4+1.20.1; Fabric requires porting_lib_obj_loader at least 2.3.4. The model declares porting_lib:obj. Missing the loader prevents this OBJ model from loading.

Five material textures live under textures/block/appraisal_status_globe/: plinth, structure, ornament, gold and crystal. Each is 32×32 with nearest filtering. Pedestal face UVs use 2 texture pixels per model unit, including rotated plinth sides. These are authoring constraints enforced by the generator and review, not general loader limits.

The native effect is isekaiexpansion:studio/appraisal_bloom/appraisal_bloom, compiled for Effekseer runtime version 1810. Its four texture dependencies remain in its exported resources/ directory. Moving those files independently breaks the native dependency paths. The current composition uses native ribbons, a procedural model and soft light sprites; it contains no drawn magic circle or ground seal.

Steps

  1. Prepare materials. Keep the generated atlas and prompt under tools/art/appraisal_globe/. Run python tools/art/appraisal_globe/prepare_textures.py to crop the reviewed material regions, reduce them to 32×32 and quantise them to the fixed palette. The crystal material is retained separately.

  2. Build and inspect. Run python tools/art/appraisal_globe/build_model.py, then python tools/art/appraisal_globe/render_preview.py. Inspect all four views of preview.png for stretching, seams and coplanar faces. The software preview uses the exported geometry and UVs; it is not a Minecraft render.

  3. Rebuild the effect. In KTM2EffekStudio, use project appraisal-globe and run python examples/systems/appraisal/author.py. The browser-reviewed candidate is 3fb23d72129a: 144 frames (2.4 seconds), 23 native nodes including controllers, and no trigger. The author preserves Oni’s native convergence and material choreography, then adds crystal light and gold glints. Export through the official compiler and install the manifest’s complete dependency set, retaining credits and licence notices. tools/art/appraisal_globe/appraisal_bloom.efkproj is an editable source snapshot whose texture paths resolve inside this repository; the adjacent recipe and vfx-manifest.json record provenance and delivery.

Declaring it

IsekaiBlocks registers the non-opaque block with luminance 7 and hardness 3.5. IsekaiBlockItems registers its item; the pickaxe tag and generated loot table handle harvesting. The OBJ model enables flipV, shadeQuads and emissiveAmbient, with automatic culling disabled. Only the crystal material supplies ambient emission.

AppraisalStatusGlobeBlock.onUse runs the reveal on the server. An already-appraised player gets feedback without another effect or sound. First appraisal calls TalentRevealer.revealAll and the internal AppraisalFx presentation helper. The effect spawns at block-bottom centre + 0.68 vertically. Authored and desired convergence-shell diameters are both 3.6 blocks; soft light falloff can extend beyond that shell. Dynamic input 1 controls size. The composition fills three dimensions and its glow sprites face the viewing camera, so no fixed planar circle needs a player-facing transform.

Sound uses the existing shared playback API and tick task manager. Chain contact and amethyst resonance start immediately. At recognition frame 30 — 10 ticks (0.5 seconds) — UI_CHANGE_ORIGIN plays at its normal pitch with a quiet chain-break accent. An amethyst chime follows at frame 54 — 18 ticks (0.9 seconds). Delayed cues skip unloaded chunks; none of them loads a chunk. These are server sound events, not embedded native audio.

The server reserves each globe position before changing reveal state. Its shared cooldown lasts AppraisalFx.durationTicks(): 144 effect frames converted to 48 ticks (2.4 seconds at normal tick rate), including the afterglow. Other players receive a busy message without being appraised or extending the timer. A new appraisal can start on the exact expiry tick. Different globes and worlds remain independent. The internal AppraisalCooldown keeps expiry-ordered reservations and removes expired entries on use; weak world keys avoid retaining unloaded worlds. No block entity or per-tick scan is needed.

Checklist

  • Confirm OBJ vertices remain within the block and all material references resolve.
  • Check the cuboid pedestal and smooth orb in the world and item GUI, with nearest filtering and no mount flicker.
  • Inspect bloom gathering, peak and disappearance against dark and light backgrounds and at size inputs 0.5, 1 and 2.
  • Inspect the currents from the front and side; confirm that no retired circle or ground seal is loaded.
  • Verify installed files against the export manifest and retain the native effect’s texture dependencies.
  • Appraise a player once, then repeat: reveal state must persist and the second use must not replay the bloom.
  • Have two unappraised players use one globe together: only one starts; the other can start at tick 48. Verify another globe remains available during that interval.

Native compilation, dependency checksums and browser review are recorded in tools/art/appraisal_globe/review/2026-10-19/. Minecraft rendering, ground occlusion and the composed sound timing still require an in-game smoke test. The earlier ring studies were rejected and are not visual acceptance evidence.

See Talent runtime for saved reveal state and Talents for appraisal gameplay.