Skip to content

Changelog

What changed in every release of CoolCatLib, for each Minecraft version. CoolCatLib was two mods for a while, CoolCatLib: Core and CoolCatLib: Canvas; Core's releases are part of CoolCatLib's list, and Canvas's own releases, up to the merge, are listed after it. The page is built from each version branch's changelogs, so it's always up to date. Downloads are on CurseForge and Modrinth.

Latest releases

Mod Minecraft Version Status
CoolCatLib 26.3 9.0.0 Nov 16, 2026
CoolCatLib 26.2 9.0.0 Nov 16, 2026
CoolCatLib 26.1 – 26.1.2 9.0.0 Nov 16, 2026
CoolCatLib 1.21 – 1.21.1 9.0.0 Nov 16, 2026
CoolCatLib 1.20.1 9.0.0 Nov 16, 2026
CoolCatLib: Canvas (until the merge) 26.3 26.1.2-7 Oct 5, 2026
CoolCatLib: Canvas (until the merge) 26.2 26.1.2-7 Oct 5, 2026
CoolCatLib: Canvas (until the merge) 26.1 – 26.1.2 26.1.2-7 Oct 5, 2026
CoolCatLib: Canvas (until the merge) 1.21 – 1.21.1 2100.1.2.0 Oct 13, 2026
CoolCatLib: Canvas (until the merge) 1.20.1 2001.1.2.0 Oct 13, 2026

What's new

CoolCatLib 9.0.0 — Nov 16, 2026
  • ModCommands (api.command): registers a mod's server commands with its mod id and the command's names, the first its own and the others aliases that work the same, e.g. ModCommands.register("ftbultimineaddition", List.of("ultimine_addition", "ua"), (root, context, selection) -> root.then(...)). A name another command already has (vanilla's /tm, another mod's) is skipped, with a warning in the log. ModCommands.registerClient(modId, names, (root, context) -> ...) does the same for client commands. Instead of names, a client command can take its server command's: ClientNames.MERGED shares them (one /folios for players: what the client's parts can run stays on the client, the rest goes to the server), ClientNames.SUFFIXED adds _client (/ua_client beside /ua).
  • Every mod with CoolCatLib configs gets a config command under its own commands: /<command> config opens the mod's config screens and /<command> config <config> one of them (/folios config client). Anyone can open them; what they may change is still up to each config's edit permission.
  • /<command> config reload [config] reads the mod's config files again after they were edited by hand, without restarting (for operators): the server's configs on the server, the player's client configs on their own game.
  • /coolcatlib config [mod] [config] and /coolcatlib config reload [mod] [config] do the same for any mod, and on servers without CoolCatLib the player's own game does it.
CoolCatLib: Canvas (until the merge) 26.1.2-7 — Oct 5, 2026
  • Camera shake (api.client.camera.CameraShake): CameraShake.shake(degrees, ticks) for a jolt, shake(origin, radius, degrees, ticks) for one that is strongest at a place and gone at its radius, and add(new Shake(...)) for a curve of the mod's own (a swell, a rumble). Shakes add up, are capped, and follow the game's "Distortion Effects" accessibility slider; CameraShake.setScale is for a mod's own option. From the server: api.vfx.ShakeControl.shake(level, origin, radius, degrees, ticks) or shake(player, degrees, ticks).
  • Camera zoom (api.client.camera.CameraZoom): CameraZoom.set(factor) narrows the view smoothly, as through a real lens, and slows the mouse by as much so aiming stays steady; reset() puts it back, and ease(perTick) sets how heavy the lens feels. CameraZoom.scroll(active, min, max, step) hands the mouse wheel to the zoom while a condition holds (a lens raised), leaving the hotbar alone.
  • Scene viewports (api.client.viewport.SceneViewport): a small 3D scene of blocks, whole structures and entities drawn to a texture of its own, from a camera that circles it and can spin. It is drawn by the game's own renderers with the game's own UI lighting, and only when its scene or camera changes (or a set number of times a second while it moves). Show it in a screen with SceneViewportWidget (drag to turn, scroll to zoom), or on any face in the world through texture().
  • HUD takeover (api.client.gui.HudTakeover): HudTakeover.register(id, active, view) hides the game's HUD while a condition holds and draws a view of the mod's own in its place: a scope, a lens, a visor.
  • Bloom, with no assets: ScreenEffects.bloom(id, intensity).enable() makes bright parts of the frame glow into what is around them, so world effects, fire and lava read as light. It is a screen effect like any other (fades, strength, conditions, enableFor for a surge). The definition is coolcatcanvas:bloom (ScreenEffects.BLOOM), with the uniforms BLOOM_THRESHOLD, BLOOM_INTENSITY and BLOOM_RADIUS.
  • Shader materials for world effects: VfxMaterial.withShader(id) draws a material with a fragment shader of the mod's own (assets/<namespace>/shaders/<path>.fsh) in place of the textured one, for what a texture cannot do. The shader gets the quad's UVs and colour, the scene's depth and coolcatcanvas:vfx.glsl. VfxDraw.quad(a, b, c, d, u0, v0, u1, v1, argb) takes any UV range, which is how a shape passes its own numbers to its shader.
  • Rifts (api.client.vfx.WorldRifts, RiftSpec, Rift): a tear in the air drawn by a built-in shader (VfxMaterial.RIFT_SHADER) and run through three acts. It opens with a flash, its opening sound and a shake of the camera nearby, overshooting and settling; while open its edge crawls and crackles, a starry elsewhere drifts inside it, motes are drawn into it and its ambient sound loops; it closes to a line and snaps shut with a ring of light and its closing sound. WorldRifts.open(spec, position) stays until rift.close(); open(spec, position, ticks) closes by itself. A RiftSpec sets size, colour, timings, the three sounds, the motes and the shake. From the server: api.vfx.RiftControl.open(level, spec id, position[, ticks]) and close(level, id) for rifts the clients registered with WorldRifts.register; RiftControl.DEFAULT needs no registering.
  • Cutscenes (api.cutscene, api.client.cutscene): a camera flown along keyframes while the player watches. A Cutscene is plain data, the same on both sides: built in code (Cutscene.builder()), read from assets/<namespace>/cutscene/<path>.json, made in the in-game editor, or sent whole by the server.
  • Keyframes (CameraKeyframe): a time, position, yaw, pitch, roll (a dutch angle) and field of view (zoom), each reached along a smooth curve through its neighbours, a straight line or a cut (Interpolation), paced by any Easing.
  • Around the camera: letterbox bars framing an aspect ratio (letterbox(), 2.39 by default) that slide in and out, fades to any colour (fadeIn, fadeOut, or a ValueTrack for fades in the middle), subtitles, and markers that fire CutsceneEvents.MARKER on a beat.
  • CameraFocus keeps the camera looking at a point, an entity or the player for a stretch, turning to it and back; blendIn / blendOut glide from and to the player's own view; CutsceneAnchor measures a cutscene from the world or from the player, so one orbit plays anywhere.
  • Playing (Cutscenes.play(id) or play(cutscene), playAt(...) for an origin of its own): hides the HUD and hand, draws the player's body, and holds the player still, each by the cutscene's own settings. The CutscenePlayback it returns can pause, seek, change speed, stop, and tell when it ends. Players skip a skippable one by holding a key (Enter by default); pausing the game pauses it.
  • From the server (CutsceneControl): play(player, id), play(player, id, cutscene) to send one the client doesn't have, playAt, stop, and ServerCutsceneEvents: STARTED, TICK (every server tick a player watches), KEYFRAME and MARKER (as the player's client reaches them) and ENDED with how it ended (finished, skipped, stopped, replaced, left).
  • Events (CutsceneEvents, client): BEFORE_START (cancellable), STARTED, TICK while it plays, KEYFRAME as the camera reaches each one, MARKER, SUBTITLE, PAUSED, CAMERA (every frame, may hand back a changed camera), BEFORE_SKIP (cancellable) and ENDED with the reason.
  • editable(false) keeps a mod's cutscene out of the in-game editor; registered from code, it can't be replaced by a resource pack either.
  • Letterbox.show(aspect, ticks) / hide(ticks) for bars without a cutscene.
  • An in-game editor (Cutscenes.openEditor(), a key unbound by default, and /coolcatcanvas_client cutscene editor in development environments): fly to a spot and press K to drop a keyframe, with the path drawn in the world (a dot a tick, so spacing shows speed). Its screen has a timeline to scrub and drag keyframes on, the selected keyframe's numbers, easing and path, the scene's letterbox, blends, fades and end hold, a live preview through the camera at the playhead, and Play. It saves JSON to config/coolcatcanvas/cutscenes/, playable as coolcatcanvas:saved/<name> and ready to copy into a resource pack. Focuses, subtitles and markers are kept when a cutscene is loaded but are edited in the file.
  • OBJ models (api.client.model.ObjModel, ObjModels): Wavefront .obj files drawn in the world by the game's own renderers, so they are lit, fogged and sorted as anything else. ObjModels.get(id) reads any file under assets/ (kept, and read again when resource packs reload); ObjModel.parse(text) reads one from anywhere. Faces of any number of corners, negative indices, missing texture coordinates and missing normals (a flat one is worked out) are all read; o, g and usemtl split a model into named parts, each of which can be drawn by itself with its own texture, tint, light and pose. model.submit(pose, collector, renderType, light) from an entity or block entity renderer, or render(pose, vertexConsumer, ...) into any buffer, with the entity render types (entityCutout, entityTranslucent, eyes). Materials (.mtl) are not read: the caller picks the texture.
  • api.utils.Easings: the easing curves by name (byName, nameOf, CODEC, register for a mod's own), for files, commands and packets.
  • More Easing curves: SMOOTH, QUART_IN / OUT / IN_OUT, EXPO_IN_OUT, BACK_IN, BACK_IN_OUT, ELASTIC_OUT and BOUNCE_OUT.

CoolCatLib

9.0.0 — Nov 16, 2026

✨ New Features - Block entity renderers (coolcatcanvas.api.client.blockentity), as on 26.1.2: BlockRenderer, a base that leaves a mod to write only what it draws (newState, extract, render), culled by distance and view (viewDistance, bounds), drawn in less detail farther off (detail bands, reach), its states reused, turned to its block's facing (facing), with layers drawn with it (ItemLayer for floating items, LabelLayer for text, ChildLayer for other renderers). Press F3 + B to see each one's bounds, colored by its detail. - ArmatureBlockRenderer is a BlockRenderer: every setting above works on it and chains with its own (.detail(...).animate(...)), bounds grow from the armature's own, and a subclass draws more with newState, extract and render. It is culled out of view by the armature's bounds, and with detail bands set it animates every other frame at REDUCED and every fourth at MINIMAL, without its attachments. - ModCommands (api.command): registers a mod's server commands with its mod id and the command's names, the first its own and the others aliases that work the same, e.g. ModCommands.register("ftbultimineaddition", List.of("ultimine_addition", "ua"), (root, context, selection) -> root.then(...)). A name another command already has (vanilla's /tm, another mod's) is skipped, with a warning in the log. ModCommands.registerClient(modId, names, (root, context) -> ...) does the same for client commands. Instead of names, a client command can take its server command's: ClientNames.MERGED shares them (one /folios for players: what the client's parts can run stays on the client, the rest goes to the server), ClientNames.SUFFIXED adds _client (/ua_client beside /ua). - Every mod with CoolCatLib configs gets a config command under its own commands: /<command> config opens the mod's config screens and /<command> config <config> one of them (/folios config client). Anyone can open them; what they may change is still up to each config's edit permission. - /<command> config reload [config] reads the mod's config files again after they were edited by hand, without restarting (for operators): the server's configs on the server, the player's client configs on their own game. - /coolcatlib config [mod] [config] and /coolcatlib config reload [mod] [config] do the same for any mod, and on servers without CoolCatLib the player's own game does it.

🔧 Changes - Breaking: Canvas's GUI and render helpers moved to tidier packages under net.ixdarklord.coolcatcanvas.api.client: gui.components and gui.components.widgets to gui.widget, gui.components.widgets.panel to gui.panel, gui.components.animations to gui.animation, utils.ScreenAnchor to gui.placement, utils.TextEffects to text, and utils.RenderUtils, Outline and NineSliceInfo to render. The class names are the same; mods using them update their imports. - CoolCatLib's visuals are a mod of their own again, CoolCatLib Canvas (coolcatcanvas), and it comes inside CoolCatLib's jar: nothing more to install. Mods built on its API need net.ixdarklord.coolcatlib:coolcatlib-canvas-<loader> beside coolcatlib-<loader> (CoolCatLib's POM names it). - Canvas's namespace is coolcatcanvas: its shaders and includes (#moj_import <coolcatcanvas:screen_effect.glsl>), text effects (coolcatcanvas:rainbow, coolcatcanvas:gradient/...), the armature item model type (coolcatcanvas:armature), its built-in effects (coolcatcanvas:tint, coolcatcanvas:bloom), lang keys, key bindings and payload ids. Resource packs and mods that name these with coolcatlib: need the new name. The effects screen's choices and saved cutscenes move to config/coolcatcanvas-screen-effects.json and config/coolcatcanvas/cutscenes/, carried over from where they were. - The config screens' look belongs to CoolCatLib itself: ConfigEffect and ConfigEffects moved to net.ixdarklord.coolcatcore.api.config.client, and the dark or light choice is saved in config/coolcatlib-style.json. - Needs Glazed Menu 1.2.2 or newer when it's installed: older ones look for the config screen effects where they were. - /coolcatlib_client is gone: the client's config command is part of /coolcatlib (on servers without CoolCatLib), and the visuals' commands are /coolcatcanvas effects and /coolcatcanvas cutscene .... - The config commands no longer get, set or reset values or apply presets from the chat (/coolcatlib config <id> get|set|reset|preset): they open the config screens, where all of that is done. - CommandEvents.REGISTER and ClientCommandEvents.REGISTER are deprecated: use ModCommands (register and registerClient). Commands registered through it still work, and still get the config command: they're matched to the mod whose configs are built in the same packages. - The renderer registries moved to Canvas, beside its renderers, in net.ixdarklord.coolcatcanvas.api.client.registry: BlockEntityRendererRegistry, EntityRendererRegistry, and ItemRendererRegistry (was SpecialModelRendererRegistry; registers item model types drawn by code). The ones in net.ixdarklord.coolcatcore.api.client.registry still work but are deprecated.

🐛 Bug Fixes - A mod's server command no longer stops working when the mod also has a client command of the same name (/folios config beside the client's /folios guide): what only the server's command can run now goes to the server instead of failing on the client as an incorrect argument.

8.2.0 — Nov 10, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on every loader: - EntityEvents.SPAWN: a new mob is about to be added to the world (spawned naturally or with a new chunk, by a spawner, a spawn egg, a command, breeding, a conversion), with why it was made; interrupt to keep it out, with its passengers. EntityEvents.MOUNT: an entity is about to ride another (interrupt to keep it off), or got off one. - PlayerEvents.OPEN_MENU: a player is about to open a menu: a block's, an entity's, an item's, or one another mod opens with extra data; interrupt to keep it closed. - RecipeEvents.MATCH: a recipe matched where the game looks one up (furnaces, campfires, smithing tables, stonecutters, crafting grids, other mods' machines), with the block entity or the player asking; interrupt to pass it over for the next one that matches. - PlayerEvents.ADVANCEMENT_EARNED (a player completed an advancement), CommandEvents.EXECUTE (a command is about to run; interrupt to stop it) and LivingEvents.EFFECT_APPLICABLE (an effect is about to be given; interrupt to keep it off). - BlockEvents.DROPS: a broken block is about to drop its items and experience; change the list and the amount. - PlayerEvents.BREAK_SPEED and HARVEST_CHECK: how fast a player breaks a block, and whether their tool is right for it (without it, it drops nothing), on both sides. - MerchantEvents.OFFERS: the trades a player is shown, as their own list; take trades out to hide them (they can't make them either). - EnchantEvents.TABLE_OPTIONS (the enchantments an enchanting table's offer gives) and ANVIL_RESULT (what an anvil makes; interrupt with another stack or none). - LootEvents.MODIFY: any loot table's loot as it's rolled (chests, block drops, mobs, fishing), with the table's id; change the list. - PlayerEvents.ITEM_FISHED: what a player reeled in with a fishing rod, as its own list, before it's thrown to them; change the list. - Blocks that look like other blocks to some players (api.block.BlockViews): BlockViews.register(id, view) adds a BlockView, which groups players by a key (players with the same key see the same, and a null key leaves everything as it is for them) and says what a block looks like to them. What the server sends them (chunks, block changes, block entities' data) has that block in its place, so their client never knows the real one, while the server keeps it for everything else. BlockViews.refresh(player) sends them their chunks again when what they should see changes. - SpecialModelRendererRegistry (api.client.registry): registers special item model renderer types, the code-drawn parts of item models ("type": "minecraft:special"), the same on every loader. - SceneViewport.blockEntity(pos, blockEntity): a block entity in a viewport's scene, drawn by its renderer as in the world (its camera-facing parts face the viewer). - SceneViewport.sprite(...): a glowing, camera-facing picture at a place in the scene (rays, halos, flares), added on as light and hidden by nearer blocks and entities. - GhostBlocks.Light.WORLD: ghosts lit as the world lights a real block there (each face shaded by its side, smooth lighting, the block and sky light where it stands), so a ghost of one block over another matches it exactly. Pass it to the new GhostBlocks.draw(blocks, argb, show, light); BRIGHT and SHADED are the old full-bright and shaded looks. - GhostBlocks.draw(groups, argbs, show, light): several groups of ghosts at once, each with its own colour and opacity (a reveal fading in waves). World-lit groups of solid blocks go over the world in one pass instead of one pass a group. - GhostBlocks.drawEffect(blocks, show, light, shader, texture, params): ghosts of blocks' real models (a flower's petals, grass's blades) with a fragment shader of the mod's own laid over the world where they show, in place of a flat colour: a force field running over the blocks, a scan, frost creeping across them. The shader imports coolcatlib:ghost_effect.glsl, which gives each pixel's place in the world, the ghosts' colour, a texture of the mod's choosing and up to sixteen numbers of its own.

🔧 Changes - CoolCatLib's mixin configs declare Java 25 (compatibilityLevel), so loading no longer warns that a mixin needs a newer class version. - GhostBlocks.Show.OVER_BLOCK ghosts are drawn a hair nearer the camera instead of a little larger, so they cover exactly their blocks' faces and no longer spill onto the blocks beside them. - World-lit ghosts keep their lighting from frame to frame and build it again only when their block changes, or twice a second for changes in the light. - World-lit ghosts of blocks drawn off the middle of their block (flowers, grass, other plants) sit where the real ones are, instead of in the middle.

8.1.0 — Nov 3, 2026

🔧 Changes - CoolCatLib's own config screen (used without Glazed Menu) lists each config as a row, instead of a card with artwork: its kind's icon, its name over what its kind means, and how many settings it has. A mod's own card artwork at assets/<modid>/textures/gui/config/cards/<config name>.png is no longer used. - Each kind of config has its own color in the config list (client blue, common teal, server purple, startup orange), unless the config sets its own theme; its rows are centered in the list and as tall as needed to fit without scrolling. - The list of every mod's configs has a new icon (a puzzle piece with a gear), drawn in the theme's accent, and the header's icons no longer sit in a box. - Config screens are in CoolCatLib's logo colors by default (warm brown, cream and orange, in dark and light mode), for mods that don't set their own: ConfigColorScheme.COOLCATLIB and COOLCATLIB_LIGHT, used by ConfigTheme.DEFAULT and any theme built without colors.

🐛 Bug Fixes - Opening CoolCatLib's config screens no longer crashes the game over a large mod icon (on 1.20.1, CoolCatLib's own logo was enough); an icon that can't be loaded is left out, with a warning in the log. - Mod icons larger than 512 pixels are scaled down before they're uploaded, as nothing is drawn near that size. - CoolCatLib's config list says when no mod has a config there, instead of showing an empty panel.

8.0.1 — Nov 2, 2026

🐛 Bug Fixes - ItemTooltipEvents.APPEND's lines go above the game's advanced tooltip lines (durability, the item's id, its component count) rather than under them.

8.0.0 — Oct 26, 2026

✨ New Features - GhostBlocks.Show.OVER_BLOCK: a ghost over the real block where it stands, hidden only by what is in front of it, to fade one block into another. - SceneViewport.perspective(fov): draws a viewport's scene in perspective, as the game's camera sees the world, and zoom moves the camera nearer; 0 (the default) keeps it flat. - More common events (api.event.v2.common), fired the same on every loader: - BlockEvents.PLACE: a block is about to be placed, by any block item (players, dispensers, other mods' machines) or an enderman; interrupt and it isn't, and the item isn't used up. - PlayerEvents.PICKUP_ITEM (interrupt to leave the item on the ground), TRAVEL_TO_DIMENSION (before any teleport to another dimension: portals, commands, other mods' teleporters; interrupt to stay), CRAFTED and SMELTED (an item taken from a crafting or furnace result slot). - LivingEvents.EQUIPMENT_CHANGE: what an entity wears or holds in a slot changed. - RecipeEvents.CRAFT_RESULT: a crafting recipe's result for a crafting grid or a crafter; interrupt with another stack, or an empty one so nothing can be crafted. - Game tests from common code (api.gametest), the same on Fabric and NeoForge: GameTests.register(modId, SomeTests.class) registers every @GameTest method (as <modid>:<class>/<method>), and GameTests.register(id, options, helper -> ...) one test by hand. GameTestOptions sets the structure, time limit, setup ticks, rotation, retries, sky access, padding and environment; without a structure of their own, tests run on CoolCatLib's coolcatlib:gametest/platform, an empty 8 × 6 × 8 space on a stone floor. Tests are added in a development environment or with -Dcoolcatlib.gametest=true (or the loader's own game test switch), then run with /test run <modid>:* or on a game test server. - Attachments on levels and on the server: get, set, update, modify, has and reset take a Level or the MinecraftServer, saved in its data folder and synced (SyncPolicy.ALL) to the players in the level, or to everyone. getGlobal(level) reads the server's values on either side. - Offline players' attachments: getOffline, setOffline, updateOffline and resetOffline read and write a player's saved values whether or not they're online (an offline player's data file is written at once). - Sound filters (api.client.sound): muffle, roughen and echo the game's sounds, as heard through a wall, under a spell or in a cave. - A SoundFilter is how loud a sound stays, how much of its high end it keeps, and how much of it goes through a distortion and into a reverb. muffled, quieter, distorted and echoing make the usual ones; then combines two and lerp goes part of the way, for fades. - SoundFilters.register(provider) adds a SoundFilterProvider, asked about each sound as it starts and as it moves, with a SoundContext: where it plays, which sound event it is, its category and whether it is relative to the listener (music, the menus). SoundFilterProvider.inWorld makes one for the sounds in the world only, by their place. register gives back a Registration to remove() it again. - Named filters for every sound at once (but the menus' clicks): SoundFilters.set(id, filter, fadeTicks) fades one in, clear(id, fadeTicks) out again; isSet(id). From the server, SoundFilterControl.set and clear (api.sound) do the same for a player. - SoundFilters.refresh() filters the sounds already playing again, when a provider's answers change. - Through OpenAL's EFX extension (a low-pass filter on each sound, sent to a distortion and a reverb effect); without it, sounds are left as they are. - Items drawn in a GUI at an opacity (api.client.gui.ItemOpacityRenderer), flat and solid ones alike, where the game draws them only fully opaque: render and renderWithDecorations (with the count and durability bar) at an opacity or an OpacityTween (in, out, between, eased over ticks and smooth at any frame rate), and withOpacity(opacity, draw) for anything that draws items, fading the text and bars drawn with them too. pushItemOpacity and popItemOpacity fade just the items drawn between them. - Placing GUI elements out of the way of everything else (api.client.gui.placement): GuiAreas.hud() and screen() give the boxes of what the HUD (every mod's HUD layers too: minimaps, block tooltips, boss bars) and the open screen drew last frame, the screen's widgets included but not its background or the tooltip under the mouse; GuiAreas.unrecorded(draw) draws your own element without it counting. GuiPlacement.hud() / screen() take a size, where you'd like it (at), a gap, the bounds to stay within and the directions it may slide in, leave out overlays and whatever you ignore, and find() the nearest clear place. - World effect layers: frame.draw(material, VfxLayer.of(n)) draws in a layer, lowest first, so a higher layer always covers a lower one. A VfxLayer.sorted(n) layer draws its painted-over shapes of every material back to front, so shapes of different textures cover each other as their distance says. Materials in a layer now draw in the order they were first used each frame, where before they drew in no set order.

🐛 Bug Fixes - Mod Menu and NeoForge's mod list have a config button for CoolCatLib again, and for every mod with a CoolCatLib config. It opens CoolCatLib's own config screens, or Glazed Menu's when it's installed (Glazed Menu then gives the other mods' buttons itself).

🔧 Changes - CoolCatLib's own config screens (used when Glazed Menu isn't installed) are the full ones again, the same as on 1.21.1 and 1.20.1: a card for each of a mod's configs (or every mod's), each config's screen with its categories, search, presets, undo and redo, list and color editors, and category popups. Configs go by their own names ("Client", "Server"), after their mod's where it matters ("Testing Mod › Client"), instead of "Testingmod Client"; translate one with config.<modid>.<name>.label. - Mod Menu no longer marks CoolCatLib as a library, so its list doesn't hide it by default. - New version numbers: <version>+<minecraft>, this one 8.0.0+26.3, the same for every Minecraft version and loader. They follow on from 26.3-7; the part before the + is what launchers and loaders compare, the Minecraft version after it is only a label. Depending on CoolCatLib: ask for >=8.0.0, and the Maven artifacts are coolcatlib-<loader>:8.0.0+26.3.

26.3-7 — Oct 23, 2026

🐛 Bug Fixes - Screen effects draw again on 26.3. Every effect (the ready-made tint and bloom, and shaders of your own) stopped on its first frame with "Render pass color attachment count must match pipeline color target state count", so none ever showed.

26.3-6 — Oct 22, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on Fabric and NeoForge: - InteractionEvents: USE_BLOCK, USE_ITEM and USE_ENTITY (answer with an InteractionResult: PASS lets the game go on, anything else stops it there) and ATTACK_BLOCK and ATTACK_ENTITY (interrupt to stop them), on both sides, before the game acts. - LivingEvents: DAMAGE (before armor; interrupt and no damage is taken) and DEATH (interrupt to keep the entity alive), on the server. - PlayerEvents.CLONE (the new player object after death or the End, to carry data over), RESPAWN and CHANGE_DIMENSION; EntityEvents.UNLOAD. - Custom boss bars (api.bossbar, api.client.bossbar): boss bars drawn a mod's own way, each in a style. - From the server, CustomBossBars.style(bar, style) gives any ServerBossEvent a style (and optionally the entity it belongs to); players seeing it are told, and those shown it later are told when they are. EntityBossBar.of(entity).style(...).range(48).showWhen(...).show() keeps a bar for any living entity by itself: its name, its health, the players near it, until the entity is gone. - On the client, BossBarRenderers.register(style, renderer) draws bars of a style, stacked with the game's own as the game stacks them. Renderers get a BossBarView: the progress eased smoothly, a trail of what was just lost (held, then draining), how fresh the last hit is, the linked entity while it is loaded, and the time. TexturedBossBar is a renderer made from one texture: a frame, a fill and a trail in its track, marks that light once passed (phases), a glow that pulses faster as the bar empties, a jolt and a flash on each hit. - A style with no renderer on a client, or a client without CoolCatLib, gets the game's own bar. - Armatures (api.client.armature, api.armature): modelled, animated entities, block entities and items, made in Blockbench and played with layered animation. - Models: Blockbench projects (.bbmodel) are read as saved, with no export step: groups, cubes with per-face UVs, free-form meshes, locators and null objects, several textures and textures embedded in the file. Bedrock .geo.json with .animation.json work too, and an .animation.json alone is enough for clips meant for another model. Files go in assets/<namespace>/armatures/; an optional <name>.armature.json sets materials per joint (cutout, solid, translucent, emissive, glow), extra animation files, texture swaps, springs, head tracking, an idle clip, transitions, scale and .obj props. A texture named <texture>_glow is drawn on top at full brightness. - Animation: an Animator per entity, block entity or item stack, with AnimLayers that each play one clip over the joints in their JointMask, overriding or adding to the layers below, with a weight that can fade. A layer can be driven by a function asked every frame (layer.drive(ctx -> ctx.moving() ? WALK : IDLE)), and play sets the driver aside until its motion ends. Motion says how a clip plays: loop, once, hold, ping-pong, a repeat count, speed (backwards too), a start time and what plays next. - Transitions: Transition.crossfade, freeze (the old pose holds still while the new one blends in) and CUT, each with a duration and easing. A layer has a default, rules for pairs of clips (transition("run", "idle", ...)), a TransitionRule function, and a switch to turn blending off; the animator has a default and a switch for every layer. A motion can carry its own. - Keyframes: linear, Catmull-Rom, Bézier and step interpolation; Molang in any value (math.*, query.*, variable.*, assignments, several statements), with the common queries built in and ArmatureQueries.register for a mod's own; anim_time_update, blend_weight, start and loop delays. Sound and particle keyframes play by themselves (a particle effect naming a world effect plays it), timeline keyframes run Molang, and animator.onEvent gets them all. - Procedural motion: animator.spring(joint) for tails, ears and capes that lag and swing (chains of them whip), kept out of the body by colliders, balls round the model's points (spring.collider(point, radius), or "colliders" in the armature file), so a cape drapes over a back and the spikes on it; free parts that hang or float where the world puts them (a spring with no stiffness): buoyancy lifts one (a balloon on a string), rope lets its string go slack, wind drifts it in slow gusts and twist spins it on its string as it swings, all reacting to the clips that move where it hangs from ("buoyancy", "rope", "wind", "twist" in the armature file's springs); and the world: a spring's weight kept out of the blocks round it and the entities near it (collideBlocks, collideEntities, a ball of collisionRadius pixels), bouncing off and dragging along what it touches (bounce, friction), so a tail rests on the ground and a balloon is pushed aside by a player walking into it ("collide": true or {"blocks", "entities", "radius", "bounce", "friction"}); a spring that pulls ("pulls": true) tugs the spring on its joint's parent along its length when stretched taut, by its share of their mass, so tension runs down a chain: a balloon draws its string of cord lengths taut toward it and the string curves as it is swung, instead of standing stiff with the balloon folded over its top; springs marked bump keep their weights apart and bounce off each other ("bump": true, a ball of collisionRadius, or "radius"): a bunch of balloons jostling; and spacing ("spacing", pixels) keeps room between them, easing them apart before they touch, so a bunch of gently lifted balloons opens out into a bouquet; cloth: springs woven to their neighbours (spring.link(joint...), "links") keep the distance the animation puts between their weights, firmly when pulled apart and as softly as linkStiffness ("link_stiffness", 0.6) when pushed together, so a cape of hanging chains side by side or a skirt of panels round a waist moves, ripples and folds as one sheet instead of parting into strips; and cloth sheets ("cloth": [{"joints": [[...row...], ...], "wrap"}] in the armature file): the faces of a sheet's joints are skinned, each corner weighed between its own joint, the one below and the one beside it, so a cape or a skirt bends smoothly between its springs and stays whole, with no seam opening or folding over, and their seams welded first: neighbours' corners that are each other's nearest and within a pixel are joined at their middle and weighed alike, so square-cut boxes that cannot quite meet (the panels of a skirt flaring to its hem) close into one smooth sheet that never parts; what a cloth is made of: mass (heavy cloth swings slowly and shrugs off the wind), airDrag (air resistance growing with speed: it streams out behind and settles), flutter (ripples the faster its wearer moves), stretch (gives and springs back), bend (holds its shape however heavy it is, critically damped: long curves instead of sagging into sharp folds or whipping), follow (its damping works on its speed relative to where the animation carries it: cloth keeps up with its wearer instead of lagging as if dragged; "follow", 0 by default) and a steady windDirection on top of the drifting wind ("mass", "air_drag", "flutter", "stretch", "bend", "wind_direction"), or all at once with a Fabric (spring.fabric(Fabric.WOOL), "fabric": "wool": silk, linen, cotton, wool, canvas, leather, rags, leaves, and cord for strings: a balloon's string as a chain of springs, skinned as a one-column sheet so it curves; keys after it change just what they name); springs are kept light: no allocation per frame, at most 8 sub-steps, a spring at rest with nothing moving it sleeps, block shapes are looked up a few times a second and entities every few frames, and past simulationDistance blocks from the camera (64; "simulation_distance") a spring isn't worked out at all; animator.lookAt(joint) follows where a mob looks, or the nearest player for blocks and items; animator.modify changes the pose in code; joints can be hidden, tinted and lit up. - Effects: .obj props carried on joints and points (ObjProp), glowing trails behind a point (animator.trail), and effect particles pouring from one (animator.emitter). - Rendering: ArmatureMobRenderer (keeps vanilla's hurt flash, death topple, sleeping, invisibility, glowing outline, name tags, leashes and render layers; holds items at points with holdItem/ItemSocket, dims or darkens its glow textures with glow), ArmatureEntityRenderer, ArmatureBlockRenderer (turns to the block's facing, shows the breaking cracks) and the coolcatlib:armature item model type, with ArmatureItems for per-item setup. Anything can be drawn at a point with attach, and ArmatureDraw draws a posed armature in a mod's own renderer (Style.glow sets how bright its glow textures are). - Per-entity variants and see-through drawing in ArmatureMobRenderer: armature(entity -> ...) picks the armature each entity is drawn with (variants whose bodies differ, each entity's animator made for the one it uses), tint((entity, partialTicks) -> argb) tints it each frame, and translucent(...) draws it see-through so the tint's alpha shows (ArmatureDraw.Style.translucent; glowing parts unchanged). - From the server: ArmatureControl.play, stop and setVariable for an entity, a block entity or the item in an entity's hand, sent to the players who can see it. On the client, Animators.of(...) and Animators.whenReady(...). - Vanilla models (api.client.armature.vanilla): clips, changes and worn armatures for vanilla mobs and players, without replacing their models. VanillaModels.player() or VanillaModels.of(type): - animations(armature) plays clips on the parts named like the joints (head, body, right_arm...; any spelling); a part a clip moves is taken over, the rest keep vanilla's animation, and armor and held items follow. A root joint moves the whole model (flips, sitting, lying down). Clips can be mirrored for left-handed entities (mirrorLeftHanded), and torsoJointNames() reads emote files whose torso is the body part and body the whole model. - Limbs bend: a bend channel (or pose.bend) curves an arm or leg smoothly at its middle, with its sleeve or pants layer, its armor and the item in its hand. - pose(...), hide, scale, rotate and translate change parts every frame; attach(part, armature) wears an animated armature on a part; when(...) limits all of it to some entities. - firstPersonArms(...) shows your own arms in first person posed as the clips pose them, with what you hold, in place of vanilla's hands. - Other mods animating the same parts: Better Combat's attacks and weapon poses are recognized, and the clips leave those parts to them by default (overlapRule(OverlapRule.YIELD / OVERRIDE / ADD)). Other animation mods can be made known with VanillaModels.registerOverlap, and VanillaModels.hasOverlap(entity) tells drivers when one is animating. - Scene viewports can lay text flat on their picture, in the texture's own pixels (SceneViewport.text(line, x, y, colour, scale), clearText()): a picture of nothing but text is drawn once, so text can be shown as a texture and cut, stretched or bent with what it is on. - Scene viewports can stand on a ground: SceneViewport.ground(y, cells, floor, lines, shadows) lays a floor with a grid of lines under the scene, turning with it, as large as what stands on it and a margin more, with a soft shadow under each entity. - Event phases reach other mods' own listeners: EventPhase.band() sorts phases into FIRST (FIRST and earlier), MIDDLE and LAST (LAST and later), and events whose loader hook fires each band at its own place run FIRST listeners before other mods' NeoForge or Fabric listeners of the game event and LAST ones after them. EventInvoker.invoker(Band) and hasListeners(Band) let a hook fire one band; invoker() still fires them all, in order. - ItemTooltipEvents.MODIFY does this on both loaders (NeoForge's highest, normal and lowest priorities; Fabric phases before, at and after the default one). - ItemTooltipEvents.APPEND: lines added at the very end of an item's tooltip, after the loaders' tooltip events and every other mod's lines, with the player when there is one; not fired for tooltips an item hides. - World effects can be drawn pixel for pixel: VfxMaterial.withSmoothing(false) samples the texture with nearest filtering instead of linear, so pixel art (block and item textures) stays crisp up close. Materials are smooth by default, as before. - Config screens without Glazed Menu: ConfigScreens now opens CoolCatLib's own screen when Glazed Menu isn't installed, in the look of the screen effects screen (the config's categories on the left, its settings on the right, a search over all of them, light and dark mode), instead of returning null. Switches, sliders, dropdowns for enums, a color picker and text boxes for everything else; changes wait for Done, server configs are sent to the server when playing on one (or shown read only), and settings needing a restart are marked. Glazed Menu's screens are still used whenever it is installed; ConfigScreens.isGlazedMenu() tells which. - ConfigScreens.categoryPopup(...) opens a popup floating over the current screen, editing just that category's settings (with reset buttons and Save), instead of the full screen. A server config the player may not change is greyed out and marked read only. - Quiet held-item changes (HeldItemSwaps, client): data a mod changes on a held item no longer makes it dip out of view and back as if swapped. HeldItemSwaps.quiet(component...) names components whose changes alone are quiet; HeldItemSwaps.register((shown, next) -> ...) decides for any change, from the stack shown and the one now held. Changes to attachments on an item are quiet by default; Attachment.Builder.swapAnimation() makes an attachment's changes play the swap as before. - GhostBlocks (api.client.vfx): blocks drawn as ghosts with their real models (block entities too), one see-through picture so only their outside shows, tinted and faded by one colour; shown through walls, in the world as real blocks would be, or always; full bright or shaded. - HeldItemSwaps.quiet(Supplier): a component registered later (a RegistryEntry) can be named while a mod sets up; it is looked up once stacks are first compared. Calling .get() on it then fails on NeoForge, where components aren't registered yet. 🔧 Changes - Minecraft 26.3: brewing recipes are data pack recipes now, and NeoForge's brewing API is gone. Recipes added with RegisterBrewingRecipesEvent still brew, through CoolCatLib's own hooks on the brewing stand on both loaders. BrewingBuilder no longer extends vanilla's builder; addMix, addStartMix, addContainer and addContainerRecipe keep working, made into CoolCatLib recipes. - Minecraft 26.3: shaders are compiled to SPIR-V. Screen effect, skybox and world effect shaders in resource packs use #include <coolcatlib:...> in place of #moj_import, start with #extension GL_ARB_separate_shader_objects : require, and give every in and out a layout(location = N) (a sky layer's skyWorld is 2 and skyLocal 3; texCoord is 0). - Block entity attachments kept in dropped items are written and read with plain injections instead of redirects, which the MixinExtras bundled with NeoForge could fail on at startup. - NeoForge: payloads are registered as optional, CoolCatLib's own included, so a client with CoolCatLib (and client-only mods built on it) can join a server without it and the other way round, as on Fabric (NeoForge used to disconnect whichever side lacked a channel). Configuration payloads are only sent to clients that have their channel. Network.sendToPlayer skips a player whose client lacks the payload's channel instead of throwing. - Rifts (WorldRifts) can be held facing one way (rift.facing(direction)), as a portal set in a wall, instead of turning to the camera. - Canvas's namespace is coolcatlib too: its assets (coolcatlib:bloom, coolcatlib:tint, #moj_import <coolcatlib:vfx.glsl>, coolcatlib:sky.glsl, coolcatlib:screen_effect.glsl, the GUI and VFX textures), text colours in JSON and commands ("coolcatlib:rainbow", "coolcatlib:gradient/..."), saved cutscenes (coolcatlib:saved/<name>, from config/coolcatlib/cutscenes/), translation keys, key bindings and payload ids. Its development commands are under /coolcatlib_client (effects, cutscene ...), and the effects screen's choices are saved to config/coolcatlib-screen-effects.json (choices saved by Canvas are not carried over). Shaders, resource packs and text that named coolcatcanvas: need the new name. - The packages are still net.ixdarklord.coolcatcore and net.ixdarklord.coolcatcanvas, so code that calls CoolCatLib needs no import changes.

