RetroAPI

The retroapi entrypoint, particles, and world features.

• New retroapi / retroapi-client / retroapi-server entrypoints (RetroModInitializer.initRetro()). RetroAPI invokes them at the one point where registration is safe: registries/tags/lang ready, vanilla's Block/Item/Stats static-init cycle entered from the safe side, before RetroAPI's own registration events, before recipes are sorted, and before any world assigns ids. The loader's init stage has no defined order, so a consuming mod could register into a platform that was not built yet. They also fire identically with and without StationAPI, which the registration events do not. init keeps working.
• Fixed: recipes that silently stopped working. An ItemStack stores a numeric id, and mods build them at init, when ids are still provisional; the real ids arrive from a world's id_map.dat or a server's sync. Stale stacks left recipes in the list with the right count and no matches, which is why relaunching sometimes "fixed" it. Id changes are now collected into an IdRemap that repairs crafting/smelting recipes, fuels and achievement icons, fires IdRemapCallback for mod-held stacks, and re-sorts the crafting list.
• Fixed: modded tools could not break modded blocks (and vanilla tools could not break modded stone). Beta answers tool effectiveness from hardcoded block lists inside each vanilla tool. Blocks with no mineable tag now infer one from their material, and Item.isSuitableFor is answered from tags + tier, so drops, breaking speed and the correct-tool check agree. Leaves are mineable by shears/sword/hoe as a result.
• Fixed: interface injection never applied on Ornithe. The loom:injected_interfaces keys were babric-era intermediary names; the gen2 build matched nothing, so consumers had to cast. Both namespaces are declared now.
• Fixed: .states(...) after .facing() dropped the facing property; blocks with more than 16 states truncated to the metadata nibble when broken and replaced; Block.setUnbreakable() was unreachable (now .unbreakable()).
• Particles: RetroParticleRegistry + RetroParticles + RetroSpriteParticle, and a server→client bridge (vanilla's server-side addParticle is an empty method, so server-spawned particles reached nobody).
• World features: RetroFeatures.ore/cluster/custom with count, height range, rarity, dimension filter, and for ores size/meta/replace. Hooked on the chunk cache, so vanilla dimensions, modded dimensions and custom generators are all covered; deterministic per seed.
• Blocks: per-face textures in code (.sided, .column, .textures), .facingAll() six-way facing, .tint(...) per-position color with no model, .overlay(...) extra render passes, .tag(...), .needsTool(...), and RetroCharProperty.
• Tools: built from parameters instead of a (non-extensible) ToolMaterial. .miningSpeed, .attackDamage, .durability, .damageOnMine plus a block-aware RetroToolTier.Contextual.
• Positions & multiblocks: RetroVec3i, RetroDirection, RetroMultiblock (ASCII patterns, any rotation), and BlockEntityLoadedCallback, which fires once NBT is read and the world exists.
• Custom renderers: BlockRenderContext gained spriteOverride, flipTexture, faceRotation, renderAllFaces, renderFaceUv and renderFaceCorner, enough for connected textures without bounding-box tricks.
• Logging: registration, id assignment, tag/lang/sound loading, atlas expansion and id sync moved to debug. A launch now prints one line.

Full feature set: https://matthewperiut.github.io/retroapi/features-0.3.0.html

Built and validated with -Pstationapi on Ornithe (b1.7.3). All features exercised by the headless populate self-check (14 [new-features] PASS, populate: PASS).