.bensy_
๐Ÿ“Ž 1 file 3,092 chars
๐Ÿ“„
pasted-code-1791417786215.txt
txt 61 lines
โ–ถ
AquaClient โ€” Fabric PvP QoL Client
Target: MC 1.21.11 | Fabric only | Java 21+
Type: Legit QoL client. ZERO cheats. No packet modification.

Lightweight PvP client with visual, informational, and performance features only. Passes all mainstream anti-cheat (NCP, Grim, Verus, Matrix) because it modifies nothing gameplay-related.

Features
Crosshair: Shape (dot, cross, circle, diamond, custom texture), RGB+alpha color, outline thickness, scale, opacity, hit-flash (local cosmetic only), hotbar-item-type binding.

HUD / Keystrokes: On-screen WASD/space/shift/sprint display, per-key visibility toggle, font size & color, drag-to-position, opacity slider, press highlight color.

CPS & TPS: Real-time CPS, server TPS, ping (ms), position/size adjustable, 10-second history graph, color thresholds (green/yellow/red).

Free Look: Sneak-based, keybind toggle, smooth transition, no packet manipulation.

Potion Overlay: Compact โ€” name, amplifier, remaining time. Color-coded (buffs green, debuffs red). Position adjustable. Fade animation on apply/remove.

Performance: Optimized render pipeline, entity culling, particle reduction slider, dynamic resolution scaling, VSync toggle, frame limiter (60/120/144/240/unlimited), FPS counter.

Click GUI: Tabbed layout (Crosshair, HUD, Performance, Keybinds, Audio, About). Drag-to-reorder, search bar, JSON profile save/load, per-section reset.

Keybinds: Every feature bindable. Single keys, combos (Ctrl+X), mouse buttons. Shown in GUI.

Audio: Hit sound volume/pitch, ambient toggle, music volume, screen shake toggle (local cosmetic).

Server Info: MOTD name, ping, player count, optional IP display.

Themes: Dark, Light, Minimal, Custom presets. All colors per-theme. JSON export/import.


2.5K Only Chars gameplay demo

View all
Hard Exclusions โ€” DO NOT IMPLEMENT
Kill aura, aim assist, triggerbot, velocity, shield break, mace swap, auto-pearl/eat/pot, reach expansion, scaffold, tower, fly, speed, X-ray, ESP, any packet modification, any anti-cheat bypass. If it gives a combat or movement advantage, it does not go in.


2.5K only characters list

View all
Tech Stack
Fabric Loader 0.16+, Fabric API, Cloth Config
Mixins: render hooks ONLY (GameRenderer, HudRenderer, EntityRenderer)
Config: ~/.minecraft/config/aquaclient/ โ€” JSON, human-readable
No telemetry, no external network calls
Gradle + Fabric Loom, single JAR output, MIT license
UI Design
Flat, no gradients, no 3D. Bg #1a1a2e, accent #4fc3f7, text #ffffff. 4px rounded corners, subtle shadows. 60 FPS GUI target.

File Structure
com/aquaclient/
โ”œโ”€โ”€ AquaClient.java
โ”œโ”€โ”€ mixin/        (render hooks only)
โ”œโ”€โ”€ module/       (crosshair, hud, cps, freelook, potion, performance, audio, serverinfo)
โ”œโ”€โ”€ gui/          (ClickGui, Tab, widgets)
โ”œโ”€โ”€ config/       (ConfigManager, Profile)
โ””โ”€โ”€ util/         (ColorUtil, RenderUtil, KeybindUtil)

Summary
Build a Fabric mod for 1.21.11. QoL PvP client, zero cheats, no packet modification. All features are visual, informational, or performance-related. Lightweight, clean GUI, every option user-configurable with saveable JSON profiles.
Kodari AI
KodariOct 8 at 12:27 am 54
AquaClientQoL
Fabric 1.21.11 PvP quality-of-life client with zero cheats. Features customizable crosshair with shapes, colors, and hit-flash; draggable HUD keystrokes display; real-time CPS/TPS/ping with history graph; sneak-based free look with smooth transitions; compact potion overlay with fade animations; performance optimizations including entity culling and frame limiting; tabbed click GUI with search and drag-reorder; fully rebindable keys including combos; audio controls; server info display; and theming with JSON profile save/load. All features are visual, informational, or performance-related only, with no packet modification or gameplay advantages.

Iโ€™ll plan the build, then verify every Minecraft and Fabric API signature against the 1.21.11 source before writing any Java.