26.1.2-5 — Oct 14, 2026

🔧 Changes - CoolCatLib is one mod again: CoolCatLib: Core and CoolCatLib: Canvas are merged into CoolCatLib, one jar per loader. Screen effects, skyboxes, world effects, cutscenes, GUI widgets and the render utilities now ship with the events, networking, registries and configs, so there is one file to install and one version to depend on. - The mod id is now coolcatlib. With it changed: the Fabric entrypoints (coolcatlib:common, coolcatlib:client, coolcatlib:server, coolcatlib:datagen), the commands (/coolcatlib config ..., /coolcatlib_client config ...), Core's translation keys (config.coolcatlib.*, tooltip.coolcatlib.*), its payload ids and ConfigTheme.STARFALL (coolcatlib:starfall). Players and servers need the same version, as with any update. - Nothing moved in the code: the packages are still net.ixdarklord.coolcatcore and net.ixdarklord.coolcatcanvas, and Canvas's classes keep their asset namespace (coolcatcanvas:bloom, coolcatcanvas:vfx.glsl, ...), command (/coolcatcanvas_client) and config files. - Mods built for CoolCatLib: Core or Canvas have to be updated: the coolcatcore and coolcatcanvas mod ids are gone, and constructors are only read from the coolcatlib:* Fabric entrypoints. Depend on coolcatlib alone. - Remove the CoolCatLib: Core and Canvas jars when updating: their classes are in this one. The loaders refuse to start with them installed. - Maven: the artifacts are now net.ixdarklord.coolcatlib:coolcatlib-<loader> (coolcatlib-common, coolcatlib-fabric, coolcatlib-neoforge) and hold everything. coolcatlib-core-<loader> and coolcatlib-canvas-<loader> stop at their last versions: replace both dependencies with the one. - Canvas's releases up to 7 are listed in CHANGELOG-canvas.md.

26.1.2-4 — Oct 5, 2026

✨ New Features - EntityAttributes.register(type, Mob::createAttributes) (api.registry): the default attributes every living entity type needs, from common code on both loaders. - Renderer registries (api.client.registry): EntityRendererRegistry.register(type, provider) and BlockEntityRendererRegistry.register(type, provider), from common code on both loaders. Types are passed as suppliers, so RegistryEntrys work before they are registered.

26.1.2-3 — Oct 4, 2026

✨ New Features - Item decorators: custom drawing over an item wherever the game draws it in a GUI (inventory slots, the hotbar, a held stack), after vanilla's durability bar, cooldown and count, the same on every loader. Implement api.item.DecoratedItem on the item's class and hand over its api.client.gui.ItemDecorator in registerDecorators(registrar): that's all, Core registers it by itself, on the client, the first time the item is drawn. An item's own isBarVisible still decides whether vanilla's bar shows under it.

26.1.2-2 — Oct 3, 2026

✨ New Features - Configured (MrCrayfish) shows CoolCatLib: Core's configs: every mod with one gets Configured's screens in NeoForge's mod list and Mod Menu while Glazed Menu isn't installed (with Glazed Menu, its screens show them instead). Booleans, numbers, enums and text get Configured's own widgets; colors, ids, lists and other types are edited as text. Synced configs are edited on the server for players allowed to. 🔧 Changes - The config screens moved out of Core into Glazed Menu, a standalone client-only mod (glazedmenu) that reads Core's configs when Core is installed. ConfigEditors, EditSlot and ValueEditor are now in net.ixdarklord.glazedmenu.api.editor. Core's ConfigScreens (api.config.client) stays as a bridge: with Glazed Menu installed its methods open Glazed Menu's screens, and without it they open nothing (they return null; isAvailable() tells which, and tellUnavailable(config) tells the player how to change the config). /coolcatcore_client config open is now /glazedmenu [mod] [config/category]. Core still loads, saves, syncs and hot reloads configs and keeps its other commands; without Glazed Menu (or Configured) there's just no in-game editor, and a startup mismatch on joining a server is the disconnect message alone. - The styled widgets and theme effects moved to CoolCatLib: Canvas: ConfigEffect and ConfigEffects are in net.ixdarklord.coolcatcanvas.api.client.gui.theme. The player's screen settings (dark/light mode, opacities, effects, transitions) are Glazed Menu's now, so Core has no client config of its own anymore. - Core no longer registers config buttons in NeoForge's mod list or Mod Menu; Glazed Menu or Configured does.

26.1.2-1 — Sep 30, 2026 (Minecraft 26.1.2 port)

✨ New Features - Runs on Minecraft 26.1, 26.1.1 and 26.1.2 (NeoForge 26.1.0.19-beta or newer, Fabric API 0.145.1 or newer). - CoolCatLib is split in two mods: CoolCatLib: Core (coolcatcore, package net.ixdarklord.coolcatcore), this one, and CoolCatLib: Canvas (coolcatcanvas), which now holds screen effects, skyboxes, GUI widgets, RenderUtils and Easing. The mod id, package, asset namespace, Fabric entrypoints (coolcatcore:common, ...) and commands (/coolcatcore, /coolcatcore_client) all changed from coolcatlib. - A cross-loader platform layer, so mods built on CoolCatLib: Core no longer need Architectury API: - Events (api.event.v2): EventInvoker keeps listeners in common code, ordered by EventPhase, and is found by its listener type (EventInvoker.lookup(ServerTickEvents.End.class)) or its constant (ServerTickEvents.END). EventInvoker.create(Type.class) makes a mod's own event, combining listeners by return type (void, EventResult, EventResultHolder, boolean). - Built-in events: server lifecycle and ticks, datapack contents sync (ServerLifecycleEvents.SYNC_DATA_PACK_CONTENTS: per player on login and after /reload), player join/leave/tick, entity load, block break/place, commands; client ticks, player join/leave, HUD rendering, item tooltips, client commands. - api.registry: DeferredRegister / RegistryEntry, CreativeTabs, ReloadListeners. - api.menu.ExtendedMenus: menu types that open with extra data. - api.network.Network: serverbound/clientbound payloads and sending. Network.canPlayerReceive(player, type) tells whether a player's connection accepts a payload (false for clients without the mod and for GameTest mock players; NeoForge throws when sending to them). - Record payloads without a StreamCodec: Network.registerServerbound(MyPayload.class, receiver) (or with an explicit Type) derives the codec from the record's components through PayloadCodecs, which knows primitives, strings, common Minecraft types, enums, nested records, arrays, Optional, List, Set, Map, Either and ResourceKey. Other types are added with PayloadCodecs.register / registerFactory; registering a payload with a component type that has no codec throws right away, naming the component. - api.client.registry: key mappings, menu screens, tooltip components. - api.platform.Platform: loader, environment, mod checks, folders, the running server, fake players. - Mod constructors (api.core): ModConstructor (both sides), ClientModConstructor, ServerModConstructor (dedicated server) and DataGenerationConstructor are written once in common code, each with a construct stage and a setup stage (DataGenerationContext.addProvider for data providers). - Fabric needs no Java entry class: list them under the coolcatcore:common, coolcatcore:client, coolcatcore:server and coolcatcore:datagen entrypoints, plus api.core.fabric.FabricDataGenerationEntrypoint under fabric-datagen. - NeoForge: extend api.core.neoforge.NeoForgeModEntrypoint in the @Mod class and call common(...), client(() -> ...), server(() -> ...), dataGeneration(...); the mod id comes from the container. - EventResult.pass()/interrupt()/allow()/deny(), and EventResultHolder.result()/getValue(). - A config system (api.config): - Declare configs with Config.builder(modId, scope) (typed values, nested groups, presets) or from an annotated class with ConfigObject.register. - Scopes: CLIENT, COMMON, SERVER (synced to players) and STARTUP (read before content is registered). - Types: booleans, ranged numbers (optionally sliders), strings (length/pattern), enums, colors, ids, lists, and any Codec; custom ConfigTypes with their own editors. - TOML (default) and JSON5 files with generated comments; a config whose format changes converts its old file once (kept as .bak); broken files are backed up; version/migration and aliases handle renamed or moved settings. - Hot reloading of edited files, change listeners and ConfigEvents: LOADED (first read), RELOADED (hot reload, the reload command or Config.reload()), VALUE_CHANGED (each value, with its old and new value), CHANGED (once per batch), SAVED and SYNCED. - serverOnly() values that never leave the server; operators edit synced configs in-game with permission checks. - Generated config screen: search, undo/redo, reset, presets, validation, dependencies (enabledWhen), restart notices and list editing. Linked from the NeoForge mod list and Mod Menu. - /coolcatcore config (server) and /coolcatcore_client config (client) commands: list, get, set, reset, reload, preset, open. - STARTUP configs, read before content is registered (for item properties, which items exist...). Their values stay fixed until a restart; edits are saved for the next start. Joining a server compares them before entering the world: values must match by default (the client is offered to adopt the server's), useServerValue() values are taken from the server while connected, and localOnly() values stay per side. - Category popups: one category of a config in a small window with Save and Cancel, floating over the current screen or the game, e.g. ConfigScreens.openCategory("mymod", "client/rendering"), ConfigScreens.categoryPopup(parent, config, path), or /coolcatcore_client config open <mod> <category> (with path suggestions). A single setting's path shows just that setting. - A color picker for color values (a popup with saturation/brightness, hue and alpha, hex input and dye colors), also available as ConfigScreens.colorPicker. - The main config screen (shown for every mod, even one with a single config): a header with the mod's icon (a "?" when it has none; the list of every mod's configs has its own icon), and each config as a portrait navigation card with its own artwork (faint, brightening on hover; CoolCatLib: Core's per scope, or the mod's own at assets/<modid>/textures/gui/config/cards/<config name>.png), its scope icon and a short label like "Server" (config.<modid>.<name>.label). Cards are centered, grow when hovered, and show a tooltip with the config's scope, contents, file and access. Mod Menu's CoolCatLib: Core button opens CoolCatLib: Core's own settings. - Page transitions: a config page's panels glide a little way into place (up from below when opened, down from above when going back, a shorter rise when opened from elsewhere) while growing from slightly smaller; the background stays still. - Choice settings: the arrows step to the previous or next value, and clicking the middle of the box opens a dropdown of every value (arrow keys, Enter and the wheel work in it). Constants implementing EnumType.Displayable can override description() to explain what they do, shown beside the dropdown on the highlighted value. - Config screen effects: animations a theme names by id, drawn behind the panels, over the whole screen, and over each widget (buttons, toggles, sliders, text fields, cards, popup panels). Mods register their own on the client with ConfigEffects.register(id, ConfigEffect) and use them with ConfigTheme.Builder.effects(...), ConfigBuilder.effects(...) for one config, or "effects" in config_theme.json; an unknown id is skipped and an effect that throws is switched off, each logged once. The built-in ConfigTheme.STARFALL, every theme's default, draws soft glows in the accent and small faint stars falling from the top, shifting with the mouse by depth (parallax). CoolCatLib: Core's client config turns effects and the page transitions on or off (Effects > Theme Effects / Page Transitions); both are always off on the Fast graphics preset. - Redesigned config screens: a top bar (title, scope badges, search), a category sidebar, settings with descriptions and nested sections, and a bottom bar with the unsaved-changes status and actions; toggle switches, sliders, selectors and flat buttons; presets, confirmations and the color picker as popups. Icons are 64x64 textures in assets/coolcatcore/textures/gui/config/icons/ (smoothly filtered), replaceable by resource packs. - ConfigTheme: each mod's own look, set per mod (ConfigTheme.setForMod) or per config (ConfigBuilder.theme / background): a full ConfigColorScheme (presets DARK, LIGHT, and tinted(accent) for the dark scheme shaded toward the mod's color), a background texture by its path (cover, stretch or tile), the texture's opacity (textureOpacity, letting the panorama or world show through) and the backdrop color's opacity over the background (backgroundOpacity). Players can scale both for every mod in CoolCatLib: Core's client config (Background > Backdrop Opacity / Texture Opacity). By default the screens are see-through to the title panorama or the world. Resource packs can restyle a mod with assets/<modid>/coolcatcore/config_theme.json. - Popup panel sprites: ConfigTheme.Builder.popupSprite (or popup_sprite in config_theme.json) draws a nine-slice GUI sprite as the panel of popups (category popups, confirmations, the color picker) instead of the flat panel, and ConfigScreens.categoryPopup(parent, config, path, theme) opens a category popup with its own theme, e.g. to match the screen it's opened from. - Toggle switches have an outline on their track: the panel border while off, a darker shade of the accent as they turn on. - Popups keep their buttons in a footer strip along the bottom and their content above it, so a sprite's footer band sits behind the buttons only (the color picker's Cancel and Done moved there). - The config list shows each mod's icon (a theme can set another); config pages and their cards show an icon of their kind (client, common, server, startup). - Platform.getModName. - Dark and light mode: a sun/moon switch in every config screen's top bar, remembered in CoolCatLib: Core's own client config (themeMode). Each theme has a light scheme too (ConfigTheme.Builder.lightColors, by default derived from the mod's accent; light_base/light_colors in config_theme.json). - The main config screen's search bar searches every config it lists (names, keys, comments, group names, values), with results grouped by config; opening a result shows that config filtered to it. A config's own search covers only that config. - Attachments, containers and handlers for items, blocks and entities: - api.attachment: typed data any entity (players included), block entity or item stack can carry. Each mod creates its own AttachmentRegistry.create(modId) (and calls register() while it initialises); its values are stored under its own id, in the <modid>:attachments item component and a <modid>:attachments tag in entity and block entity data. Declared once (ATTACHMENTS.builder(name, codec, default)), then used as MADNESS.get(player), set, update, modify, reset, or through AttachmentHolder.of(...). - Persistent attachments save with their holder; transientBuilder ones never do. copyOnDeath() keeps a player's value through death (always kept through dimension changes and the End exit); keepOnDrop() carries a block entity's value into its dropped item and back when placed. - sync(SyncPolicy): SELF (the player it belongs to), TRACKING, ALL, or any predicate. Only changed values are sent, at most once per tick; everything when a player starts seeing the holder, receives its chunk, joins, respawns or changes dimension. - On item stacks, defaults aren't stored, so stacks still stack. - AttachmentEvents: CHANGING (cancel a change or replace the value), ADDED, CHANGED (in-place changes included), REMOVED, START_TRACKING/STOP_TRACKING (a player starts or stops receiving a holder's data) and RECEIVED (synced values arrived on the client), plus typed per-attachment helpers (onChanged(MADNESS, ...)). - api.container: ContainerLayout (slot filters, limits, roles STORAGE/INPUT/OUTPUT/INTERNAL, which slots each face reaches) makes SlotContainers, vanilla Containers with insert/extract, listeners and layout-aware menu slots. AttachmentRegistry.container stores one on any entity or block entity (saved and synced with the rest); ItemContainers keeps one in a stack (ContainerItem for items that have one); ItemTransfer moves items between any containers through faces. - api.block: ExtendedBlockEntity (attachment shortcuts, handlers, serverTick/clientTick with ExtendedBlockEntity.ticker) and ExtendedContainerBlockEntity (an inventory hoppers and comparators use; contents spill or, with keepContentsOnBreak, stay in the item). - api.handler: HandlerType for anything holders hand out (inventories, energy...), from the holder itself (HandlerProvider, HandlerMap) or registered providers and fallbacks for blocks, block entities, entities and items. HandlerTypes.CONTAINER also finds vanilla containers (double chests as one). BlockHandlerCache keeps a lookup until the block changes, its block entity goes, or HandlerType.invalidate is called. - Other mods reach these containers through each loader's own system, following the layout's filters, roles and limits: NeoForge item handler capabilities (blocks, entities and ContainerItem stacks) and Fabric's Transfer API (ItemStorage.SIDED for blocks, ItemStorage.ITEM for ContainerItem stacks). - api.registry.BlockEntityTypes.create: block entity types from common code. - Storage menus (api.menu.StorageMenuDefinition): a menu for a block's or an item's inventory, declared once (StorageMenuDefinition.grid(columns, rows) or placed slot by slot), registered with createMenuType and opened with open(player, blockEntity, title) or open(player, hand, title). Slots follow the container's layout and shift-click; the menu closes when the block is removed, the player walks away, or the item leaves its slot (which stays locked meanwhile). sync(attachment) and syncValue(...) send extra values to the screen while it's open, and button(id, action) runs screen buttons on the server. api.client.gui.screens.StorageScreen draws any of these menus with no texture, and can be extended.

⚙️ Refactoring - Rewrote the v2 event system (the lookup-based skeleton had no events); EventInvokerRegistry was removed.

2001.1.0.0 — Oct 30, 2025

⚙️ Refactoring - Renamed and reorganized several classes. - Updated version formatting from X.X.X to MCVR.X.X.X to clearly distinguish between Minecraft release versions.

1.1.2 — April 11, 2025
  • Added new methods to MouseHelper and fixed an issue in RenderUtils
1.1.1 — (Fabric Hotfix) | March 20, 2025
  • Correct implementation of Potion Brewing and Potion Brewing Builder extension interfaces
1.1.0 — March 19, 2025
  • Revamped the Brewing Recipe API
  • Added two versions of Events (second version is still unstable)
  • Introduced new abstract classes for widgets
1.0.1 — December 30, 2024
  • Changing and Organizing the packages
1.0.0 — September 21, 2024
  • Port to 1.21
9.0.0 — Nov 16, 2026

✨ New Features - Block entity renderers (coolcatcanvas.api.client.blockentity), as on 26.1.2: BlockRenderer, a base that leaves a mod to write only what it draws (newState, extract, render), culled by distance and view (viewDistance, bounds), drawn in less detail farther off (detail bands, reach), its states reused, turned to its block's facing (facing), with layers drawn with it (ItemLayer for floating items, LabelLayer for text, ChildLayer for other renderers). Press F3 + B to see each one's bounds, colored by its detail. - ArmatureBlockRenderer is a BlockRenderer: every setting above works on it and chains with its own (.detail(...).animate(...)), bounds grow from the armature's own, and a subclass draws more with newState, extract and render. It is culled out of view by the armature's bounds, and with detail bands set it animates every other frame at REDUCED and every fourth at MINIMAL, without its attachments. - ModCommands (api.command): registers a mod's server commands with its mod id and the command's names, the first its own and the others aliases that work the same, e.g. ModCommands.register("ftbultimineaddition", List.of("ultimine_addition", "ua"), (root, context, selection) -> root.then(...)). A name another command already has (vanilla's /tm, another mod's) is skipped, with a warning in the log. ModCommands.registerClient(modId, names, (root, context) -> ...) does the same for client commands. Instead of names, a client command can take its server command's: ClientNames.MERGED shares them (one /folios for players: what the client's parts can run stays on the client, the rest goes to the server), ClientNames.SUFFIXED adds _client (/ua_client beside /ua). - Every mod with CoolCatLib configs gets a config command under its own commands: /<command> config opens the mod's config screens and /<command> config <config> one of them (/folios config client). Anyone can open them; what they may change is still up to each config's edit permission. - /<command> config reload [config] reads the mod's config files again after they were edited by hand, without restarting (for operators): the server's configs on the server, the player's client configs on their own game. - /coolcatlib config [mod] [config] and /coolcatlib config reload [mod] [config] do the same for any mod, and on servers without CoolCatLib the player's own game does it.

🔧 Changes - Breaking: Canvas's GUI and render helpers moved to tidier packages under net.ixdarklord.coolcatcanvas.api.client: gui.components and gui.components.widgets to gui.widget, gui.components.widgets.panel to gui.panel, gui.components.animations to gui.animation, utils.ScreenAnchor to gui.placement, utils.TextEffects to text, and utils.RenderUtils, Outline and NineSliceInfo to render. The class names are the same; mods using them update their imports. - CoolCatLib's visuals are a mod of their own again, CoolCatLib Canvas (coolcatcanvas), and it comes inside CoolCatLib's jar: nothing more to install. Mods built on its API need net.ixdarklord.coolcatlib:coolcatlib-canvas-<loader> beside coolcatlib-<loader> (CoolCatLib's POM names it). - Canvas's namespace is coolcatcanvas: its shaders and includes (#moj_import <coolcatcanvas:screen_effect.glsl>), text effects (coolcatcanvas:rainbow, coolcatcanvas:gradient/...), the armature item model type (coolcatcanvas:armature), its built-in effects (coolcatcanvas:tint, coolcatcanvas:bloom), lang keys, key bindings and payload ids. Resource packs and mods that name these with coolcatlib: need the new name. The effects screen's choices and saved cutscenes move to config/coolcatcanvas-screen-effects.json and config/coolcatcanvas/cutscenes/, carried over from where they were. - The config screens' look belongs to CoolCatLib itself: ConfigEffect and ConfigEffects moved to net.ixdarklord.coolcatcore.api.config.client, and the dark or light choice is saved in config/coolcatlib-style.json. - Needs Glazed Menu 1.2.2 or newer when it's installed: older ones look for the config screen effects where they were. - /coolcatlib_client is gone: the client's config command is part of /coolcatlib (on servers without CoolCatLib), and the visuals' commands are /coolcatcanvas effects and /coolcatcanvas cutscene .... - The config commands no longer get, set or reset values or apply presets from the chat (/coolcatlib config <id> get|set|reset|preset): they open the config screens, where all of that is done. - CommandEvents.REGISTER and ClientCommandEvents.REGISTER are deprecated: use ModCommands (register and registerClient). Commands registered through it still work, and still get the config command: they're matched to the mod whose configs are built in the same packages. - The renderer registries moved to Canvas, beside its renderers, in net.ixdarklord.coolcatcanvas.api.client.registry: BlockEntityRendererRegistry, EntityRendererRegistry, and ItemRendererRegistry (was SpecialModelRendererRegistry; registers item model types drawn by code). The ones in net.ixdarklord.coolcatcore.api.client.registry still work but are deprecated.

🐛 Bug Fixes - A mod's server command no longer stops working when the mod also has a client command of the same name (/folios config beside the client's /folios guide): what only the server's command can run now goes to the server instead of failing on the client as an incorrect argument.

8.2.0 — Nov 10, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on every loader: - EntityEvents.SPAWN: a new mob is about to be added to the world (spawned naturally or with a new chunk, by a spawner, a spawn egg, a command, breeding, a conversion), with why it was made; interrupt to keep it out, with its passengers. EntityEvents.MOUNT: an entity is about to ride another (interrupt to keep it off), or got off one. - PlayerEvents.OPEN_MENU: a player is about to open a menu: a block's, an entity's, an item's, or one another mod opens with extra data; interrupt to keep it closed. - RecipeEvents.MATCH: a recipe matched where the game looks one up (furnaces, campfires, smithing tables, stonecutters, crafting grids, other mods' machines), with the block entity or the player asking; interrupt to pass it over for the next one that matches. - PlayerEvents.ADVANCEMENT_EARNED (a player completed an advancement), CommandEvents.EXECUTE (a command is about to run; interrupt to stop it) and LivingEvents.EFFECT_APPLICABLE (an effect is about to be given; interrupt to keep it off). - BlockEvents.DROPS: a broken block is about to drop its items and experience; change the list and the amount. - PlayerEvents.BREAK_SPEED and HARVEST_CHECK: how fast a player breaks a block, and whether their tool is right for it (without it, it drops nothing), on both sides. - MerchantEvents.OFFERS: the trades a player is shown, as their own list; take trades out to hide them (they can't make them either). - EnchantEvents.TABLE_OPTIONS (the enchantments an enchanting table's offer gives) and ANVIL_RESULT (what an anvil makes; interrupt with another stack or none). - LootEvents.MODIFY: any loot table's loot as it's rolled (chests, block drops, mobs, fishing), with the table's id; change the list. - PlayerEvents.ITEM_FISHED: what a player reeled in with a fishing rod, as its own list, before it's thrown to them; change the list. - Blocks that look like other blocks to some players (api.block.BlockViews): BlockViews.register(id, view) adds a BlockView, which groups players by a key (players with the same key see the same, and a null key leaves everything as it is for them) and says what a block looks like to them. What the server sends them (chunks, block changes, block entities' data) has that block in its place, so their client never knows the real one, while the server keeps it for everything else. BlockViews.refresh(player) sends them their chunks again when what they should see changes. - SceneViewport.blockEntity(pos, blockEntity): a block entity in a viewport's scene, drawn by its renderer as in the world (its camera-facing parts face the viewer). - SpecialModelRendererRegistry (api.client.registry): registers special item model renderer types, the code-drawn parts of item models ("type": "minecraft:special"), the same on every loader. - GhostBlocks.Light.WORLD: ghosts lit as the world lights a real block there (each face shaded by its side, smooth lighting, the block and sky light where it stands), so a ghost of one block over another matches it exactly. Pass it to the new GhostBlocks.draw(blocks, argb, show, light); BRIGHT and SHADED are the old full-bright and shaded looks. - GhostBlocks.draw(groups, argbs, show, light): several groups of ghosts at once, each with its own colour and opacity (a reveal fading in waves). World-lit groups of solid blocks go over the world in one pass instead of one pass a group. - GhostBlocks.drawEffect(blocks, show, light, shader, texture, params): ghosts of blocks' real models (a flower's petals, grass's blades) with a fragment shader of the mod's own laid over the world where they show, in place of a flat colour: a force field running over the blocks, a scan, frost creeping across them. The shader imports coolcatlib:ghost_effect.glsl, which gives each pixel's place in the world, the ghosts' colour, a texture of the mod's choosing and up to sixteen numbers of its own. - SceneViewport.sprite(...): a glowing, camera-facing picture at a place in the scene (rays, halos, flares), added on as light and hidden by nearer blocks and entities.

🔧 Changes - CoolCatLib's mixin configs declare Java 25 (compatibilityLevel), so loading no longer warns that a mixin needs a newer class version. - GhostBlocks.Show.OVER_BLOCK ghosts are drawn a hair nearer the camera instead of a little larger, so they cover exactly their blocks' faces and no longer spill onto the blocks beside them. - World-lit ghosts keep their lighting from frame to frame and build it again only when their block changes, or twice a second for changes in the light. - World-lit ghosts of blocks drawn off the middle of their block (flowers, grass, other plants) sit where the real ones are, instead of in the middle.

8.1.0 — Nov 3, 2026

🔧 Changes - CoolCatLib's own config screen (used without Glazed Menu) lists each config as a row, instead of a card with artwork: its kind's icon, its name over what its kind means, and how many settings it has. A mod's own card artwork at assets/<modid>/textures/gui/config/cards/<config name>.png is no longer used. - Each kind of config has its own color in the config list (client blue, common teal, server purple, startup orange), unless the config sets its own theme; its rows are centered in the list and as tall as needed to fit without scrolling. - The list of every mod's configs has a new icon (a puzzle piece with a gear), drawn in the theme's accent, and the header's icons no longer sit in a box. - Config screens are in CoolCatLib's logo colors by default (warm brown, cream and orange, in dark and light mode), for mods that don't set their own: ConfigColorScheme.COOLCATLIB and COOLCATLIB_LIGHT, used by ConfigTheme.DEFAULT and any theme built without colors.

🐛 Bug Fixes - Opening CoolCatLib's config screens no longer crashes the game over a large mod icon (on 1.20.1, CoolCatLib's own logo was enough); an icon that can't be loaded is left out, with a warning in the log. - Mod icons larger than 512 pixels are scaled down before they're uploaded, as nothing is drawn near that size. - CoolCatLib's config list says when no mod has a config there, instead of showing an empty panel.

8.0.1 — Nov 2, 2026

🐛 Bug Fixes - ItemTooltipEvents.APPEND's lines go above the game's advanced tooltip lines (durability, the item's id, its component count) rather than under them.

8.0.0 — Oct 26, 2026

✨ New Features - GhostBlocks.Show.OVER_BLOCK: a ghost over the real block where it stands, hidden only by what is in front of it, to fade one block into another. - SceneViewport.perspective(fov): draws a viewport's scene in perspective, as the game's camera sees the world, and zoom moves the camera nearer; 0 (the default) keeps it flat. - More common events (api.event.v2.common), fired the same on every loader: - BlockEvents.PLACE: a block is about to be placed, by any block item (players, dispensers, other mods' machines) or an enderman; interrupt and it isn't, and the item isn't used up. - PlayerEvents.PICKUP_ITEM (interrupt to leave the item on the ground), TRAVEL_TO_DIMENSION (before any teleport to another dimension: portals, commands, other mods' teleporters; interrupt to stay), CRAFTED and SMELTED (an item taken from a crafting or furnace result slot). - LivingEvents.EQUIPMENT_CHANGE: what an entity wears or holds in a slot changed. - RecipeEvents.CRAFT_RESULT: a crafting recipe's result for a crafting grid or a crafter; interrupt with another stack, or an empty one so nothing can be crafted. - Game tests from common code (api.gametest), the same on Fabric and NeoForge: GameTests.register(modId, SomeTests.class) registers every @GameTest method (as <modid>:<class>/<method>), and GameTests.register(id, options, helper -> ...) one test by hand. GameTestOptions sets the structure, time limit, setup ticks, rotation, retries, sky access, padding and environment; without a structure of their own, tests run on CoolCatLib's coolcatlib:gametest/platform, an empty 8 × 6 × 8 space on a stone floor. Tests are added in a development environment or with -Dcoolcatlib.gametest=true (or the loader's own game test switch), then run with /test run <modid>:* or on a game test server. - Attachments on levels and on the server: get, set, update, modify, has and reset take a Level or the MinecraftServer, saved in its data folder and synced (SyncPolicy.ALL) to the players in the level, or to everyone. getGlobal(level) reads the server's values on either side. - Offline players' attachments: getOffline, setOffline, updateOffline and resetOffline read and write a player's saved values whether or not they're online (an offline player's data file is written at once). - Sound filters (api.client.sound): muffle, roughen and echo the game's sounds, as heard through a wall, under a spell or in a cave. - A SoundFilter is how loud a sound stays, how much of its high end it keeps, and how much of it goes through a distortion and into a reverb. muffled, quieter, distorted and echoing make the usual ones; then combines two and lerp goes part of the way, for fades. - SoundFilters.register(provider) adds a SoundFilterProvider, asked about each sound as it starts and as it moves, with a SoundContext: where it plays, which sound event it is, its category and whether it is relative to the listener (music, the menus). SoundFilterProvider.inWorld makes one for the sounds in the world only, by their place. register gives back a Registration to remove() it again. - Named filters for every sound at once (but the menus' clicks): SoundFilters.set(id, filter, fadeTicks) fades one in, clear(id, fadeTicks) out again; isSet(id). From the server, SoundFilterControl.set and clear (api.sound) do the same for a player. - SoundFilters.refresh() filters the sounds already playing again, when a provider's answers change. - Through OpenAL's EFX extension (a low-pass filter on each sound, sent to a distortion and a reverb effect); without it, sounds are left as they are. - Items drawn in a GUI at an opacity (api.client.gui.ItemOpacityRenderer), flat and solid ones alike, where the game draws them only fully opaque: render and renderWithDecorations (with the count and durability bar) at an opacity or an OpacityTween (in, out, between, eased over ticks and smooth at any frame rate), and withOpacity(opacity, draw) for anything that draws items, fading the text and bars drawn with them too. pushItemOpacity and popItemOpacity fade just the items drawn between them. - Placing GUI elements out of the way of everything else (api.client.gui.placement): GuiAreas.hud() and screen() give the boxes of what the HUD (every mod's HUD layers too: minimaps, block tooltips, boss bars) and the open screen drew last frame, the screen's widgets included but not its background or the tooltip under the mouse; GuiAreas.unrecorded(draw) draws your own element without it counting. GuiPlacement.hud() / screen() take a size, where you'd like it (at), a gap, the bounds to stay within and the directions it may slide in, leave out overlays and whatever you ignore, and find() the nearest clear place. - World effect layers: frame.draw(material, VfxLayer.of(n)) draws in a layer, lowest first, so a higher layer always covers a lower one. A VfxLayer.sorted(n) layer draws its painted-over shapes of every material back to front, so shapes of different textures cover each other as their distance says. Materials in a layer now draw in the order they were first used each frame, where before they drew in no set order.

🐛 Bug Fixes - Mod Menu and NeoForge's mod list have a config button for CoolCatLib again, and for every mod with a CoolCatLib config. It opens CoolCatLib's own config screens, or Glazed Menu's when it's installed (Glazed Menu then gives the other mods' buttons itself).

🔧 Changes - CoolCatLib's own config screens (used when Glazed Menu isn't installed) are the full ones again, the same as on 1.21.1 and 1.20.1: a card for each of a mod's configs (or every mod's), each config's screen with its categories, search, presets, undo and redo, list and color editors, and category popups. Configs go by their own names ("Client", "Server"), after their mod's where it matters ("Testing Mod › Client"), instead of "Testingmod Client"; translate one with config.<modid>.<name>.label. - Mod Menu no longer marks CoolCatLib as a library, so its list doesn't hide it by default. - New version numbers: <version>+<minecraft>, this one 8.0.0+26.2, the same for every Minecraft version and loader. They follow on from 26.2-6; the part before the + is what launchers and loaders compare, the Minecraft version after it is only a label. Depending on CoolCatLib: ask for >=8.0.0, and the Maven artifacts are coolcatlib-<loader>:8.0.0+26.2.

26.2-6 — Oct 22, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on Fabric and NeoForge: - InteractionEvents: USE_BLOCK, USE_ITEM and USE_ENTITY (answer with an InteractionResult: PASS lets the game go on, anything else stops it there) and ATTACK_BLOCK and ATTACK_ENTITY (interrupt to stop them), on both sides, before the game acts. - LivingEvents: DAMAGE (before armor; interrupt and no damage is taken) and DEATH (interrupt to keep the entity alive), on the server. - PlayerEvents.CLONE (the new player object after death or the End, to carry data over), RESPAWN and CHANGE_DIMENSION; EntityEvents.UNLOAD. - Custom boss bars (api.bossbar, api.client.bossbar): boss bars drawn a mod's own way, each in a style. - From the server, CustomBossBars.style(bar, style) gives any ServerBossEvent a style (and optionally the entity it belongs to); players seeing it are told, and those shown it later are told when they are. EntityBossBar.of(entity).style(...).range(48).showWhen(...).show() keeps a bar for any living entity by itself: its name, its health, the players near it, until the entity is gone. - On the client, BossBarRenderers.register(style, renderer) draws bars of a style, stacked with the game's own as the game stacks them. Renderers get a BossBarView: the progress eased smoothly, a trail of what was just lost (held, then draining), how fresh the last hit is, the linked entity while it is loaded, and the time. TexturedBossBar is a renderer made from one texture: a frame, a fill and a trail in its track, marks that light once passed (phases), a glow that pulses faster as the bar empties, a jolt and a flash on each hit. - A style with no renderer on a client, or a client without CoolCatLib, gets the game's own bar. - Armatures (api.client.armature, api.armature): modelled, animated entities, block entities and items, made in Blockbench and played with layered animation. - Models: Blockbench projects (.bbmodel) are read as saved, with no export step: groups, cubes with per-face UVs, free-form meshes, locators and null objects, several textures and textures embedded in the file. Bedrock .geo.json with .animation.json work too, and an .animation.json alone is enough for clips meant for another model. Files go in assets/<namespace>/armatures/; an optional <name>.armature.json sets materials per joint (cutout, solid, translucent, emissive, glow), extra animation files, texture swaps, springs, head tracking, an idle clip, transitions, scale and .obj props. A texture named <texture>_glow is drawn on top at full brightness. - Animation: an Animator per entity, block entity or item stack, with AnimLayers that each play one clip over the joints in their JointMask, overriding or adding to the layers below, with a weight that can fade. A layer can be driven by a function asked every frame (layer.drive(ctx -> ctx.moving() ? WALK : IDLE)), and play sets the driver aside until its motion ends. Motion says how a clip plays: loop, once, hold, ping-pong, a repeat count, speed (backwards too), a start time and what plays next. - Transitions: Transition.crossfade, freeze (the old pose holds still while the new one blends in) and CUT, each with a duration and easing. A layer has a default, rules for pairs of clips (transition("run", "idle", ...)), a TransitionRule function, and a switch to turn blending off; the animator has a default and a switch for every layer. A motion can carry its own. - Keyframes: linear, Catmull-Rom, Bézier and step interpolation; Molang in any value (math.*, query.*, variable.*, assignments, several statements), with the common queries built in and ArmatureQueries.register for a mod's own; anim_time_update, blend_weight, start and loop delays. Sound and particle keyframes play by themselves (a particle effect naming a world effect plays it), timeline keyframes run Molang, and animator.onEvent gets them all. - Procedural motion: animator.spring(joint) for tails, ears and capes that lag and swing (chains of them whip), kept out of the body by colliders, balls round the model's points (spring.collider(point, radius), or "colliders" in the armature file), so a cape drapes over a back and the spikes on it; free parts that hang or float where the world puts them (a spring with no stiffness): buoyancy lifts one (a balloon on a string), rope lets its string go slack, wind drifts it in slow gusts and twist spins it on its string as it swings, all reacting to the clips that move where it hangs from ("buoyancy", "rope", "wind", "twist" in the armature file's springs); and the world: a spring's weight kept out of the blocks round it and the entities near it (collideBlocks, collideEntities, a ball of collisionRadius pixels), bouncing off and dragging along what it touches (bounce, friction), so a tail rests on the ground and a balloon is pushed aside by a player walking into it ("collide": true or {"blocks", "entities", "radius", "bounce", "friction"}); a spring that pulls ("pulls": true) tugs the spring on its joint's parent along its length when stretched taut, by its share of their mass, so tension runs down a chain: a balloon draws its string of cord lengths taut toward it and the string curves as it is swung, instead of standing stiff with the balloon folded over its top; springs marked bump keep their weights apart and bounce off each other ("bump": true, a ball of collisionRadius, or "radius"): a bunch of balloons jostling; and spacing ("spacing", pixels) keeps room between them, easing them apart before they touch, so a bunch of gently lifted balloons opens out into a bouquet; cloth: springs woven to their neighbours (spring.link(joint...), "links") keep the distance the animation puts between their weights, firmly when pulled apart and as softly as linkStiffness ("link_stiffness", 0.6) when pushed together, so a cape of hanging chains side by side or a skirt of panels round a waist moves, ripples and folds as one sheet instead of parting into strips; and cloth sheets ("cloth": [{"joints": [[...row...], ...], "wrap"}] in the armature file): the faces of a sheet's joints are skinned, each corner weighed between its own joint, the one below and the one beside it, so a cape or a skirt bends smoothly between its springs and stays whole, with no seam opening or folding over, and their seams welded first: neighbours' corners that are each other's nearest and within a pixel are joined at their middle and weighed alike, so square-cut boxes that cannot quite meet (the panels of a skirt flaring to its hem) close into one smooth sheet that never parts; what a cloth is made of: mass (heavy cloth swings slowly and shrugs off the wind), airDrag (air resistance growing with speed: it streams out behind and settles), flutter (ripples the faster its wearer moves), stretch (gives and springs back), bend (holds its shape however heavy it is, critically damped: long curves instead of sagging into sharp folds or whipping), follow (its damping works on its speed relative to where the animation carries it: cloth keeps up with its wearer instead of lagging as if dragged; "follow", 0 by default) and a steady windDirection on top of the drifting wind ("mass", "air_drag", "flutter", "stretch", "bend", "wind_direction"), or all at once with a Fabric (spring.fabric(Fabric.WOOL), "fabric": "wool": silk, linen, cotton, wool, canvas, leather, rags, leaves, and cord for strings: a balloon's string as a chain of springs, skinned as a one-column sheet so it curves; keys after it change just what they name); springs are kept light: no allocation per frame, at most 8 sub-steps, a spring at rest with nothing moving it sleeps, block shapes are looked up a few times a second and entities every few frames, and past simulationDistance blocks from the camera (64; "simulation_distance") a spring isn't worked out at all; animator.lookAt(joint) follows where a mob looks, or the nearest player for blocks and items; animator.modify changes the pose in code; joints can be hidden, tinted and lit up. - Effects: .obj props carried on joints and points (ObjProp), glowing trails behind a point (animator.trail), and effect particles pouring from one (animator.emitter). - Rendering: ArmatureMobRenderer (keeps vanilla's hurt flash, death topple, sleeping, invisibility, glowing outline, name tags, leashes and render layers; holds items at points with holdItem/ItemSocket, dims or darkens its glow textures with glow), ArmatureEntityRenderer, ArmatureBlockRenderer (turns to the block's facing, shows the breaking cracks) and the coolcatlib:armature item model type, with ArmatureItems for per-item setup. Anything can be drawn at a point with attach, and ArmatureDraw draws a posed armature in a mod's own renderer (Style.glow sets how bright its glow textures are). - Per-entity variants and see-through drawing in ArmatureMobRenderer: armature(entity -> ...) picks the armature each entity is drawn with (variants whose bodies differ, each entity's animator made for the one it uses), tint((entity, partialTicks) -> argb) tints it each frame, and translucent(...) draws it see-through so the tint's alpha shows (ArmatureDraw.Style.translucent; glowing parts unchanged). - From the server: ArmatureControl.play, stop and setVariable for an entity, a block entity or the item in an entity's hand, sent to the players who can see it. On the client, Animators.of(...) and Animators.whenReady(...). - Vanilla models (api.client.armature.vanilla): clips, changes and worn armatures for vanilla mobs and players, without replacing their models. VanillaModels.player() or VanillaModels.of(type): - animations(armature) plays clips on the parts named like the joints (head, body, right_arm...; any spelling); a part a clip moves is taken over, the rest keep vanilla's animation, and armor and held items follow. A root joint moves the whole model (flips, sitting, lying down). Clips can be mirrored for left-handed entities (mirrorLeftHanded), and torsoJointNames() reads emote files whose torso is the body part and body the whole model. - Limbs bend: a bend channel (or pose.bend) curves an arm or leg smoothly at its middle, with its sleeve or pants layer, its armor and the item in its hand. - pose(...), hide, scale, rotate and translate change parts every frame; attach(part, armature) wears an animated armature on a part; when(...) limits all of it to some entities. - firstPersonArms(...) shows your own arms in first person posed as the clips pose them, with what you hold, in place of vanilla's hands. - Other mods animating the same parts: Better Combat's attacks and weapon poses are recognized, and the clips leave those parts to them by default (overlapRule(OverlapRule.YIELD / OVERRIDE / ADD)). Other animation mods can be made known with VanillaModels.registerOverlap, and VanillaModels.hasOverlap(entity) tells drivers when one is animating. - Scene viewports can lay text flat on their picture, in the texture's own pixels (SceneViewport.text(line, x, y, colour, scale), clearText()): a picture of nothing but text is drawn once, so text can be shown as a texture and cut, stretched or bent with what it is on. - Scene viewports can stand on a ground: SceneViewport.ground(y, cells, floor, lines, shadows) lays a floor with a grid of lines under the scene, turning with it, as large as what stands on it and a margin more, with a soft shadow under each entity. - Event phases reach other mods' own listeners: EventPhase.band() sorts phases into FIRST (FIRST and earlier), MIDDLE and LAST (LAST and later), and events whose loader hook fires each band at its own place run FIRST listeners before other mods' NeoForge or Fabric listeners of the game event and LAST ones after them. EventInvoker.invoker(Band) and hasListeners(Band) let a hook fire one band; invoker() still fires them all, in order. - ItemTooltipEvents.MODIFY does this on both loaders (NeoForge's highest, normal and lowest priorities; Fabric phases before, at and after the default one). - ItemTooltipEvents.APPEND: lines added at the very end of an item's tooltip, after the loaders' tooltip events and every other mod's lines, with the player when there is one; not fired for tooltips an item hides. - World effects can be drawn pixel for pixel: VfxMaterial.withSmoothing(false) samples the texture with nearest filtering instead of linear, so pixel art (block and item textures) stays crisp up close. Materials are smooth by default, as before. - Config screens without Glazed Menu: ConfigScreens now opens CoolCatLib's own screen when Glazed Menu isn't installed, in the look of the screen effects screen (the config's categories on the left, its settings on the right, a search over all of them, light and dark mode), instead of returning null. Switches, sliders, dropdowns for enums, a color picker and text boxes for everything else; changes wait for Done, server configs are sent to the server when playing on one (or shown read only), and settings needing a restart are marked. Glazed Menu's screens are still used whenever it is installed; ConfigScreens.isGlazedMenu() tells which. - ConfigScreens.categoryPopup(...) opens a popup floating over the current screen, editing just that category's settings (with reset buttons and Save), instead of the full screen. A server config the player may not change is greyed out and marked read only. - Quiet held-item changes (HeldItemSwaps, client): data a mod changes on a held item no longer makes it dip out of view and back as if swapped. HeldItemSwaps.quiet(component...) names components whose changes alone are quiet; HeldItemSwaps.register((shown, next) -> ...) decides for any change, from the stack shown and the one now held. Changes to attachments on an item are quiet by default; Attachment.Builder.swapAnimation() makes an attachment's changes play the swap as before. - GhostBlocks (api.client.vfx): blocks drawn as ghosts with their real models (block entities too), one see-through picture so only their outside shows, tinted and faded by one colour; shown through walls, in the world as real blocks would be, or always; full bright or shaded. - HeldItemSwaps.quiet(Supplier): a component registered later (a RegistryEntry) can be named while a mod sets up; it is looked up once stacks are first compared. Calling .get() on it then fails on NeoForge, where components aren't registered yet. 🔧 Changes - Block entity attachments kept in dropped items are written and read with plain injections instead of redirects, which the MixinExtras bundled with NeoForge could fail on at startup. - NeoForge: payloads are registered as optional, CoolCatLib's own included, so a client with CoolCatLib (and client-only mods built on it) can join a server without it and the other way round, as on Fabric (NeoForge used to disconnect whichever side lacked a channel). Configuration payloads are only sent to clients that have their channel. Network.sendToPlayer skips a player whose client lacks the payload's channel instead of throwing. - Rifts (WorldRifts) can be held facing one way (rift.facing(direction)), as a portal set in a wall, instead of turning to the camera. - Canvas's namespace is coolcatlib too: its assets (coolcatlib:bloom, coolcatlib:tint, #moj_import <coolcatlib:vfx.glsl>, coolcatlib:sky.glsl, coolcatlib:screen_effect.glsl, the GUI and VFX textures), text colours in JSON and commands ("coolcatlib:rainbow", "coolcatlib:gradient/..."), saved cutscenes (coolcatlib:saved/<name>, from config/coolcatlib/cutscenes/), translation keys, key bindings and payload ids. Its development commands are under /coolcatlib_client (effects, cutscene ...), and the effects screen's choices are saved to config/coolcatlib-screen-effects.json (choices saved by Canvas are not carried over). Shaders, resource packs and text that named coolcatcanvas: need the new name. - The packages are still net.ixdarklord.coolcatcore and net.ixdarklord.coolcatcanvas, so code that calls CoolCatLib needs no import changes.

