MilkyWayLib

1.0.2 — 2026-09-11

API Changes

• Added net.galaxihd.milkywaylib.text.MilkyText fluent per-character text renderer: independent base color and glow-halo color, per-character sinusoidal wave bob, and a scrolling per-character color gradient hook (gradient(IntUnaryOperator, float)) with fireGradient()/frostGradient() ready-made examples
• Added net.galaxihd.milkywaylib.client.input.SprintLock (+ mixin.client.MixinLocalPlayerSprint): client-side Predicate<LocalPlayer> registry that vetoes sprinting the way vanilla's own Blindness effect does — cancels LocalPlayer#canStartSprinting() and force-stops an already-sprinting player at the top of aiStep(), both purely client-side so there's no server-correction jitter
• Added net.galaxihd.milkywaylib.particle.ParticleEasing for smooth mathematical interpolation curves (linear, quad, cubic, sine, exponential, bounce, fade, pop-and-fade)
• Added net.galaxihd.milkywaylib.particle.ParticleCurves for color gradient sampling and RGB lerping
• Added net.galaxihd.milkywaylib.particle.ParticleSpawner fluent particle emitter builder supporting bursts, lines, rings, shockwaves, spheres, helixes, and cones across client and server levels
• Added net.galaxihd.milkywaylib.particle.ParticleFactoryRegistry for simple particle type registration
• Added net.galaxihd.milkywaylib.client.particle.ParticleOrientation supporting camera billboard, flat horizontal, upright Y-axis billboard, and velocity-aligned quad orientations
• Added net.galaxihd.milkywaylib.client.particle.MilkyParticleRenderTypes providing additive blending and custom translucent particle render sheets
• Added net.galaxihd.milkywaylib.client.particle.MilkyParticle enhanced base texture particle supporting orientation modes, additive/translucent rendering, scale/alpha/color easing curves, bounce physics, spin, turbulence, and target homing
• Added net.galaxihd.milkywaylib.client.particle.CustomMeshParticle for procedural 3D mesh and BufferSource particle rendering
• Added net.galaxihd.milkywaylib.client.particle.MilkyParticleProvider functional interfaces and registration helpers for RegisterParticleProvidersEvent
• Added net.galaxihd.milkywaylib.fluid.FluidSplashEffects and net.galaxihd.milkywaylib.mixin.entity.MixinEntityFluidSplash: register a custom FluidType with bubble/splash particles and get vanilla-style splash effects on entity entry for free, without touching vanilla's own doWaterSplashEffect
• Removed PotionContents parameter and manual potion tinting override from BERFluidRenderer.renderFluidBox in favor of standard FluidStack / IClientFluidTypeExtensions tint resolution
• Added math.IcosphereMesh — procedural icosphere mesh generator (verts/uvs/index buffer) for low-poly sphere rendering with no baked model
• Added client.render.RibbonMeshBuilder — procedural quad-strip ribbon mesh (wing/cape/silk/cloth) swept around an axis with a per-segment wave offset
• Added client.fx.PostChainDepthAccess (+ mixin.client.MixinPostChain) — exposes a PostChain's pass list so a shader can be bound an arbitrary depth sampler
• Added client.fx.StatusShaderEffectRegistry — registry of full-screen PostChain effects gated on a live intensity supplier, with GameTime/FadeInTest uniforms driven automatically
• Extended FluidBuilder fluent API with custom factory hooks for bucket items (bucketFactory), custom fluid types (fluidTypeFactory), fluid source/flowing subclasses (sourceFactory, flowingFactory), and custom client extensions (clientExtensions)
• Added DyeColorHelper.dyeItemForColorName(String) — the reverse of the existing getColorName(ItemStack): resolves the DyeItem for a color name string, checking the vanilla DyeColor enum first and falling back to scanning for a #c:dyes/<colorName>-tagged item for a genuinely modded color name

Bug Fixes

• Fixed MineableEntityAPI.getMineableData's raw-NBT scan (saveWithoutId) crashing/desyncing other mods' entities that aren't fully initialized yet when it runs from isMultipartEntity on client entity tracking-start (e.g. Create contraptions on dedicated servers, where ControlledContraptionEntity.writeAdditional throws NPE before controllerPos is set); the failure is now caught and treated as "no raw NBT," matching the surrounding attachment/manager lookups instead of propagating out and killing the entity's initialization
• Fixed several bugs with collapsible creative-tab item groups: category layout and section headers corrupting on expand/collapse, the scrollbar position desyncing after a toggle, the search tab showing group badges/slot borders over unrelated items (items are now strictly isolated to category tabs and everything is searchable), and the +/- toggle having no click sound (now plays the vanilla wooden button click, on/off variant matching direction)
• Removed MineableCrumbleLayer's deprecated explicit event-bus selector; NeoForge now routes IModBusEvent listeners automatically
• Fixed ProceduralChunkGenerator's edge cache retaining every previously visited dimension's data for the life of the game session instead of releasing it when a dimension unloads