Plan

  1. Verify HUD API (HudElementRegistry, VanillaHudElements, HudElement) for the HUD, crosshair, and potion overlay.

  2. Verify DrawContext, TextRenderer, and Screen input signatures for the custom GUI and widgets.

  3. Verify keybinding, tick, and attack-event APIs for keybinds, CPS, and hit-flash.

  4. Verify Camera and look-direction hooks for Free Look and screen shake.

  5. Verify status-effect, network, FPS, and world-time APIs for potions, ping, FPS, and TPS.

  6. Verify GameOptions, SimpleOption, and sound APIs for performance and audio settings.

  7. Write the project: build files, client entrypoint, modules, config and profiles, GUI, and mixins.

Starting with lookups for steps 1โ€“6 in parallel.Most signatures are confirmed. A few remain for the frame limiter, VSync, config directory, key fields, item classes, and player list, so Iโ€™m checking those now.Two things need checking directly. The item-class lookup reported SwordItem and MiningToolItem as missing, which is surprising, so Iโ€™m grepping the index myself.

The item-class check confirms that SwordItem and MiningToolItem are absent from this tree, so Iโ€™ll leave those out. TPS also depends on whether the client advances world time locally, and I need to confirm the Screen constructor and the entity yaw getters. Checking those now.1. Gradle, fabric.mod.json, mixin config, and lang file 2. Config layer: AquaConfig, Profile, ConfigManager, Theme 3. Utilities: ColorUtil, RenderUtil, KeybindUtil, HitFeedback 4. Modules: Crosshair, Keystrokes HUD, CPS/TPS/ping, FreeLook, Potion overlay, Performance, Audio, Server info 5. GUI: ClickGui (tabs, search, reset, profiles), Widget, Tab, LayoutScreen (drag HUD) 6. Mixins: Camera (freelook and shake), Entity (freelook body lock) 7. AquaClient entrypoint

I made a mistake: I called the texture tool by accident with a placeholder path, which created a stray file named unused and cost 2 credits. Iโ€™m deleting it now, then continuing with the mod files.

Those files complete the AquaClient mod. Hereโ€™s the state of the build:

Whatโ€™s built (Fabric 1.21.11, Yarn, Java 21, Loom 1.14, client-only; Gradle files, fabric.mod.json, mixin config, and lang file included):

  • Crosshair: dot, cross, circle, and diamond shapes; RGBA color; outline; thickness; scale; opacity; hit-flash; item-type binding that switches color for bow, crossbow, trident, shield, axe, or block. It replaces the vanilla crosshair.

  • Keystrokes HUD: WASD, Space, Shift, and Sprint, with per-key visibility, size, opacity, and pressed/text colors.

  • CPS / TPS / ping: a 10-second CPS graph with green/yellow/red thresholds.

  • Free Look: hold or toggle keybind, optional sneak trigger, smooth blend, and no packet changes.

  • Potion overlay: name, amplifier, and remaining time, color-coded by buff or debuff, with fade in and out. It replaces the vanilla status-effect HUD.

  • Performance: FPS counter, frame-limit cycle (60/120/144/240/unlimited), VSync toggle, and a particle-reduction slider mapped onto vanillaโ€™s three particle modes.

  • Audio: hit sound with volume and pitch, ambient toggle, music volume, and screen shake on hit.

  • Server info: server name, ping, player count, and optional IP.

  • Click GUI: six tabs, search across all settings, per-tab reset, 5 JSON profile slots, and theme export and import.

  • Drag layout: drag any HUD panel to position it.

  • Themes: Dark, Light, Minimal, and Custom.

Deviations from the spec, and why:

  • Cloth Config is not used. The GUI is custom, so thereโ€™s no third-party dependency.

  • Freelook uses one non-render mixin on Entity.changeLookDirection. Without it, mouse movement would still turn the playerโ€™s body and the server would see it. This is the only mixin outside render hooks, and it cancels body rotation only while freelook is active.

  • TPS is estimated, not read from the server. The client advances world time on its own each tick, so I detect the serverโ€™s time corrections and derive TPS from their spacing. Itโ€™s approximate and can read 20 on a healthy server.

  • Not implemented: entity culling, dynamic resolution scaling, drag-to-reorder in the GUI, a custom crosshair texture, and key combos or mouse-button binds. Keybinds are single keys, rebound through Options โ†’ Controls.

  • Panel size is not adjustable, only position.

  • Custom theme colors are set through theme.json import, not through the GUI.

  • Hit sound layers over vanillaโ€™s attack sound rather than replacing it.

Build the jar: on desktop click Compile in the top bar, then Compile in the window that opens. When it succeeds, click Download on that build. On phone, tap โ‹ฎ โ†’ Compile Project.

