This document specifies the requirements for a master engineering, stability, performance, UI, and content overhaul of Blue Client — a custom Minecraft client developed for the Blue Network ecosystem.
Blue Client is intended to be a polished custom client that feels like a single cohesive product, not a random collection of modules. The overhaul must make Blue Client substantially more stable, performant, polished, customizable, and complete while keeping the implementation maintainable.
This is not a request to blindly add features. It is a deliberate sequence: inspect the existing client and evidence, diagnose real problems and their causes, design a master engineering plan and detailed implementation specification, review that specification for unnecessary work, then execute, test, fix, and package.
The requirements below preserve every explicit capability, constraint, control rule, workflow, phase, and delivery item from the source material.
Blue Client is a Fabric-based Minecraft client built for the Blue Network. It provides PvP functionality, performance improvements, a module system, HUD functionality, custom interfaces, cosmetics, emotes, Blue Network integration, customization, and quality-of-life features.
Project Identity
| Attribute | Value |
|---|---|
| Name | Blue Client |
| Ecosystem | Blue Network |
| Primary Minecraft Version | Minecraft 1.21.11 |
| Mod Loader | Fabric |
Blue Network Resources
| Resource | Value |
|---|---|
| Discord | https://discord.gg/DmEPAb3NFU |
| X | https://x.com/bluewuztaken |
| Logo | https://i.postimg.cc/BnJqF9X0/Blue-Network-Logo-New.png |
| Minecraft Server | play.sennahosting.com |
External resources must not be unnecessarily embedded into the client, unnecessary network requests must not be made, and secrets must not be hardcoded.
Known Current Issue (highest priority): The attached logs contain a serious Blue Client problem. The log shows blueclient.mixins.json:BlockEntityRenderManagerMixin failing to apply because the injection descriptor does not match the target method. The log reports an expected parameter type different from the injected Object parameter, resulting in an InvalidInjectionException. This must be fixed first, and no new features may be built on top of a known broken initialization path.
Attached material is evidence. Attached material represents the current state of Blue Client and/or its runtime environment. It must be treated as evidence. Not every warning is necessarily caused by Blue Client; the SRD requires distinguishing between (a) Blue Client problems and (b) problems caused by other mods, resource packs, Fabric, the environment, or unrelated software.
Delivery shape: An engineering overhaul producing a compiled Blue Client JAR, source, conditional backend and database schema, assets, documentation, progress notes, version folders, and a final ZIP.
Deliverable type (authoritative): The primary deliverable is a JAR file — a compiled Fabric Minecraft client mod for the Blue Network, not a website. All design, user flows, and functionality must target the Java/Fabric client and remain compatible with the Java Runtime Environment (JRE). Website-specific technologies such as HTML, CSS, and JavaScript are not the product output and must not be produced as the deliverable, except where the JAR itself legitimately embeds web technologies. All project artifacts, workflows, and documentation must recognize and refer to the JAR deliverable, avoiding misalignment with website or web-service outputs.
BlockEntityRenderManagerMixin InvalidInjectionException fixed first, so that the known broken initialization path is repaired before anything is built on top of it.play.sennahosting.com, so that rewards are legitimate.README.md created, so that the project is documented.NEXT_AGENT.md created, so that I can understand the project without repeating the entire investigation.PROGRESS.md maintained, so that development progress is recorded.README.md, NEXT_AGENT.md, and PROGRESS.md at the top level, so that documentation is discoverable.1.21.11/ directory containing source/, backend/, build/, README.md, and NEXT_AGENT.md, so that the primary version is self-contained.versions/ directory with per-version folders (e.g., 1.21.1/, 1.21.2/, … 26.2/), so that additional versions are organized.documentation/ directory, so that documentation is centralized.Blue Client Player — A Minecraft player on the Blue Network using Blue Client. They launch the client via Fabric, toggle modules, configure settings, open the Right Shift/ClickGUI, use the pause menu, equip and preview emotes, browse the cosmetic shop, and earn/spend Blue Stars through playtime. Their visible surface is the client HUD, ClickGUI, pause menu, settings interface, emote collection, and shop.
Lead Engineer — Owns the entire client overhaul: inspects the attached project/source/files and logs as evidence, diagnoses real defects and root causes, produces the BLUE CLIENT MASTER ENGINEERING PLAN and a detailed implementation specification, reviews the plan for unnecessary work and credit usage, then executes stability fixes, performance work, UI/UX overhaul, module/settings overhaul, emote framework and content, Blue Stars, cosmetic shop, conditional backend integration, testing, and packaging/documentation. Success is a compiled, launchable, stable, performant, polished Blue Client delivered as a JAR, source, assets, documentation, progress notes, version folders, and a final ZIP.
Next Agent — The engineer who continues the project after handoff. They rely on README.md, NEXT_AGENT.md, PROGRESS.md, and the centralized documentation of architecture, modules, settings, UI, rendering, mixins, networking, backend, database, Blue Stars, emotes, shop, version differences, build instructions, testing, known limitations, and unfinished work so they can resume without repeating the entire investigation.
No completed page designs yet.
Completed design pages will appear here when they are ready to preview.
No completed page designs yet.
Completed design pages will appear here when they are ready to preview.
No comments yet. Be the first!