26.1.2-5 — Oct 14, 2026

🔧 Changes - CoolCatLib is one mod again: CoolCatLib: Core and CoolCatLib: Canvas are merged into CoolCatLib, one jar per loader. Screen effects, skyboxes, world effects, cutscenes, GUI widgets and the render utilities now ship with the events, networking, registries and configs, so there is one file to install and one version to depend on. - The mod id is now coolcatlib. With it changed: the Fabric entrypoints (coolcatlib:common, coolcatlib:client, coolcatlib:server, coolcatlib:datagen), the commands (/coolcatlib config ..., /coolcatlib_client config ...), Core's translation keys (config.coolcatlib.*, tooltip.coolcatlib.*), its payload ids and ConfigTheme.STARFALL (coolcatlib:starfall). Players and servers need the same version, as with any update. - Nothing moved in the code: the packages are still net.ixdarklord.coolcatcore and net.ixdarklord.coolcatcanvas, and Canvas's classes keep their asset namespace (coolcatcanvas:bloom, coolcatcanvas:vfx.glsl, ...), command (/coolcatcanvas_client) and config files. - Mods built for CoolCatLib: Core or Canvas have to be updated: the coolcatcore and coolcatcanvas mod ids are gone, and constructors are only read from the coolcatlib:* Fabric entrypoints. Depend on coolcatlib alone. - Remove the CoolCatLib: Core and Canvas jars when updating: their classes are in this one. The loaders refuse to start with them installed. - Maven: the artifacts are now net.ixdarklord.coolcatlib:coolcatlib-<loader> (coolcatlib-common, coolcatlib-fabric, coolcatlib-neoforge) and hold everything. coolcatlib-core-<loader> and coolcatlib-canvas-<loader> stop at their last versions: replace both dependencies with the one. - Canvas's releases up to 7 are listed in CHANGELOG-canvas.md.

26.1.2-4 — Oct 5, 2026

✨ New Features - EntityAttributes.register(type, Mob::createAttributes) (api.registry): the default attributes every living entity type needs, from common code on both loaders. - Renderer registries (api.client.registry): EntityRendererRegistry.register(type, provider) and BlockEntityRendererRegistry.register(type, provider), from common code on both loaders. Types are passed as suppliers, so RegistryEntrys work before they are registered.

26.1.2-3 — Oct 4, 2026

✨ New Features - Item decorators: custom drawing over an item wherever the game draws it in a GUI (inventory slots, the hotbar, a held stack), after vanilla's durability bar, cooldown and count, the same on every loader. Implement api.item.DecoratedItem on the item's class and hand over its api.client.gui.ItemDecorator in registerDecorators(registrar): that's all, Core registers it by itself, on the client, the first time the item is drawn. An item's own isBarVisible still decides whether vanilla's bar shows under it.

26.1.2-2 — Oct 3, 2026

✨ New Features - Configured (MrCrayfish) shows CoolCatLib: Core's configs: every mod with one gets Configured's screens in NeoForge's mod list and Mod Menu while Glazed Menu isn't installed (with Glazed Menu, its screens show them instead). Booleans, numbers, enums and text get Configured's own widgets; colors, ids, lists and other types are edited as text. Synced configs are edited on the server for players allowed to. 🔧 Changes - The config screens moved out of Core into Glazed Menu, a standalone client-only mod (glazedmenu) that reads Core's configs when Core is installed. ConfigEditors, EditSlot and ValueEditor are now in net.ixdarklord.glazedmenu.api.editor. Core's ConfigScreens (api.config.client) stays as a bridge: with Glazed Menu installed its methods open Glazed Menu's screens, and without it they open nothing (they return null; isAvailable() tells which, and tellUnavailable(config) tells the player how to change the config). /coolcatcore_client config open is now /glazedmenu [mod] [config/category]. Core still loads, saves, syncs and hot reloads configs and keeps its other commands; without Glazed Menu (or Configured) there's just no in-game editor, and a startup mismatch on joining a server is the disconnect message alone. - The styled widgets and theme effects moved to CoolCatLib: Canvas: ConfigEffect and ConfigEffects are in net.ixdarklord.coolcatcanvas.api.client.gui.theme. The player's screen settings (dark/light mode, opacities, effects, transitions) are Glazed Menu's now, so Core has no client config of its own anymore. - Core no longer registers config buttons in NeoForge's mod list or Mod Menu; Glazed Menu or Configured does.

26.1.2-1 — Sep 30, 2026 (Minecraft 26.1.2 port)

✨ New Features - Runs on Minecraft 26.1, 26.1.1 and 26.1.2 (NeoForge 26.1.0.19-beta or newer, Fabric API 0.145.1 or newer). - CoolCatLib is split in two mods: CoolCatLib: Core (coolcatcore, package net.ixdarklord.coolcatcore), this one, and CoolCatLib: Canvas (coolcatcanvas), which now holds screen effects, skyboxes, GUI widgets, RenderUtils and Easing. The mod id, package, asset namespace, Fabric entrypoints (coolcatcore:common, ...) and commands (/coolcatcore, /coolcatcore_client) all changed from coolcatlib. - A cross-loader platform layer, so mods built on CoolCatLib: Core no longer need Architectury API: - Events (api.event.v2): EventInvoker keeps listeners in common code, ordered by EventPhase, and is found by its listener type (EventInvoker.lookup(ServerTickEvents.End.class)) or its constant (ServerTickEvents.END). EventInvoker.create(Type.class) makes a mod's own event, combining listeners by return type (void, EventResult, EventResultHolder, boolean). - Built-in events: server lifecycle and ticks, datapack contents sync (ServerLifecycleEvents.SYNC_DATA_PACK_CONTENTS: per player on login and after /reload), player join/leave/tick, entity load, block break/place, commands; client ticks, player join/leave, HUD rendering, item tooltips, client commands. - api.registry: DeferredRegister / RegistryEntry, CreativeTabs, ReloadListeners. - api.menu.ExtendedMenus: menu types that open with extra data. - api.network.Network: serverbound/clientbound payloads and sending. Network.canPlayerReceive(player, type) tells whether a player's connection accepts a payload (false for clients without the mod and for GameTest mock players; NeoForge throws when sending to them). - Record payloads without a StreamCodec: Network.registerServerbound(MyPayload.class, receiver) (or with an explicit Type) derives the codec from the record's components through PayloadCodecs, which knows primitives, strings, common Minecraft types, enums, nested records, arrays, Optional, List, Set, Map, Either and ResourceKey. Other types are added with PayloadCodecs.register / registerFactory; registering a payload with a component type that has no codec throws right away, naming the component. - api.client.registry: key mappings, menu screens, tooltip components. - api.platform.Platform: loader, environment, mod checks, folders, the running server, fake players. - Mod constructors (api.core): ModConstructor (both sides), ClientModConstructor, ServerModConstructor (dedicated server) and DataGenerationConstructor are written once in common code, each with a construct stage and a setup stage (DataGenerationContext.addProvider for data providers). - Fabric needs no Java entry class: list them under the coolcatcore:common, coolcatcore:client, coolcatcore:server and coolcatcore:datagen entrypoints, plus api.core.fabric.FabricDataGenerationEntrypoint under fabric-datagen. - NeoForge: extend api.core.neoforge.NeoForgeModEntrypoint in the @Mod class and call common(...), client(() -> ...), server(() -> ...), dataGeneration(...); the mod id comes from the container. - EventResult.pass()/interrupt()/allow()/deny(), and EventResultHolder.result()/getValue(). - A config system (api.config): - Declare configs with Config.builder(modId, scope) (typed values, nested groups, presets) or from an annotated class with ConfigObject.register. - Scopes: CLIENT, COMMON, SERVER (synced to players) and STARTUP (read before content is registered). - Types: booleans, ranged numbers (optionally sliders), strings (length/pattern), enums, colors, ids, lists, and any Codec; custom ConfigTypes with their own editors. - TOML (default) and JSON5 files with generated comments; a config whose format changes converts its old file once (kept as .bak); broken files are backed up; version/migration and aliases handle renamed or moved settings. - Hot reloading of edited files, change listeners and ConfigEvents: LOADED (first read), RELOADED (hot reload, the reload command or Config.reload()), VALUE_CHANGED (each value, with its old and new value), CHANGED (once per batch), SAVED and SYNCED. - serverOnly() values that never leave the server; operators edit synced configs in-game with permission checks. - Generated config screen: search, undo/redo, reset, presets, validation, dependencies (enabledWhen), restart notices and list editing. Linked from the NeoForge mod list and Mod Menu. - /coolcatcore config (server) and /coolcatcore_client config (client) commands: list, get, set, reset, reload, preset, open. - STARTUP configs, read before content is registered (for item properties, which items exist...). Their values stay fixed until a restart; edits are saved for the next start. Joining a server compares them before entering the world: values must match by default (the client is offered to adopt the server's), useServerValue() values are taken from the server while connected, and localOnly() values stay per side. - Category popups: one category of a config in a small window with Save and Cancel, floating over the current screen or the game, e.g. ConfigScreens.openCategory("mymod", "client/rendering"), ConfigScreens.categoryPopup(parent, config, path), or /coolcatcore_client config open <mod> <category> (with path suggestions). A single setting's path shows just that setting. - A color picker for color values (a popup with saturation/brightness, hue and alpha, hex input and dye colors), also available as ConfigScreens.colorPicker. - The main config screen (shown for every mod, even one with a single config): a header with the mod's icon (a "?" when it has none; the list of every mod's configs has its own icon), and each config as a portrait navigation card with its own artwork (faint, brightening on hover; CoolCatLib: Core's per scope, or the mod's own at assets/<modid>/textures/gui/config/cards/<config name>.png), its scope icon and a short label like "Server" (config.<modid>.<name>.label). Cards are centered, grow when hovered, and show a tooltip with the config's scope, contents, file and access. Mod Menu's CoolCatLib: Core button opens CoolCatLib: Core's own settings. - Page transitions: a config page's panels glide a little way into place (up from below when opened, down from above when going back, a shorter rise when opened from elsewhere) while growing from slightly smaller; the background stays still. - Choice settings: the arrows step to the previous or next value, and clicking the middle of the box opens a dropdown of every value (arrow keys, Enter and the wheel work in it). Constants implementing EnumType.Displayable can override description() to explain what they do, shown beside the dropdown on the highlighted value. - Config screen effects: animations a theme names by id, drawn behind the panels, over the whole screen, and over each widget (buttons, toggles, sliders, text fields, cards, popup panels). Mods register their own on the client with ConfigEffects.register(id, ConfigEffect) and use them with ConfigTheme.Builder.effects(...), ConfigBuilder.effects(...) for one config, or "effects" in config_theme.json; an unknown id is skipped and an effect that throws is switched off, each logged once. The built-in ConfigTheme.STARFALL, every theme's default, draws soft glows in the accent and small faint stars falling from the top, shifting with the mouse by depth (parallax). CoolCatLib: Core's client config turns effects and the page transitions on or off (Effects > Theme Effects / Page Transitions); both are always off on the Fast graphics preset. - Redesigned config screens: a top bar (title, scope badges, search), a category sidebar, settings with descriptions and nested sections, and a bottom bar with the unsaved-changes status and actions; toggle switches, sliders, selectors and flat buttons; presets, confirmations and the color picker as popups. Icons are 64x64 textures in assets/coolcatcore/textures/gui/config/icons/ (smoothly filtered), replaceable by resource packs. - ConfigTheme: each mod's own look, set per mod (ConfigTheme.setForMod) or per config (ConfigBuilder.theme / background): a full ConfigColorScheme (presets DARK, LIGHT, and tinted(accent) for the dark scheme shaded toward the mod's color), a background texture by its path (cover, stretch or tile), the texture's opacity (textureOpacity, letting the panorama or world show through) and the backdrop color's opacity over the background (backgroundOpacity). Players can scale both for every mod in CoolCatLib: Core's client config (Background > Backdrop Opacity / Texture Opacity). By default the screens are see-through to the title panorama or the world. Resource packs can restyle a mod with assets/<modid>/coolcatcore/config_theme.json. - Popup panel sprites: ConfigTheme.Builder.popupSprite (or popup_sprite in config_theme.json) draws a nine-slice GUI sprite as the panel of popups (category popups, confirmations, the color picker) instead of the flat panel, and ConfigScreens.categoryPopup(parent, config, path, theme) opens a category popup with its own theme, e.g. to match the screen it's opened from. - Toggle switches have an outline on their track: the panel border while off, a darker shade of the accent as they turn on. - Popups keep their buttons in a footer strip along the bottom and their content above it, so a sprite's footer band sits behind the buttons only (the color picker's Cancel and Done moved there). - The config list shows each mod's icon (a theme can set another); config pages and their cards show an icon of their kind (client, common, server, startup). - Platform.getModName. - Dark and light mode: a sun/moon switch in every config screen's top bar, remembered in CoolCatLib: Core's own client config (themeMode). Each theme has a light scheme too (ConfigTheme.Builder.lightColors, by default derived from the mod's accent; light_base/light_colors in config_theme.json). - The main config screen's search bar searches every config it lists (names, keys, comments, group names, values), with results grouped by config; opening a result shows that config filtered to it. A config's own search covers only that config. - Attachments, containers and handlers for items, blocks and entities: - api.attachment: typed data any entity (players included), block entity or item stack can carry. Each mod creates its own AttachmentRegistry.create(modId) (and calls register() while it initialises); its values are stored under its own id, in the <modid>:attachments item component and a <modid>:attachments tag in entity and block entity data. Declared once (ATTACHMENTS.builder(name, codec, default)), then used as MADNESS.get(player), set, update, modify, reset, or through AttachmentHolder.of(...). - Persistent attachments save with their holder; transientBuilder ones never do. copyOnDeath() keeps a player's value through death (always kept through dimension changes and the End exit); keepOnDrop() carries a block entity's value into its dropped item and back when placed. - sync(SyncPolicy): SELF (the player it belongs to), TRACKING, ALL, or any predicate. Only changed values are sent, at most once per tick; everything when a player starts seeing the holder, receives its chunk, joins, respawns or changes dimension. - On item stacks, defaults aren't stored, so stacks still stack. - AttachmentEvents: CHANGING (cancel a change or replace the value), ADDED, CHANGED (in-place changes included), REMOVED, START_TRACKING/STOP_TRACKING (a player starts or stops receiving a holder's data) and RECEIVED (synced values arrived on the client), plus typed per-attachment helpers (onChanged(MADNESS, ...)). - api.container: ContainerLayout (slot filters, limits, roles STORAGE/INPUT/OUTPUT/INTERNAL, which slots each face reaches) makes SlotContainers, vanilla Containers with insert/extract, listeners and layout-aware menu slots. AttachmentRegistry.container stores one on any entity or block entity (saved and synced with the rest); ItemContainers keeps one in a stack (ContainerItem for items that have one); ItemTransfer moves items between any containers through faces. - api.block: ExtendedBlockEntity (attachment shortcuts, handlers, serverTick/clientTick with ExtendedBlockEntity.ticker) and ExtendedContainerBlockEntity (an inventory hoppers and comparators use; contents spill or, with keepContentsOnBreak, stay in the item). - api.handler: HandlerType for anything holders hand out (inventories, energy...), from the holder itself (HandlerProvider, HandlerMap) or registered providers and fallbacks for blocks, block entities, entities and items. HandlerTypes.CONTAINER also finds vanilla containers (double chests as one). BlockHandlerCache keeps a lookup until the block changes, its block entity goes, or HandlerType.invalidate is called. - Other mods reach these containers through each loader's own system, following the layout's filters, roles and limits: NeoForge item handler capabilities (blocks, entities and ContainerItem stacks) and Fabric's Transfer API (ItemStorage.SIDED for blocks, ItemStorage.ITEM for ContainerItem stacks). - api.registry.BlockEntityTypes.create: block entity types from common code. - Storage menus (api.menu.StorageMenuDefinition): a menu for a block's or an item's inventory, declared once (StorageMenuDefinition.grid(columns, rows) or placed slot by slot), registered with createMenuType and opened with open(player, blockEntity, title) or open(player, hand, title). Slots follow the container's layout and shift-click; the menu closes when the block is removed, the player walks away, or the item leaves its slot (which stays locked meanwhile). sync(attachment) and syncValue(...) send extra values to the screen while it's open, and button(id, action) runs screen buttons on the server. api.client.gui.screens.StorageScreen draws any of these menus with no texture, and can be extended.

⚙️ Refactoring - Rewrote the v2 event system (the lookup-based skeleton had no events); EventInvokerRegistry was removed.

2001.1.0.0 — Oct 30, 2025

⚙️ Refactoring - Renamed and reorganized several classes. - Updated version formatting from X.X.X to MCVR.X.X.X to clearly distinguish between Minecraft release versions.

1.1.2 — April 11, 2025
  • Added new methods to MouseHelper and fixed an issue in RenderUtils
1.1.1 — (Fabric Hotfix) | March 20, 2025
  • Correct implementation of Potion Brewing and Potion Brewing Builder extension interfaces
1.1.0 — March 19, 2025
  • Revamped the Brewing Recipe API
  • Added two versions of Events (second version is still unstable)
  • Introduced new abstract classes for widgets
1.0.1 — December 30, 2024
  • Changing and Organizing the packages
1.0.0 — September 21, 2024
  • Port to 1.21
9.0.0 — Nov 16, 2026

✨ New Features - ModCommands (api.command): registers a mod's server commands with its mod id and the command's names, the first its own and the others aliases that work the same, e.g. ModCommands.register("ftbultimineaddition", List.of("ultimine_addition", "ua"), (root, context, selection) -> root.then(...)). A name another command already has (vanilla's /tm, another mod's) is skipped, with a warning in the log. ModCommands.registerClient(modId, names, (root, context) -> ...) does the same for client commands. Instead of names, a client command can take its server command's: ClientNames.MERGED shares them (one /folios for players: what the client's parts can run stays on the client, the rest goes to the server), ClientNames.SUFFIXED adds _client (/ua_client beside /ua). - Every mod with CoolCatLib configs gets a config command under its own commands: /<command> config opens the mod's config screens and /<command> config <config> one of them (/folios config client). Anyone can open them; what they may change is still up to each config's edit permission. - /<command> config reload [config] reads the mod's config files again after they were edited by hand, without restarting (for operators): the server's configs on the server, the player's client configs on their own game. - /coolcatlib config [mod] [config] and /coolcatlib config reload [mod] [config] do the same for any mod, and on servers without CoolCatLib the player's own game does it.

🔧 Changes - Breaking: Canvas's GUI and render helpers moved to tidier packages under net.ixdarklord.coolcatcanvas.api.client: gui.components and gui.components.widgets to gui.widget, gui.components.widgets.panel to gui.panel, gui.components.animations to gui.animation, utils.ScreenAnchor to gui.placement, utils.TextEffects to text, and utils.RenderUtils, Outline and NineSliceInfo to render. The class names are the same; mods using them update their imports. - CoolCatLib's visuals are a mod of their own again, CoolCatLib Canvas (coolcatcanvas), and it comes inside CoolCatLib's jar: nothing more to install. Mods built on its API need net.ixdarklord.coolcatlib:coolcatlib-canvas-<loader> beside coolcatlib-<loader> (CoolCatLib's POM names it). - Canvas's namespace is coolcatcanvas: its shaders and includes (#moj_import <coolcatcanvas:screen_effect.glsl>), text effects (coolcatcanvas:rainbow, coolcatcanvas:gradient/...), the armature item model type (coolcatcanvas:armature), its built-in effects (coolcatcanvas:tint, coolcatcanvas:bloom), lang keys, key bindings and payload ids. Resource packs and mods that name these with coolcatlib: need the new name. The effects screen's choices and saved cutscenes move to config/coolcatcanvas-screen-effects.json and config/coolcatcanvas/cutscenes/, carried over from where they were. - The config screens' look belongs to CoolCatLib itself: ConfigEffect and ConfigEffects moved to net.ixdarklord.coolcatcore.api.config.client, and the dark or light choice is saved in config/coolcatlib-style.json. - Needs Glazed Menu 1.2.2 or newer when it's installed: older ones look for the config screen effects where they were. - /coolcatlib_client is gone: the client's config command is part of /coolcatlib (on servers without CoolCatLib), and the visuals' commands are /coolcatcanvas effects and /coolcatcanvas cutscene .... - The config commands no longer get, set or reset values or apply presets from the chat (/coolcatlib config <id> get|set|reset|preset): they open the config screens, where all of that is done. - CommandEvents.REGISTER and ClientCommandEvents.REGISTER are deprecated: use ModCommands (register and registerClient). Commands registered through it still work, and still get the config command: they're matched to the mod whose configs are built in the same packages. - The renderer registries moved to Canvas, beside its renderers, in net.ixdarklord.coolcatcanvas.api.client.registry: BlockEntityRendererRegistry, EntityRendererRegistry, and ItemRendererRegistry (was SpecialModelRendererRegistry; registers item model types drawn by code). The ones in net.ixdarklord.coolcatcore.api.client.registry still work but are deprecated. - ArmatureBlockRenderer works like any BlockRenderer: it turns to its block with facing(Facing) (Facing.ALL by default; facing(boolean) and overriding facing(blockEntity, state) are deprecated, override direction instead), every BlockRenderer setting chains with its own (.detail(...).animate(...)), bounds grow from the armature's own instead of replacing them, offScreen is respected, and its layers turn with it. A subclass draws more the BlockRenderer way, with newState, extract and render, keeping its states reused.

🐛 Bug Fixes - A mod's server command no longer stops working when the mod also has a client command of the same name (/folios config beside the client's /folios guide): what only the server's command can run now goes to the server instead of failing on the client as an incorrect argument.

8.2.0 — Nov 10, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on every loader: - EntityEvents.SPAWN: a new mob is about to be added to the world (spawned naturally or with a new chunk, by a spawner, a spawn egg, a command, breeding, a conversion), with why it was made; interrupt to keep it out, with its passengers. EntityEvents.MOUNT: an entity is about to ride another (interrupt to keep it off), or got off one. - PlayerEvents.OPEN_MENU: a player is about to open a menu: a block's, an entity's, an item's, or one another mod opens with extra data; interrupt to keep it closed. - RecipeEvents.MATCH: a recipe matched where the game looks one up (furnaces, campfires, smithing tables, stonecutters, crafting grids, other mods' machines), with the block entity or the player asking; interrupt to pass it over for the next one that matches. - PlayerEvents.ADVANCEMENT_EARNED (a player completed an advancement), CommandEvents.EXECUTE (a command is about to run; interrupt to stop it) and LivingEvents.EFFECT_APPLICABLE (an effect is about to be given; interrupt to keep it off). - BlockEvents.DROPS: a broken block is about to drop its items and experience; change the list and the amount. - PlayerEvents.BREAK_SPEED and HARVEST_CHECK: how fast a player breaks a block, and whether their tool is right for it (without it, it drops nothing), on both sides. - MerchantEvents.OFFERS: the trades a player is shown, as their own list; take trades out to hide them (they can't make them either). - EnchantEvents.TABLE_OPTIONS (the enchantments an enchanting table's offer gives) and ANVIL_RESULT (what an anvil makes; interrupt with another stack or none). - LootEvents.MODIFY: any loot table's loot as it's rolled (chests, block drops, mobs, fishing), with the table's id; change the list. - PlayerEvents.ITEM_FISHED: what a player reeled in with a fishing rod, as its own list, before it's thrown to them; change the list. - LootTableEvents.MODIFY: a loot table loading (on server start and /reload), vanilla's, mods' and data packs' alike; add pools to it. - Blocks that look like other blocks to some players (api.block.BlockViews): BlockViews.register(id, view) adds a BlockView, which groups players by a key (players with the same key see the same, and a null key leaves everything as it is for them) and says what a block looks like to them. What the server sends them (chunks, block changes, block entities' data) has that block in its place, so their client never knows the real one, while the server keeps it for everything else. BlockViews.refresh(player) sends them their chunks again when what they should see changes. - SceneViewport.blockEntity(pos, blockEntity): a block entity in a viewport's scene, drawn by its renderer as in the world (its camera-facing parts face the viewer). - SpecialModelRendererRegistry (api.client.registry): registers special item model renderer types, the code-drawn parts of item models ("type": "minecraft:special"), the same on every loader. - Block entity renderers (coolcatcanvas.api.client.blockentity): BlockRenderer, a base that leaves a mod to write only what it draws (newState, extract, render). Registered as any renderer, with BlockEntityRendererRegistry.register(type, MyRenderer::new). - It is culled before the game makes it a render state: by distance (viewDistance, grown by reach for one shown larger), and when its bounds are out of view. This works the same on Fabric, which doesn't cull block entities by view at all, and on NeoForge, without NeoForge's new box per block entity per frame. - Detail by distance: detail(Detail.FULL, 16).detail(Detail.REDUCED, 40) sets what each block entity's state is drawn at (state.detail, state.detailed(...)), and layers are skipped past the detail they're drawn to. - Render states are reused from frame to frame instead of made anew for every block entity every frame (pooled(false) turns it off; createUnpooledState() makes one to keep). - facing(Facing.HORIZONTAL) or facing(Facing.ALL) turns what it draws to the block's facing. trackLookedAt() sets state.lookedAt, and BlockRenderContext.transition(...) eases a change in over some ticks. onFrame() runs once a frame, for work every block entity shares. - Layers (BlockRenderLayer, each with a typed state of its own): ItemLayer (an item shown on the block, which can spin and bob), LabelLayer (lines of text facing the camera, always, while looked at or never, within a range) and ChildLayer (another block entity drawn by its own renderer, such as a cabinet's pedestals). - With F3 + B, each one's bounds are drawn, colored by the detail it's drawn at. - GhostBlocks.Light.WORLD: ghosts lit as the world lights a real block there (each face shaded by its side, smooth lighting, the block and sky light where it stands), so a ghost of one block over another matches it exactly. Pass it to the new GhostBlocks.draw(blocks, argb, show, light); BRIGHT and SHADED are the old full-bright and shaded looks. - GhostBlocks.draw(groups, argbs, show, light): several groups of ghosts at once, each with its own colour and opacity (a reveal fading in waves). World-lit groups of solid blocks go over the world in one pass instead of one pass a group. - GhostBlocks.drawEffect(blocks, show, light, shader, texture, params): ghosts of blocks' real models (a flower's petals, grass's blades) with a fragment shader of the mod's own laid over the world where they show, in place of a flat colour: a force field running over the blocks, a scan, frost creeping across them. The shader imports coolcatlib:ghost_effect.glsl, which gives each pixel's place in the world, the ghosts' colour, a texture of the mod's choosing and up to sixteen numbers of its own. - SceneViewport.sprite(...): a glowing, camera-facing picture at a place in the scene (rays, halos, flares), added on as light and hidden by nearer blocks and entities.

🔧 Changes - CoolCatLib's mixin configs declare Java 25 (compatibilityLevel), so loading no longer warns that a mixin needs a newer class version. - GhostBlocks.Show.OVER_BLOCK ghosts are drawn a hair nearer the camera instead of a little larger, so they cover exactly their blocks' faces and no longer spill onto the blocks beside them. - World-lit ghosts keep their lighting from frame to frame and build it again only when their block changes, or twice a second for changes in the light. - World-lit ghosts of blocks drawn off the middle of their block (flowers, grass, other plants) sit where the real ones are, instead of in the middle. - ArmatureBlockRenderer is a BlockRenderer. Its setup and its State are unchanged, and it is now culled out of view by its armature's bounds, with its states reused. With detail bands set, it animates every other frame at REDUCED and every fourth at MINIMAL, without its attachments. It no longer makes two matrices per block entity per frame. A subclass that overrides createRenderState() still works, without the reuse; override newState() to get it.

8.1.0 — Nov 3, 2026

🔧 Changes - CoolCatLib's own config screen (used without Glazed Menu) lists each config as a row, instead of a card with artwork: its kind's icon, its name over what its kind means, and how many settings it has. A mod's own card artwork at assets/<modid>/textures/gui/config/cards/<config name>.png is no longer used. - Each kind of config has its own color in the config list (client blue, common teal, server purple, startup orange), unless the config sets its own theme; its rows are centered in the list and as tall as needed to fit without scrolling. - The list of every mod's configs has a new icon (a puzzle piece with a gear), drawn in the theme's accent, and the header's icons no longer sit in a box. - Config screens are in CoolCatLib's logo colors by default (warm brown, cream and orange, in dark and light mode), for mods that don't set their own: ConfigColorScheme.COOLCATLIB and COOLCATLIB_LIGHT, used by ConfigTheme.DEFAULT and any theme built without colors.

🐛 Bug Fixes - Opening CoolCatLib's config screens no longer crashes the game over a large mod icon (on 1.20.1, CoolCatLib's own logo was enough); an icon that can't be loaded is left out, with a warning in the log. - Mod icons larger than 512 pixels are scaled down before they're uploaded, as nothing is drawn near that size. - CoolCatLib's config list says when no mod has a config there, instead of showing an empty panel.