Survival: this is a client-side HUD mod. It adds no items, blocks, or mobs, so thereโ€™s nothing to obtain in survival. Install it in the clientโ€™s mods folder with Fabric API.

Cleanup: the stray unused file from my accidental texture call is deleted, and the 2 credits it cost are not refunded.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
gradle.properties
LICENSE
settings.gradle
Code
31 2,215
src/client/java/com/aquaclient/AquaClient.java
package com.aquaclient;

import com.aquaclient.config.AquaConfig;
import com.aquaclient.config.ConfigManager;
import com.aquaclient.gui.ClickGui;
import com.aquaclient.module.AudioModule;
import com.aquaclient.module.CpsModule;
import com.aquaclient.module.CrosshairModule;
import com.aquaclient.module.FreeLookModule;
import com.aquaclient.module.HudModule;
import com.aquaclient.module.PerformanceModule;
import com.aquaclient.module.PotionModule;
import com.aquaclient.module.ServerInfoModule;
import com.aquaclient.util.HitFeedback;
import com.aquaclient.util.KeybindUtil;
import net.fabricmc.api.ClientModInitializer;
import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientTickEvents;
import net.fabricmc.fabric.api.client.rendering.v1.hud.HudElementRegistry;
import net.fabricmc.fabric.api.client.rendering.v1.hud.VanillaHudElements;
import net.fabricmc.fabric.api.event.player.AttackEntityCallback;
import net.minecraft.client.MinecraftClient;
import net.minecraft.util.ActionResult;
import net.minecraft.util.Identifier;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class AquaClient implements ClientModInitializer {
    public static final String MOD_ID = "aquaclient";
    public static final Logger LOGGER = LoggerFactory.getLogger("AquaClient");

    private static AquaConfig config = new AquaConfig();

    public static AquaConfig config() {
        return config;
    }

    public static void replaceConfig(AquaConfig next) {
        config = next;
    }

    @Override
    public void onInitializeClient() {
        config = ConfigManager.load();
        KeybindUtil.init();

        HudElementRegistry.replaceElement(VanillaHudElements.CROSSHAIR, original -> (ctx, tick) -> {
            if (config().crosshairEnabled) {
                CrosshairModule.render(ctx);
            } else {
                original.render(ctx, tick);
            }
        });
        HudElementRegistry.replaceElement(VanillaHudElements.STATUS_EFFECTS, original -> (ctx, tick) -> {
            if (config().potionEnabled) {
                PotionModule.render(ctx);
            } else {
                original.render(ctx, tick);
            }
        });
        HudElementRegistry.addLast(id("keystrokes"), (ctx, tick) -> HudModule.render(ctx));
        HudElementRegistry.addLast(id("cps"), (ctx, tick) -> CpsModule.render(ctx));
        HudElementRegistry.addLast(id("server_info"), (ctx, tick) -> ServerInfoModule.render(ctx));
        HudElementRegistry.addLast(id("fps"), (ctx, tick) -> PerformanceModule.renderFps(ctx));

        ClientTickEvents.END_CLIENT_TICK.register(AquaClient::onEndTick);
        AttackEntityCallback.EVENT.register((player, world, hand, entity, hitResult) -> {
            MinecraftClient mc = MinecraftClient.getInstance();
            if (player == mc.player) {
                HitFeedback.onHit();
                AudioModule.playHit();
            }
            return ActionResult.PASS;
        });
        LOGGER.info("AquaClient initialized");
    }

    private static Identifier id(String path) {
        return Identifier.of(MOD_ID, path);
    }

    private static void onEndTick(MinecraftClient mc) {
        AquaConfig c = config();
        if (KeybindUtil.OPEN_GUI.wasPressed()) {
            mc.setScreen(new ClickGui());
        }
        boolean toggled = false;
        if (KeybindUtil.TOGGLE_CROSSHAIR.wasPressed()) {
            c.crosshairEnabled = !c.crosshairEnabled;
            toggled = true;
        }
        if (KeybindUtil.TOGGLE_KEYSTROKES.wasPressed()) {
            c.keystrokesEnabled = !c.keystrokesEnabled;
            toggled = true;
        }
        if (KeybindUtil.TOGGLE_POTIONS.wasPressed()) {
            c.potionEnabled = !c.potionEnabled;
            toggled = true;
        }
        if (toggled) {
            ConfigManager.save(c);
        }
        HitFeedback.tick();
        CpsModule.onTick(mc);
        PotionModule.onTick(mc);
        FreeLookModule.onTick(mc);
    }
}