JeanAddons

A lightweight, personal-use client-side Fabric mod for Minecraft 26.1.2: rendering tweaks, chat-screen conveniences, and Hypixel Skyblock QoL.

Core contract — client-side only. Every feature is a purely client-side change: cosmetic rendering tweaks, conveniences inside the chat screen, and Skyblock conveniences that reproduce vanilla-client behavior. The mod is still strictly client-side ("environment": "client", never loads on a dedicated server) and produces outbound traffic in exactly two deliberate, Hypixel-allowed places: (a) it sends user-configured chat commands through the vanilla sendCommand path, always under a game-tick cooldown, and (b) it rewrites the user's real click on the currently open screen into the 1.8.9-equivalent middle-click form before vanilla builds the packet. Outside those two patterns the mod never alters any packet the client sends, nor any input, movement, or gameplay behavior.

Features

Known limitation (remove-text-shadow): mods that render text with their own font engine (for example NanoVG-based HUDs, like Odin's custom HUD) bypass Font entirely and cannot be affected. Everything using the vanilla font pipeline is covered.

Notes (chat features): copy-chat-line copies the whole logical message under the cursor, not just the wrapped line, strips legacy § color codes, and consumes the click. chat-history-size widens both vanilla caps (stored messages and display lines) to the same number, which is what lets scrolling reach the extra history; values beyond the newest 10000 are clamped.

Notes (cape features): the cape tweaks are ported from Animatium (its cape-movement options) and stay purely client-side render changes. Both movement options act inside AvatarRenderer#extractCapeState and are independent knobs that compose: optifine-cape-flow removes only the 150-degree bound on the cape lean, while old-cape-movement switches the body-yaw interpolation to a plain lerp, keeps the cape lean unscaled while elytra-flying, and unclamps the side lean, like 1.12.x and earlier. force-cape swaps the local player's cape texture asset for the single bundled one inside CapeLayer#submit and restores it before the method returns, so the skin object is never permanently modified — in particular the mod never claims you own a cape anywhere outside your own view of your own player. The bundled texture is the original 64x32 MineCon 2016 cape export from reference/cape/, used as-is: the vanilla cape model declares a 64x64 layer with texScaleV 0.5, which makes its effective UV space 64x32 — exactly the classic (1.8.9-era) cape format, so the file needs no re-layout.

Notes (Skyblock features): the keybind, refill, and middle-click features are ported from NoFrills. What makes them safe on Hypixel is that they only reproduce vanilla-client behavior, never invent it: keybind commands go through the vanilla sendCommand path — the same thing typing the command does; the middle clicks produce exactly the CLONE (button 2) container packet a 1.8.9 client sent unconditionally; and the override only rewrites the user's own real click on the currently open screen, so containerId, stateId, carried item, and changed slots all come from vanilla's own slotClicked → handleContainerInput chain — byte-identical to a 1.8.9 player pressing middle click. There is no auto-clicking anywhere in the mod; nothing ever touches a UI the server has replaced (Skyblock covers old container UIs with new ones instead of closing them — interacting with a stale one is what gets accounts banned), no menu/screen reference outlives an UI change, and no ServerboundContainerClickPacket is ever constructed by hand. All automated command sends are rate-limited in game ticks to match the server's per-tick processing: one shared configurable cooldown for keybind sends (command-cooldown-ticks, default 60 = 3 s) and a hard-coded 60-tick cooldown on the /gfs refill send — a keybind running /jeanaddons refill passes through both, each guarding its own packets. The command itself is /jeanaddons refill <item> [amount] (alias /ja), topping an item up from your sacks via /gfs (default amount 64), matching items by Skyblock id or plain item name with underscores read as spaces.

Directory layout

Building and running

./gradlew build       # jar lands in bin/jeanaddons-<version>.jar
./gradlew runClient   # launches a dev client

Mixin debugging escape hatch when something refuses to apply: add -Dmixin.debug.export=true to the client run config's VM args to dump the transformed classes.

Configuration

There is no config GUI. The entire configuration is one hand-edited, self-documenting text file:

• On first launch the mod generates <game directory>/config/jeanaddons.conf from the bundled template (assets/jeanaddons/default.conf inside the jar) and logs one line saying so.
• Format: [Section] headers group features by category (the section name is the category display name, e.g. [Visual]); each feature toggle is one key = value line with a stable kebab-case key; # starts a comment; blank lines are ignored; whitespace around keys and values is trimmed.
• The file is read once at startup. There is no hot reload and the mod never rewrites the file — restart the game to apply edits. Deleting the file restores defaults on the next launch.
• Unknown sections or keys log a warning and are ignored; missing keys fall back to the feature's built-in default; numeric values outside a feature's documented range log a warning and are clamped; a corrupt or unreadable file logs an error and all defaults are used — the game never crashes over the config.

Adding a new feature

Three steps:

1. Create one new class under src/main/kotlin/dev/chatfatigue/feature/impl/<category>/ extending Feature (a toggle) or IntOption (a numeric setting); pick a stable, unique kebab-case id.
2. Add one line to the features or intOptions list in FeatureManager (plus, if the mixin side needs it, one @JvmStatic accessor in FeatureAccess).
3. Add one commented block for the feature to src/main/resources/assets/jeanaddons/default.conf (under the right [Section], with its valid values documented).

The command keybinds are the one structured entry: each bind is four flat bind-N-* lines in [Skyblock], parsed by KeybindRegistry — still the same two steps of a commented block in default.conf plus one registry, just a registry of binds instead of features.

Toolchain

Mixin compatibility note: Fabric Loader 0.19.4 updated the bundled sponge-mixin (0.17.3 → 0.17.4) and reworked how per-mod mixin compatibility is selected: the loader derives a fabric-compat level from the loader version each mod declares in its own fabric.mod.json. Mods built against older loaders get routed onto legacy paths. Since 0.1.1 this mod declares fabricloader >= 0.19.5 (new behavior) and its mixin config declares JAVA_25, matching the actual class files (JVM target 25).

Historical note: before 0.1.1 the build pinned Loom 1.16-SNAPSHOT because the then-current Gradle 9.4.1 wrapper rejected Loom 1.17.x (built against Gradle plugin API 9.5.0). The wrapper was upgraded to 9.7.1, which resolves the deviation and allows following the Loom 1.17-SNAPSHOT line again. The mod was known as ChatAddons until 0.2.0.

License

MIT — see LICENSE.