8.0.1 — Nov 2, 2026

🐛 Bug Fixes - ItemTooltipEvents.APPEND's lines go above the game's advanced tooltip lines (durability, the item's id, its component count) rather than under them.

8.0.0 — Oct 26, 2026

✨ New Features - GhostBlocks.Show.OVER_BLOCK: a ghost over the real block where it stands, hidden only by what is in front of it, to fade one block into another. - SceneViewport.perspective(fov): draws a viewport's scene in perspective, as the game's camera sees the world, and zoom moves the camera nearer; 0 (the default) keeps it flat. - More common events (api.event.v2.common), fired the same on every loader: - BlockEvents.PLACE: a block is about to be placed, by any block item (players, dispensers, other mods' machines) or an enderman; interrupt and it isn't, and the item isn't used up. - PlayerEvents.PICKUP_ITEM (interrupt to leave the item on the ground), TRAVEL_TO_DIMENSION (before any teleport to another dimension: portals, commands, other mods' teleporters; interrupt to stay), CRAFTED and SMELTED (an item taken from a crafting or furnace result slot). - LivingEvents.EQUIPMENT_CHANGE: what an entity wears or holds in a slot changed. - RecipeEvents.CRAFT_RESULT: a crafting recipe's result for a crafting grid or a crafter; interrupt with another stack, or an empty one so nothing can be crafted. - Game tests from common code (api.gametest), the same on Fabric and NeoForge: GameTests.register(modId, SomeTests.class) registers every @GameTest method (as <modid>:<class>/<method>), and GameTests.register(id, options, helper -> ...) one test by hand. GameTestOptions sets the structure, time limit, setup ticks, rotation, retries, sky access, padding and environment; without a structure of their own, tests run on CoolCatLib's coolcatlib:gametest/platform, an empty 8 × 6 × 8 space on a stone floor. Tests are added in a development environment or with -Dcoolcatlib.gametest=true (or the loader's own game test switch), then run with /test run <modid>:* or on a game test server. - Attachments on levels and on the server: get, set, update, modify, has and reset take a Level or the MinecraftServer, saved in its data folder and synced (SyncPolicy.ALL) to the players in the level, or to everyone. getGlobal(level) reads the server's values on either side. - Offline players' attachments: getOffline, setOffline, updateOffline and resetOffline read and write a player's saved values whether or not they're online (an offline player's data file is written at once). - Sound filters (api.client.sound): muffle, roughen and echo the game's sounds, as heard through a wall, under a spell or in a cave. - A SoundFilter is how loud a sound stays, how much of its high end it keeps, and how much of it goes through a distortion and into a reverb. muffled, quieter, distorted and echoing make the usual ones; then combines two and lerp goes part of the way, for fades. - SoundFilters.register(provider) adds a SoundFilterProvider, asked about each sound as it starts and as it moves, with a SoundContext: where it plays, which sound event it is, its category and whether it is relative to the listener (music, the menus). SoundFilterProvider.inWorld makes one for the sounds in the world only, by their place. register gives back a Registration to remove() it again. - Named filters for every sound at once (but the menus' clicks): SoundFilters.set(id, filter, fadeTicks) fades one in, clear(id, fadeTicks) out again; isSet(id). From the server, SoundFilterControl.set and clear (api.sound) do the same for a player. - SoundFilters.refresh() filters the sounds already playing again, when a provider's answers change. - Through OpenAL's EFX extension (a low-pass filter on each sound, sent to a distortion and a reverb effect); without it, sounds are left as they are. - Items drawn in a GUI at an opacity (api.client.gui.ItemOpacityRenderer), flat and solid ones alike, where the game draws them only fully opaque: render and renderWithDecorations (with the count and durability bar) at an opacity or an OpacityTween (in, out, between, eased over ticks and smooth at any frame rate), and withOpacity(opacity, draw) for anything that draws items, fading the text and bars drawn with them too. pushItemOpacity and popItemOpacity fade just the items drawn between them. - Placing GUI elements out of the way of everything else (api.client.gui.placement): GuiAreas.hud() and screen() give the boxes of what the HUD (every mod's HUD layers too: minimaps, block tooltips, boss bars) and the open screen drew last frame, the screen's widgets included but not its background or the tooltip under the mouse; GuiAreas.unrecorded(draw) draws your own element without it counting. GuiPlacement.hud() / screen() take a size, where you'd like it (at), a gap, the bounds to stay within and the directions it may slide in, leave out overlays and whatever you ignore, and find() the nearest clear place. - World effect layers: frame.draw(material, VfxLayer.of(n)) draws in a layer, lowest first, so a higher layer always covers a lower one. A VfxLayer.sorted(n) layer draws its painted-over shapes of every material back to front, so shapes of different textures cover each other as their distance says. Materials in a layer now draw in the order they were first used each frame, where before they drew in no set order.

🐛 Bug Fixes - Mod Menu and NeoForge's mod list have a config button for CoolCatLib again, and for every mod with a CoolCatLib config. It opens CoolCatLib's own config screens, or Glazed Menu's when it's installed (Glazed Menu then gives the other mods' buttons itself).

🔧 Changes - CoolCatLib's own config screens (used when Glazed Menu isn't installed) are the full ones again, the same as on 1.21.1 and 1.20.1: a card for each of a mod's configs (or every mod's), each config's screen with its categories, search, presets, undo and redo, list and color editors, and category popups. Configs go by their own names ("Client", "Server"), after their mod's where it matters ("Testing Mod › Client"), instead of "Testingmod Client"; translate one with config.<modid>.<name>.label. - Mod Menu no longer marks CoolCatLib as a library, so its list doesn't hide it by default. - New version numbers: <version>+<minecraft>, this one 8.0.0+26.1.2, the same for every Minecraft version and loader. They follow on from 26.1.2-7; the part before the + is what launchers and loaders compare, the Minecraft version after it is only a label. Depending on CoolCatLib: ask for >=8.0.0, and the Maven artifacts are coolcatlib-<loader>:8.0.0+26.1.2.

26.1.2-6 — Oct 22, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on Fabric and NeoForge: - InteractionEvents: USE_BLOCK, USE_ITEM and USE_ENTITY (answer with an InteractionResult: PASS lets the game go on, anything else stops it there) and ATTACK_BLOCK and ATTACK_ENTITY (interrupt to stop them), on both sides, before the game acts. - LivingEvents: DAMAGE (before armor; interrupt and no damage is taken) and DEATH (interrupt to keep the entity alive), on the server. - PlayerEvents.CLONE (the new player object after death or the End, to carry data over), RESPAWN and CHANGE_DIMENSION; EntityEvents.UNLOAD. - Custom boss bars (api.bossbar, api.client.bossbar): boss bars drawn a mod's own way, each in a style. - From the server, CustomBossBars.style(bar, style) gives any ServerBossEvent a style (and optionally the entity it belongs to); players seeing it are told, and those shown it later are told when they are. EntityBossBar.of(entity).style(...).range(48).showWhen(...).show() keeps a bar for any living entity by itself: its name, its health, the players near it, until the entity is gone. - On the client, BossBarRenderers.register(style, renderer) draws bars of a style, stacked with the game's own as the game stacks them. Renderers get a BossBarView: the progress eased smoothly, a trail of what was just lost (held, then draining), how fresh the last hit is, the linked entity while it is loaded, and the time. TexturedBossBar is a renderer made from one texture: a frame, a fill and a trail in its track, marks that light once passed (phases), a glow that pulses faster as the bar empties, a jolt and a flash on each hit. - A style with no renderer on a client, or a client without CoolCatLib, gets the game's own bar. - Armatures (api.client.armature, api.armature): modelled, animated entities, block entities and items, made in Blockbench and played with layered animation. - Models: Blockbench projects (.bbmodel) are read as saved, with no export step: groups, cubes with per-face UVs, free-form meshes, locators and null objects, several textures and textures embedded in the file. Bedrock .geo.json with .animation.json work too, and an .animation.json alone is enough for clips meant for another model. Files go in assets/<namespace>/armatures/; an optional <name>.armature.json sets materials per joint (cutout, solid, translucent, emissive, glow), extra animation files, texture swaps, springs, head tracking, an idle clip, transitions, scale and .obj props. A texture named <texture>_glow is drawn on top at full brightness. - Animation: an Animator per entity, block entity or item stack, with AnimLayers that each play one clip over the joints in their JointMask, overriding or adding to the layers below, with a weight that can fade. A layer can be driven by a function asked every frame (layer.drive(ctx -> ctx.moving() ? WALK : IDLE)), and play sets the driver aside until its motion ends. Motion says how a clip plays: loop, once, hold, ping-pong, a repeat count, speed (backwards too), a start time and what plays next. - Transitions: Transition.crossfade, freeze (the old pose holds still while the new one blends in) and CUT, each with a duration and easing. A layer has a default, rules for pairs of clips (transition("run", "idle", ...)), a TransitionRule function, and a switch to turn blending off; the animator has a default and a switch for every layer. A motion can carry its own. - Keyframes: linear, Catmull-Rom, Bézier and step interpolation; Molang in any value (math.*, query.*, variable.*, assignments, several statements), with the common queries built in and ArmatureQueries.register for a mod's own; anim_time_update, blend_weight, start and loop delays. Sound and particle keyframes play by themselves (a particle effect naming a world effect plays it), timeline keyframes run Molang, and animator.onEvent gets them all. - Procedural motion: animator.spring(joint) for tails, ears and capes that lag and swing (chains of them whip), kept out of the body by colliders, balls round the model's points (spring.collider(point, radius), or "colliders" in the armature file), so a cape drapes over a back and the spikes on it; free parts that hang or float where the world puts them (a spring with no stiffness): buoyancy lifts one (a balloon on a string), rope lets its string go slack, wind drifts it in slow gusts and twist spins it on its string as it swings, all reacting to the clips that move where it hangs from ("buoyancy", "rope", "wind", "twist" in the armature file's springs); and the world: a spring's weight kept out of the blocks round it and the entities near it (collideBlocks, collideEntities, a ball of collisionRadius pixels), bouncing off and dragging along what it touches (bounce, friction), so a tail rests on the ground and a balloon is pushed aside by a player walking into it ("collide": true or {"blocks", "entities", "radius", "bounce", "friction"}); a spring that pulls ("pulls": true) tugs the spring on its joint's parent along its length when stretched taut, by its share of their mass, so tension runs down a chain: a balloon draws its string of cord lengths taut toward it and the string curves as it is swung, instead of standing stiff with the balloon folded over its top; springs marked bump keep their weights apart and bounce off each other ("bump": true, a ball of collisionRadius, or "radius"): a bunch of balloons jostling; and spacing ("spacing", pixels) keeps room between them, easing them apart before they touch, so a bunch of gently lifted balloons opens out into a bouquet; cloth: springs woven to their neighbours (spring.link(joint...), "links") keep the distance the animation puts between their weights, firmly when pulled apart and as softly as linkStiffness ("link_stiffness", 0.6) when pushed together, so a cape of hanging chains side by side or a skirt of panels round a waist moves, ripples and folds as one sheet instead of parting into strips; and cloth sheets ("cloth": [{"joints": [[...row...], ...], "wrap"}] in the armature file): the faces of a sheet's joints are skinned, each corner weighed between its own joint, the one below and the one beside it, so a cape or a skirt bends smoothly between its springs and stays whole, with no seam opening or folding over, and their seams welded first: neighbours' corners that are each other's nearest and within a pixel are joined at their middle and weighed alike, so square-cut boxes that cannot quite meet (the panels of a skirt flaring to its hem) close into one smooth sheet that never parts; what a cloth is made of: mass (heavy cloth swings slowly and shrugs off the wind), airDrag (air resistance growing with speed: it streams out behind and settles), flutter (ripples the faster its wearer moves), stretch (gives and springs back), bend (holds its shape however heavy it is, critically damped: long curves instead of sagging into sharp folds or whipping), follow (its damping works on its speed relative to where the animation carries it: cloth keeps up with its wearer instead of lagging as if dragged; "follow", 0 by default) and a steady windDirection on top of the drifting wind ("mass", "air_drag", "flutter", "stretch", "bend", "wind_direction"), or all at once with a Fabric (spring.fabric(Fabric.WOOL), "fabric": "wool": silk, linen, cotton, wool, canvas, leather, rags, leaves, and cord for strings: a balloon's string as a chain of springs, skinned as a one-column sheet so it curves; keys after it change just what they name); springs are kept light: no allocation per frame, at most 8 sub-steps, a spring at rest with nothing moving it sleeps, block shapes are looked up a few times a second and entities every few frames, and past simulationDistance blocks from the camera (64; "simulation_distance") a spring isn't worked out at all; animator.lookAt(joint) follows where a mob looks, or the nearest player for blocks and items; animator.modify changes the pose in code; joints can be hidden, tinted and lit up. - Effects: .obj props carried on joints and points (ObjProp), glowing trails behind a point (animator.trail), and effect particles pouring from one (animator.emitter). - Rendering: ArmatureMobRenderer (keeps vanilla's hurt flash, death topple, sleeping, invisibility, glowing outline, name tags, leashes and render layers; holds items at points with holdItem/ItemSocket, dims or darkens its glow textures with glow), ArmatureEntityRenderer, ArmatureBlockRenderer (turns to the block's facing, shows the breaking cracks) and the coolcatlib:armature item model type, with ArmatureItems for per-item setup. Anything can be drawn at a point with attach, and ArmatureDraw draws a posed armature in a mod's own renderer (Style.glow sets how bright its glow textures are). - Per-entity variants and see-through drawing in ArmatureMobRenderer: armature(entity -> ...) picks the armature each entity is drawn with (variants whose bodies differ, each entity's animator made for the one it uses), tint((entity, partialTicks) -> argb) tints it each frame, and translucent(...) draws it see-through so the tint's alpha shows (ArmatureDraw.Style.translucent; glowing parts unchanged). - From the server: ArmatureControl.play, stop and setVariable for an entity, a block entity or the item in an entity's hand, sent to the players who can see it. On the client, Animators.of(...) and Animators.whenReady(...). - Vanilla models (api.client.armature.vanilla): clips, changes and worn armatures for vanilla mobs and players, without replacing their models. VanillaModels.player() or VanillaModels.of(type): - animations(armature) plays clips on the parts named like the joints (head, body, right_arm...; any spelling); a part a clip moves is taken over, the rest keep vanilla's animation, and armor and held items follow. A root joint moves the whole model (flips, sitting, lying down). Clips can be mirrored for left-handed entities (mirrorLeftHanded), and torsoJointNames() reads emote files whose torso is the body part and body the whole model. - Limbs bend: a bend channel (or pose.bend) curves an arm or leg smoothly at its middle, with its sleeve or pants layer, its armor and the item in its hand. - pose(...), hide, scale, rotate and translate change parts every frame; attach(part, armature) wears an animated armature on a part; when(...) limits all of it to some entities. - firstPersonArms(...) shows your own arms in first person posed as the clips pose them, with what you hold, in place of vanilla's hands. - Other mods animating the same parts: Better Combat's attacks and weapon poses are recognized, and the clips leave those parts to them by default (overlapRule(OverlapRule.YIELD / OVERRIDE / ADD)). Other animation mods can be made known with VanillaModels.registerOverlap, and VanillaModels.hasOverlap(entity) tells drivers when one is animating. - Scene viewports can lay text flat on their picture, in the texture's own pixels (SceneViewport.text(line, x, y, colour, scale), clearText()): a picture of nothing but text is drawn once, so text can be shown as a texture and cut, stretched or bent with what it is on. - Scene viewports can stand on a ground: SceneViewport.ground(y, cells, floor, lines, shadows) lays a floor with a grid of lines under the scene, turning with it, as large as what stands on it and a margin more, with a soft shadow under each entity. - Event phases reach other mods' own listeners: EventPhase.band() sorts phases into FIRST (FIRST and earlier), MIDDLE and LAST (LAST and later), and events whose loader hook fires each band at its own place run FIRST listeners before other mods' NeoForge or Fabric listeners of the game event and LAST ones after them. EventInvoker.invoker(Band) and hasListeners(Band) let a hook fire one band; invoker() still fires them all, in order. - ItemTooltipEvents.MODIFY does this on both loaders (NeoForge's highest, normal and lowest priorities; Fabric phases before, at and after the default one). - ItemTooltipEvents.APPEND: lines added at the very end of an item's tooltip, after the loaders' tooltip events and every other mod's lines, with the player when there is one; not fired for tooltips an item hides. - World effects can be drawn pixel for pixel: VfxMaterial.withSmoothing(false) samples the texture with nearest filtering instead of linear, so pixel art (block and item textures) stays crisp up close. Materials are smooth by default, as before. - Config screens without Glazed Menu: ConfigScreens now opens CoolCatLib's own screen when Glazed Menu isn't installed, in the look of the screen effects screen (the config's categories on the left, its settings on the right, a search over all of them, light and dark mode), instead of returning null. Switches, sliders, dropdowns for enums, a color picker and text boxes for everything else; changes wait for Done, server configs are sent to the server when playing on one (or shown read only), and settings needing a restart are marked. Glazed Menu's screens are still used whenever it is installed; ConfigScreens.isGlazedMenu() tells which. - ConfigScreens.categoryPopup(...) opens a popup floating over the current screen, editing just that category's settings (with reset buttons and Save), instead of the full screen. A server config the player may not change is greyed out and marked read only. - Quiet held-item changes (HeldItemSwaps, client): data a mod changes on a held item no longer makes it dip out of view and back as if swapped. HeldItemSwaps.quiet(component...) names components whose changes alone are quiet; HeldItemSwaps.register((shown, next) -> ...) decides for any change, from the stack shown and the one now held. Changes to attachments on an item are quiet by default; Attachment.Builder.swapAnimation() makes an attachment's changes play the swap as before. - GhostBlocks (api.client.vfx): blocks drawn as ghosts with their real models (block entities too), one see-through picture so only their outside shows, tinted and faded by one colour; shown through walls, in the world as real blocks would be, or always; full bright or shaded. - HeldItemSwaps.quiet(Supplier): a component registered later (a RegistryEntry) can be named while a mod sets up; it is looked up once stacks are first compared. Calling .get() on it then fails on NeoForge, where components aren't registered yet. 🔧 Changes - Block entity attachments kept in dropped items are written and read with plain injections instead of redirects, which the MixinExtras bundled with NeoForge could fail on at startup. - NeoForge: payloads are registered as optional, CoolCatLib's own included, so a client with CoolCatLib (and client-only mods built on it) can join a server without it and the other way round, as on Fabric (NeoForge used to disconnect whichever side lacked a channel). Configuration payloads are only sent to clients that have their channel. Network.sendToPlayer skips a player whose client lacks the payload's channel instead of throwing. - Rifts (WorldRifts) can be held facing one way (rift.facing(direction)), as a portal set in a wall, instead of turning to the camera. - Canvas's namespace is coolcatlib too: its assets (coolcatlib:bloom, coolcatlib:tint, #moj_import <coolcatlib:vfx.glsl>, coolcatlib:sky.glsl, coolcatlib:screen_effect.glsl, the GUI and VFX textures), text colours in JSON and commands ("coolcatlib:rainbow", "coolcatlib:gradient/..."), saved cutscenes (coolcatlib:saved/<name>, from config/coolcatlib/cutscenes/), translation keys, key bindings and payload ids. Its development commands are under /coolcatlib_client (effects, cutscene ...), and the effects screen's choices are saved to config/coolcatlib-screen-effects.json (choices saved by Canvas are not carried over). Shaders, resource packs and text that named coolcatcanvas: need the new name. - The packages are still net.ixdarklord.coolcatcore and net.ixdarklord.coolcatcanvas, so code that calls CoolCatLib needs no import changes.

26.1.2-5 — Oct 14, 2026

🔧 Changes - CoolCatLib is one mod again: CoolCatLib: Core and CoolCatLib: Canvas are merged into CoolCatLib, one jar per loader. Screen effects, skyboxes, world effects, cutscenes, GUI widgets and the render utilities now ship with the events, networking, registries and configs, so there is one file to install and one version to depend on. - The mod id is now coolcatlib. With it changed: the Fabric entrypoints (coolcatlib:common, coolcatlib:client, coolcatlib:server, coolcatlib:datagen), the commands (/coolcatlib config ..., /coolcatlib_client config ...), Core's translation keys (config.coolcatlib.*, tooltip.coolcatlib.*), its payload ids and ConfigTheme.STARFALL (coolcatlib:starfall). Players and servers need the same version, as with any update. - Nothing moved in the code: the packages are still net.ixdarklord.coolcatcore and net.ixdarklord.coolcatcanvas, and Canvas's classes keep their asset namespace (coolcatcanvas:bloom, coolcatcanvas:vfx.glsl, ...), command (/coolcatcanvas_client) and config files. - Mods built for CoolCatLib: Core or Canvas have to be updated: the coolcatcore and coolcatcanvas mod ids are gone, and constructors are only read from the coolcatlib:* Fabric entrypoints. Depend on coolcatlib alone. - Remove the CoolCatLib: Core and Canvas jars when updating: their classes are in this one. The loaders refuse to start with them installed. - Maven: the artifacts are now net.ixdarklord.coolcatlib:coolcatlib-<loader> (coolcatlib-common, coolcatlib-fabric, coolcatlib-neoforge) and hold everything. coolcatlib-core-<loader> and coolcatlib-canvas-<loader> stop at their last versions: replace both dependencies with the one. - Canvas's releases up to 7 are listed in CHANGELOG-canvas.md.

26.1.2-4 — Oct 5, 2026

✨ New Features - EntityAttributes.register(type, Mob::createAttributes) (api.registry): the default attributes every living entity type needs, from common code on both loaders. - Renderer registries (api.client.registry): EntityRendererRegistry.register(type, provider) and BlockEntityRendererRegistry.register(type, provider), from common code on both loaders. Types are passed as suppliers, so RegistryEntrys work before they are registered.

26.1.2-3 — Oct 4, 2026

✨ New Features - Item decorators: custom drawing over an item wherever the game draws it in a GUI (inventory slots, the hotbar, a held stack), after vanilla's durability bar, cooldown and count, the same on every loader. Implement api.item.DecoratedItem on the item's class and hand over its api.client.gui.ItemDecorator in registerDecorators(registrar): that's all, Core registers it by itself, on the client, the first time the item is drawn. An item's own isBarVisible still decides whether vanilla's bar shows under it.

26.1.2-2 — Oct 3, 2026

✨ New Features - Configured (MrCrayfish) shows CoolCatLib: Core's configs: every mod with one gets Configured's screens in NeoForge's mod list and Mod Menu while Glazed Menu isn't installed (with Glazed Menu, its screens show them instead). Booleans, numbers, enums and text get Configured's own widgets; colors, ids, lists and other types are edited as text. Synced configs are edited on the server for players allowed to. 🔧 Changes - The config screens moved out of Core into Glazed Menu, a standalone client-only mod (glazedmenu) that reads Core's configs when Core is installed. ConfigEditors, EditSlot and ValueEditor are now in net.ixdarklord.glazedmenu.api.editor. Core's ConfigScreens (api.config.client) stays as a bridge: with Glazed Menu installed its methods open Glazed Menu's screens, and without it they open nothing (they return null; isAvailable() tells which, and tellUnavailable(config) tells the player how to change the config). /coolcatcore_client config open is now /glazedmenu [mod] [config/category]. Core still loads, saves, syncs and hot reloads configs and keeps its other commands; without Glazed Menu (or Configured) there's just no in-game editor, and a startup mismatch on joining a server is the disconnect message alone. - The styled widgets and theme effects moved to CoolCatLib: Canvas: ConfigEffect and ConfigEffects are in net.ixdarklord.coolcatcanvas.api.client.gui.theme. The player's screen settings (dark/light mode, opacities, effects, transitions) are Glazed Menu's now, so Core has no client config of its own anymore. - Core no longer registers config buttons in NeoForge's mod list or Mod Menu; Glazed Menu or Configured does.

26.1.2-1 — Sep 30, 2026 (Minecraft 26.1.2 port)

✨ New Features - Runs on Minecraft 26.1, 26.1.1 and 26.1.2 (NeoForge 26.1.0.19-beta or newer, Fabric API 0.145.1 or newer). - CoolCatLib is split in two mods: CoolCatLib: Core (coolcatcore, package net.ixdarklord.coolcatcore), this one, and CoolCatLib: Canvas (coolcatcanvas), which now holds screen effects, skyboxes, GUI widgets, RenderUtils and Easing. The mod id, package, asset namespace, Fabric entrypoints (coolcatcore:common, ...) and commands (/coolcatcore, /coolcatcore_client) all changed from coolcatlib. - A cross-loader platform layer, so mods built on CoolCatLib: Core no longer need Architectury API: - Events (api.event.v2): EventInvoker keeps listeners in common code, ordered by EventPhase, and is found by its listener type (EventInvoker.lookup(ServerTickEvents.End.class)) or its constant (ServerTickEvents.END). EventInvoker.create(Type.class) makes a mod's own event, combining listeners by return type (void, EventResult, EventResultHolder, boolean). - Built-in events: server lifecycle and ticks, datapack contents sync (ServerLifecycleEvents.SYNC_DATA_PACK_CONTENTS: per player on login and after /reload), player join/leave/tick, entity load, block break/place, commands; client ticks, player join/leave, HUD rendering, item tooltips, client commands. - api.registry: DeferredRegister / RegistryEntry, CreativeTabs, ReloadListeners. - api.menu.ExtendedMenus: menu types that open with extra data. - api.network.Network: serverbound/clientbound payloads and sending. Network.canPlayerReceive(player, type) tells whether a player's connection accepts a payload (false for clients without the mod and for GameTest mock players; NeoForge throws when sending to them). - Record payloads without a StreamCodec: Network.registerServerbound(MyPayload.class, receiver) (or with an explicit Type) derives the codec from the record's components through PayloadCodecs, which knows primitives, strings, common Minecraft types, enums, nested records, arrays, Optional, List, Set, Map, Either and ResourceKey. Other types are added with PayloadCodecs.register / registerFactory; registering a payload with a component type that has no codec throws right away, naming the component. - api.client.registry: key mappings, menu screens, tooltip components. - api.platform.Platform: loader, environment, mod checks, folders, the running server, fake players. - Mod constructors (api.core): ModConstructor (both sides), ClientModConstructor, ServerModConstructor (dedicated server) and DataGenerationConstructor are written once in common code, each with a construct stage and a setup stage (DataGenerationContext.addProvider for data providers). - Fabric needs no Java entry class: list them under the coolcatcore:common, coolcatcore:client, coolcatcore:server and coolcatcore:datagen entrypoints, plus api.core.fabric.FabricDataGenerationEntrypoint under fabric-datagen. - NeoForge: extend api.core.neoforge.NeoForgeModEntrypoint in the @Mod class and call common(...), client(() -> ...), server(() -> ...), dataGeneration(...); the mod id comes from the container. - EventResult.pass()/interrupt()/allow()/deny(), and EventResultHolder.result()/getValue(). - A config system (api.config): - Declare configs with Config.builder(modId, scope) (typed values, nested groups, presets) or from an annotated class with ConfigObject.register. - Scopes: CLIENT, COMMON, SERVER (synced to players) and STARTUP (read before content is registered). - Types: booleans, ranged numbers (optionally sliders), strings (length/pattern), enums, colors, ids, lists, and any Codec; custom ConfigTypes with their own editors. - TOML (default) and JSON5 files with generated comments; a config whose format changes converts its old file once (kept as .bak); broken files are backed up; version/migration and aliases handle renamed or moved settings. - Hot reloading of edited files, change listeners and ConfigEvents: LOADED (first read), RELOADED (hot reload, the reload command or Config.reload()), VALUE_CHANGED (each value, with its old and new value), CHANGED (once per batch), SAVED and SYNCED. - serverOnly() values that never leave the server; operators edit synced configs in-game with permission checks. - Generated config screen: search, undo/redo, reset, presets, validation, dependencies (enabledWhen), restart notices and list editing. Linked from the NeoForge mod list and Mod Menu. - /coolcatcore config (server) and /coolcatcore_client config (client) commands: list, get, set, reset, reload, preset, open. - STARTUP configs, read before content is registered (for item properties, which items exist...). Their values stay fixed until a restart; edits are saved for the next start. Joining a server compares them before entering the world: values must match by default (the client is offered to adopt the server's), useServerValue() values are taken from the server while connected, and localOnly() values stay per side. - Category popups: one category of a config in a small window with Save and Cancel, floating over the current screen or the game, e.g. ConfigScreens.openCategory("mymod", "client/rendering"), ConfigScreens.categoryPopup(parent, config, path), or /coolcatcore_client config open <mod> <category> (with path suggestions). A single setting's path shows just that setting. - A color picker for color values (a popup with saturation/brightness, hue and alpha, hex input and dye colors), also available as ConfigScreens.colorPicker. - The main config screen (shown for every mod, even one with a single config): a header with the mod's icon (a "?" when it has none; the list of every mod's configs has its own icon), and each config as a portrait navigation card with its own artwork (faint, brightening on hover; CoolCatLib: Core's per scope, or the mod's own at assets/<modid>/textures/gui/config/cards/<config name>.png), its scope icon and a short label like "Server" (config.<modid>.<name>.label). Cards are centered, grow when hovered, and show a tooltip with the config's scope, contents, file and access. Mod Menu's CoolCatLib: Core button opens CoolCatLib: Core's own settings. - Page transitions: a config page's panels glide a little way into place (up from below when opened, down from above when going back, a shorter rise when opened from elsewhere) while growing from slightly smaller; the background stays still. - Choice settings: the arrows step to the previous or next value, and clicking the middle of the box opens a dropdown of every value (arrow keys, Enter and the wheel work in it). Constants implementing EnumType.Displayable can override description() to explain what they do, shown beside the dropdown on the highlighted value. - Config screen effects: animations a theme names by id, drawn behind the panels, over the whole screen, and over each widget (buttons, toggles, sliders, text fields, cards, popup panels). Mods register their own on the client with ConfigEffects.register(id, ConfigEffect) and use them with ConfigTheme.Builder.effects(...), ConfigBuilder.effects(...) for one config, or "effects" in config_theme.json; an unknown id is skipped and an effect that throws is switched off, each logged once. The built-in ConfigTheme.STARFALL, every theme's default, draws soft glows in the accent and small faint stars falling from the top, shifting with the mouse by depth (parallax). CoolCatLib: Core's client config turns effects and the page transitions on or off (Effects > Theme Effects / Page Transitions); both are always off on the Fast graphics preset. - Redesigned config screens: a top bar (title, scope badges, search), a category sidebar, settings with descriptions and nested sections, and a bottom bar with the unsaved-changes status and actions; toggle switches, sliders, selectors and flat buttons; presets, confirmations and the color picker as popups. Icons are 64x64 textures in assets/coolcatcore/textures/gui/config/icons/ (smoothly filtered), replaceable by resource packs. - ConfigTheme: each mod's own look, set per mod (ConfigTheme.setForMod) or per config (ConfigBuilder.theme / background): a full ConfigColorScheme (presets DARK, LIGHT, and tinted(accent) for the dark scheme shaded toward the mod's color), a background texture by its path (cover, stretch or tile), the texture's opacity (textureOpacity, letting the panorama or world show through) and the backdrop color's opacity over the background (backgroundOpacity). Players can scale both for every mod in CoolCatLib: Core's client config (Background > Backdrop Opacity / Texture Opacity). By default the screens are see-through to the title panorama or the world. Resource packs can restyle a mod with assets/<modid>/coolcatcore/config_theme.json. - Popup panel sprites: ConfigTheme.Builder.popupSprite (or popup_sprite in config_theme.json) draws a nine-slice GUI sprite as the panel of popups (category popups, confirmations, the color picker) instead of the flat panel, and ConfigScreens.categoryPopup(parent, config, path, theme) opens a category popup with its own theme, e.g. to match the screen it's opened from. - Toggle switches have an outline on their track: the panel border while off, a darker shade of the accent as they turn on. - Popups keep their buttons in a footer strip along the bottom and their content above it, so a sprite's footer band sits behind the buttons only (the color picker's Cancel and Done moved there). - The config list shows each mod's icon (a theme can set another); config pages and their cards show an icon of their kind (client, common, server, startup). - Platform.getModName. - Dark and light mode: a sun/moon switch in every config screen's top bar, remembered in CoolCatLib: Core's own client config (themeMode). Each theme has a light scheme too (ConfigTheme.Builder.lightColors, by default derived from the mod's accent; light_base/light_colors in config_theme.json). - The main config screen's search bar searches every config it lists (names, keys, comments, group names, values), with results grouped by config; opening a result shows that config filtered to it. A config's own search covers only that config. - Attachments, containers and handlers for items, blocks and entities: - api.attachment: typed data any entity (players included), block entity or item stack can carry. Each mod creates its own AttachmentRegistry.create(modId) (and calls register() while it initialises); its values are stored under its own id, in the <modid>:attachments item component and a <modid>:attachments tag in entity and block entity data. Declared once (ATTACHMENTS.builder(name, codec, default)), then used as MADNESS.get(player), set, update, modify, reset, or through AttachmentHolder.of(...). - Persistent attachments save with their holder; transientBuilder ones never do. copyOnDeath() keeps a player's value through death (always kept through dimension changes and the End exit); keepOnDrop() carries a block entity's value into its dropped item and back when placed. - sync(SyncPolicy): SELF (the player it belongs to), TRACKING, ALL, or any predicate. Only changed values are sent, at most once per tick; everything when a player starts seeing the holder, receives its chunk, joins, respawns or changes dimension. - On item stacks, defaults aren't stored, so stacks still stack. - AttachmentEvents: CHANGING (cancel a change or replace the value), ADDED, CHANGED (in-place changes included), REMOVED, START_TRACKING/STOP_TRACKING (a player starts or stops receiving a holder's data) and RECEIVED (synced values arrived on the client), plus typed per-attachment helpers (onChanged(MADNESS, ...)). - api.container: ContainerLayout (slot filters, limits, roles STORAGE/INPUT/OUTPUT/INTERNAL, which slots each face reaches) makes SlotContainers, vanilla Containers with insert/extract, listeners and layout-aware menu slots. AttachmentRegistry.container stores one on any entity or block entity (saved and synced with the rest); ItemContainers keeps one in a stack (ContainerItem for items that have one); ItemTransfer moves items between any containers through faces. - api.block: ExtendedBlockEntity (attachment shortcuts, handlers, serverTick/clientTick with ExtendedBlockEntity.ticker) and ExtendedContainerBlockEntity (an inventory hoppers and comparators use; contents spill or, with keepContentsOnBreak, stay in the item). - api.handler: HandlerType for anything holders hand out (inventories, energy...), from the holder itself (HandlerProvider, HandlerMap) or registered providers and fallbacks for blocks, block entities, entities and items. HandlerTypes.CONTAINER also finds vanilla containers (double chests as one). BlockHandlerCache keeps a lookup until the block changes, its block entity goes, or HandlerType.invalidate is called. - Other mods reach these containers through each loader's own system, following the layout's filters, roles and limits: NeoForge item handler capabilities (blocks, entities and ContainerItem stacks) and Fabric's Transfer API (ItemStorage.SIDED for blocks, ItemStorage.ITEM for ContainerItem stacks). - api.registry.BlockEntityTypes.create: block entity types from common code. - Storage menus (api.menu.StorageMenuDefinition): a menu for a block's or an item's inventory, declared once (StorageMenuDefinition.grid(columns, rows) or placed slot by slot), registered with createMenuType and opened with open(player, blockEntity, title) or open(player, hand, title). Slots follow the container's layout and shift-click; the menu closes when the block is removed, the player walks away, or the item leaves its slot (which stays locked meanwhile). sync(attachment) and syncValue(...) send extra values to the screen while it's open, and button(id, action) runs screen buttons on the server. api.client.gui.screens.StorageScreen draws any of these menus with no texture, and can be extended.

⚙️ Refactoring - Rewrote the v2 event system (the lookup-based skeleton had no events); EventInvokerRegistry was removed.

2001.1.0.0 — Oct 30, 2025

⚙️ Refactoring - Renamed and reorganized several classes. - Updated version formatting from X.X.X to MCVR.X.X.X to clearly distinguish between Minecraft release versions.

1.1.2 — April 11, 2025
  • Added new methods to MouseHelper and fixed an issue in RenderUtils
1.1.1 — (Fabric Hotfix) | March 20, 2025
  • Correct implementation of Potion Brewing and Potion Brewing Builder extension interfaces
1.1.0 — March 19, 2025
  • Revamped the Brewing Recipe API
  • Added two versions of Events (second version is still unstable)
  • Introduced new abstract classes for widgets
1.0.1 — December 30, 2024
  • Changing and Organizing the packages
1.0.0 — September 21, 2024
  • Port to 1.21
9.0.0 — Nov 16, 2026

✨ New Features - ModCommands (api.command): registers a mod's server commands with its mod id and the command's names, the first its own and the others aliases that work the same, e.g. ModCommands.register("ftbultimineaddition", List.of("ultimine_addition", "ua"), (root, context, selection) -> root.then(...)). A name another command already has (vanilla's /tm, another mod's) is skipped, with a warning in the log. ModCommands.registerClient(modId, names, (root, context) -> ...) does the same for client commands. Instead of names, a client command can take its server command's: ClientNames.MERGED shares them (one /folios for players: what the client's parts can run stays on the client, the rest goes to the server), ClientNames.SUFFIXED adds _client (/ua_client beside /ua). - Every mod with CoolCatLib configs gets a config command under its own commands: /<command> config opens the mod's config screens and /<command> config <config> one of them (/folios config client). Anyone can open them; what they may change is still up to each config's edit permission. - /<command> config reload [config] reads the mod's config files again after they were edited by hand, without restarting (for operators): the server's configs on the server, the player's client configs on their own game. - /coolcatlib config [mod] [config] and /coolcatlib config reload [mod] [config] do the same for any mod, and on servers without CoolCatLib the player's own game does it. - Block entity renderers come to 1.21.1 with the same API as on 26.1 (coolcatcanvas.api.client.blockentity): BlockRenderer with culling by bounds, detail by distance, facing and layers (ItemLayer, LabelLayer, ChildLayer); render and a layer's submit take a MultiBufferSource and the Camera. Also EntityRendererRegistry and ItemRendererRegistry in coolcatcanvas.api.client.registry, and ObjModel. - Armatures come to 1.21.1 with the same API as on 26.1 (api.client.armature, api.armature): Armature, Animator, ArmatureMobRenderer, ArmatureEntityRenderer, ArmatureBlockRenderer, ArmatureItems, VanillaModels and ArmatureControl. An armature item names its armature in its own model (models/item/<item>.json: "parent": "builtin/entity" and "coolcatcanvas:armature": {...}), as 1.21.1 has no item model types.

🔧 Changes - Breaking: Canvas's GUI and render helpers moved to tidier packages under net.ixdarklord.coolcatcanvas.api.client: gui.components and gui.components.widgets to gui.widget, gui.components.widgets.panel to gui.panel, gui.components.animations to gui.animation, utils.ScreenAnchor to gui.placement, utils.TextEffects to text, and utils.RenderUtils, Outline and NineSliceInfo to render. The class names are the same; mods using them update their imports. - CoolCatLib's visuals are a mod of their own again, CoolCatLib Canvas (coolcatcanvas), and it comes inside CoolCatLib's jar: nothing more to install. Mods built on its API need net.ixdarklord.coolcatlib:coolcatlib-canvas-<loader> beside coolcatlib-<loader> (CoolCatLib's POM names it). - /coolcatlib_client is gone: the client's config command is part of /coolcatlib (on servers without CoolCatLib). - The config commands no longer get, set or reset values or apply presets from the chat (/coolcatlib config <id> get|set|reset|preset): they open the config screens, where all of that is done. - /coolcatlib_client config open [mod] is now /coolcatlib config [mod] [config]. - /coolcatcanvas_client effects is now /coolcatcanvas effects. - CommandEvents.REGISTER and ClientCommandEvents.REGISTER are deprecated: use ModCommands (register and registerClient). Commands registered through it still work, and still get the config command: they're matched to the mod whose configs are built in the same packages. - The renderer registries moved to Canvas: BlockEntityRendererRegistry and ItemRendererRegistry are in net.ixdarklord.coolcatcanvas.api.client.registry. The ones in net.ixdarklord.coolcatcore.api.client.registry still work but are deprecated.

🐛 Bug Fixes - A mod's server command no longer stops working when the mod also has a client command of the same name (/folios config beside the client's /folios guide): what only the server's command can run now goes to the server instead of failing on the client as an incorrect argument.

8.2.2 — Nov 13, 2026

🐛 Bug Fixes - Fixed a memory leak on Forge: CoolCatLib kept every block entity the game had made (all but vanilla containers) for the whole session, so memory filled up over long sessions or with machines that make and remove many block entities.

8.2.1 — Nov 12, 2026

🐛 Bug Fixes - No longer crashes the game alongside Citadel (or any mod that changes the smithing table's recipe lookup): CoolCatLib's hooks added in 8.2.0 (the smithing table's recipes, a merchant's offers, BlockViews' chunk data, and a broken block's drops on Fabric and Forge) now wrap the game's calls instead of replacing them, so other mods can change the same calls too.

8.2.0 — Nov 10, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on every loader: - EntityEvents.SPAWN: a new mob is about to be added to the world (spawned naturally or with a new chunk, by a spawner, a spawn egg, a command, breeding, a conversion), with why it was made when the game says; interrupt to keep it out, with its passengers. EntityEvents.MOUNT: an entity is about to ride another (interrupt to keep it off), or got off one. - PlayerEvents.OPEN_MENU: a player is about to open a menu: a block's, an entity's, an item's, or one another mod opens with extra data; interrupt to keep it closed. - RecipeEvents.MATCH: a recipe matched where the game looks one up (furnaces, campfires, smithing tables, stonecutters, crafting grids, other mods' machines), with the block entity or the player asking; interrupt to pass it over for the next one that matches. - PlayerEvents.ADVANCEMENT_EARNED (a player completed an advancement), CommandEvents.EXECUTE (a command is about to run; interrupt to stop it) and LivingEvents.EFFECT_APPLICABLE (an effect is about to be given; interrupt to keep it off). - BlockEvents.DROPS: a broken block is about to drop its items and experience; change the list and the amount. - PlayerEvents.BREAK_SPEED and HARVEST_CHECK: how fast a player breaks a block, and whether their tool is right for it (without it, it drops nothing), on both sides. - MerchantEvents.OFFERS: the trades a player is shown, as their own list; take trades out to hide them (they can't make them either). - EnchantEvents.TABLE_OPTIONS (the enchantments an enchanting table's offer gives) and ANVIL_RESULT (what an anvil makes; interrupt with another stack or none). - LootEvents.MODIFY: any loot table's loot as it's rolled (chests, block drops, mobs, fishing), with the table's id; change the list. - PlayerEvents.ITEM_FISHED: what a player reeled in with a fishing rod, as its own list, before it's thrown to them; change the list. - LivingEvents.DAMAGE (before armor; interrupt and no damage is taken) and DEATH (interrupt to keep the entity alive), as on 26.1.2. - Blocks that look like other blocks to some players (api.block.BlockViews): BlockViews.register(id, view) adds a BlockView, which groups players by a key (players with the same key see the same, and a null key leaves everything as it is for them) and says what a block looks like to them. What the server sends them (chunks, block changes, block entities' data) has that block in its place, so their client never knows the real one, while the server keeps it for everything else. BlockViews.refresh(player) sends them their chunks again when what they should see changes. - BlockEntityRendererRegistry (api.client.registry): registers block entity renderers, the same on every loader, as on 26.x. - BlockRenderLayers (api.client.registry): register(block, RenderType.translucent()) (or cutout(), cutoutMipped()) draws a block's model in that layer, for textures with clear or partly see-through pixels, the same on every loader. - GhostBlocks.Show.OVER_BLOCK: a ghost over the real block where it stands, hidden only by what is in front of it, to fade one block into another. It is drawn a hair nearer the camera, so it covers exactly its block's faces and doesn't spill onto the blocks beside it. - GhostBlocks.Light.WORLD: ghosts lit as the world lights a real block there (each face shaded by its side, smooth lighting, the block and sky light where it stands), so a ghost of one block over another matches it exactly. Pass it to the new GhostBlocks.draw(blocks, argb, show, light); BRIGHT and SHADED are the old full-bright and shaded looks. World-lit ghosts keep their lighting from frame to frame and build it again only when their block changes, or twice a second for changes in the light; ghosts of plants drawn off the middle of their block (flowers, grass) sit where the real ones are. - GhostBlocks.draw(groups, argbs, show, light): several groups of ghosts at once, each with its own colour and opacity (a reveal fading in waves). World-lit groups of solid blocks go over the world in one pass instead of one pass a group. - GhostBlocks.drawEffect(blocks, show, light, shader, texture, params): ghosts of blocks' real models (a flower's petals, grass's blades) with a fragment shader of the mod's own laid over the world where they show, in place of a flat colour: a force field running over the blocks, a scan, frost creeping across them. The shader imports coolcatlib:ghost_effect.glsl, which gives each pixel's place in the world, the ghosts' colour, a texture of the mod's choosing and up to sixteen numbers of its own (GLSL 150 on this version, with ColorModulator declared by the include). - SceneViewport.perspective(fov): draws a viewport's scene in perspective, as the game's camera sees the world, and zoom moves the camera nearer; 0 (the default) keeps it flat. - SceneViewport.blockEntity(pos, blockEntity): a block entity in a viewport's scene, drawn by its renderer as in the world. - SceneViewport.sprite(...) and uprightSprite(...): a glowing, camera-facing picture at a place in the scene (rays, halos, flares), added on as light and hidden by nearer blocks and entities. SceneViewportWidget shows the picture premultiplied, so that light shows over what's behind it. - HudTakeover (api.client.gui), as on 26.x: while a condition holds, the game's HUD isn't drawn and a view of the mod's own is drawn in its place.

8.1.0 — Nov 3, 2026

🔧 Changes - CoolCatLib's own config screen (used without Glazed Menu) lists each config as a row, instead of a card with artwork: its kind's icon, its name over what its kind means, and how many settings it has. A mod's own card artwork at assets/<modid>/textures/gui/config/cards/<config name>.png is no longer used. - Each kind of config has its own color in the config list (client blue, common teal, server purple, startup orange, world green), unless the config sets its own theme; its rows are centered in the list and as tall as needed to fit without scrolling. - The list of every mod's configs has a new icon (a puzzle piece with a gear), drawn in the theme's accent, and the header's icons no longer sit in a box. - Config screens are in CoolCatLib's logo colors by default (warm brown, cream and orange, in dark and light mode), for mods that don't set their own: ConfigColorScheme.COOLCATLIB and COOLCATLIB_LIGHT, used by ConfigTheme.DEFAULT and any theme built without colors.

🐛 Bug Fixes - Opening CoolCatLib's config screens no longer crashes the game over a large mod icon (on 1.20.1, CoolCatLib's own logo was enough); an icon that can't be loaded is left out, with a warning in the log. - Mod icons larger than 512 pixels are scaled down before they're uploaded, as nothing is drawn near that size. - CoolCatLib's config list says when no mod has a config there, instead of showing an empty panel.

8.0.1 — Nov 2, 2026

🐛 Bug Fixes - ItemTooltipEvents.APPEND's lines go above the game's advanced tooltip lines (durability, the item's id, its component count) rather than under them.

8.0.0 — Oct 26, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on every loader: - BlockEvents.PLACE: a block is about to be placed, by any block item (players, dispensers, other mods' machines) or an enderman; interrupt and it isn't, and the item isn't used up. - PlayerEvents.PICKUP_ITEM (interrupt to leave the item on the ground), TRAVEL_TO_DIMENSION (before any move to another dimension: portals, commands, other mods' teleporters; interrupt to stay), CRAFTED and SMELTED (an item taken from a crafting or furnace result slot). - PlayerEvents.CLONE (a new player object copied from the old one, after death or leaving the End), RESPAWN and CHANGE_DIMENSION (after arriving), as on 26.1.2. - LivingEvents.EQUIPMENT_CHANGE: what an entity wears or holds in a slot changed. - RecipeEvents.CRAFT_RESULT: a crafting recipe's result for a crafting grid or a crafter; interrupt with another stack, or an empty one so nothing can be crafted. - Game tests from common code (api.gametest), as on 26.1.2 and the same on Fabric, NeoForge and Forge: GameTests.register(modId, SomeTests.class) registers every @GameTest method (as <modid>:<class>/<method>), and GameTests.register(id, options, helper -> ...) one test by hand. GameTestOptions sets the structure, time limit, setup ticks, rotation, retries, sky access and batch (one per mod by default; there are no test environments on this version); without a structure of their own, tests run on CoolCatLib's coolcatlib:gametest/platform, an empty 8 × 6 × 8 space on a stone floor. Positions count from the structure's corner, as on newer versions. Tests are added in a development environment or with -Dcoolcatlib.gametest=true (or the loader's own game test switch), then run with /test run <modid>.<class>.<method>, /test runall <modid> or on a game test server. - Attachments on levels and on the server: get, set, update, modify, has and reset take a Level or the MinecraftServer, saved with the level (the server's in the overworld's data folder) and synced (SyncPolicy.ALL) to the players in the level, or to everyone. getGlobal(level) reads the server's values on either side. - Offline players' attachments: getOffline, setOffline, updateOffline and resetOffline read and write a player's saved values whether or not they're online (an offline player's data file is written at once).

  • Sound filters (api.client.sound): muffle, roughen and echo the game's sounds, as heard through a wall, under a spell or in a cave.
  • A SoundFilter is how loud a sound stays, how much of its high end it keeps, and how much of it goes through a distortion and into a reverb. muffled, quieter, distorted and echoing make the usual ones; then combines two and lerp goes part of the way, for fades.
  • SoundFilters.register(provider) adds a SoundFilterProvider, asked about each sound as it starts and as it moves, with a SoundContext: where it plays, which sound event it is, its category and whether it is relative to the listener (music, the menus; the menus' clicks are relative MASTER sounds here, as this version has no UI category). SoundFilterProvider.inWorld makes one for the sounds in the world only, by their place. register gives back a Registration to remove() it again.
  • Named filters for every sound at once (but the menus' clicks): SoundFilters.set(id, filter, fadeTicks) fades one in, clear(id, fadeTicks) out again; isSet(id). From the server, SoundFilterControl.set and clear (api.sound) do the same for a player.
  • SoundFilters.refresh() filters the sounds already playing again, when a provider's answers change.
  • Through OpenAL's EFX extension (a low-pass filter on each sound, sent to a distortion and a reverb effect); without it, sounds are left as they are.
  • Items drawn in a GUI at an opacity (api.client.gui.ItemOpacityRenderer), flat and solid ones alike, where the game draws them only fully opaque: render and renderWithDecorations (with the count and durability bar) at an opacity or an OpacityTween (in, out, between, eased over ticks and smooth at any frame rate), and withOpacity(opacity, draw) for anything that draws items, fading the text and bars drawn with them too. Any item drawn while the shader color's alpha is under 1 fades with it, the game's own included.
  • World effect layers: frame.draw(material, VfxLayer.of(n)) draws in a layer, lowest first, so a higher layer always covers a lower one. A VfxLayer.sorted(n) layer draws its painted-over shapes of every material back to front, so shapes of different textures cover each other as their distance says. Materials in a layer now draw in the order they were first used each frame, where before they drew in no set order.
  • What is on the screen, for placing your own things out of the way (api.client.gui.placement), as on 26.1.2: GuiAreas.hud() is the box of everything the HUD drew last frame (the game's and every mod's HUD layers), GuiAreas.screen() everything the open screen drew in its own pass (not its background or panel art, nor the tooltip) and its visible widgets, and GuiAreas.unrecorded(draw) draws without being recorded. GuiPlacement.hud(), screen() or among(areas) finds the nearest clear spot for a box of a given size, sliding it in the directions allowed, within set bounds, past whatever is in the way.

🔧 Changes - Config screens call configs by their own name ("Client", "Server"), after their mod's name where it matters ("Testing Mod › Client"), instead of a title made from the mod id ("Testingmod Client"): in a config's screen, its category popups, the config cards' tooltips and search results, and saved notices. Translate a config's name with config.<modid>.<name>.label. - New version numbers: <version>+<minecraft>, this one 8.0.0+1.21.1, the same for every Minecraft version and loader. They follow on from 2100.4.0.0; the part before the + is what launchers and loaders compare, the Minecraft version after it is only a label. Depending on CoolCatLib: ask for >=8.0.0, and the Maven artifacts are coolcatlib-<loader>:8.0.0+1.21.1.

2100.4.0.0 — Oct 22, 2026

✨ New Features - World effects (api.client.vfx), as on 26.1.2: glowing shapes drawn in the world, after the whole level and before the hand, lit by nothing. They hide behind solid things and fade softly where they meet them (VfxMaterial.softness), so nothing ends in a hard line at a wall or the ground. - Materials (VfxMaterial): a texture, a blend (VfxBlend.ADDITIVE for light, ALPHA for smoke, LUMINOUS for black-background glow textures against bright skies), a softness, and smooth or pixel-for-pixel sampling (withSmoothing(false) keeps block and item textures crisp). Everything of one material in a frame is one draw call. - Effect particles (ParticleSpec, WorldParticles): size, opacity and spin follow three-point eased curves (Curve, now with Curve.FADE) over each particle's life, colour shifts around the colour wheel, lifetimes are randomised, with gravity, drag and velocity-stretched sparks (Shape.SPARK). WorldParticles.spawn, burst and line. They are not vanilla particles: nothing to register, nothing on the server. - Shapes every frame (WorldVfx.register with a VfxRenderer, drawing through VfxFrame and VfxDraw): camera-facing billboards, beams, flat ground quads, free quads, and ribbons that follow a Trail. One-liners that draw themselves and fade: WorldVfx.beam, flash and groundFlash. - Built-in textures: VfxMaterial.GLOW, SPARKLE, STAR, RING, SMOKE and STREAK. - Shader materials: VfxMaterial.withShader(id) draws a material with a fragment shader of the mod's own (assets/<namespace>/shaders/<path>.fsh, GLSL 150 on this version), which imports coolcatcanvas:vfx.glsl for the camera, the time and the depth-fade helpers. - Rifts (WorldRifts, RiftSpec, Rift): a tear in the air drawn by a built-in shader (VfxMaterial.RIFT_SHADER) that opens with a flash, a sound and a shake, hums while open, and snaps shut; rift.facing(direction) holds it facing one way, as a portal in a wall. - From the server (api.vfx): VfxControl.play(level, id, VfxParams) plays an effect a client registered with VfxEffects.register, and RiftControl.open(level, spec id, position[, ticks]) and close(level, id) open and close rifts, each as one small packet to the players in range. - Event phases reach other mods' own listeners: EventPhase.band() sorts phases into FIRST (FIRST and earlier), MIDDLE and LAST (LAST and later), and events whose loader hook fires each band at its own place run FIRST listeners before other mods' NeoForge, Forge or Fabric listeners of the game event and LAST ones after them. EventInvoker.invoker(Band) and hasListeners(Band) let a hook fire one band; invoker() still fires them all, in order. - ItemTooltipEvents.MODIFY does this on every loader (NeoForge's and Forge's highest, normal and lowest priorities; Fabric phases before, at and after the default one). - ItemTooltipEvents.APPEND: lines added at the very end of an item's tooltip, after the loaders' tooltip events and every other mod's lines, with the player when there is one. - InteractionEvents (api.event.v2.common): USE_BLOCK, USE_ITEM and USE_ENTITY (answer with an InteractionResult: PASS lets the game go on, anything else stops it there) and ATTACK_BLOCK and ATTACK_ENTITY (interrupt to stop them), on both sides, before the game acts, the same on Fabric, NeoForge and Forge. - HeldItemSwaps (api.client.item): which changes to a held stack are quiet, so the item stays where it is in the hand instead of being put away and taken out again: quiet(...) for components (a Supplier for one registered later), register(...) for any test of the old and new stacks. Attachments' changes are quiet unless the attachment was built with swapAnimation(). - GhostBlocks (api.client.vfx): blocks drawn as ghosts with their real models (block entities too), one see-through picture so only their outside shows, tinted and faded by one colour; shown through walls, in the world as real blocks would be, or always; full bright or shaded. Call it right after the level is drawn. - Scene viewports (api.client.viewport.SceneViewport, api.client.gui.components.SceneViewportWidget): a 3D view of blocks, block entities, entities and items, drawn into a texture of its own (by the game's own renderers, lit as the world is) for a GUI or any textured face; turned, zoomed and framed in code or by dragging, with a ground of grid lines and shadows, and text laid flat on the picture. - ItemRendererRegistry (api.client.registry): items drawn in code, the same on every loader: an item whose model is builtin/entity is drawn by its renderer wherever it shows. - ItemColorRegistry (api.client.registry): colours for items' tinted faces, the same on every loader. - ExtraModels (api.client.registry): models baked with the game's though no item or block uses them, for drawing in code; named outright or found in the resources as they load. 🔧 Changes - NeoForge: payloads are registered as optional, CoolCatLib's own included, so a client with CoolCatLib (and client-only mods built on it) can join a server without it and the other way round, as on Fabric (NeoForge used to disconnect whichever side lacked a channel). Configuration payloads are only sent to clients that have their channel. Network.sendToPlayer skips a player whose client lacks the payload's channel instead of throwing.

2100.3.0.0 — Oct 14, 2026

🔧 Changes - CoolCatLib is one mod again: CoolCatLib: Core and CoolCatLib: Canvas are merged into CoolCatLib, one jar per loader. Screen effects, skyboxes, GUI widgets and the render utilities now ship with the events, networking, registries and configs, so there is one file to install and one version to depend on. - The mod id is now coolcatlib. With it changed: the Fabric entrypoints (coolcatlib:common, coolcatlib:client, coolcatlib:server, coolcatlib:datagen), the commands (/coolcatlib config ..., /coolcatlib_client config ...), Core's translation keys (config.coolcatlib.*, tooltip.coolcatlib.*), its payload ids and ConfigTheme.STARFALL (coolcatlib:starfall). Players and servers need the same version, as with any update. - Nothing moved in the code: the packages are still net.ixdarklord.coolcatcore and net.ixdarklord.coolcatcanvas, and Canvas's classes keep their asset namespace (coolcatcanvas:...), command (/coolcatcanvas_client) and config files. - Mods built for CoolCatLib: Core or Canvas have to be updated: the coolcatcore and coolcatcanvas mod ids are gone, and constructors are only read from the coolcatlib:* Fabric entrypoints. Depend on coolcatlib alone. - Remove the CoolCatLib: Core and Canvas jars when updating: their classes are in this one. The loaders refuse to start with them installed. - Maven: the artifacts are now net.ixdarklord.coolcatlib:coolcatlib-<loader> and hold everything. coolcatlib-core-<loader> and coolcatlib-canvas-<loader> stop at their last versions: replace both dependencies with the one. - Canvas's earlier releases are listed in CHANGELOG-canvas.md.

2100.2.0.1 — Oct 4, 2026

✨ New Features - Item decorators: custom drawing over an item wherever the game draws it in a GUI (inventory slots, the hotbar, a held stack), after vanilla's durability bar, cooldown and count, the same on every loader. Implement api.item.DecoratedItem on the item's class and hand over its api.client.gui.ItemDecorator in registerDecorators(registrar): that's all, Core registers it by itself, on the client, the first time the item is drawn. An item's own isBarVisible still decides whether vanilla's bar shows under it.

2100.2.0.0 — Sep 30, 2026 (Minecraft 1.21.1)

Backport of the 26.1.2 release: the same features, on Forge, NeoForge and Fabric. ✨ New Features - CoolCatLib is split in two mods: CoolCatLib: Core (coolcatcore, package net.ixdarklord.coolcatcore), this one, and CoolCatLib: Canvas (coolcatcanvas), which now holds screen effects, skyboxes, GUI widgets, RenderUtils and Easing. The mod id, package, asset namespace, Fabric entrypoints (coolcatcore:common, ...) and commands (/coolcatcore, /coolcatcore_client) all changed from coolcatlib. - A cross-loader platform layer, so mods built on CoolCatLib: Core no longer need Architectury API: - Events (api.event.v2): EventInvoker keeps listeners in common code, ordered by EventPhase, and is found by its listener type (EventInvoker.lookup(ServerTickEvents.End.class)) or its constant (ServerTickEvents.END). EventInvoker.create(Type.class) makes a mod's own event, combining listeners by return type (void, EventResult, EventResultHolder, boolean). - Built-in events: server lifecycle and ticks, datapack contents sync (ServerLifecycleEvents.SYNC_DATA_PACK_CONTENTS: per player on login and after /reload), player join/leave/tick, entity load, block break/place, commands; client ticks, player join/leave, HUD rendering, item tooltips, client commands. - api.registry: DeferredRegister / RegistryEntry, CreativeTabs, ReloadListeners. - api.menu.ExtendedMenus: menu types that open with extra data. - api.network.Network: serverbound/clientbound payloads and sending. Network.canPlayerReceive(player, type) tells whether a player's connection accepts a payload (false for clients without the mod and for GameTest mock players; NeoForge throws when sending to them). - Record payloads without a StreamCodec: Network.registerServerbound(MyPayload.class, receiver) (or with an explicit Type) derives the codec from the record's components through PayloadCodecs, which knows primitives, strings, common Minecraft types, enums, nested records, arrays, Optional, List, Set, Map, Either and ResourceKey. Other types are added with PayloadCodecs.register / registerFactory; registering a payload with a component type that has no codec throws right away, naming the component. - api.client.registry: key mappings, menu screens, tooltip components. - api.platform.Platform: loader, environment, mod checks, folders, the running server, fake players. - Mod constructors (api.core): ModConstructor (both sides), ClientModConstructor, ServerModConstructor (dedicated server) and DataGenerationConstructor are written once in common code, each with a construct stage and a setup stage (DataGenerationContext.addProvider for data providers). - Fabric needs no Java entry class: list them under the coolcatcore:common, coolcatcore:client, coolcatcore:server and coolcatcore:datagen entrypoints, plus api.core.fabric.FabricDataGenerationEntrypoint under fabric-datagen. - NeoForge: extend api.core.neoforge.NeoForgeModEntrypoint in the @Mod class and call common(...), client(() -> ...), server(() -> ...), dataGeneration(...); the mod id comes from the container. - Forge: the same with api.core.forge.ForgeModEntrypoint, constructed with the @Mod constructor's FMLJavaModLoadingContext. - EventResult.pass()/interrupt()/allow()/deny(), and EventResultHolder.result()/getValue(). - A config system (api.config): - Declare configs with Config.builder(modId, scope) (typed values, nested groups, presets) or from an annotated class with ConfigObject.register. - Scopes: CLIENT, COMMON, SERVER (synced to players) and WORLD (stored per world, seeded from defaultconfigs, synced). - Types: booleans, ranged numbers (optionally sliders), strings (length/pattern), enums, colors, ids, lists, and any Codec; custom ConfigTypes with their own editors. - TOML (default) and JSON5 files with generated comments; a config whose format changes converts its old file once (kept as .bak); broken files are backed up; version/migration and aliases handle renamed or moved settings. - Hot reloading of edited files, change listeners and ConfigEvents: LOADED (first read), RELOADED (hot reload, the reload command or Config.reload()), UNLOADING (a world config before its server's values are dropped), VALUE_CHANGED (each value, with its old and new value), CHANGED (once per batch), SAVED and SYNCED. - serverOnly() values that never leave the server; operators edit synced configs in-game with permission checks. - Generated config screen: search, undo/redo, reset, presets, validation, dependencies (enabledWhen), restart notices and list editing. Linked from the Forge and NeoForge mod lists and Mod Menu. - /coolcatcore config (server) and /coolcatcore_client config (client) commands: list, get, set, reset, reload, preset, open. - STARTUP configs, read before content is registered (for item properties, which items exist...). Their values stay fixed until a restart; edits are saved for the next start. Joining a server compares them before entering the world: values must match by default (the client is offered to adopt the server's), useServerValue() values are taken from the server while connected, and localOnly() values stay per side. - Category popups: one category of a config in a small window with Save and Cancel, floating over the current screen or the game, e.g. ConfigScreens.openCategory("mymod", "client/rendering"), ConfigScreens.categoryPopup(parent, config, path), or /coolcatcore_client config open <mod> <category> (with path suggestions). A single setting's path shows just that setting. - A color picker for color values (a popup with saturation/brightness, hue and alpha, hex input and dye colors), also available as ConfigScreens.colorPicker. - The main config screen (shown for every mod, even one with a single config): a header with the mod's icon (a "?" when it has none; the list of every mod's configs has its own icon), and each config as a portrait navigation card with its own artwork (faint, brightening on hover; CoolCatLib: Core's per scope, or the mod's own at assets/<modid>/textures/gui/config/cards/<config name>.png), its scope icon and a short label like "Server" (config.<modid>.<name>.label). Cards are centered, grow when hovered, and show a tooltip with the config's scope, contents, file and access. Mod Menu's CoolCatLib: Core button opens CoolCatLib: Core's own settings. - Page transitions: a config page's panels glide a little way into place (up from below when opened, down from above when going back, a shorter rise when opened from elsewhere) while growing from slightly smaller; the background stays still. - Config screen effects: animations a theme names by id, drawn behind the panels, over the whole screen, and over each widget (buttons, toggles, sliders, text fields, cards, popup panels). Mods register their own on the client with ConfigEffects.register(id, ConfigEffect) and use them with ConfigTheme.Builder.effects(...), ConfigBuilder.effects(...) for one config, or "effects" in config_theme.json; an unknown id is skipped and an effect that throws is switched off, each logged once. The built-in ConfigTheme.STARFALL, every theme's default, draws soft glows in the accent and small faint stars falling from the top, shifting with the mouse by depth (parallax). CoolCatLib: Core's client config turns effects and the page transitions on or off (Effects > Theme Effects / Page Transitions); both are always off on the Fast graphics preset. - Redesigned config screens: a top bar (title, scope badges, search), a category sidebar, settings with descriptions and nested sections, and a bottom bar with the unsaved-changes status and actions; toggle switches, sliders, selectors and flat buttons; presets, confirmations and the color picker as popups. Icons are 64x64 textures in assets/coolcatcore/textures/gui/config/icons/ (smoothly filtered), replaceable by resource packs. - ConfigTheme: each mod's own look, set per mod (ConfigTheme.setForMod) or per config (ConfigBuilder.theme / background): a full ConfigColorScheme (presets DARK, LIGHT, and tinted(accent) for the dark scheme shaded toward the mod's color), a background texture by its path (cover, stretch or tile), the texture's opacity (textureOpacity, letting the panorama or world show through) and the backdrop color's opacity over the background (backgroundOpacity). Players can scale both for every mod in CoolCatLib: Core's client config (Background > Backdrop Opacity / Texture Opacity). By default the screens are see-through to the title panorama or the world. Resource packs can restyle a mod with assets/<modid>/coolcatcore/config_theme.json. - Popup panel sprites: ConfigTheme.Builder.popupSprite (or popup_sprite in config_theme.json) draws a nine-slice GUI sprite as the panel of popups (category popups, confirmations, the color picker) instead of the flat panel, and ConfigScreens.categoryPopup(parent, config, path, theme) opens a category popup with its own theme, e.g. to match the screen it's opened from. - Toggle switches have an outline on their track: the panel border while off, a darker shade of the accent as they turn on. - Popups keep their buttons in a footer strip along the bottom and their content above it, so a sprite's footer band sits behind the buttons only (the color picker's Cancel and Done moved there). - The config list shows each mod's icon (a theme can set another); config pages and their cards show an icon of their kind (client, common, server, world, startup). - Platform.getModName. - Dark and light mode: a sun/moon switch in every config screen's top bar, remembered in CoolCatLib: Core's own client config (themeMode). Each theme has a light scheme too (ConfigTheme.Builder.lightColors, by default derived from the mod's accent; light_base/light_colors in config_theme.json). - The main config screen's search bar searches every config it lists (names, keys, comments, group names, values), with results grouped by config; opening a result shows that config filtered to it. A config's own search covers only that config. - Attachments, containers and handlers for items, blocks and entities: - api.attachment: typed data any entity (players included), block entity or item stack can carry. Each mod creates its own AttachmentRegistry.create(modId) (and calls register() while it initialises); its values are stored under its own id, in the <modid>:attachments item component and a <modid>:attachments tag in entity and block entity data. Declared once (ATTACHMENTS.builder(name, codec, default)), then used as MADNESS.get(player), set, update, modify, reset, or through AttachmentHolder.of(...). - Persistent attachments save with their holder; transientBuilder ones never do. copyOnDeath() keeps a player's value through death (always kept through dimension changes and the End exit); keepOnDrop() carries a block entity's value into its dropped item and back when placed. - sync(SyncPolicy): SELF (the player it belongs to), TRACKING, ALL, or any predicate. Only changed values are sent, at most once per tick; everything when a player starts seeing the holder, receives its chunk, joins, respawns or changes dimension. - On item stacks, defaults aren't stored, so stacks still stack. - AttachmentEvents: CHANGING (cancel a change or replace the value), ADDED, CHANGED (in-place changes included), REMOVED, START_TRACKING/STOP_TRACKING (a player starts or stops receiving a holder's data) and RECEIVED (synced values arrived on the client), plus typed per-attachment helpers (onChanged(MADNESS, ...)). - api.container: ContainerLayout (slot filters, limits, roles STORAGE/INPUT/OUTPUT/INTERNAL, which slots each face reaches) makes SlotContainers, vanilla Containers with insert/extract, listeners and layout-aware menu slots. AttachmentRegistry.container stores one on any entity or block entity (saved and synced with the rest); ItemContainers keeps one in a stack (ContainerItem for items that have one); ItemTransfer moves items between any containers through faces. - api.block: ExtendedBlockEntity (attachment shortcuts, handlers, serverTick/clientTick with ExtendedBlockEntity.ticker) and ExtendedContainerBlockEntity (an inventory hoppers and comparators use; contents spill or, with keepContentsOnBreak, stay in the item). - api.handler: HandlerType for anything holders hand out (inventories, energy...), from the holder itself (HandlerProvider, HandlerMap) or registered providers and fallbacks for blocks, block entities, entities and items. HandlerTypes.CONTAINER also finds vanilla containers (double chests as one). BlockHandlerCache keeps a lookup until the block changes, its block entity goes, or HandlerType.invalidate is called. - Other mods reach these containers through each loader's own system, following the layout's filters, roles and limits: Forge and NeoForge item handler capabilities (blocks, entities and ContainerItem stacks) and Fabric's Transfer API (ItemStorage.SIDED for blocks, ItemStorage.ITEM for ContainerItem stacks). - api.registry.BlockEntityTypes.create: block entity types from common code. - Storage menus (api.menu.StorageMenuDefinition): a menu for a block's or an item's inventory, declared once (StorageMenuDefinition.grid(columns, rows) or placed slot by slot), registered with createMenuType and opened with open(player, blockEntity, title) or open(player, hand, title). Slots follow the container's layout and shift-click; the menu closes when the block is removed, the player walks away, or the item leaves its slot (which stays locked meanwhile). sync(attachment) and syncValue(...) send extra values to the screen while it's open, and button(id, action) runs screen buttons on the server. api.client.gui.screens.StorageScreen draws any of these menus with no texture, and can be extended.

⚙️ Refactoring - Rewrote the v2 event system (the lookup-based skeleton had no events); EventInvokerRegistry was removed.

🔧 Differences from the 26.1.2 release - Config edit permissions are permission levels (ConfigBuilder.editPermission(int), default 2), as 1.21.1 has no permission sets. The slider doesn't change the cursor shape (1.21.1 has no cursor shapes). - Signatures use 1.21.1's types where 26.1's don't exist: GuiGraphics instead of GuiGraphicsExtractor (StorageScreen.renderBg, ClientGuiEvents.RenderHud), ClickType in StorageMenu.clicked, List<Component> tooltips in ComponentItem, and CompoundTag saving for attachments. - ConfigEffect's hooks are renderBackground / renderForeground / renderWidget (26.1.2: extract*), drawing with GuiGraphics. The Fast graphics mode turns effects and transitions off. - Platform.isForge() and Platform.Loader.FORGE.

2001.1.0.0 — Oct 30, 2025

⚙️ Refactoring - Renamed and reorganized several classes. - Updated version formatting from X.X.X to MCVR.X.X.X to clearly distinguish between Minecraft release versions.

1.1.2 — April 11, 2025
  • Added new methods to MouseHelper and fixed an issue in RenderUtils
1.1.1 — (Fabric Hotfix) | March 20, 2025
  • Correct implementation of Potion Brewing and Potion Brewing Builder extension interfaces
1.1.0 — March 19, 2025
  • Revamped the Brewing Recipe API
  • Added two versions of Events (second version is still unstable)
  • Introduced new abstract classes for widgets
1.0.1 — December 30, 2024
  • Changing and Organizing the packages
1.0.0 — September 21, 2024
  • Port to 1.21
9.0.0 — Nov 16, 2026

✨ New Features - ModCommands (api.command): registers a mod's server commands with its mod id and the command's names, the first its own and the others aliases that work the same, e.g. ModCommands.register("ftbultimineaddition", List.of("ultimine_addition", "ua"), (root, context, selection) -> root.then(...)). A name another command already has (vanilla's /tm, another mod's) is skipped, with a warning in the log. ModCommands.registerClient(modId, names, (root, context) -> ...) does the same for client commands. Instead of names, a client command can take its server command's: ClientNames.MERGED shares them (one /folios for players: what the client's parts can run stays on the client, the rest goes to the server), ClientNames.SUFFIXED adds _client (/ua_client beside /ua). - Every mod with CoolCatLib configs gets a config command under its own commands: /<command> config opens the mod's config screens and /<command> config <config> one of them (/folios config client). Anyone can open them; what they may change is still up to each config's edit permission. - /<command> config reload [config] reads the mod's config files again after they were edited by hand, without restarting (for operators): the server's configs on the server, the player's client configs on their own game. - /coolcatlib config [mod] [config] and /coolcatlib config reload [mod] [config] do the same for any mod, and on servers without CoolCatLib the player's own game does it. - Block entity renderers come to 1.20.1 with the same API as on 26.1 (coolcatcanvas.api.client.blockentity): BlockRenderer with culling by bounds, detail by distance, facing and layers (ItemLayer, LabelLayer, ChildLayer); render and a layer's submit take a MultiBufferSource and the Camera. Also EntityRendererRegistry and ItemRendererRegistry in coolcatcanvas.api.client.registry, and ObjModel. - Armatures come to 1.20.1 with the same API as on 26.1 (api.client.armature, api.armature): Armature, Animator, ArmatureMobRenderer, ArmatureEntityRenderer, ArmatureBlockRenderer, ArmatureItems, VanillaModels and ArmatureControl. An armature item names its armature in its own model (models/item/<item>.json: "parent": "builtin/entity" and "coolcatcanvas:armature": {...}), as 1.20.1 has no item model types.

🔧 Changes - Breaking: Canvas's GUI and render helpers moved to tidier packages under net.ixdarklord.coolcatcanvas.api.client: gui.components and gui.components.widgets to gui.widget, gui.components.widgets.panel to gui.panel, gui.components.animations to gui.animation, utils.ScreenAnchor to gui.placement, utils.TextEffects to text, and utils.RenderUtils, Outline and NineSliceInfo to render. The class names are the same; mods using them update their imports. - CoolCatLib's visuals are a mod of their own again, CoolCatLib Canvas (coolcatcanvas), and it comes inside CoolCatLib's jar: nothing more to install. Mods built on its API need net.ixdarklord.coolcatlib:coolcatlib-canvas-<loader> beside coolcatlib-<loader> (CoolCatLib's POM names it). - /coolcatlib_client is gone: the client's config command is part of /coolcatlib (on servers without CoolCatLib). - The config commands no longer get, set or reset values or apply presets from the chat (/coolcatlib config <id> get|set|reset|preset): they open the config screens, where all of that is done. - /coolcatlib_client config open [mod] is now /coolcatlib config [mod] [config]. - /coolcatcanvas_client effects is now /coolcatcanvas effects. - CommandEvents.REGISTER and ClientCommandEvents.REGISTER are deprecated: use ModCommands (register and registerClient). Commands registered through it still work, and still get the config command: they're matched to the mod whose configs are built in the same packages. - The renderer registries moved to Canvas: BlockEntityRendererRegistry and ItemRendererRegistry are in net.ixdarklord.coolcatcanvas.api.client.registry. The ones in net.ixdarklord.coolcatcore.api.client.registry still work but are deprecated.

🐛 Bug Fixes - A mod's server command no longer stops working when the mod also has a client command of the same name (/folios config beside the client's /folios guide): what only the server's command can run now goes to the server instead of failing on the client as an incorrect argument.

8.2.2 — Nov 13, 2026

🐛 Bug Fixes - Fixed a memory leak on Forge: CoolCatLib kept every block entity the game had made (all but vanilla containers) for the whole session, so memory filled up over long sessions or with machines that make and remove many block entities.

8.2.1 — Nov 12, 2026

🐛 Bug Fixes - No longer crashes the game alongside Citadel (or any mod that changes the smithing table's recipe lookup): CoolCatLib's hooks added in 8.2.0 (the smithing table's recipes, a merchant's offers, and BlockViews' chunk data) now wrap the game's calls instead of replacing them, so other mods can change the same calls too.

8.2.0 — Nov 10, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on every loader: - EntityEvents.SPAWN: a new mob is about to be added to the world (spawned naturally or with a new chunk, by a spawner, a spawn egg, a command, breeding, a conversion), with why it was made when the game says; interrupt to keep it out, with its passengers. EntityEvents.MOUNT: an entity is about to ride another (interrupt to keep it off), or got off one. - PlayerEvents.OPEN_MENU: a player is about to open a menu: a block's, an entity's, an item's, or one another mod opens with extra data; interrupt to keep it closed. - RecipeEvents.MATCH: a recipe matched where the game looks one up (furnaces, campfires, smithing tables, stonecutters, crafting grids, other mods' machines), with the block entity or the player asking; interrupt to pass it over for the next one that matches. - PlayerEvents.ADVANCEMENT_EARNED (a player completed an advancement), CommandEvents.EXECUTE (a command is about to run; interrupt to stop it) and LivingEvents.EFFECT_APPLICABLE (an effect is about to be given; interrupt to keep it off). - BlockEvents.DROPS: a broken block is about to drop its items and experience; change the list and the amount. - PlayerEvents.BREAK_SPEED and HARVEST_CHECK: how fast a player breaks a block, and whether their tool is right for it (without it, it drops nothing), on both sides. - MerchantEvents.OFFERS: the trades a player is shown, as their own list; take trades out to hide them (they can't make them either). - EnchantEvents.TABLE_OPTIONS (the enchantments an enchanting table's offer gives) and ANVIL_RESULT (what an anvil makes; interrupt with another stack or none). - LootEvents.MODIFY: any loot table's loot as it's rolled (chests, block drops, mobs, fishing), with the table's id; change the list. - PlayerEvents.ITEM_FISHED: what a player reeled in with a fishing rod, as its own list, before it's thrown to them; change the list. - LivingEvents.DAMAGE (before armor; interrupt and no damage is taken) and DEATH (interrupt to keep the entity alive), as on 26.1.2. - Blocks that look like other blocks to some players (api.block.BlockViews): BlockViews.register(id, view) adds a BlockView, which groups players by a key (players with the same key see the same, and a null key leaves everything as it is for them) and says what a block looks like to them. What the server sends them (chunks, block changes, block entities' data) has that block in its place, so their client never knows the real one, while the server keeps it for everything else. BlockViews.refresh(player) sends them their chunks again when what they should see changes. - BlockEntityRendererRegistry (api.client.registry): registers block entity renderers, the same on every loader, as on 26.x. - BlockRenderLayers (api.client.registry): register(block, RenderType.translucent()) (or cutout(), cutoutMipped()) draws a block's model in that layer, for textures with clear or partly see-through pixels, the same on every loader. - GhostBlocks.Show.OVER_BLOCK: a ghost over the real block where it stands, hidden only by what is in front of it, to fade one block into another. It is drawn a hair nearer the camera, so it covers exactly its block's faces and doesn't spill onto the blocks beside it. - GhostBlocks.Light.WORLD: ghosts lit as the world lights a real block there (each face shaded by its side, smooth lighting, the block and sky light where it stands), so a ghost of one block over another matches it exactly. Pass it to the new GhostBlocks.draw(blocks, argb, show, light); BRIGHT and SHADED are the old full-bright and shaded looks. World-lit ghosts keep their lighting from frame to frame and build it again only when their block changes, or twice a second for changes in the light; ghosts of blocks drawn off the middle of their block (flowers, grass, other plants) sit where the real ones are. - GhostBlocks.draw(groups, argbs, show, light): several groups of ghosts at once, each with its own colour and opacity (a reveal fading in waves). World-lit groups of solid blocks go over the world in one pass instead of one pass a group. - GhostBlocks.drawEffect(blocks, show, light, shader, texture, params): ghosts of blocks' real models (a flower's petals, grass's blades) with a fragment shader of the mod's own laid over the world where they show, in place of a flat colour: a force field running over the blocks, a scan, frost creeping across them. The shader imports coolcatlib:ghost_effect.glsl, which gives each pixel's place in the world, the ghosts' colour, a texture of the mod's choosing and up to sixteen numbers of its own. - SceneViewport.perspective(fov): draws a viewport's scene in perspective, as the game's camera sees the world, and zoom moves the camera nearer; 0 (the default) keeps it flat. - SceneViewport.sprite(...) and uprightSprite(...): a glowing, camera-facing picture at a place in the scene (rays, halos, flares), added on as light and hidden by nearer blocks and entities; clearSprites() takes them away. SceneViewport.blockEntity(pos, blockEntity) draws a block entity in the scene by its own renderer. - HudTakeover (api.client.gui): while a condition holds, the game's HUD (and other mods' additions to it) isn't drawn, and a view of the mod's own is drawn in its place.

8.1.0 — Nov 3, 2026

🔧 Changes - CoolCatLib's own config screen (used without Glazed Menu) lists each config as a row, instead of a card with artwork: its kind's icon, its name over what its kind means, and how many settings it has. A mod's own card artwork at assets/<modid>/textures/gui/config/cards/<config name>.png is no longer used. - Each kind of config has its own color in the config list (client blue, common teal, server purple, startup orange, world green), unless the config sets its own theme; its rows are centered in the list and as tall as needed to fit without scrolling. - The list of every mod's configs has a new icon (a puzzle piece with a gear), drawn in the theme's accent, and the header's icons no longer sit in a box. - Config screens are in CoolCatLib's logo colors by default (warm brown, cream and orange, in dark and light mode), for mods that don't set their own: ConfigColorScheme.COOLCATLIB and COOLCATLIB_LIGHT, used by ConfigTheme.DEFAULT and any theme built without colors.

🐛 Bug Fixes - Opening CoolCatLib's config screens no longer crashes the game over a large mod icon (on 1.20.1, CoolCatLib's own logo was enough); an icon that can't be loaded is left out, with a warning in the log. - Mod icons larger than 512 pixels are scaled down before they're uploaded, as nothing is drawn near that size. - CoolCatLib's config list says when no mod has a config there, instead of showing an empty panel.

8.0.1 — Nov 2, 2026

🐛 Bug Fixes - ItemTooltipEvents.APPEND's lines go above the game's advanced tooltip lines (durability, the item's id, its NBT tag count) rather than under them.

8.0.0 — Oct 26, 2026

✨ New Features - More common events (api.event.v2.common), fired the same on Fabric and Forge: - BlockEvents.PLACE: a block is about to be placed, by any block item (players, dispensers, other mods' machines) or an enderman; interrupt and it isn't, and the item isn't used up. - PlayerEvents.PICKUP_ITEM (interrupt to leave the item on the ground), TRAVEL_TO_DIMENSION (before any teleport to another dimension: portals, commands, other mods' teleporters; interrupt to stay), CRAFTED and SMELTED (an item taken from a crafting or furnace result slot). - PlayerEvents.CLONE (the new player object after death or the End, to carry data over), RESPAWN and CHANGE_DIMENSION. - LivingEvents.EQUIPMENT_CHANGE: what an entity wears or holds in a slot changed. - RecipeEvents.CRAFT_RESULT: a crafting recipe's result for a crafting grid; interrupt with another stack, or an empty one so nothing can be crafted. On this version it gets the game's Recipe and CraftingContainer (there is no crafter block). - Game tests from common code (api.gametest), as on 26.1.2 and the same on Fabric and Forge: GameTests.register(modId, SomeTests.class) registers every @GameTest method (as <modid>:<class>/<method>), and GameTests.register(id, options, helper -> ...) one test by hand. GameTestOptions sets the structure, time limit, setup ticks, rotation, retries and batch (one per mod by default; there are no test environments on this version); without a structure of their own, tests run on CoolCatLib's coolcatlib:gametest/platform, an empty 8 × 6 × 8 space on a stone floor. Positions count from the structure's corner, as on newer versions. Tests are added in a development environment or with -Dcoolcatlib.gametest=true (or the loader's own game test switch), then run with /test run <modid>.<class>.<method>, /test runall <modid> or on a game test server. - Attachments on levels and on the server: get, set, update, modify, has and reset take a Level or the MinecraftServer, saved in the level's data folder (the server's in the overworld's) and synced (SyncPolicy.ALL) to the players in the level, or to everyone. getGlobal(level) reads the server's values on either side. - Offline players' attachments: getOffline, setOffline, updateOffline and resetOffline read and write a player's saved values whether or not they're online (an offline player's data file is written at once).

  • Sound filters (api.client.sound): muffle, roughen and echo the game's sounds, as heard through a wall, under a spell or in a cave.
  • A SoundFilter is how loud a sound stays, how much of its high end it keeps, and how much of it goes through a distortion and into a reverb. muffled, quieter, distorted and echoing make the usual ones; then combines two and lerp goes part of the way, for fades.
  • SoundFilters.register(provider) adds a SoundFilterProvider, asked about each sound as it starts and as it moves, with a SoundContext: where it plays, which sound event it is, its category and whether it is relative to the listener (music, the menus; the menus' clicks are relative MASTER sounds here, as this version has no UI category). SoundFilterProvider.inWorld makes one for the sounds in the world only, by their place. register gives back a Registration to remove() it again.
  • Named filters for every sound at once (but the menus' clicks): SoundFilters.set(id, filter, fadeTicks) fades one in, clear(id, fadeTicks) out again; isSet(id). From the server, SoundFilterControl.set and clear (api.sound) do the same for a player.
  • SoundFilters.refresh() filters the sounds already playing again, when a provider's answers change.
  • Through OpenAL's EFX extension (a low-pass filter on each sound, sent to a distortion and a reverb effect); without it, sounds are left as they are.
  • Items drawn in a GUI at an opacity (api.client.gui.ItemOpacityRenderer), flat and solid ones alike, where the game draws them only fully opaque: render and renderWithDecorations (with the count and durability bar) at an opacity or an OpacityTween (in, out, between, eased over ticks and smooth at any frame rate), and withOpacity(opacity, draw) for anything that draws items, fading the text and bars drawn with them too. Any item drawn while the shader color's alpha is under 1 fades with it, the game's own included.
  • Placing GUI elements out of the way of everything else (api.client.gui.placement): GuiAreas.hud() and screen() give the boxes of what the HUD (every mod's HUD layers too: minimaps, block tooltips, boss bars) and the open screen drew last frame, the screen's widgets included but not its background or the tooltip under the mouse; GuiAreas.unrecorded(draw) draws your own element without it counting. GuiPlacement.hud() / screen() take a size, where you'd like it (at), a gap, the bounds to stay within and the directions it may slide in, leave out overlays and whatever you ignore, and find() the nearest clear place.
  • World effect layers: frame.draw(material, VfxLayer.of(n)) draws in a layer, lowest first, so a higher layer always covers a lower one. A VfxLayer.sorted(n) layer draws its painted-over shapes of every material back to front, so shapes of different textures cover each other as their distance says. Materials in a layer now draw in the order they were first used each frame, where before they drew in no set order.

🔧 Changes - Config screens call configs by their own name ("Client", "Server"), after their mod's name where it matters ("Testing Mod › Client"), instead of a title made from the mod id ("Testingmod Client"): in a config's screen, its category popups, the config cards' tooltips and search results, and saved notices. Translate a config's name with config.<modid>.<name>.label. - New version numbers: <version>+<minecraft>, this one 8.0.0+1.20.1, the same for every Minecraft version and loader. They follow on from 2001.4.0.1; the part before the + is what launchers and loaders compare, the Minecraft version after it is only a label. Depending on CoolCatLib: ask for >=8.0.0, and the Maven artifacts are coolcatlib-<loader>:8.0.0+1.20.1.

2001.4.0.1 — Oct 22, 2026

🐛 Bug Fixes - Screen effects, skyboxes, world effects and ghost blocks no longer leave the game believing its own shader is still bound. Vanilla skips binding a core or post shader it bound last; after one of CoolCatLib's programs, the next draw with that shader could run with the wrong program (or none) and send its uniforms to it.

🔧 Changes - CoolCatLib's shader programs remember their uniform locations and the values last sent, so a uniform set to the value it already has (samplers, unchanged matrices, every frame) costs no GL call, and matrices are sent without a temporary buffer.

2001.4.0.0 — Oct 22, 2026

✨ New Features - World effects (api.client.vfx), as on 26.1.2: glowing shapes drawn in the world, after the whole level and before the hand, lit by nothing. They hide behind solid things and fade softly where they meet them (VfxMaterial.softness), so nothing ends in a hard line at a wall or the ground. - Materials (VfxMaterial): a texture, a blend (VfxBlend.ADDITIVE for light, ALPHA for smoke, LUMINOUS for black-background glow textures against bright skies), a softness, and smooth or pixel-for-pixel sampling (withSmoothing(false) keeps block and item textures crisp). Everything of one material in a frame is one draw call. - Effect particles (ParticleSpec, WorldParticles): size, opacity and spin follow three-point eased curves (Curve, now with Curve.FADE) over each particle's life, colour shifts around the colour wheel, lifetimes are randomised, with gravity, drag and velocity-stretched sparks (Shape.SPARK). WorldParticles.spawn, burst and line. They are not vanilla particles: nothing to register, nothing on the server. - Shapes every frame (WorldVfx.register with a VfxRenderer, drawing through VfxFrame and VfxDraw): camera-facing billboards, beams, flat ground quads, free quads, and ribbons that follow a Trail. One-liners that draw themselves and fade: WorldVfx.beam, flash and groundFlash. - Built-in textures: VfxMaterial.GLOW, SPARKLE, STAR, RING, SMOKE and STREAK. - Shader materials: VfxMaterial.withShader(id) draws a material with a fragment shader of the mod's own (assets/<namespace>/shaders/<path>.fsh, GLSL 150 on this version), which imports coolcatcanvas:vfx.glsl for the camera, the time and the depth-fade helpers. - Rifts (WorldRifts, RiftSpec, Rift): a tear in the air drawn by a built-in shader (VfxMaterial.RIFT_SHADER) that opens with a flash, a sound and a shake, hums while open, and snaps shut; rift.facing(direction) holds it facing one way, as a portal in a wall. - From the server (api.vfx): VfxControl.play(level, id, VfxParams) plays an effect a client registered with VfxEffects.register, and RiftControl.open(level, spec id, position[, ticks]) and close(level, id) open and close rifts, each as one small packet to the players in range. - Event phases reach other mods' own listeners: EventPhase.band() sorts phases into FIRST (FIRST and earlier), MIDDLE and LAST (LAST and later), and events whose loader hook fires each band at its own place run FIRST listeners before other mods' Forge or Fabric listeners of the game event and LAST ones after them. EventInvoker.invoker(Band) and hasListeners(Band) let a hook fire one band; invoker() still fires them all, in order. - ItemTooltipEvents.MODIFY does this on every loader (Forge's highest, normal and lowest priorities; Fabric phases before, at and after the default one). - ItemTooltipEvents.APPEND: lines added at the very end of an item's tooltip, after the loaders' tooltip events and every other mod's lines, with the player when there is one. - InteractionEvents (api.event.v2.common): USE_BLOCK, USE_ITEM and USE_ENTITY (answer with an InteractionResult: PASS lets the game go on, anything else stops it there) and ATTACK_BLOCK and ATTACK_ENTITY (interrupt to stop them), on both sides, before the game acts, the same on Fabric and Forge. - HeldItemSwaps (api.client.item): which changes to a held stack are quiet, so the item stays where it is in the hand instead of being put away and taken out again: quiet(...) for keys of the stack's NBT, register(...) for any test of the old and new stacks. Attachments' changes are quiet unless the attachment was built with swapAnimation(). - GhostBlocks (api.client.vfx): blocks drawn as ghosts with their real models (block entities too), one see-through picture so only their outside shows, tinted and faded by one colour; shown through walls, in the world as real blocks would be, or always; full bright or shaded. Call it right after the level is drawn. - Scene viewports (api.client.viewport.SceneViewport, api.client.gui.components.SceneViewportWidget): a 3D view of blocks, block entities, entities and items, drawn into a texture of its own (by the game's own renderers, lit as the world is) for a GUI or any textured face; turned, zoomed and framed in code or by dragging, with a ground of grid lines and shadows, and text laid flat on the picture. - ItemRendererRegistry (api.client.registry): items drawn in code, the same on every loader: an item whose model is builtin/entity is drawn by its renderer wherever it shows. - ItemColorRegistry (api.client.registry): colours for items' tinted faces, the same on every loader. - ExtraModels (api.client.registry): models baked with the game's though no item or block uses them, for drawing in code; named outright or found in the resources as they load.

2001.3.0.0 — Oct 14, 2026

🔧 Changes - CoolCatLib is one mod again: CoolCatLib: Core and CoolCatLib: Canvas are merged into CoolCatLib, one jar per loader. Screen effects, skyboxes, GUI widgets and the render utilities now ship with the events, networking, registries and configs, so there is one file to install and one version to depend on. - The mod id is now coolcatlib. With it changed: the Fabric entrypoints (coolcatlib:common, coolcatlib:client, coolcatlib:server, coolcatlib:datagen), the commands (/coolcatlib config ..., /coolcatlib_client config ...), Core's translation keys (config.coolcatlib.*, tooltip.coolcatlib.*), its payload ids and ConfigTheme.STARFALL (coolcatlib:starfall). Players and servers need the same version, as with any update. - Nothing moved in the code: the packages are still net.ixdarklord.coolcatcore and net.ixdarklord.coolcatcanvas, and Canvas's classes keep their asset namespace (coolcatcanvas:...), command (/coolcatcanvas_client) and config files. - Mods built for CoolCatLib: Core or Canvas have to be updated: the coolcatcore and coolcatcanvas mod ids are gone, and constructors are only read from the coolcatlib:* Fabric entrypoints. Depend on coolcatlib alone. - Remove the CoolCatLib: Core and Canvas jars when updating: their classes are in this one. The loaders refuse to start with them installed (Forge just fails to load them). - Maven: the artifacts are now net.ixdarklord.coolcatlib:coolcatlib-<loader> and hold everything. coolcatlib-core-<loader> and coolcatlib-canvas-<loader> stop at their last versions: replace both dependencies with the one. - Canvas's earlier releases are listed in CHANGELOG-canvas.md.

2001.2.0.1 — Oct 4, 2026

✨ New Features - Item decorators: custom drawing over an item wherever the game draws it in a GUI (inventory slots, the hotbar, a held stack), after vanilla's durability bar, cooldown and count, the same on every loader. Implement api.item.DecoratedItem on the item's class and hand over its api.client.gui.ItemDecorator in registerDecorators(registrar): that's all, Core registers it by itself, on the client, the first time the item is drawn. An item's own isBarVisible still decides whether vanilla's bar shows under it.

2001.2.0.0 — Sep 30, 2026 (Minecraft 1.20.1 backport)

✨ New Features - CoolCatLib is split in two mods: CoolCatLib: Core (coolcatcore, package net.ixdarklord.coolcatcore), this one, and CoolCatLib: Canvas (coolcatcanvas), which now holds screen effects, skyboxes, GUI widgets, RenderUtils and Easing. The mod id, package, asset namespace, Fabric entrypoints (coolcatcore:common, ...) and commands (/coolcatcore, /coolcatcore_client) all changed from coolcatlib. - A cross-loader platform layer, so mods built on CoolCatLib: Core no longer need Architectury API: - Events (api.event.v2): EventInvoker keeps listeners in common code, ordered by EventPhase, and is found by its listener type (EventInvoker.lookup(ServerTickEvents.End.class)) or its constant (ServerTickEvents.END). EventInvoker.create(Type.class) makes a mod's own event, combining listeners by return type (void, EventResult, EventResultHolder, boolean). - Built-in events: server lifecycle and ticks, datapack contents sync (ServerLifecycleEvents.SYNC_DATA_PACK_CONTENTS: per player on login and after /reload), player join/leave/tick, entity load, block break/place, commands; client ticks, player join/leave, HUD rendering, item tooltips, client commands. - api.registry: DeferredRegister / RegistryEntry, CreativeTabs, ReloadListeners. - api.menu.ExtendedMenus: menu types that open with extra data. - api.network.Network: serverbound/clientbound payloads and sending. Network.canPlayerReceive(player, type) tells whether a player's connection accepts a payload (false for clients without the mod and for GameTest mock players). - Record payloads without a StreamCodec: Network.registerServerbound(MyPayload.class, receiver) (or with an explicit Type) derives the codec from the record's components through PayloadCodecs, which knows primitives, strings, common Minecraft types, enums, nested records, arrays, Optional, List, Set, Map, Either and ResourceKey. Other types are added with PayloadCodecs.register / registerFactory; registering a payload with a component type that has no codec throws right away, naming the component. - api.client.registry: key mappings, menu screens, tooltip components. - api.platform.Platform: loader, environment, mod checks, folders, the running server, fake players. - Mod constructors (api.core): ModConstructor (both sides), ClientModConstructor, ServerModConstructor (dedicated server) and DataGenerationConstructor are written once in common code, each with a construct stage and a setup stage (DataGenerationContext.addProvider for data providers). - Fabric needs no Java entry class: list them under the coolcatcore:common, coolcatcore:client, coolcatcore:server and coolcatcore:datagen entrypoints, plus api.core.fabric.FabricDataGenerationEntrypoint under fabric-datagen. - Forge: extend api.core.forge.ForgeModEntrypoint in the @Mod class (its constructor takes the FMLJavaModLoadingContext Forge passes to @Mod constructors) and call common(...), client(() -> ...), server(() -> ...), dataGeneration(...); the mod id comes from the context. - EventResult.pass()/interrupt()/allow()/deny(), and EventResultHolder.result()/getValue(). - A config system (api.config): - Declare configs with Config.builder(modId, scope) (typed values, nested groups, presets) or from an annotated class with ConfigObject.register. - Scopes: CLIENT, COMMON, SERVER (synced to players) and WORLD (stored per world, seeded from defaultconfigs, synced). - Types: booleans, ranged numbers (optionally sliders), strings (length/pattern), enums, colors, ids, lists, and any Codec; custom ConfigTypes with their own editors. - TOML (default) and JSON5 files with generated comments; a config whose format changes converts its old file once (kept as .bak); broken files are backed up; version/migration and aliases handle renamed or moved settings. - Hot reloading of edited files, change listeners and ConfigEvents: LOADED (first read), RELOADED (hot reload, the reload command or Config.reload()), UNLOADING (a world config before its server's values are dropped), VALUE_CHANGED (each value, with its old and new value), CHANGED (once per batch), SAVED and SYNCED. - serverOnly() values that never leave the server; operators edit synced configs in-game with permission checks. - Generated config screen: search, undo/redo, reset, presets, validation, dependencies (enabledWhen), restart notices and list editing. Linked from the Forge mod list and Mod Menu. - /coolcatcore config (server) and /coolcatcore_client config (client) commands: list, get, set, reset, reload, preset, open. - STARTUP configs, read before content is registered (for item properties, which items exist...). Their values stay fixed until a restart; edits are saved for the next start. Joining a server compares them before entering the world: values must match by default (the client is offered to adopt the server's), useServerValue() values are taken from the server while connected, and localOnly() values stay per side. - Category popups: one category of a config in a small window with Save and Cancel, floating over the current screen or the game, e.g. ConfigScreens.openCategory("mymod", "client/rendering"), ConfigScreens.categoryPopup(parent, config, path), or /coolcatcore_client config open <mod> <category> (with path suggestions). A single setting's path shows just that setting. - A color picker for color values (a popup with saturation/brightness, hue and alpha, hex input and dye colors), also available as ConfigScreens.colorPicker. - The main config screen (shown for every mod, even one with a single config): a header with the mod's icon (a "?" when it has none; the list of every mod's configs has its own icon), and each config as a portrait navigation card with its own artwork (faint, brightening on hover; CoolCatLib: Core's per scope, or the mod's own at assets/<modid>/textures/gui/config/cards/<config name>.png), its scope icon and a short label like "Server" (config.<modid>.<name>.label). Cards are centered, grow when hovered, and show a tooltip with the config's scope, contents, file and access. Mod Menu's CoolCatLib: Core button opens CoolCatLib: Core's own settings. - Page transitions: a config page's panels glide a little way into place (up from below when opened, down from above when going back, a shorter rise when opened from elsewhere) while growing from slightly smaller; the background stays still. - Config screen effects: animations a theme names by id, drawn behind the panels, over the whole screen, and over each widget (buttons, toggles, sliders, text fields, cards, popup panels). Mods register their own on the client with ConfigEffects.register(id, ConfigEffect) and use them with ConfigTheme.Builder.effects(...), ConfigBuilder.effects(...) for one config, or "effects" in config_theme.json; an unknown id is skipped and an effect that throws is switched off, each logged once. The built-in ConfigTheme.STARFALL, every theme's default, draws soft glows in the accent and small faint stars falling from the top, shifting with the mouse by depth (parallax). CoolCatLib: Core's client config turns effects and the page transitions on or off (Effects > Theme Effects / Page Transitions); both are always off on the Fast graphics preset. - Redesigned config screens: a top bar (title, scope badges, search), a category sidebar, settings with descriptions and nested sections, and a bottom bar with the unsaved-changes status and actions; toggle switches, sliders, selectors and flat buttons; presets, confirmations and the color picker as popups. Icons are 64x64 textures in assets/coolcatcore/textures/gui/config/icons/ (smoothly filtered), replaceable by resource packs. - ConfigTheme: each mod's own look, set per mod (ConfigTheme.setForMod) or per config (ConfigBuilder.theme / background): a full ConfigColorScheme (presets DARK, LIGHT, and tinted(accent) for the dark scheme shaded toward the mod's color), a background texture by its path (cover, stretch or tile), the texture's opacity (textureOpacity, letting the panorama or world show through) and the backdrop color's opacity over the background (backgroundOpacity). Players can scale both for every mod in CoolCatLib: Core's client config (Background > Backdrop Opacity / Texture Opacity). By default the screens are see-through to the title panorama or the world. Resource packs can restyle a mod with assets/<modid>/coolcatcore/config_theme.json. - Popup panel sprites: ConfigTheme.Builder.popupSprite (or popup_sprite in config_theme.json) draws a nine-slice GUI sprite as the panel of popups (category popups, confirmations, the color picker) instead of the flat panel, and ConfigScreens.categoryPopup(parent, config, path, theme) opens a category popup with its own theme, e.g. to match the screen it's opened from. - Toggle switches have an outline on their track: the panel border while off, a darker shade of the accent as they turn on. - Popups keep their buttons in a footer strip along the bottom and their content above it, so a sprite's footer band sits behind the buttons only (the color picker's Cancel and Done moved there). - The config list shows each mod's icon (a theme can set another); config pages and their cards show an icon of their kind (client, common, server, world, startup). - Platform.getModName. - Dark and light mode: a sun/moon switch in every config screen's top bar, remembered in CoolCatLib: Core's own client config (themeMode). Each theme has a light scheme too (ConfigTheme.Builder.lightColors, by default derived from the mod's accent; light_base/light_colors in config_theme.json). - The main config screen's search bar searches every config it lists (names, keys, comments, group names, values), with results grouped by config; opening a result shows that config filtered to it. A config's own search covers only that config. - Attachments, containers and handlers for items, blocks and entities: - api.attachment: typed data any entity (players included), block entity or item stack can carry. Each mod creates its own AttachmentRegistry.create(modId) (and calls register() while it initialises); its values are stored under its own id, in the <modid>:attachments item component and a <modid>:attachments tag in entity and block entity data. Declared once (ATTACHMENTS.builder(name, codec, default)), then used as MADNESS.get(player), set, update, modify, reset, or through AttachmentHolder.of(...). - Persistent attachments save with their holder; transientBuilder ones never do. copyOnDeath() keeps a player's value through death (always kept through dimension changes and the End exit); keepOnDrop() carries a block entity's value into its dropped item and back when placed. - sync(SyncPolicy): SELF (the player it belongs to), TRACKING, ALL, or any predicate. Only changed values are sent, at most once per tick; everything when a player starts seeing the holder, receives its chunk, joins, respawns or changes dimension. - On item stacks, defaults aren't stored, so stacks still stack. - AttachmentEvents: CHANGING (cancel a change or replace the value), ADDED, CHANGED (in-place changes included), REMOVED, START_TRACKING/STOP_TRACKING (a player starts or stops receiving a holder's data) and RECEIVED (synced values arrived on the client), plus typed per-attachment helpers (onChanged(MADNESS, ...)). - api.container: ContainerLayout (slot filters, limits, roles STORAGE/INPUT/OUTPUT/INTERNAL, which slots each face reaches) makes SlotContainers, vanilla Containers with insert/extract, listeners and layout-aware menu slots. AttachmentRegistry.container stores one on any entity or block entity (saved and synced with the rest); ItemContainers keeps one in a stack (ContainerItem for items that have one); ItemTransfer moves items between any containers through faces. - api.block: ExtendedBlockEntity (attachment shortcuts, handlers, serverTick/clientTick with ExtendedBlockEntity.ticker) and ExtendedContainerBlockEntity (an inventory hoppers and comparators use; contents spill or, with keepContentsOnBreak, stay in the item). - api.handler: HandlerType for anything holders hand out (inventories, energy...), from the holder itself (HandlerProvider, HandlerMap) or registered providers and fallbacks for blocks, block entities, entities and items. HandlerTypes.CONTAINER also finds vanilla containers (double chests as one). BlockHandlerCache keeps a lookup until the block changes, its block entity goes, or HandlerType.invalidate is called. - Other mods reach these containers through each loader's own system, following the layout's filters, roles and limits: Forge item handler capabilities (ForgeCapabilities.ITEM_HANDLER on block entities, entities and ContainerItem stacks) and Fabric's Transfer API (ItemStorage.SIDED for blocks). - api.registry.BlockEntityTypes.create: block entity types from common code. - Storage menus (api.menu.StorageMenuDefinition): a menu for a block's or an item's inventory, declared once (StorageMenuDefinition.grid(columns, rows) or placed slot by slot), registered with createMenuType and opened with open(player, blockEntity, title) or open(player, hand, title). Slots follow the container's layout and shift-click; the menu closes when the block is removed, the player walks away, or the item leaves its slot (which stays locked meanwhile). sync(attachment) and syncValue(...) send extra values to the screen while it's open, and button(id, action) runs screen buttons on the server. api.client.gui.screens.StorageScreen draws any of these menus with no texture, and can be extended.

⚙️ Refactoring - Rewrote the v2 event system (the lookup-based skeleton had no events); EventInvokerRegistry was removed.

🔁 Differences from the 26.1.2 version (Minecraft 1.20.1) - Built for Forge 47 and Fabric (Fabric API 0.92.6) on Java 17, with the same features as CoolCatLib: Core for 26.1.2, except where 1.20.1 has no equivalent: - Networking: 1.20.1 has no payload types, so Core brings its own api.network.CustomPacketPayload and the api.network.codec package (StreamCodec, ByteBufCodecs, ...; ByteBufCodecs also holds the codecs newer Minecraft keeps on vanilla classes, such as RESOURCE_LOCATION, BLOCK_POS, ITEM_STACK, COMPONENT). On Forge every payload travels on one coolcatcore:network channel; on Fabric each payload type is its own channel. - There is no configuration phase: configuration payloads (config sync and the STARTUP config check) are sent in the login phase instead. - api.utils.ARGB: the packed colour helpers newer Minecraft has as net.minecraft.util.ARGB. - GUI: everything draws with GuiGraphics; methods named extract... on 26.1.2 are render... again (StyledScreen.renderBackground/renderPanels/renderTitle, StyledPopup.renderPopup, FlatButton.renderContents, StorageScreen.renderPanel, ConfigEffect.renderBackground/renderForeground/renderWidget), and input uses 1.20.1's mouseClicked(double, double, int), keyPressed(int, int, int), ... signatures. GUI sprites (config theme popup sprites included) are textures under textures/gui/sprites/, with their stretch, tile or nine-slice scaling read from the .mcmeta; a theme's popupSprite may also be a .png texture path. The menu blur is always on, at the default strength. Config screen effects and page transitions are off on the "Fast" graphics setting (1.20.1's equivalent of the Fast graphics preset). - Events: ClientGuiEvents HUD listeners take (GuiGraphics, float partialTick); ItemTooltipEvents has no tooltip context. - Attachments: item stack values live in the stack's NBT ("<modid>:attachments"), not in a data component (AttachmentRegistry.componentType()/bundleComponent() don't exist). keepOnDrop values reach the dropped block item through the loot table: AttachmentRegistry.copyKeptOnDrop() gives the copy_nbt function. - Containers: SlotContainer.toContents/fromContents use a CompoundTag (a vanilla Items list); ItemContainers keeps contents in BlockEntityTag.Items for block items and Items for other items. Blocks of an ExtendedContainerBlockEntity call ExtendedContainerBlockEntity.onBlockRemoved(state, level, pos, newState) from onRemove so the contents spill, and a keepContentsOnBreak layout needs a copy_nbt of Items into BlockEntityTag.Items in the loot table. There's no Fabric item storage lookup for ContainerItem stacks. - Config: ConfigBuilder.editPermission(int level) / Config.editPermission() use a permission level (default 2) instead of a Permission. - ItemDataComponent(ResourceLocation, Codec) and DataComponent are backed by the stack's NBT. - Brewing: BrewingBuilder takes Potions; RegisterBrewingRecipesEvent.invokeEvent() takes no builder and fires once per game. On Fabric, custom recipes are read through api.brewing.fabric.FabricBrewingRecipes (the PotionBrewingExt/PotionBrewingBuilderExt interfaces don't exist on 1.20.1). - FabricLanguageWrapper takes a FabricDataOutput. - Platform.isForge() and Platform.Loader.FORGE instead of isNeoForge()/NEOFORGE. - Carries the brewing fix of v2001.1.0.1: RegisterBrewingRecipesEvent fires during Forge's common setup.

2001.1.0.1 — Jul 9, 2026

🐛 Bug Fixes & Improvements - Resolved an issue where the RegisterBrewingRecipesEvent was not being triggered correctly.

2001.1.0.0 — Oct 30, 2025

⚙️ Refactoring - Renamed and reorganized several classes. - Updated version formatting from X.X.X to MCVR.X.X.X to clearly distinguish between Minecraft release versions.

✨ New Feature - Added Language Data Generator to support shared environments.

1.0.3 — Feb 19, 2024

Fixed - [CCL-1] [Fabric] Incompatibility with KubeJS

1.0.2 — Dec 27, 2023

Adding - [Fabric] Conditional Recipes - Improving the TomlConfigReader class

1.0.1 — Nov 8, 2023

Adding - Adding Arabic Translation - More methods in ScreenUtils class - Moving and rename some of the packages and classes

1.0.0 — Oct 9, 2023
  • Port to 1.20.1

CoolCatLib: Canvas (until the merge)

26.1.2-7 — Oct 5, 2026

✨ New Features - Camera shake (api.client.camera.CameraShake): CameraShake.shake(degrees, ticks) for a jolt, shake(origin, radius, degrees, ticks) for one that is strongest at a place and gone at its radius, and add(new Shake(...)) for a curve of the mod's own (a swell, a rumble). Shakes add up, are capped, and follow the game's "Distortion Effects" accessibility slider; CameraShake.setScale is for a mod's own option. From the server: api.vfx.ShakeControl.shake(level, origin, radius, degrees, ticks) or shake(player, degrees, ticks). - Camera zoom (api.client.camera.CameraZoom): CameraZoom.set(factor) narrows the view smoothly, as through a real lens, and slows the mouse by as much so aiming stays steady; reset() puts it back, and ease(perTick) sets how heavy the lens feels. CameraZoom.scroll(active, min, max, step) hands the mouse wheel to the zoom while a condition holds (a lens raised), leaving the hotbar alone. - Scene viewports (api.client.viewport.SceneViewport): a small 3D scene of blocks, whole structures and entities drawn to a texture of its own, from a camera that circles it and can spin. It is drawn by the game's own renderers with the game's own UI lighting, and only when its scene or camera changes (or a set number of times a second while it moves). Show it in a screen with SceneViewportWidget (drag to turn, scroll to zoom), or on any face in the world through texture(). - HUD takeover (api.client.gui.HudTakeover): HudTakeover.register(id, active, view) hides the game's HUD while a condition holds and draws a view of the mod's own in its place: a scope, a lens, a visor. - Bloom, with no assets: ScreenEffects.bloom(id, intensity).enable() makes bright parts of the frame glow into what is around them, so world effects, fire and lava read as light. It is a screen effect like any other (fades, strength, conditions, enableFor for a surge). The definition is coolcatcanvas:bloom (ScreenEffects.BLOOM), with the uniforms BLOOM_THRESHOLD, BLOOM_INTENSITY and BLOOM_RADIUS. - Shader materials for world effects: VfxMaterial.withShader(id) draws a material with a fragment shader of the mod's own (assets/<namespace>/shaders/<path>.fsh) in place of the textured one, for what a texture cannot do. The shader gets the quad's UVs and colour, the scene's depth and coolcatcanvas:vfx.glsl. VfxDraw.quad(a, b, c, d, u0, v0, u1, v1, argb) takes any UV range, which is how a shape passes its own numbers to its shader. - Rifts (api.client.vfx.WorldRifts, RiftSpec, Rift): a tear in the air drawn by a built-in shader (VfxMaterial.RIFT_SHADER) and run through three acts. It opens with a flash, its opening sound and a shake of the camera nearby, overshooting and settling; while open its edge crawls and crackles, a starry elsewhere drifts inside it, motes are drawn into it and its ambient sound loops; it closes to a line and snaps shut with a ring of light and its closing sound. WorldRifts.open(spec, position) stays until rift.close(); open(spec, position, ticks) closes by itself. A RiftSpec sets size, colour, timings, the three sounds, the motes and the shake. From the server: api.vfx.RiftControl.open(level, spec id, position[, ticks]) and close(level, id) for rifts the clients registered with WorldRifts.register; RiftControl.DEFAULT needs no registering. - Cutscenes (api.cutscene, api.client.cutscene): a camera flown along keyframes while the player watches. A Cutscene is plain data, the same on both sides: built in code (Cutscene.builder()), read from assets/<namespace>/cutscene/<path>.json, made in the in-game editor, or sent whole by the server. - Keyframes (CameraKeyframe): a time, position, yaw, pitch, roll (a dutch angle) and field of view (zoom), each reached along a smooth curve through its neighbours, a straight line or a cut (Interpolation), paced by any Easing. - Around the camera: letterbox bars framing an aspect ratio (letterbox(), 2.39 by default) that slide in and out, fades to any colour (fadeIn, fadeOut, or a ValueTrack for fades in the middle), subtitles, and markers that fire CutsceneEvents.MARKER on a beat. - CameraFocus keeps the camera looking at a point, an entity or the player for a stretch, turning to it and back; blendIn / blendOut glide from and to the player's own view; CutsceneAnchor measures a cutscene from the world or from the player, so one orbit plays anywhere. - Playing (Cutscenes.play(id) or play(cutscene), playAt(...) for an origin of its own): hides the HUD and hand, draws the player's body, and holds the player still, each by the cutscene's own settings. The CutscenePlayback it returns can pause, seek, change speed, stop, and tell when it ends. Players skip a skippable one by holding a key (Enter by default); pausing the game pauses it. - From the server (CutsceneControl): play(player, id), play(player, id, cutscene) to send one the client doesn't have, playAt, stop, and ServerCutsceneEvents: STARTED, TICK (every server tick a player watches), KEYFRAME and MARKER (as the player's client reaches them) and ENDED with how it ended (finished, skipped, stopped, replaced, left). - Events (CutsceneEvents, client): BEFORE_START (cancellable), STARTED, TICK while it plays, KEYFRAME as the camera reaches each one, MARKER, SUBTITLE, PAUSED, CAMERA (every frame, may hand back a changed camera), BEFORE_SKIP (cancellable) and ENDED with the reason. - editable(false) keeps a mod's cutscene out of the in-game editor; registered from code, it can't be replaced by a resource pack either. - Letterbox.show(aspect, ticks) / hide(ticks) for bars without a cutscene. - An in-game editor (Cutscenes.openEditor(), a key unbound by default, and /coolcatcanvas_client cutscene editor in development environments): fly to a spot and press K to drop a keyframe, with the path drawn in the world (a dot a tick, so spacing shows speed). Its screen has a timeline to scrub and drag keyframes on, the selected keyframe's numbers, easing and path, the scene's letterbox, blends, fades and end hold, a live preview through the camera at the playhead, and Play. It saves JSON to config/coolcatcanvas/cutscenes/, playable as coolcatcanvas:saved/<name> and ready to copy into a resource pack. Focuses, subtitles and markers are kept when a cutscene is loaded but are edited in the file. - OBJ models (api.client.model.ObjModel, ObjModels): Wavefront .obj files drawn in the world by the game's own renderers, so they are lit, fogged and sorted as anything else. ObjModels.get(id) reads any file under assets/ (kept, and read again when resource packs reload); ObjModel.parse(text) reads one from anywhere. Faces of any number of corners, negative indices, missing texture coordinates and missing normals (a flat one is worked out) are all read; o, g and usemtl split a model into named parts, each of which can be drawn by itself with its own texture, tint, light and pose. model.submit(pose, collector, renderType, light) from an entity or block entity renderer, or render(pose, vertexConsumer, ...) into any buffer, with the entity render types (entityCutout, entityTranslucent, eyes). Materials (.mtl) are not read: the caller picks the texture. - api.utils.Easings: the easing curves by name (byName, nameOf, CODEC, register for a mod's own), for files, commands and packets. - More Easing curves: SMOOTH, QUART_IN / OUT / IN_OUT, EXPO_IN_OUT, BACK_IN, BACK_IN_OUT, ELASTIC_OUT and BOUNCE_OUT.

🔧 Changes - Everything that animates by the clock stops while the game is paused and goes on from where it stopped: world effects (VfxFrame.time(), the Time of world-effect shaders, rifts), skyboxes and screen effects (their time, deltaTime, ages, fades and the Time of their shaders). A paused game is a still picture, and nothing has jumped ahead when it is taken up again. World particles also hold their exact place while paused (they used to be drawn at the end of their tick). A game counts as paused only where the game says so: a singleplayer world with a pausing screen open. - VfxMaterial has a fourth component, shader (null for the built-in one). The three-argument constructor and the additive / alpha / luminous factories are unchanged.

26.1.2-6 — Oct 5, 2026

✨ New Features - World effects (api.client.vfx): glowing shapes drawn in the world, after the whole level and before the hand, lit by nothing. They hide behind solid things and fade softly where they meet them (VfxMaterial.softness), so nothing ends in a hard line at a wall or the ground. - Materials (VfxMaterial): a texture, a blend (VfxBlend.ADDITIVE for light, ALPHA for smoke, LUMINOUS for black-background glow textures against bright skies) and a softness. Everything of one material in a frame is one draw call. - Effect particles (ParticleSpec, WorldParticles): size, opacity and spin follow three-point eased curves (Curve) over each particle's life, colour shifts around the colour wheel so gradients stay vivid, lifetimes are randomised, with gravity, drag and velocity-stretched sparks (Shape.SPARK). WorldParticles.spawn, burst and line. They are not vanilla particles: nothing to register, nothing on the server. - Shapes every frame (WorldVfx.register with a VfxRenderer): camera-facing billboards, beams, flat ground quads, free quads, and ribbons that follow a Trail. - One-liners that draw themselves and fade: WorldVfx.beam, flash and groundFlash. - Built-in textures: VfxMaterial.GLOW, SPARKLE, STAR, RING, SMOKE and STREAK (white, with brightness in alpha, so they take any colour and blend either way). - From the server (api.vfx.VfxControl): VfxControl.play(level, id, VfxParams) plays an effect a client registered with VfxEffects.register, as one small packet to each player in range. - Shaders can import coolcatcanvas:vfx.glsl for the camera block and the depth-fade helpers.

26.1.2-5 — Oct 4, 2026

🔧 Changes - Renamed ScreenEffectStage to ScreenEffectScope, and ScreenEffect.stage() / stage(...) to scope() / scope(...): .scope(ScreenEffectScope.SCREEN) puts an effect over the HUD and menus. Mods calling the old names need updating. The effects screen's screen_effect.coolcatcanvas.screen.stage.* translation keys are now ...screen.scope.*.

26.1.2-4 — Oct 4, 2026

✨ New Features - A built-in tint screen effect, with nothing to set up: ScreenEffects.tint(id, argb) makes a color wash under a mod's own id the first time and recolors it after, so ScreenEffects.tint(id, 0x59FF0000).enableFor(5) is a red flash wherever it's called. It's a screen effect like any other (fades, strength, conditions), over the world or, on the SCREEN stage, over the HUD and menus too. From the server, ScreenEffectControl.tint(player, id, argb[, ticks]) does the same for a player, with nothing registered on the client. The definition is coolcatcanvas:tint (ScreenEffects.TINT, color uniform TINT_COLOR).

26.1.2-3 — Oct 4, 2026

🔧 Changes - Built for CoolCatLib: Core 26.1.2-3; no changes of its own.

26.1.2-2 — Oct 3, 2026

🔧 Changes - Now holds the styled widgets its screen effects screen uses (from CoolCatLib: Core; Glazed Menu has its own copy): panels, flat buttons, toggles, text boxes, popups, dropdowns, icons and their textures (assets/coolcatcanvas/textures/gui/style/). - Config screen effects moved here from Core: ConfigEffect and ConfigEffects are now in net.ixdarklord.coolcatcanvas.api.client.gui.theme (the built-in ConfigTheme.STARFALL keeps its id). - Its screen effects screen keeps its dark/light choice with the effects screen's other choices (config/coolcatcanvas-screen-effects.json); its animations are off on the Fast graphics preset. Canvas has no config file of its own (Glazed Menu's screens use Glazed Menu's settings).

26.1.2-1 — Sep 30, 2026 (Minecraft 26.1.2)

✨ New Features - Runs on Minecraft 26.1, 26.1.1 and 26.1.2 (NeoForge 26.1.0.19-beta or newer, Fabric API 0.145.1 or newer). - First release: the render and visuals half of what used to be CoolCatLib, split out and built on CoolCatLib: Core. Everything below was moved from CoolCatLib into the net.ixdarklord.coolcatcanvas package and coolcatcanvas namespace. - Screen effects (api.client.effect): full-screen post-processing shaders whose uniforms can change every frame (vanilla's post chains bake them in at load). - ScreenEffects.register(id, definition) from a vanilla-format post_effect JSON (vanilla's own included) or a ScreenEffectDefinition built in code; any number stack, ordered by priority, drawn over the world (WORLD) or over everything including the HUD and menus (SCREEN). - Smooth fades (fade, Easing), timed pulses (enableFor), animated strength, conditions (activeWhen), strength functions of the frame (strength) and per-frame callbacks (onFrame). - Uniforms by name: set, animated (animateTo) or bound to a function of the frame; autoBlend fades shaders that ignore the effect's strength. - Shaders get Strength, Time, Age and Seed plus noise and luminance helpers from #moj_import <coolcatcanvas:screen_effect.glsl>; persistent targets allow feedback effects; reloaded with resource packs; a failing effect is logged and skipped. - No effects of its own: mods bring their own post_effect JSON and shaders, or use vanilla's (minecraft:invert, ...). - api.effect.ScreenEffectControl drives a player's effects from the server. - Layers (ScreenEffects.layers()): the draw order of every effect, from priorities until rearranged (move up/down, to a layer, to the top or bottom, reset). - An effects screen (ScreenEffects.openScreen(), a key unbound by default, and /coolcatcanvas_client effects in development environments only): every selectable effect with a switch, the active ones as drag-and-drop layers grouped by stage with a strength slider each, a live unblurred preview and a Preview mode hiding the panels. Players' choices (on/off, strengths, order) are saved to config/coolcatcanvas-screen-effects.json. Effects have a displayName, description and selectable flag for it. - Events (ScreenEffectEvents): BEFORE_TOGGLE (cancellable) and TOGGLED with the cause (code, condition, timeout, player, server), STRENGTH_CHANGED, UNIFORM_CHANGED, LAYERS_CHANGED and LOADED. - Custom skyboxes (api.client.sky): layers drawn inside vanilla's sky pass, around the sun, moon and stars. - Skyboxes.register(id, definition) from a SkyboxDefinition built in code or assets/<namespace>/skybox/<path>.json; resource packs add skyboxes with no code by listing dimensions (dimensions without a sky, like the Nether, get one while it shows). - Layer types: cubemap (six faces in a 3x2 image), panorama (equirectangular), sprite (an image placed in the sky, e.g. a planet), gradient, and shader (your own fragment shader, with #moj_import <coolcatcanvas:sky.glsl>); any type can swap in its own fragment shader. - Per layer: blend mode (alpha, additive, multiply, screen), tint, orientation, rotation over real time, game time, the day or vanilla's sun/moon/star angle, flipbook animation with optional interpolation, day-time fade windows, rain fade, horizon/underwater fog, and 4 shader params. - Hides vanilla's sky color, sunrise, sun, moon, stars, void, End sky and End flashes, fading them out as the skybox fades in. - Runtime control: fades, enableFor, conditions (activeWhen), per-frame callbacks, and per layer (Skybox.layer(name)) visibility, animated opacity and tint, and params set, animated or bound to a function of the frame. api.sky.SkyboxControl drives them from the server: enable, disable, toggle, setEnabled, timed pulses and layer changes, for one player or several (to(players), inLevel(level), everyone(server)). - Cheap: nothing runs while no skybox shows; a visible layer is one draw from a shared static mesh, all layers of a stage share one render pass and one uniform upload. - api.utils.Easing: easing curves. - GUI components and widgets (api.client.gui.components: panels, scroll and drag widgets, slide animations, ColorableImageButton), and api.client.utils RenderUtils, NineSliceInfo and ScreenAnchor. - ViewportPanel (pan and zoom) edge fades show where content continues past an edge, and shrink smoothly into their side as the end of the content on that side comes into view. - Animated color gradients (api.utils.ColorGradient): color stops looping around (ColorGradient.of(colors...)) or the full rainbow (RAINBOW, rainbow(saturation, brightness)), scrolling over time (withSpeed) and along the text or outline (withSpread), with each letter colored (perLetter(n)) or the whole text in one cycling color (wholeText(), RAINBOW_WHOLE). Presets: RAINBOW, RAINBOW_WHOLE, PASTEL_RAINBOW, FIRE, OCEAN, AURORA. - Gradient components: gradient.literal("..."), gradient.apply(component) or a style with gradient.textColor() make a component animate wherever it's drawn (chat, tooltips, item names, signs, widget labels). In JSON text and commands (/tellraw) the color is "coolcatcanvas:rainbow", "coolcatcanvas:rainbow_whole", "coolcatcanvas:rainbow/<speed>/<spread>/<saturation>/<brightness>" or "coolcatcanvas:gradient/<speed>/<spread>/#RRGGBB/#RRGGBB..."; players without Canvas can't read it. - Gradient and outlined text (api.client.utils.TextEffects): gradient(text, gradient) and rainbow(text) recolor existing text and stay animated when kept; outlined text in a solid color or a gradient. - Outlines (api.client.utils.Outline): solid or a gradient (Outline.gradient, Outline.rainbow()), with a thickness and padding, drawn around any rectangle; ElementOutlines.set(widget, outline[, when]) attaches one to any widget (vanilla's too), optionally only while a condition holds (hovered, focused...).

26.1.2-7 — Oct 5, 2026

✨ New Features - Camera shake (api.client.camera.CameraShake): CameraShake.shake(degrees, ticks) for a jolt, shake(origin, radius, degrees, ticks) for one that is strongest at a place and gone at its radius, and add(new Shake(...)) for a curve of the mod's own (a swell, a rumble). Shakes add up, are capped, and follow the game's "Distortion Effects" accessibility slider; CameraShake.setScale is for a mod's own option. From the server: api.vfx.ShakeControl.shake(level, origin, radius, degrees, ticks) or shake(player, degrees, ticks). - Camera zoom (api.client.camera.CameraZoom): CameraZoom.set(factor) narrows the view smoothly, as through a real lens, and slows the mouse by as much so aiming stays steady; reset() puts it back, and ease(perTick) sets how heavy the lens feels. CameraZoom.scroll(active, min, max, step) hands the mouse wheel to the zoom while a condition holds (a lens raised), leaving the hotbar alone. - Scene viewports (api.client.viewport.SceneViewport): a small 3D scene of blocks, whole structures and entities drawn to a texture of its own, from a camera that circles it and can spin. It is drawn by the game's own renderers with the game's own UI lighting, and only when its scene or camera changes (or a set number of times a second while it moves). Show it in a screen with SceneViewportWidget (drag to turn, scroll to zoom), or on any face in the world through texture(). - HUD takeover (api.client.gui.HudTakeover): HudTakeover.register(id, active, view) hides the game's HUD while a condition holds and draws a view of the mod's own in its place: a scope, a lens, a visor. - Bloom, with no assets: ScreenEffects.bloom(id, intensity).enable() makes bright parts of the frame glow into what is around them, so world effects, fire and lava read as light. It is a screen effect like any other (fades, strength, conditions, enableFor for a surge). The definition is coolcatcanvas:bloom (ScreenEffects.BLOOM), with the uniforms BLOOM_THRESHOLD, BLOOM_INTENSITY and BLOOM_RADIUS. - Shader materials for world effects: VfxMaterial.withShader(id) draws a material with a fragment shader of the mod's own (assets/<namespace>/shaders/<path>.fsh) in place of the textured one, for what a texture cannot do. The shader gets the quad's UVs and colour, the scene's depth and coolcatcanvas:vfx.glsl. VfxDraw.quad(a, b, c, d, u0, v0, u1, v1, argb) takes any UV range, which is how a shape passes its own numbers to its shader. - Rifts (api.client.vfx.WorldRifts, RiftSpec, Rift): a tear in the air drawn by a built-in shader (VfxMaterial.RIFT_SHADER) and run through three acts. It opens with a flash, its opening sound and a shake of the camera nearby, overshooting and settling; while open its edge crawls and crackles, a starry elsewhere drifts inside it, motes are drawn into it and its ambient sound loops; it closes to a line and snaps shut with a ring of light and its closing sound. WorldRifts.open(spec, position) stays until rift.close(); open(spec, position, ticks) closes by itself. A RiftSpec sets size, colour, timings, the three sounds, the motes and the shake. From the server: api.vfx.RiftControl.open(level, spec id, position[, ticks]) and close(level, id) for rifts the clients registered with WorldRifts.register; RiftControl.DEFAULT needs no registering. - Cutscenes (api.cutscene, api.client.cutscene): a camera flown along keyframes while the player watches. A Cutscene is plain data, the same on both sides: built in code (Cutscene.builder()), read from assets/<namespace>/cutscene/<path>.json, made in the in-game editor, or sent whole by the server. - Keyframes (CameraKeyframe): a time, position, yaw, pitch, roll (a dutch angle) and field of view (zoom), each reached along a smooth curve through its neighbours, a straight line or a cut (Interpolation), paced by any Easing. - Around the camera: letterbox bars framing an aspect ratio (letterbox(), 2.39 by default) that slide in and out, fades to any colour (fadeIn, fadeOut, or a ValueTrack for fades in the middle), subtitles, and markers that fire CutsceneEvents.MARKER on a beat. - CameraFocus keeps the camera looking at a point, an entity or the player for a stretch, turning to it and back; blendIn / blendOut glide from and to the player's own view; CutsceneAnchor measures a cutscene from the world or from the player, so one orbit plays anywhere. - Playing (Cutscenes.play(id) or play(cutscene), playAt(...) for an origin of its own): hides the HUD and hand, draws the player's body, and holds the player still, each by the cutscene's own settings. The CutscenePlayback it returns can pause, seek, change speed, stop, and tell when it ends. Players skip a skippable one by holding a key (Enter by default); pausing the game pauses it. - From the server (CutsceneControl): play(player, id), play(player, id, cutscene) to send one the client doesn't have, playAt, stop, and ServerCutsceneEvents: STARTED, TICK (every server tick a player watches), KEYFRAME and MARKER (as the player's client reaches them) and ENDED with how it ended (finished, skipped, stopped, replaced, left). - Events (CutsceneEvents, client): BEFORE_START (cancellable), STARTED, TICK while it plays, KEYFRAME as the camera reaches each one, MARKER, SUBTITLE, PAUSED, CAMERA (every frame, may hand back a changed camera), BEFORE_SKIP (cancellable) and ENDED with the reason. - editable(false) keeps a mod's cutscene out of the in-game editor; registered from code, it can't be replaced by a resource pack either. - Letterbox.show(aspect, ticks) / hide(ticks) for bars without a cutscene. - An in-game editor (Cutscenes.openEditor(), a key unbound by default, and /coolcatcanvas_client cutscene editor in development environments): fly to a spot and press K to drop a keyframe, with the path drawn in the world (a dot a tick, so spacing shows speed). Its screen has a timeline to scrub and drag keyframes on, the selected keyframe's numbers, easing and path, the scene's letterbox, blends, fades and end hold, a live preview through the camera at the playhead, and Play. It saves JSON to config/coolcatcanvas/cutscenes/, playable as coolcatcanvas:saved/<name> and ready to copy into a resource pack. Focuses, subtitles and markers are kept when a cutscene is loaded but are edited in the file. - OBJ models (api.client.model.ObjModel, ObjModels): Wavefront .obj files drawn in the world by the game's own renderers, so they are lit, fogged and sorted as anything else. ObjModels.get(id) reads any file under assets/ (kept, and read again when resource packs reload); ObjModel.parse(text) reads one from anywhere. Faces of any number of corners, negative indices, missing texture coordinates and missing normals (a flat one is worked out) are all read; o, g and usemtl split a model into named parts, each of which can be drawn by itself with its own texture, tint, light and pose. model.submit(pose, collector, renderType, light) from an entity or block entity renderer, or render(pose, vertexConsumer, ...) into any buffer, with the entity render types (entityCutout, entityTranslucent, eyes). Materials (.mtl) are not read: the caller picks the texture. - api.utils.Easings: the easing curves by name (byName, nameOf, CODEC, register for a mod's own), for files, commands and packets. - More Easing curves: SMOOTH, QUART_IN / OUT / IN_OUT, EXPO_IN_OUT, BACK_IN, BACK_IN_OUT, ELASTIC_OUT and BOUNCE_OUT.

🔧 Changes - Everything that animates by the clock stops while the game is paused and goes on from where it stopped: world effects (VfxFrame.time(), the Time of world-effect shaders, rifts), skyboxes and screen effects (their time, deltaTime, ages, fades and the Time of their shaders). A paused game is a still picture, and nothing has jumped ahead when it is taken up again. World particles also hold their exact place while paused (they used to be drawn at the end of their tick). A game counts as paused only where the game says so: a singleplayer world with a pausing screen open. - VfxMaterial has a fourth component, shader (null for the built-in one). The three-argument constructor and the additive / alpha / luminous factories are unchanged.

26.1.2-6 — Oct 5, 2026

✨ New Features - World effects (api.client.vfx): glowing shapes drawn in the world, after the whole level and before the hand, lit by nothing. They hide behind solid things and fade softly where they meet them (VfxMaterial.softness), so nothing ends in a hard line at a wall or the ground. - Materials (VfxMaterial): a texture, a blend (VfxBlend.ADDITIVE for light, ALPHA for smoke, LUMINOUS for black-background glow textures against bright skies) and a softness. Everything of one material in a frame is one draw call. - Effect particles (ParticleSpec, WorldParticles): size, opacity and spin follow three-point eased curves (Curve) over each particle's life, colour shifts around the colour wheel so gradients stay vivid, lifetimes are randomised, with gravity, drag and velocity-stretched sparks (Shape.SPARK). WorldParticles.spawn, burst and line. They are not vanilla particles: nothing to register, nothing on the server. - Shapes every frame (WorldVfx.register with a VfxRenderer): camera-facing billboards, beams, flat ground quads, free quads, and ribbons that follow a Trail. - One-liners that draw themselves and fade: WorldVfx.beam, flash and groundFlash. - Built-in textures: VfxMaterial.GLOW, SPARKLE, STAR, RING, SMOKE and STREAK (white, with brightness in alpha, so they take any colour and blend either way). - From the server (api.vfx.VfxControl): VfxControl.play(level, id, VfxParams) plays an effect a client registered with VfxEffects.register, as one small packet to each player in range. - Shaders can import coolcatcanvas:vfx.glsl for the camera block and the depth-fade helpers.

26.1.2-5 — Oct 4, 2026

🔧 Changes - Renamed ScreenEffectStage to ScreenEffectScope, and ScreenEffect.stage() / stage(...) to scope() / scope(...): .scope(ScreenEffectScope.SCREEN) puts an effect over the HUD and menus. Mods calling the old names need updating. The effects screen's screen_effect.coolcatcanvas.screen.stage.* translation keys are now ...screen.scope.*.

26.1.2-4 — Oct 4, 2026

✨ New Features - A built-in tint screen effect, with nothing to set up: ScreenEffects.tint(id, argb) makes a color wash under a mod's own id the first time and recolors it after, so ScreenEffects.tint(id, 0x59FF0000).enableFor(5) is a red flash wherever it's called. It's a screen effect like any other (fades, strength, conditions), over the world or, on the SCREEN stage, over the HUD and menus too. From the server, ScreenEffectControl.tint(player, id, argb[, ticks]) does the same for a player, with nothing registered on the client. The definition is coolcatcanvas:tint (ScreenEffects.TINT, color uniform TINT_COLOR).

26.1.2-3 — Oct 4, 2026

🔧 Changes - Built for CoolCatLib: Core 26.1.2-3; no changes of its own.

26.1.2-2 — Oct 3, 2026

🔧 Changes - Now holds the styled widgets its screen effects screen uses (from CoolCatLib: Core; Glazed Menu has its own copy): panels, flat buttons, toggles, text boxes, popups, dropdowns, icons and their textures (assets/coolcatcanvas/textures/gui/style/). - Config screen effects moved here from Core: ConfigEffect and ConfigEffects are now in net.ixdarklord.coolcatcanvas.api.client.gui.theme (the built-in ConfigTheme.STARFALL keeps its id). - Its screen effects screen keeps its dark/light choice with the effects screen's other choices (config/coolcatcanvas-screen-effects.json); its animations are off on the Fast graphics preset. Canvas has no config file of its own (Glazed Menu's screens use Glazed Menu's settings).

26.1.2-1 — Sep 30, 2026 (Minecraft 26.1.2)

✨ New Features - Runs on Minecraft 26.1, 26.1.1 and 26.1.2 (NeoForge 26.1.0.19-beta or newer, Fabric API 0.145.1 or newer). - First release: the render and visuals half of what used to be CoolCatLib, split out and built on CoolCatLib: Core. Everything below was moved from CoolCatLib into the net.ixdarklord.coolcatcanvas package and coolcatcanvas namespace. - Screen effects (api.client.effect): full-screen post-processing shaders whose uniforms can change every frame (vanilla's post chains bake them in at load). - ScreenEffects.register(id, definition) from a vanilla-format post_effect JSON (vanilla's own included) or a ScreenEffectDefinition built in code; any number stack, ordered by priority, drawn over the world (WORLD) or over everything including the HUD and menus (SCREEN). - Smooth fades (fade, Easing), timed pulses (enableFor), animated strength, conditions (activeWhen), strength functions of the frame (strength) and per-frame callbacks (onFrame). - Uniforms by name: set, animated (animateTo) or bound to a function of the frame; autoBlend fades shaders that ignore the effect's strength. - Shaders get Strength, Time, Age and Seed plus noise and luminance helpers from #moj_import <coolcatcanvas:screen_effect.glsl>; persistent targets allow feedback effects; reloaded with resource packs; a failing effect is logged and skipped. - No effects of its own: mods bring their own post_effect JSON and shaders, or use vanilla's (minecraft:invert, ...). - api.effect.ScreenEffectControl drives a player's effects from the server. - Layers (ScreenEffects.layers()): the draw order of every effect, from priorities until rearranged (move up/down, to a layer, to the top or bottom, reset). - An effects screen (ScreenEffects.openScreen(), a key unbound by default, and /coolcatcanvas_client effects in development environments only): every selectable effect with a switch, the active ones as drag-and-drop layers grouped by stage with a strength slider each, a live unblurred preview and a Preview mode hiding the panels. Players' choices (on/off, strengths, order) are saved to config/coolcatcanvas-screen-effects.json. Effects have a displayName, description and selectable flag for it. - Events (ScreenEffectEvents): BEFORE_TOGGLE (cancellable) and TOGGLED with the cause (code, condition, timeout, player, server), STRENGTH_CHANGED, UNIFORM_CHANGED, LAYERS_CHANGED and LOADED. - Custom skyboxes (api.client.sky): layers drawn inside vanilla's sky pass, around the sun, moon and stars. - Skyboxes.register(id, definition) from a SkyboxDefinition built in code or assets/<namespace>/skybox/<path>.json; resource packs add skyboxes with no code by listing dimensions (dimensions without a sky, like the Nether, get one while it shows). - Layer types: cubemap (six faces in a 3x2 image), panorama (equirectangular), sprite (an image placed in the sky, e.g. a planet), gradient, and shader (your own fragment shader, with #moj_import <coolcatcanvas:sky.glsl>); any type can swap in its own fragment shader. - Per layer: blend mode (alpha, additive, multiply, screen), tint, orientation, rotation over real time, game time, the day or vanilla's sun/moon/star angle, flipbook animation with optional interpolation, day-time fade windows, rain fade, horizon/underwater fog, and 4 shader params. - Hides vanilla's sky color, sunrise, sun, moon, stars, void, End sky and End flashes, fading them out as the skybox fades in. - Runtime control: fades, enableFor, conditions (activeWhen), per-frame callbacks, and per layer (Skybox.layer(name)) visibility, animated opacity and tint, and params set, animated or bound to a function of the frame. api.sky.SkyboxControl drives them from the server: enable, disable, toggle, setEnabled, timed pulses and layer changes, for one player or several (to(players), inLevel(level), everyone(server)). - Cheap: nothing runs while no skybox shows; a visible layer is one draw from a shared static mesh, all layers of a stage share one render pass and one uniform upload. - api.utils.Easing: easing curves. - GUI components and widgets (api.client.gui.components: panels, scroll and drag widgets, slide animations, ColorableImageButton), and api.client.utils RenderUtils, NineSliceInfo and ScreenAnchor. - ViewportPanel (pan and zoom) edge fades show where content continues past an edge, and shrink smoothly into their side as the end of the content on that side comes into view. - Animated color gradients (api.utils.ColorGradient): color stops looping around (ColorGradient.of(colors...)) or the full rainbow (RAINBOW, rainbow(saturation, brightness)), scrolling over time (withSpeed) and along the text or outline (withSpread), with each letter colored (perLetter(n)) or the whole text in one cycling color (wholeText(), RAINBOW_WHOLE). Presets: RAINBOW, RAINBOW_WHOLE, PASTEL_RAINBOW, FIRE, OCEAN, AURORA. - Gradient components: gradient.literal("..."), gradient.apply(component) or a style with gradient.textColor() make a component animate wherever it's drawn (chat, tooltips, item names, signs, widget labels). In JSON text and commands (/tellraw) the color is "coolcatcanvas:rainbow", "coolcatcanvas:rainbow_whole", "coolcatcanvas:rainbow/<speed>/<spread>/<saturation>/<brightness>" or "coolcatcanvas:gradient/<speed>/<spread>/#RRGGBB/#RRGGBB..."; players without Canvas can't read it. - Gradient and outlined text (api.client.utils.TextEffects): gradient(text, gradient) and rainbow(text) recolor existing text and stay animated when kept; outlined text in a solid color or a gradient. - Outlines (api.client.utils.Outline): solid or a gradient (Outline.gradient, Outline.rainbow()), with a thickness and padding, drawn around any rectangle; ElementOutlines.set(widget, outline[, when]) attaches one to any widget (vanilla's too), optionally only while a condition holds (hovered, focused...).

26.1.2-7 — Oct 5, 2026

✨ New Features - Camera shake (api.client.camera.CameraShake): CameraShake.shake(degrees, ticks) for a jolt, shake(origin, radius, degrees, ticks) for one that is strongest at a place and gone at its radius, and add(new Shake(...)) for a curve of the mod's own (a swell, a rumble). Shakes add up, are capped, and follow the game's "Distortion Effects" accessibility slider; CameraShake.setScale is for a mod's own option. From the server: api.vfx.ShakeControl.shake(level, origin, radius, degrees, ticks) or shake(player, degrees, ticks). - Camera zoom (api.client.camera.CameraZoom): CameraZoom.set(factor) narrows the view smoothly, as through a real lens, and slows the mouse by as much so aiming stays steady; reset() puts it back, and ease(perTick) sets how heavy the lens feels. CameraZoom.scroll(active, min, max, step) hands the mouse wheel to the zoom while a condition holds (a lens raised), leaving the hotbar alone. - Scene viewports (api.client.viewport.SceneViewport): a small 3D scene of blocks, whole structures and entities drawn to a texture of its own, from a camera that circles it and can spin. It is drawn by the game's own renderers with the game's own UI lighting, and only when its scene or camera changes (or a set number of times a second while it moves). Show it in a screen with SceneViewportWidget (drag to turn, scroll to zoom), or on any face in the world through texture(). - HUD takeover (api.client.gui.HudTakeover): HudTakeover.register(id, active, view) hides the game's HUD while a condition holds and draws a view of the mod's own in its place: a scope, a lens, a visor. - Bloom, with no assets: ScreenEffects.bloom(id, intensity).enable() makes bright parts of the frame glow into what is around them, so world effects, fire and lava read as light. It is a screen effect like any other (fades, strength, conditions, enableFor for a surge). The definition is coolcatcanvas:bloom (ScreenEffects.BLOOM), with the uniforms BLOOM_THRESHOLD, BLOOM_INTENSITY and BLOOM_RADIUS. - Shader materials for world effects: VfxMaterial.withShader(id) draws a material with a fragment shader of the mod's own (assets/<namespace>/shaders/<path>.fsh) in place of the textured one, for what a texture cannot do. The shader gets the quad's UVs and colour, the scene's depth and coolcatcanvas:vfx.glsl. VfxDraw.quad(a, b, c, d, u0, v0, u1, v1, argb) takes any UV range, which is how a shape passes its own numbers to its shader. - Rifts (api.client.vfx.WorldRifts, RiftSpec, Rift): a tear in the air drawn by a built-in shader (VfxMaterial.RIFT_SHADER) and run through three acts. It opens with a flash, its opening sound and a shake of the camera nearby, overshooting and settling; while open its edge crawls and crackles, a starry elsewhere drifts inside it, motes are drawn into it and its ambient sound loops; it closes to a line and snaps shut with a ring of light and its closing sound. WorldRifts.open(spec, position) stays until rift.close(); open(spec, position, ticks) closes by itself. A RiftSpec sets size, colour, timings, the three sounds, the motes and the shake. From the server: api.vfx.RiftControl.open(level, spec id, position[, ticks]) and close(level, id) for rifts the clients registered with WorldRifts.register; RiftControl.DEFAULT needs no registering. - Cutscenes (api.cutscene, api.client.cutscene): a camera flown along keyframes while the player watches. A Cutscene is plain data, the same on both sides: built in code (Cutscene.builder()), read from assets/<namespace>/cutscene/<path>.json, made in the in-game editor, or sent whole by the server. - Keyframes (CameraKeyframe): a time, position, yaw, pitch, roll (a dutch angle) and field of view (zoom), each reached along a smooth curve through its neighbours, a straight line or a cut (Interpolation), paced by any Easing. - Around the camera: letterbox bars framing an aspect ratio (letterbox(), 2.39 by default) that slide in and out, fades to any colour (fadeIn, fadeOut, or a ValueTrack for fades in the middle), subtitles, and markers that fire CutsceneEvents.MARKER on a beat. - CameraFocus keeps the camera looking at a point, an entity or the player for a stretch, turning to it and back; blendIn / blendOut glide from and to the player's own view; CutsceneAnchor measures a cutscene from the world or from the player, so one orbit plays anywhere. - Playing (Cutscenes.play(id) or play(cutscene), playAt(...) for an origin of its own): hides the HUD and hand, draws the player's body, and holds the player still, each by the cutscene's own settings. The CutscenePlayback it returns can pause, seek, change speed, stop, and tell when it ends. Players skip a skippable one by holding a key (Enter by default); pausing the game pauses it. - From the server (CutsceneControl): play(player, id), play(player, id, cutscene) to send one the client doesn't have, playAt, stop, and ServerCutsceneEvents: STARTED, TICK (every server tick a player watches), KEYFRAME and MARKER (as the player's client reaches them) and ENDED with how it ended (finished, skipped, stopped, replaced, left). - Events (CutsceneEvents, client): BEFORE_START (cancellable), STARTED, TICK while it plays, KEYFRAME as the camera reaches each one, MARKER, SUBTITLE, PAUSED, CAMERA (every frame, may hand back a changed camera), BEFORE_SKIP (cancellable) and ENDED with the reason. - editable(false) keeps a mod's cutscene out of the in-game editor; registered from code, it can't be replaced by a resource pack either. - Letterbox.show(aspect, ticks) / hide(ticks) for bars without a cutscene. - An in-game editor (Cutscenes.openEditor(), a key unbound by default, and /coolcatcanvas_client cutscene editor in development environments): fly to a spot and press K to drop a keyframe, with the path drawn in the world (a dot a tick, so spacing shows speed). Its screen has a timeline to scrub and drag keyframes on, the selected keyframe's numbers, easing and path, the scene's letterbox, blends, fades and end hold, a live preview through the camera at the playhead, and Play. It saves JSON to config/coolcatcanvas/cutscenes/, playable as coolcatcanvas:saved/<name> and ready to copy into a resource pack. Focuses, subtitles and markers are kept when a cutscene is loaded but are edited in the file. - OBJ models (api.client.model.ObjModel, ObjModels): Wavefront .obj files drawn in the world by the game's own renderers, so they are lit, fogged and sorted as anything else. ObjModels.get(id) reads any file under assets/ (kept, and read again when resource packs reload); ObjModel.parse(text) reads one from anywhere. Faces of any number of corners, negative indices, missing texture coordinates and missing normals (a flat one is worked out) are all read; o, g and usemtl split a model into named parts, each of which can be drawn by itself with its own texture, tint, light and pose. model.submit(pose, collector, renderType, light) from an entity or block entity renderer, or render(pose, vertexConsumer, ...) into any buffer, with the entity render types (entityCutout, entityTranslucent, eyes). Materials (.mtl) are not read: the caller picks the texture. - api.utils.Easings: the easing curves by name (byName, nameOf, CODEC, register for a mod's own), for files, commands and packets. - More Easing curves: SMOOTH, QUART_IN / OUT / IN_OUT, EXPO_IN_OUT, BACK_IN, BACK_IN_OUT, ELASTIC_OUT and BOUNCE_OUT.

🔧 Changes - Everything that animates by the clock stops while the game is paused and goes on from where it stopped: world effects (VfxFrame.time(), the Time of world-effect shaders, rifts), skyboxes and screen effects (their time, deltaTime, ages, fades and the Time of their shaders). A paused game is a still picture, and nothing has jumped ahead when it is taken up again. World particles also hold their exact place while paused (they used to be drawn at the end of their tick). A game counts as paused only where the game says so: a singleplayer world with a pausing screen open. - VfxMaterial has a fourth component, shader (null for the built-in one). The three-argument constructor and the additive / alpha / luminous factories are unchanged.

26.1.2-6 — Oct 5, 2026

✨ New Features - World effects (api.client.vfx): glowing shapes drawn in the world, after the whole level and before the hand, lit by nothing. They hide behind solid things and fade softly where they meet them (VfxMaterial.softness), so nothing ends in a hard line at a wall or the ground. - Materials (VfxMaterial): a texture, a blend (VfxBlend.ADDITIVE for light, ALPHA for smoke, LUMINOUS for black-background glow textures against bright skies) and a softness. Everything of one material in a frame is one draw call. - Effect particles (ParticleSpec, WorldParticles): size, opacity and spin follow three-point eased curves (Curve) over each particle's life, colour shifts around the colour wheel so gradients stay vivid, lifetimes are randomised, with gravity, drag and velocity-stretched sparks (Shape.SPARK). WorldParticles.spawn, burst and line. They are not vanilla particles: nothing to register, nothing on the server. - Shapes every frame (WorldVfx.register with a VfxRenderer): camera-facing billboards, beams, flat ground quads, free quads, and ribbons that follow a Trail. - One-liners that draw themselves and fade: WorldVfx.beam, flash and groundFlash. - Built-in textures: VfxMaterial.GLOW, SPARKLE, STAR, RING, SMOKE and STREAK (white, with brightness in alpha, so they take any colour and blend either way). - From the server (api.vfx.VfxControl): VfxControl.play(level, id, VfxParams) plays an effect a client registered with VfxEffects.register, as one small packet to each player in range. - Shaders can import coolcatcanvas:vfx.glsl for the camera block and the depth-fade helpers.

26.1.2-5 — Oct 4, 2026

🔧 Changes - Renamed ScreenEffectStage to ScreenEffectScope, and ScreenEffect.stage() / stage(...) to scope() / scope(...): .scope(ScreenEffectScope.SCREEN) puts an effect over the HUD and menus. Mods calling the old names need updating. The effects screen's screen_effect.coolcatcanvas.screen.stage.* translation keys are now ...screen.scope.*.

26.1.2-4 — Oct 4, 2026

✨ New Features - A built-in tint screen effect, with nothing to set up: ScreenEffects.tint(id, argb) makes a color wash under a mod's own id the first time and recolors it after, so ScreenEffects.tint(id, 0x59FF0000).enableFor(5) is a red flash wherever it's called. It's a screen effect like any other (fades, strength, conditions), over the world or, on the SCREEN stage, over the HUD and menus too. From the server, ScreenEffectControl.tint(player, id, argb[, ticks]) does the same for a player, with nothing registered on the client. The definition is coolcatcanvas:tint (ScreenEffects.TINT, color uniform TINT_COLOR).

26.1.2-3 — Oct 4, 2026

🔧 Changes - Built for CoolCatLib: Core 26.1.2-3; no changes of its own.

26.1.2-2 — Oct 3, 2026

🔧 Changes - Now holds the styled widgets its screen effects screen uses (from CoolCatLib: Core; Glazed Menu has its own copy): panels, flat buttons, toggles, text boxes, popups, dropdowns, icons and their textures (assets/coolcatcanvas/textures/gui/style/). - Config screen effects moved here from Core: ConfigEffect and ConfigEffects are now in net.ixdarklord.coolcatcanvas.api.client.gui.theme (the built-in ConfigTheme.STARFALL keeps its id). - Its screen effects screen keeps its dark/light choice with the effects screen's other choices (config/coolcatcanvas-screen-effects.json); its animations are off on the Fast graphics preset. Canvas has no config file of its own (Glazed Menu's screens use Glazed Menu's settings).

26.1.2-1 — Sep 30, 2026 (Minecraft 26.1.2)

✨ New Features - Runs on Minecraft 26.1, 26.1.1 and 26.1.2 (NeoForge 26.1.0.19-beta or newer, Fabric API 0.145.1 or newer). - First release: the render and visuals half of what used to be CoolCatLib, split out and built on CoolCatLib: Core. Everything below was moved from CoolCatLib into the net.ixdarklord.coolcatcanvas package and coolcatcanvas namespace. - Screen effects (api.client.effect): full-screen post-processing shaders whose uniforms can change every frame (vanilla's post chains bake them in at load). - ScreenEffects.register(id, definition) from a vanilla-format post_effect JSON (vanilla's own included) or a ScreenEffectDefinition built in code; any number stack, ordered by priority, drawn over the world (WORLD) or over everything including the HUD and menus (SCREEN). - Smooth fades (fade, Easing), timed pulses (enableFor), animated strength, conditions (activeWhen), strength functions of the frame (strength) and per-frame callbacks (onFrame). - Uniforms by name: set, animated (animateTo) or bound to a function of the frame; autoBlend fades shaders that ignore the effect's strength. - Shaders get Strength, Time, Age and Seed plus noise and luminance helpers from #moj_import <coolcatcanvas:screen_effect.glsl>; persistent targets allow feedback effects; reloaded with resource packs; a failing effect is logged and skipped. - No effects of its own: mods bring their own post_effect JSON and shaders, or use vanilla's (minecraft:invert, ...). - api.effect.ScreenEffectControl drives a player's effects from the server. - Layers (ScreenEffects.layers()): the draw order of every effect, from priorities until rearranged (move up/down, to a layer, to the top or bottom, reset). - An effects screen (ScreenEffects.openScreen(), a key unbound by default, and /coolcatcanvas_client effects in development environments only): every selectable effect with a switch, the active ones as drag-and-drop layers grouped by stage with a strength slider each, a live unblurred preview and a Preview mode hiding the panels. Players' choices (on/off, strengths, order) are saved to config/coolcatcanvas-screen-effects.json. Effects have a displayName, description and selectable flag for it. - Events (ScreenEffectEvents): BEFORE_TOGGLE (cancellable) and TOGGLED with the cause (code, condition, timeout, player, server), STRENGTH_CHANGED, UNIFORM_CHANGED, LAYERS_CHANGED and LOADED. - Custom skyboxes (api.client.sky): layers drawn inside vanilla's sky pass, around the sun, moon and stars. - Skyboxes.register(id, definition) from a SkyboxDefinition built in code or assets/<namespace>/skybox/<path>.json; resource packs add skyboxes with no code by listing dimensions (dimensions without a sky, like the Nether, get one while it shows). - Layer types: cubemap (six faces in a 3x2 image), panorama (equirectangular), sprite (an image placed in the sky, e.g. a planet), gradient, and shader (your own fragment shader, with #moj_import <coolcatcanvas:sky.glsl>); any type can swap in its own fragment shader. - Per layer: blend mode (alpha, additive, multiply, screen), tint, orientation, rotation over real time, game time, the day or vanilla's sun/moon/star angle, flipbook animation with optional interpolation, day-time fade windows, rain fade, horizon/underwater fog, and 4 shader params. - Hides vanilla's sky color, sunrise, sun, moon, stars, void, End sky and End flashes, fading them out as the skybox fades in. - Runtime control: fades, enableFor, conditions (activeWhen), per-frame callbacks, and per layer (Skybox.layer(name)) visibility, animated opacity and tint, and params set, animated or bound to a function of the frame. api.sky.SkyboxControl drives them from the server: enable, disable, toggle, setEnabled, timed pulses and layer changes, for one player or several (to(players), inLevel(level), everyone(server)). - Cheap: nothing runs while no skybox shows; a visible layer is one draw from a shared static mesh, all layers of a stage share one render pass and one uniform upload. - api.utils.Easing: easing curves. - GUI components and widgets (api.client.gui.components: panels, scroll and drag widgets, slide animations, ColorableImageButton), and api.client.utils RenderUtils, NineSliceInfo and ScreenAnchor. - ViewportPanel (pan and zoom) edge fades show where content continues past an edge, and shrink smoothly into their side as the end of the content on that side comes into view. - Animated color gradients (api.utils.ColorGradient): color stops looping around (ColorGradient.of(colors...)) or the full rainbow (RAINBOW, rainbow(saturation, brightness)), scrolling over time (withSpeed) and along the text or outline (withSpread), with each letter colored (perLetter(n)) or the whole text in one cycling color (wholeText(), RAINBOW_WHOLE). Presets: RAINBOW, RAINBOW_WHOLE, PASTEL_RAINBOW, FIRE, OCEAN, AURORA. - Gradient components: gradient.literal("..."), gradient.apply(component) or a style with gradient.textColor() make a component animate wherever it's drawn (chat, tooltips, item names, signs, widget labels). In JSON text and commands (/tellraw) the color is "coolcatcanvas:rainbow", "coolcatcanvas:rainbow_whole", "coolcatcanvas:rainbow/<speed>/<spread>/<saturation>/<brightness>" or "coolcatcanvas:gradient/<speed>/<spread>/#RRGGBB/#RRGGBB..."; players without Canvas can't read it. - Gradient and outlined text (api.client.utils.TextEffects): gradient(text, gradient) and rainbow(text) recolor existing text and stay animated when kept; outlined text in a solid color or a gradient. - Outlines (api.client.utils.Outline): solid or a gradient (Outline.gradient, Outline.rainbow()), with a thickness and padding, drawn around any rectangle; ElementOutlines.set(widget, outline[, when]) attaches one to any widget (vanilla's too), optionally only while a condition holds (hovered, focused...).

2100.1.2.0 — Oct 13, 2026

✨ New Features - Camera shake (api.client.camera.CameraShake): CameraShake.shake(degrees, ticks) for a jolt, shake(origin, radius, degrees, ticks) for one that is strongest at a place and gone at its radius, and add(new Shake(...)) for a curve of the mod's own (a swell, a rumble), given as a Curve (api.client.vfx.Curve). Shakes add up, are capped, and follow the game's "Distortion Effects" accessibility slider; CameraShake.setScale is for a mod's own option. From the server: api.vfx.ShakeControl.shake(level, origin, radius, degrees, ticks) or shake(player, degrees, ticks).

2100.1.1.0 — Oct 4, 2026

✨ New Features - A built-in tint screen effect, with nothing to set up: ScreenEffects.tint(id, argb) makes a color wash under a mod's own id the first time and recolors it after, so ScreenEffects.tint(id, 0x59FF0000).enableFor(5) is a red flash wherever it's called. It's a screen effect like any other (fades, strength, conditions), over the world or, on the SCREEN scope, over the HUD and menus too. From the server, ScreenEffectControl.tint(player, id, argb[, ticks]) does the same for a player, with nothing registered on the client. The definition is coolcatcanvas:tint (ScreenEffects.TINT, color uniform TINT_COLOR).

🔧 Changes - Renamed ScreenEffectStage to ScreenEffectScope, and ScreenEffect.stage() / stage(...) to scope() / scope(...): .scope(ScreenEffectScope.SCREEN) puts an effect over the HUD and menus. Mods calling the old names need updating. The effects screen's screen_effect.coolcatcanvas.screen.stage.* translation keys are now ...screen.scope.*.

2100.1.0.0 — Sep 30, 2026 (Minecraft 1.21.1)

Backport of the 26.1.2 release: the same features, on Forge, NeoForge and Fabric, with the rendering rebuilt on 1.21.1's. ✨ New Features - First release: the render and visuals half of what used to be CoolCatLib, split out and built on CoolCatLib: Core. Everything below was moved from CoolCatLib into the net.ixdarklord.coolcatcanvas package and coolcatcanvas namespace. - Screen effects (api.client.effect): full-screen post-processing shaders whose uniforms can change every frame (vanilla's post chains bake them in at load). - ScreenEffects.register(id, definition) from a vanilla-format post_effect JSON (vanilla's own included) or a ScreenEffectDefinition built in code; any number stack, ordered by priority, drawn over the world (WORLD) or over everything including the HUD and menus (SCREEN). - Smooth fades (fade, Easing), timed pulses (enableFor), animated strength, conditions (activeWhen), strength functions of the frame (strength) and per-frame callbacks (onFrame). - Uniforms by name: set, animated (animateTo) or bound to a function of the frame; autoBlend fades shaders that ignore the effect's strength. - Shaders get Strength, Time, Age and Seed plus noise and luminance helpers from #moj_import <coolcatcanvas:screen_effect.glsl>; persistent targets allow feedback effects; reloaded with resource packs; a failing effect is logged and skipped. - No effects of its own: mods bring their own post effect JSON and shaders, or use vanilla's (minecraft:invert, ...). - api.effect.ScreenEffectControl drives a player's effects from the server. - Layers (ScreenEffects.layers()): the draw order of every effect, from priorities until rearranged (move up/down, to a layer, to the top or bottom, reset). - An effects screen (ScreenEffects.openScreen(), a key unbound by default, and /coolcatcanvas_client effects in development environments only): every selectable effect with a switch, the active ones as drag-and-drop layers grouped by stage with a strength slider each, a live unblurred preview and a Preview mode hiding the panels. Players' choices (on/off, strengths, order) are saved to config/coolcatcanvas-screen-effects.json. Effects have a displayName, description and selectable flag for it. - Events (ScreenEffectEvents): BEFORE_TOGGLE (cancellable) and TOGGLED with the cause (code, condition, timeout, player, server), STRENGTH_CHANGED, UNIFORM_CHANGED, LAYERS_CHANGED and LOADED. - Custom skyboxes (api.client.sky): layers drawn inside vanilla's sky pass, around the sun, moon and stars. - Skyboxes.register(id, definition) from a SkyboxDefinition built in code or assets/<namespace>/skybox/<path>.json; resource packs add skyboxes with no code by listing dimensions (dimensions without a sky, like the Nether, get one while it shows). - Layer types: cubemap (six faces in a 3x2 image), panorama (equirectangular), sprite (an image placed in the sky, e.g. a planet), gradient, and shader (your own fragment shader, with #moj_import <coolcatcanvas:sky.glsl>); any type can swap in its own fragment shader. - Per layer: blend mode (alpha, additive, multiply, screen), tint, orientation, rotation over real time, game time, the day or vanilla's sun/moon/star angle, flipbook animation with optional interpolation, day-time fade windows, rain fade, horizon/underwater fog, and 4 shader params. - Hides vanilla's sky color, sunrise, sun, moon, stars, void, End sky and End flashes, fading them out as the skybox fades in. - Runtime control: fades, enableFor, conditions (activeWhen), per-frame callbacks, and per layer (Skybox.layer(name)) visibility, animated opacity and tint, and params set, animated or bound to a function of the frame. api.sky.SkyboxControl drives them from the server: enable, disable, toggle, setEnabled, timed pulses and layer changes, for one player or several (to(players), inLevel(level), everyone(server)). - Cheap: nothing runs while no skybox shows; a visible layer is one draw from a shared static mesh, all layers of a stage share one render pass and one uniform upload. - api.utils.Easing: easing curves. - GUI components and widgets (api.client.gui.components: panels, scroll and drag widgets, slide animations, ColorableImageButton), and api.client.utils RenderUtils, NineSliceInfo and ScreenAnchor. - ViewportPanel (pan and zoom) edge fades show where content continues past an edge, and shrink smoothly into their side as the end of the content on that side comes into view. - Animated color gradients (api.utils.ColorGradient): color stops looping around (ColorGradient.of(colors...)) or the full rainbow (RAINBOW, rainbow(saturation, brightness)), scrolling over time (withSpeed) and along the text or outline (withSpread), with each letter colored (perLetter(n)) or the whole text in one cycling color (wholeText(), RAINBOW_WHOLE). Presets: RAINBOW, RAINBOW_WHOLE, PASTEL_RAINBOW, FIRE, OCEAN, AURORA. - Gradient components: gradient.literal("..."), gradient.apply(component) or a style with gradient.textColor() make a component animate wherever it's drawn (chat, tooltips, item names, signs, widget labels). In JSON text and commands (/tellraw) the color is "coolcatcanvas:rainbow", "coolcatcanvas:rainbow_whole", "coolcatcanvas:rainbow/<speed>/<spread>/<saturation>/<brightness>" or "coolcatcanvas:gradient/<speed>/<spread>/#RRGGBB/#RRGGBB..."; players without Canvas can't read it. - Gradient and outlined text (api.client.utils.TextEffects): gradient(text, gradient) and rainbow(text) recolor existing text and stay animated when kept; outlined text in a solid color or a gradient. - Outlines (api.client.utils.Outline): solid or a gradient (Outline.gradient, Outline.rainbow()), with a thickness and padding, drawn around any rectangle; ElementOutlines.set(widget, outline[, when]) attaches one to any widget (vanilla's too), optionally only while a condition holds (hovered, focused...).

🔧 Differences from the 26.1.2 release - Screen effect and sky shaders are GLSL 150 with plain uniforms instead of uniform blocks; post_effect definitions and their JSON stay the same, and a vanilla shaders/post chain (e.g. minecraft:creeper) can be registered as an effect too. - End flashes don't exist on 1.21.1, so VanillaSky.END_FLASH does nothing. - GUI panel input methods take 1.21.1's (mouse x, y, button...) parameters, and their extract* hooks are render*.

2001.1.2.0 — Oct 13, 2026

✨ New Features - Camera shake (api.client.camera.CameraShake): CameraShake.shake(degrees, ticks) for a jolt, shake(origin, radius, degrees, ticks) for one that is strongest at a place and gone at its radius, and add(new Shake(...)) for a curve of the mod's own (a swell, a rumble), given as a Curve (api.client.vfx.Curve). Shakes add up, are capped, and follow the game's "Distortion Effects" accessibility slider; CameraShake.setScale is for a mod's own option. From the server: api.vfx.ShakeControl.shake(level, origin, radius, degrees, ticks) or shake(player, degrees, ticks).

2001.1.1.0 — Oct 4, 2026

✨ New Features - A built-in tint screen effect, with nothing to set up: ScreenEffects.tint(id, argb) makes a color wash under a mod's own id the first time and recolors it after, so ScreenEffects.tint(id, 0x59FF0000).enableFor(5) is a red flash wherever it's called. It's a screen effect like any other (fades, strength, conditions), over the world or, on the SCREEN scope, over the HUD and menus too. From the server, ScreenEffectControl.tint(player, id, argb[, ticks]) does the same for a player, with nothing registered on the client. The definition is coolcatcanvas:tint (ScreenEffects.TINT, color uniform TINT_COLOR).

🔧 Changes - Renamed ScreenEffectStage to ScreenEffectScope, and ScreenEffect.stage() / stage(...) to scope() / scope(...): .scope(ScreenEffectScope.SCREEN) puts an effect over the HUD and menus. Mods calling the old names need updating. The effects screen's screen_effect.coolcatcanvas.screen.stage.* translation keys are now ...screen.scope.*.

2001.1.0.0 — Sep 30, 2026 (Minecraft 1.20.1)

✨ New Features - First release: the render and visuals half of what used to be CoolCatLib, split out and built on CoolCatLib: Core. Everything below was moved from CoolCatLib into the net.ixdarklord.coolcatcanvas package and coolcatcanvas namespace. - Screen effects (api.client.effect): full-screen post-processing shaders whose uniforms can change every frame (vanilla's post chains bake them in at load). - ScreenEffects.register(id, definition) from a vanilla-format post_effect JSON (vanilla's own included) or a ScreenEffectDefinition built in code; any number stack, ordered by priority, drawn over the world (WORLD) or over everything including the HUD and menus (SCREEN). - Smooth fades (fade, Easing), timed pulses (enableFor), animated strength, conditions (activeWhen), strength functions of the frame (strength) and per-frame callbacks (onFrame). - Uniforms by name: set, animated (animateTo) or bound to a function of the frame; autoBlend fades shaders that ignore the effect's strength. - Shaders get Strength, Time, Age and Seed plus noise and luminance helpers from #moj_import <coolcatcanvas:screen_effect.glsl>; persistent targets allow feedback effects; reloaded with resource packs; a failing effect is logged and skipped. - No effects of its own: mods bring their own post effect JSON and shaders, or use vanilla's (minecraft:invert, ...). - api.effect.ScreenEffectControl drives a player's effects from the server. - Layers (ScreenEffects.layers()): the draw order of every effect, from priorities until rearranged (move up/down, to a layer, to the top or bottom, reset). - An effects screen (ScreenEffects.openScreen(), a key unbound by default, /coolcatcanvas_client effects): every selectable effect with a switch, the active ones as drag-and-drop layers grouped by stage with a strength slider each, a live unblurred preview and a Preview mode hiding the panels. Players' choices (on/off, strengths, order) are saved to config/coolcatcanvas-screen-effects.json. Effects have a displayName, description and selectable flag for it. - Events (ScreenEffectEvents): BEFORE_TOGGLE (cancellable) and TOGGLED with the cause (code, condition, timeout, player, server), STRENGTH_CHANGED, UNIFORM_CHANGED, LAYERS_CHANGED and LOADED. - Custom skyboxes (api.client.sky): layers drawn inside vanilla's sky pass, around the sun, moon and stars. - Skyboxes.register(id, definition) from a SkyboxDefinition built in code or assets/<namespace>/skybox/<path>.json; resource packs add skyboxes with no code by listing dimensions (dimensions without a sky, like the Nether, get one while it shows). - Layer types: cubemap (six faces in a 3x2 image), panorama (equirectangular), sprite (an image placed in the sky, e.g. a planet), gradient, and shader (your own fragment shader, with #moj_import <coolcatcanvas:sky.glsl>); any type can swap in its own fragment shader. - Per layer: blend mode (alpha, additive, multiply, screen), tint, orientation, rotation over real time, game time, the day or vanilla's sun/moon/star angle, flipbook animation with optional interpolation, day-time fade windows, rain fade, horizon/underwater fog, and 4 shader params. - Hides vanilla's sky color, sunrise, sun, moon, stars, void, End sky and End flashes, fading them out as the skybox fades in. - Runtime control: fades, enableFor, conditions (activeWhen), per-frame callbacks, and per layer (Skybox.layer(name)) visibility, animated opacity and tint, and params set, animated or bound to a function of the frame. api.sky.SkyboxControl drives them from the server: enable, disable, toggle, setEnabled, timed pulses and layer changes, for one player or several (to(players), inLevel(level), everyone(server)). - Cheap: nothing runs while no skybox shows; a visible layer is one draw from a shared static mesh, all layers of a stage share one render pass and one uniform upload. - api.utils.Easing: easing curves. - GUI components and widgets (api.client.gui.components: panels, scroll and drag widgets, slide animations, ColorableImageButton), and api.client.utils RenderUtils, NineSliceInfo and ScreenAnchor. - ViewportPanel (pan and zoom) edge fades show where content continues past an edge, and shrink smoothly into their side as the end of the content on that side comes into view. - Animated color gradients (api.utils.ColorGradient): color stops looping around (ColorGradient.of(colors...)) or the full rainbow (RAINBOW, rainbow(saturation, brightness)), scrolling over time (withSpeed) and along the text or outline (withSpread), with each letter colored (perLetter(n)) or the whole text in one cycling color (wholeText(), RAINBOW_WHOLE). Presets: RAINBOW, RAINBOW_WHOLE, PASTEL_RAINBOW, FIRE, OCEAN, AURORA. - Gradient components: gradient.literal("..."), gradient.apply(component) or a style with gradient.textColor() make a component animate wherever it's drawn (chat, tooltips, item names, signs, widget labels). In JSON text and commands (/tellraw) the color is "coolcatcanvas:rainbow", "coolcatcanvas:rainbow_whole", "coolcatcanvas:rainbow/<speed>/<spread>/<saturation>/<brightness>" or "coolcatcanvas:gradient/<speed>/<spread>/#RRGGBB/#RRGGBB..."; players without Canvas can't read it. - Gradient and outlined text (api.client.utils.TextEffects): gradient(text, gradient) and rainbow(text) recolor existing text and stay animated when kept; outlined text in a solid color or a gradient. - Outlines (api.client.utils.Outline): solid or a gradient (Outline.gradient, Outline.rainbow()), with a thickness and padding, drawn around any rectangle; ElementOutlines.set(widget, outline[, when]) attaches one to any widget (vanilla's too), optionally only while a condition holds (hovered, focused...).

🔁 Differences from the 26.1.2 version (Minecraft 1.20.1) - Built for Forge 47 and Fabric on Java 17. Screen effects and skyboxes run on 1.20.1's OpenGL rendering with Canvas's own shader programs (GLSL 150, no uniform blocks, #moj_import supported), hooked into GameRenderer.render and LevelRenderer.renderSky on both loaders. - Screen effects use 1.20.1's post chain format: definitions are assets/<ns>/shaders/post/<path>.json (vanilla's own included, e.g. minecraft:invert) with programs in shaders/program/. ScreenEffectDefinition is (targets, passes); a Pass has program, input, output, auxTargets, uniforms and bilinear (JSON name, intarget, outtarget, auxtargets, uniforms, bilinear); uniform types come from the program JSON (UniformSpec(name, values)); the main input sampler is DiffuseSampler. simple(program, uniforms...), PassBuilder.input(sampler, target) takes the full sampler name, and PassBuilder.bilinear/uniform are new; every target persists between frames. BLIT_PROGRAM and BUILTIN_UNIFORMS replace the 26.1.2 shader-stage constants. - Skyboxes: SkyBlend exposes sourceColor()/destColor()/sourceAlpha()/destAlpha()/apply(). 1.20.1 has no End flashes (VanillaSky.END_FLASH does nothing) and its moon and stars follow the sun, so the moon and star clocks do too. In dimensions with a sky renderer of their own (Forge DimensionSpecialEffects.renderSky, Fabric API DimensionRenderingRegistry), the layers are drawn over that sky, in the sky's fog; what a skybox hides only applies to vanilla's sky, so nothing of that sky is hidden. With an Iris/Oculus shader pack active, skyboxes step aside. - GUI widgets: render methods named extract... on 26.1.2 are render... (Panel.renderContents, ScrollPanel.renderScrolled/renderFrame, ViewportPanel.renderWorld/renderViewBackground/renderViewForeground); input uses 1.20.1's signatures (ViewportPanel.worldClicked(x, y, int button)); widgets take Canvas's own WidgetSprites (texture paths, stretched or nine-sliced); AbstractScrollableWidget scrolls sideways with Shift + wheel. RenderUtils adds containsPoint, nextStratum, withTint and blitSprite.