Mod Overview - Title/Theme: Xianxia/Murim cultivation expansion for Minecraft. Primary target: Fabric 1.21.5 (Forge optional). Full PT-BR localization mandatory for all in-game text, item/block short descriptions, lore lines. Legendary swords require a top-line legendary short lore. - Core Systems: Qi resource + HUD; 9 progressive Realms (PT-BR labels); Tribulação Celestial (7-wave ritual; Pedestal Celestial removed v203); Visual Technique System with 5-phase Technique Visual Framework; Skill Tree (J); Cultivator modal (K); Technique system (6 loadable slots; Alt/Ctrl hotkeys); Dimensional Rings; Relics with dedicated left-of-inventory GUI dot; per-world persistence & migration; server-authoritative validation; modular architecture; MUST implement exactly one animation path (GeckoLib OR native renderer/shader) — do NOT mix; animation/render path choice must be documented. - Controls & Keybinds (MANDATORY): K = Cultivator modal; J = Skill Tree GUI; M = equip/skills menu; C = hold to meditate / sit pose; Right-click = normal technique; Sneak+Right-click = advanced technique; Alt+1–6 select slot; Ctrl+1–6 activate slot (configurable); Shift+Right-click = batch transfer of rings; Relics GUI opened by small clickable dot left of head armor slot; ESC closes GUIs; no fullscreen blur in GUIs; J/K must render without blur/dimming. - Absolute Constraints / Architecture & Assets (MANDATORY): - Remove all mob-type entities/assets (v47 enforced). NPCs allowed only if not classified as mobs (conflicts v216/v218/v222/v223 must be reconciled). - Choose exactly one animation path: GeckoLib path (v54) OR native renderer/shader path (v60). Do NOT mix. - Modular architecture with interfaces/abstract classes isolating Qi/relics/skills/entities (v43). - Preserve resource IDs/namespaces/texture paths during refactors (v102/v204). - Render hygiene: VertexFormat must include POSITION, COLOR, UV, NORMAL; use RenderType.getEntityTranslucent(texture); custom particles require UVs; particle pooling & LOD mandatory. - Optional shader hooks allowed (GLSL/Iris/Sodium). - Asset standards: pixel-art 4K preserving large-pixel aesthetic; sword textures min 64x (128 preferred v62+), oriented right with pivot/meta "Tipo de Empunhadura"; each entity unique ResourceLocation & flattened skins (v41). - Relics GUI MUST be a dedicated left-of-inventory panel opened by the small dot and NOT conflict with Cultivator menus (v33/v38/v39). - PT-BR required for all text; user-supplied textures must replace specified textures without renaming (v205/v211/v214). Items / Blocks / Assets Baseline (PT-BR names required) - Required items: Espada Zhuqin (lendária) + Zhuqin Refinada upgrade; Redmoon Hua Sword (vampiric lifesteal, animated aura); ≥2 additional swords; hammer-pickaxe marreta; Sopa de Lótus Espiritual; Pedra Espiritual; Madeira de Cascal refinada; Bloco de Qi; 2 simple blocks; Poção de Recuperação de Qi; Talismãs/Amuletos; weapon upgrade recipes; all with PT-BR names/descriptions/metadata (Tipo de Empunhadura). - Pedestal Celestial historically required but REMOVED (v203). - Texture replacement history: v205 Zhuqin texture replaced with user file; v211 relic spirit sword texture replacement; v214 new spiritual outfit using uploaded full-body cultivator robe armor layer_1 texture (use uploaded texture directly, no rename); v217 MontHua manual rename/description changes. Technical Systems / Behaviors (baseline) - Qi: numeric value + HUD bar; default ≈0.2 Qi/tick (configurable per-world); colored aura/particles; gain via attacks/kills/consumables/rituals; server-authoritative validation (v10/v80). - Realms: nine progressive Realms PT-BR; advancement via 7-wave Tribulação Celestial; Meditation Lock during Tribulation (v9/v12); Pedestal removed v203. - Skill Tree (J): awards points on realm-up; categories Universal/Elemental/Combate/Legado/Stats; must render without blur/dimming (v162); supports pan/zoom, scissor clipping; definitions via JSON (v118/v130/v140). - Cultivator Modal (K): layout parity with J; no fullscreen blur; ESC closes; K contains Técnicas and Aura tabs; M opens equipment; responsive/resizable (v70/v174/v197). - Techniques: 6 loadable slots; drag/drop saved in NBT; Alt 1–6 select; Ctrl 1–6 activate; tap/hold charge; charge HUD; client intents C2S; server validates costs/cooldowns/state; visual 5-phase structure (Charge/Gather, Windup/Thrust, Execute/Travel, Impact, Dissipate/Fade) (v32/v70/v196). - Dimensional Rings: Anel Terrestre/Celestial/Imortal storage, bind-on-first-use; Shift+RClick batch transfer; commands /anel abrir, /anel invocar, /anel listar; GUI like creative with search/categories (v23/v31). - Relics System: dedicated left-of-inventory Relics GUI; drag/drop equip; previews animated per chosen animation path (v33/v38/v55). - Meditation: HOLD C to sit & absorb Qi; final behavior: hold C with technique equipped sits and absorbs Qi; release on move/damage/Shift; implementation evolution from seat entity → pose mixin → entity-based; v225 replaces with minimal pose-based system (no mount/mixin). - Health & Hunger UI: continuous health bar replacing hearts (v135 override); custom hunger overlay orange gradient visual-only (v188/v190). Workflow & Release Checklist / Blockers - Priorities: 1) UI/UX fundamentals (K/J/C, Relic GUI dot left-side, no blur, ESC closes, readable fonts) → 2) Core systems (Qi, Realms, Tribulation, per-world persistence v183) → 3) Visual Skills & Skill Tree J, 6 slots, charge/HUD → 4) Assets/content → 5) Rings & Relics → 6) Remove mob-code (v47) → 7) Implement exactly one animation path (v54 OR v60) → 8) Polish UI, modular code, PT-BR, tests → 9) Final verification. - Release blockers: removal of mobs (v47), exactly one animation path implemented, per-world persistence (v183), fix critical crashes (v154/v161/v190/v212), atomic Skill Tree unlock (v174), Relic GUI left-side, PT-BR localization, render hygiene (VertexFormat/render) (v49/v69/v167). Mandatory Deliverables (authoritative) - Include v152 verbatim Shadow & Lightning skill entries. - Implement MontHua manual initially (v189) with required Mixin snippet verbatim; after v217 rename to Técnica da Espada Fluorescente with Mont Hua origin & pink aura while preserving Mixin snippet. - Implement hunger overlay per v190 visual-only. - Per-world persistence & migrate legacy global data (v183). - Remove ALL mob-related content (v47) or document exception if v216/v218/v222/v223 accepted. - Choose exactly one animation path; implement and test. - Fix critical crashes/mixin issues (v154/v161/v190/v212). - Validate render hygiene. - Full PT-BR localization. - Skill Tree J and Cultivator K standardized and atomic unlocks. - Implement Technique Visual Framework (v196) 5-phase with provided verbatim snippets. - Implement skill pipeline (v204): JSON loader data/xianxia/skills/, SkillRegistry at startup, SkillDefinition (immutable), SkillBehavior, SkillRuntimeContext, GUI & persistence integration, state machine for 5 phases, server-side activation validation & cost formula costFinal = baseCost * (1 + realmTier / 10), VFXRegistry pooling & LOD, manuals register techniques, HUD hotkey integration, diagnostic logs. Data & Format Rules (v149 constraints) - Skills output MUST be data-only JSON-like objects grouped by Manuals: Fire, Shadow, Lightning, Water, Wind, Universal. - Strict skill object field order: Name, Aspect, Rarity, Type, Stages [{name,durationSeconds,shortDescription}], CooldownSeconds, EnergyCost, ActivationRangeBlocks, EffectRadiusBlocks, Damage {Base,Scaling}, StatusEffectsApplied[], Knockback {Enabled,Strength}, Visuals (vanilla-only particles), Sound (vanilla keys), ActivationAnimation, LineOfSightRequired, UsableWhileMoving, MultiplayerSyncNotes, IntegrationNote, AdditionalNotes. - Balance constraints: Common CD 3–6s; Rare 10–20s; Epic 20–40s; Legendary 45–90s; EnergyCost 30–200; Activation ranges 2–40; radii 2–15. - v152 Shadow & Lightning entries MUST be included verbatim; v189 MontHua Mixin snippet MUST be preserved & implemented verbatim; v196 Technique framework snippets MUST be preserved & implemented verbatim. Mandatory Code/Text Snippets to Preserve Verbatim - v152 (Shadow & Lightning skills), v189 (MontHua Manual Mixin snippet), v196 (Technique framework POSE MIXIN, PARTICLE SPAWNER, MOVEMENT OVERRIDE, TECHNIQUE EXECUTOR) — these must be included verbatim. Telemetry, Logging & Diagnostics - Standardized logs for manual acquisition, unlocks, S2C sends, client packet handling, UI refreshes, equip validation, aura rendering, mixin load issues. - Diagnostics for v204 loader: count loaded skills, manuals missing skills, learned skills per player. Testing & Release Checks (MANDATORY) - Verify UI fundamentals (K/J/M/C behaviors, no blur, ESC closes, relic dot opens left-side GUI, aura preview only in Aura tab). - Qi ≈0.2/tick configurable per-world. - Per-world persistence & legacy migration (v183). - Tribulation mechanics updated for Pedestal removal (v203). - Meditation seat/pose works (v185/v165/v198/v225). - Skills visual system & 6-slot loadouts persisted; Alt/Ctrl hotkeys; charge mechanics. - Rings & relics items present. - Sword texture minima enforced; Zhuqin replaced v205; relic spirit sword replaced v211; v214 outfit using uploaded armor layer_1. - Ring commands /anel abrir /anel invocar /anel listar; Relics GUI left-side. - Particle pooling & LOD; technique framework functional; modular code; single animation path chosen & tested; full PT-BR localization; fabric.mod.json & mixins JSON validated (v191); render hygiene validated. Critical Errors & Priority Fixes - v154 ExceptionInInitializerError; v161 mixin static field visibility & @Unique; v162 Skill Tree J must render without blur; v164 missing-texture & BlockEntityRenderer UV/transparency; v165/v185/v198 meditation must work (hold C sits & absorbs Qi); v167 aura blending & Qi bar coordinates/clamps; v174/v192 atomic skill unlock flow; v183 per-world persistence & migration; v190 remove HungerTracker/HungerManager mixins; v161/v191 mixin warnings/errors; v47 verify removal of mob content. Conflicts & Decisions Required - v47 (REMOVE ALL MOBS) conflicts with v216/v218/v222/v223 (dragon mob & spawn egg & mating). Decision: honor v47 (reject dragon edits) OR accept dragon edits and document exception & QA/mitigations (grief mitigation, spawn configs, permissions, mixin safety). - Choose and document exactly one animation/render path: GeckoLib (v54) OR native shader/particle pipeline (v60). Do NOT mix. - Preserve verbatim snippets (v152, v189, v196). - Apply user-supplied textures exactly to specified texture paths without renaming (v205, v211, v214). - Implement per-world persistence & migrate legacy global data (v183). - Fix critical mixin/bootstrap issues (v154, v161, v190, v212) and validate startup. Implementation Deliverables Checklist (authoritative) - Full modular Fabric 1.21.5 codebase PT-BR. - GUIs J/K/M + Relics left-side dot. - Qi system + HUD. - Realms progression & Tribulação Celestial updated for Pedestal removal. - Techniques system with JSON loader data/xianxia/skills/, SkillRegistry, SkillDefinition, SkillBehavior, SkillRuntimeContext, 5-phase Visual Framework (v196), HUD hotkeys & NBT persistence. - Dimensional Rings & Relics left-side GUI. - MontHua manual / Técnica da Espada Fluorescente with required verbatim Mixin (v189/v217). - v152 verbatim Shadow & Lightning entries. - v196 verbatim technique framework snippets integrated. - v205/v211/v214/v217 asset replacements applied exactly. - Per-world persistence + migration tool. - Mixins fixed & validated. - Particle pooling & LOD; RenderType/VertexFormat hygiene. - Telemetry & diagnostic logs. Agent/Developer Decisions & Action Items (explicit) - Decide animation path and document. - Decide to honor v47 (no mobs) or accept dragon edits with documented exception & QA. - Ensure inclusion of v152, v189, v196 verbatim blocks. - Apply user textures exactly to target texture paths (v205, v211, v214). - Fix mixin/bootstrap issues and validate startup. - Implement per-world persistence & legacy migration. - If dragons accepted: implement spawn egg model (v222), mating (v223) and destructive behaviors (v216/v218) with server-side guards and documented QA. TECHNIQUE v224 "Punho da Aura Divina" (full deliverable summary — MUST follow v149 & integrate with v196/v204) - Registration: id xianxia:divine_aura_fist; name "Punho da Aura Divina"; manuals ["xianxia:mountain_fist","xianxia:celestial_breath"]; rarity epic; cooldown 15s; qi_cost 60; unlock: realm>=3 & 5 skill points. - JSON fields per v149 including 5 stages: gather (0.4s crouch, flame_converge), thrust (0.15s punch), travel (2s spiral_trail+end_rod+enchant), impact (0.25s explosion + camera shake 0.8), fade (0.5s smoke_rise). - CooldownSeconds 15; EnergyCost 60; ActivationRangeBlocks 40; EffectRadiusBlocks 3. - Damage: Base 15 hearts; Scaling +5 per realm; Max 40 hearts. - StatusEffectsApplied: Stun 1s (Slowness V 20 ticks); Knockback enabled true strength 2. - Visuals: vanilla-only particles specified; Sound keys for charge/launch/whoosh/explode. - ActivationAnimation: gather CROUCHING 8 ticks via TechniquePoseMixin; thrust punch; projectile rotation 5°/tick. - LineOfSightRequired yes; UsableWhileMoving No; MultiplayerSyncNotes: server spawns AuraFistEntity, server-authoritative damage/block destruction; clients receive S2C updates. - Projectile/AuraFistEntity: server-authoritative; RenderType.entityTranslucent(FIST_TEXTURE) alpha 0.6 additive; rotate age*5°; scale size = 2.0f + realm*0.5f; particle counts; VFX pooling/LOD; server-side block destruction with exclusions (BEDROCK, OBSIDIAN, DIAMOND_ORE, ANCIENT_DEBRIS), grief mitigations, permission toggles. v225 Meditation Replacement (exact required behavior & code semantics) - REMOVE old MeditationSeatEntity, meditation Mixins, mounting logic. - Implement minimal pose-based meditation: - Use EntityPose.SITTING directly (no extra entities/mixins). - MeditationManager: Map MEDITATING with start/stop/isMeditating. - Client keybind (XianxiaClient snippet) sends MeditateC2SPacket (ID xianxia:meditate). - ServerPlayNetworking receiver toggles meditation; ServerTickEvents.END_SERVER_TICK loop enforces cancel conditions: movement >0.01, sneaking, recent damage <20 ticks. - While meditating: set pose SITTING, set velocity 0, add Qi 0.2f * getTechniqueBonus(qi) per tick, spawn particles (ENCHANT, END_ROD, GLOW). - Sync function sync(ServerPlayerEntity p, boolean state) broadcasting meditation_sync packet to all players. - Deliver provided code snippets exactly as given. No mixes/entities. Conflicts & Decisions Recap - v47 (no mobs) vs v216/v218/v222/v223 (dragon mob edits): must choose to reject dragons (honor v47) OR accept dragons and document exception + QA/mitigations. - Required verbatim snippets to preserve: v152, v189, v196. - Must choose exactly one animation path (v54 GeckoLib OR v60 native). Mandatory Chronological Edit History (each on new line; highlights & important versions) - v0: Baseline Qi bar, Realms, Skills, Zhuqin lore/materials, per-hit bleed, SFX, PT-BR lore. - v2: Zhuqin rework: new actives (Crimson Moon Slash, Ancestors’ Lament, Zhuqin’s Rhythm); passives use soul fragments; shadow/light VFX. - v3: Scope opened for extra content. - v4: +1 block, +2 swords, +1 food. - v5: +2 simple blocks; marreta hammer-pickaxe; extra content. - v6: Asset/render improvements: larger sword textures; FP/TP angles & pivots; model/texture refactor. - v7: Force right-rotation of swords; add Redmoon Hua Sword (animated aura, vampiric lifesteal). - v8: New 4K Zhuqin asset rotated; minor fixes. - v9: Qi bar activatable with C; Realms labels PT-BR 1–9. - v10: Qi mechanics & UI modal; Qi ≈0.2/tick; Cultivator modal; Right-click/Sneak+Right-click; colored Qi types. - v11: K menu polish; C absorbs Qi depending on technique; 3 basic manuals added. - v12: Fixes K menu & Tribulations; remove overlapping auras; ESC closes; rotate weapons; Tribulações Celestiais implemented; Meditation Lock added. - v13: Blocks & Pedestal ritual integrated; Sopa de Lótus Espiritual restores Qi + regen. - v14: Remove full-screen blur (vignette allowed); C originally toggle (later changed). - v15: UI legibility & camera fixes; FP/TP compatibility. - v16: Menu/data fixes; Celestial Punishment config; "Tipo de Empunhadura" variable recommended. - v17: Visual Skills System integrated with example VFX (Crimson Slash, Qi Wall, etc.). - v18: Skill Tree UI introduced & mobs added (later removed v47); realm demote fixes. - v19: Biomes & recipes (Fogged Forest, Qi Cave). - v20: NPCs & advanced AI (Mortals, Disciples, Elders), dialogue, routines, quests, reputation, companions. - v21: Dynamic aura evolution; manual charging with overcharge risk; specializations. - v22: Technical proposal: layered auras, Power Projection, GeckoLib recommended, shader hooks; Alt/Ctrl hotkeys; M menu supporting 6 slots. - v23: Introduced Dimensional Rings (Terrestrial/Celestial/Immortal) bind-on-first-use. - v31: Rings improvements: Shift+RClick batch transfer; creative-like GUI; commands /anel abrir /anel invocar /anel listar; player cultivation aura. - v32: Technique slots integrated into Cultivator menu (6 slots); Alt/number & Ctrl/number hotkeys; charge system; NBT persistence. - v33: Relics system: Relíquias GUI left-of-inventory with exclusive slots. - v38: Relíquias bug fixes: ensure small dot opens dedicated GUI; Z-index & persistence fixes. - v39: Reiteration: relic dot opens left-of-armor GUI; skill selection persistence. - v41: Entity texture exclusivity: unique ResourceLocation & flattened skin per entity. - v42: UX & Relic GUI improvements; cooldown/Qi/relic feedback; ambient VFX prioritized. - v43: Architectural requirement: modular/extensible via interfaces/abstract classes. - v44: Spirit Beasts added (later removed v47). - v45: PT-BR skins: NPCs with unique flattened skins. - v46: GUI quality & relic HUD PT-BR fixes; icons replacing R1/R2; PNGs for techniques; responsive scaling. - v47 (ENFORCED): REMOVE ALL MOBS — delete all mob-related assets/code; NPCs allowed only if not classified as mobs. - v48: Visual framework & 3D skill model; verify mob removal. - v49: Render/debug hygiene fixes: RenderType/VertexFormat crashes fixed; particle UVs; player starts without techniques; remove modid:identifier displays. - v50: Relic Amuleto do Dragão added (flame wings visuals). - v51: Expand: full set of swords, armors, tools. - v52: UI/naming/wings/lore fixes; remove modid prefixes; short descriptions mandatory; rare items with lore lists. - v53: Xianxia immersion: Celestial Warnings, vivid aura styles. - v54 (OPTIONAL PATH—MANDATORY IF CHOSEN): GeckoLib dependency option: refactor GeoItem/GeoRenderer/GeoEntity; animations Idle/Attack/Defense/Fly; Relic GUI renders GeoItems; NBT stores animation state; server/client sync; particles tied to keyframes (EXCLUSIVE path). - v55: Dragon wings & Spiritual Sword orbit visuals implemented as relic/GeoItem (GeckoLib) with persistent NBT. - v56: Bugfixes & GeckoLib usage for auras/powers. - v57: Iterations & compatibility work. - v58: PT-BR pre-v59 fixes: drag/drop, technique PNGs, Relíquias text. - v59: PT-BR edits: decorative Xianxia/Wuxia/Murim blocks and Qi Stone recipes. - v60 (ALTERNATIVE PATH REMAKE without GeckoLib): Native visuals via particles, custom entities & GLSL shaders; DataComponents, TechniqueEntity rendering, XianxiaParticleEngine with LOD & pooling; migrate GeoItems → native (EXCLUSIVE ALTERNATIVE). - v61: Hotfix PT-BR: duplicate Cultivator menus, slot tooltips, aura toggles, 5-phase visuals. - v62: Enforce sword textures min 64x (prefer 128x); right orientation. - v63 (Build Final MC 1.21.5 PT-BR): Playable build centered on Cultivator systems; bug fixes, persistence, multiplayer sync; NBT loadout persistence; Relics & Rings optimized; docs/tests PT-BR. - v65: Add slab & stairs matching roof texture; review Cultivator menu. - v66: Replace Técnicas & Aura UI with new sections inside Cultivator UI; review/test. - v68: Remake Técnicas tab to fix out-of-menu/overlap; layout recreated & tested. - v69: Aura rendering spec: render in RenderLivingEvent.Post (Forge) — DO NOT use world.addParticle(); use translucent PNGs with additive blending; pooling & LOD; preview in Aura UI. - v70: Complete Técnicas & Aura tabs: translucent background; Técnicas (6 slots, scrollable list, drag/drop, 5-phases); Aura controls & realtime preview. - v72: Internal instruction to complete/revise changes. - v73: Side Techniques panel (PT-BR) when aba active; icons PNGs. - v75: Remove descriptive text under Técnicas menu; aura preview only in Aura tab. - v76: Restrict aura styles to Standard and Technique Color; add techniques up to 6 total (3 new). - v77: Layout & positioning fixes (K) to avoid overflow; scrolling/autodistribution. - v79: UI content fixes PT-BR; remove helper texts; remove Aspect selector. - v80: Server validation concepts: Aspect values; Realm int 1..9; technique metadata; linear Qi scaling; equip rules; server validation for client C2S intents with OperationResultS2C. - v83: UI microfixes PT-BR. - v84/v85: Stable build (final). - v87: Swords must include top-line legendary short lore; some swords have defined skills (CD, duration, VFX, SFX). - v91: Add Cultivator Diaries & Ancient Legacies (collectibles) with cosmetic aura when held; elemental affinities. - v95: Fix text overflow: trimStringToWidth recommendation. - v98/v100: Meditation pose (Fabric 1.21.5) initially via static invisible ArmorStand entity; C toggles (later changed). - v102: Clean refactor (Fabric 1.21.5): modular package structure without changing IDs/namespaces/textures. - v106: Texture diagnostics: detect duplicates/corruptions; fix names/resolutions/alpha. - v108: Each Legacy/Diary has unique texture; Diaries readable with text. - v109: Facility to remove Diaries/Legacies if instructed. - v111: Base Skill Tree: J with categories; skill points on realm up; tags/gui ids. - v118: Skill Tree part 2: progression chains; glowing connection lines; unlock requirements. - v119: Dynamic node alignment; pan/zoom enabled. - v120: Meditation: HOLD C activates meditating and absorbs Qi; cancels on move/damage/Shift (entity invis used, later replaced). - v121: Qi aura living render: sprites ascend from ground; preview only in Aura tab. - v122: Build Stable. - v123: HOLD C adds seated pose; remove Qi focus toggle; hold C immediately activates meditation. - v124: PNGs for each cultivation manual; unique manual texture. - v129: Skill Tree integration: hold manual + right-click to unlock associated technique in J; auto-register learned skills. - v130: Skill Tree GUI directives: scissor viewport, centering, pan/zoom clamps (0.5–1.5). - v131: Define Technique slots and passives per technique with VFX/particles/animations. - v132: HOLD C activates seated pose regardless of Realm; shows Qi absorption; releasing C or moving cancels. - v133: Unique auras per technique; player chooses Standard or Technique Aura. - v134: Skill Tree restatement: J opens GUI; points & chains reaffirmed. - v135 (OVERRIDE HEALTH): Replace hearts with continuous bar; maxHealth = 20 * 2^(realmTier - 1); server-authoritative via AttributeModifier & NBT; scale rendering. - v138: Mixin hotfix for injection failure; fallback; cancel vanilla draw and call renderCustomHealthBar; DrawContext. - v140: Skill Tree visuals: pan/drag, mouse-wheel, ornamented border, rarity colors, Bezier connections, unlock particles, JSON-driven skills. - v144: Remove blur/excess transparency in Skill Tree; clean background. - v146: HUD refinements: centered health number, Qi bar below health with numeric value; realm name above Qi bar. - v148: Meditation entity & networking: C mounts invisible ArmorStand-type to sit; absorbs Qi per tick; dismount via C; networking specified. - v149: Task to generate Skills-only: output JSON-like objects grouped by Manuals; data-only. - v151: Fire manual skill examples provided verbatim as reference. - v152 (MANDATORY): Provide Shadow Skills and Lightning Skills entries verbatim in the dataset (these exact blocks are required). - v154: Crash reported: ExceptionInInitializerError — mandatory fix. - v161: Mixin static field visibility & @Unique fixes needed; HealthHudMixin compile fixes required. - v162: Skill Tree J must render without blur/dimming. - v164: Fix missing-texture pink/black & BlockEntityRenderer UV/transparency issues. - v165: Replace mount-invisible solution with mixin injecting pose into player model activated by QiDataComponent. - v167: Fix aura blending & Qi bar positioning (qiBarY/qiBarWidth); RGBA vertex corrections. - v173: Build Stable. - v174 (EDIT/FINAL OBJECTIVE): Standardize Skill Tree (J) & Cultivator Menu (K) visual/functional integrity; use GuiGraphics; unlock server-side atomic: validate prerequisites, subtract cost, add skill ID, S2C sync, persist NBT. - v175: Bug: C activates sitting pose while riding — fix. - v180: Aura & Qi label overflow/clamp fixes. - v181: Skill Tree / Main Manual sync bug: switching main manual did not update J — require modal warning and server-side atomic validation to remove incompatible skills and deterministically refund/deduct points; UI must reflect current manual with immediate client/server sync. - v182: Build Stable (latest stable). - v183 (MANDATORY): Fix global-save bug: progression saved globally — MUST save per-world (Evolutions, leveled Skills). Migrate legacy global data to per-world storage. - v184: Validate all bug fixes applied. - v185 (REQUIRED MEDITATION FIX): Fix meditation in Fabric 1.21.5: hold C sits and absorbs Qi; preserve client/server packets and approach MeditationSeatEntity or fallback pose override; entity registered, packets registered, player not in creative flight. - v186: Fix skill unlock bug: only Fire skills appeared; read active manual from QiDataComponent to filter skill tree; add AspectChangeWarningScreen + AspectChangeC2SPacket to clear/unlock/reset; checks canUnlockSkill by aspect, realm, points. - v187: Fix mob damage scaling bug (if mobs existed before v47): apply fixed values, per-realm percent reduction to 75%; boss damage = 5% of player max HP; damage caps; PvP scaling by realm difference; per-realm regen. - v188 (EDIT NEW): Implement custom hunger bar matching continuous health bar style (orange gradient). Requirements: position, gradient, centered number, maxHunger scaling up to 200 by realm; avoid mixin crashes; overlay visual-only. - v189 (MANDATORY PART 1 & 2): MONT HUA MANUAL (MANDATORY): Manual id xianxia:manual_mont_hua (Rare/Epic), PT-BR lore, right-click integrates into Skill Tree (J), registers mont_hua_steps & mont_hua_slash; sets active aura mont_hua_aura; particles, glow radius, drop particles, texture; PROVIDED Mixin snippet MUST BE PRESERVED & IMPLEMENTED VERBATIM. - v190: Fix Mixin crash & implement scaled hunger bar: remove HungerTracker/HungerManager mixins from mixins JSON; overlay visual-only hunger bar (maxHunger formula), cancel vanilla drawing via InGameHud mixin HEAD; deliver orange overlay number without breaking mechanics. - v191: Mandatory validations: package naming com.xianxia.granddeluxe.*, validate fabric.mod.json, mixins JSON and build.gradle; mixins target Yarn 1.21.5; fix visibilities & @Unique; remove InvalidMixinException & MethodNotFoundException. - v192: Integration fixes between Skill Tree J, Cultivator K and Manuals: manual acquisition unlock-only; canonical NBT xianxia_learned_techniques; server sends LearnedTechsS2CPacket; client caches HashSet; UI refresh hooks; server-side equip validation with EquipResultS2CPacket; AuraRenderer loads aura_texture from manual manifest; RenderType.entityTranslucent alpha 0.5; provide example NBT & logs; implementation flow 1→10 specified. - v196: PART 1 — Technique Visual Framework AAA+ (5-phase) with Celestial Tempest example; deliver pose mixin, particle patterns, movement override & TechniqueExecutor; provided code snippets (POSE MIXIN, PARTICLE SPAWNER, MOVEMENT OVERRIDE, TECHNIQUE EXECUTOR) MUST be PRESERVED & IMPLEMENTED VERBATIM. - v197: Fix K layout after resize; expand menu to 420×300; recalc menuX/menuY; Técnicas scissor clipping; Aura spacing recalculated; Skill Tree dims TREE_WIDTH=400,TREE_HEIGHT=300; responsive scaling; deliver menu ≈400×280–420×300 with no overlaps. - v198 (LATEST EDIT before v199): Rework Meditation (Cultivation Pose): pressing C mounts an invisible non-colliding static entity at current location; cancel on move/damage/Shift; integrate client/server packets; deliverable: hold C sits/absorbs Qi; release cancels. - v199: Technique sync bug fix (CRITICAL): techniques unlocked in Skill Tree J not appearing in K → ensure reading unlocked techniques from player NBT/DataComponents and dynamically populate lists; drag/drop to 6 loadouts; server-client synchronization consistent. - v200: “The Grand Synchronization Update” — sweeping sync/consistency improvements (implicit). - v201: World Launch Redirect Fix (CRITICAL): fix bug redirecting to multiplayer list when entering singleplayer world; ensure IntegratedServer initializes locally; avoid network logic on world open. - v202: Edit final: Mod declared 100% playable, no silly bugs. - v203 (EDIT): Remove the Pedestal — Pedestal Celestial removed; Pedestal Celestial no longer required nor present. Update progression flows accordingly (Tribulação Celestial remains). - v204 (EDIT): Parte 2 do framework: implement complete skill pipeline — manuals’ Técnicas generated/loaded/linked to players and visible in menus (J and K). Requirements: central JSON loader data/xianxia/skills/ registered via SkillRegistry at startup; class separation SkillDefinition, SkillBehavior, SkillRuntimeContext; GUI & persistence integration; state machine for 5 phases; server-side validation & cost formula; VFXRegistry; manuals register contained techniques; HUD hotkey integration; diagnostic logs; dynamic modular system. - v205 (EDIT): Replace the texture of the Zhuqin sword with the texture provided by the user (must be applied to Espada Zhuqin and its refinements). - v211 (EDIT): Replace the texture of the relic spirit sword with the texture the user sent. - v212 (EDIT): Fix broken Mixin causing crash in Fabric 1.21.5. Do not remove Mixins; fix using correct targets, private static, @Unique, try-catch; regenerate refmap; validate packets and NBT; game loads without crashes. - v213 (EDIT): Skill Manual Framework Expansion (Phase 2) – Manual-Specific Techniques Sync and Dynamic Skill Tree Refresh: ActiveManual DataComponent, manual-specific JSON skill trees, ManualChangeSyncPacket, preserve universal skills, ensure UI rebuild & NBT update. - v214 (EDIT): New spiritual outfit item using uploaded full-body cultivator robe texture (armor layer_1); use uploaded texture directly as armor layer in model renderer; do not rename texture; mod generator must apply uploaded file as texture path. - v216 (EDIT): New appended prompt: "Feral Ender Dragon (Fabric 1.21.5)" — introduces rare hostile mob ghast_dynasty:feral_ender_dragon with adult/juvenile variants, Ender Dragon model with user-provided dragon.png texture, destructive AI (block destruction via Mixins), blue Soul Fire breath, Overworld/The End spawns, attributes adult HP 250 juvenile 100, juvenile scaled to Iron Golem size; CONFLICT with v47 — implementation must reconcile (reject or document exception & QA/mitigations). - v217 (EDIT): MontHua manual rename: from "Manual das Artes MontHua" → "Técnica da Espada Fluorescente"; description must state it's from Mont Hua; aura pink; preserve registrations and required Mixin snippet from v189. - v218 (EDIT appended by requester): Create a dragon (not a relic), a mob in the standard Elder Dragon model using user texture; wanders world; within 200-block radius of village/temple has 15% chance to destroy by spitting default blue fire; CONFLICT with v47. - v222 (EDIT appended): Create spawn egg model for the new mob in creative inventory and analyze localization/model correctness (placement, model correctness); CONFLICT with v47. - v223 (EDIT appended): New mob (Feral Ancient Dragon) mating behavior: two dragons can meet & mate producing small golem-sized offspring; behavior similar to fox/dog mating; CONFLICT with v47. - v224 (EDIT): Create "Punho da Aura Divina" technique for Fabric 1.21.5 using five-phase framework. Full specification included (id xianxia:divine_aura_fist) with JSON-like fields, projectile AuraFistEntity rendering rules, damage scaling, block-destruction rules & exclusions, VFX pooling/LOD, server-authoritative mechanics, integration with TechniqueExecutor & SkillRuntimeContext, grief mitigations & config toggles. - v225 (EDIT): Replace broken meditation system completely. REMOVE old MeditationSeatEntity, meditation Mixins, mounting logic. Implement minimal pose-based system using EntityPose.SITTING, MeditationManager (Map MEDITATING), MeditateC2SPacket (ID xianxia:meditate), ServerPlayNetworking receiver toggling meditation, ServerTickEvents.END_SERVER_TICK loop enforcing cancel conditions (movement>0.01, sneaking, recent damage <20 ticks), set pose SITTING, add Qi 0.2f*getTechniqueBonus(qi) per tick, spawn particles (ENCHANT, END_ROD, GLOW), sync function to broadcast meditation_sync. No mixins/entities required. Deliver provided snippets exactly. - v226 (EDIT): Check the mechanics. See if the dragon egg we created is created and available in creative mode. Check if each layer can have its own aura, correctly. And more things. The goal is to seek improvements Internal. Final Conflicts & Required Decisions (restated) - Enforce v47 (no mobs) OR accept appended dragon edits v216/v218/v222/v223 — if accepting, implement clear QA, sandboxing, permission/config toggles, grief mitigation, and document exception. - Choose and document exactly one animation path: GeckoLib (v54) OR native shader/particle pipeline (v60). - Preserve verbatim snippets v152, v189, v196 in code/data. - Apply user-supplied textures exactly to target paths (v205, v211, v214). - Implement per-world persistence & migrate legacy global data (v183) before release. - Fix mixin/bootstrap issues (v154, v161, v190, v212) and validate Fabric 1.21.5 startup (fabric.mod.json & mixins JSON). Deliverables to Produce / Verify Before Release - Modular Fabric 1.21.5 codebase with full PT-BR localization. - GUIs J/K/M, Relics left-of-inventory GUI dot, Qi HUD, continuous health & visual hunger overlay. - Skill pipeline (data/xianxia/skills JSON loader, SkillRegistry, SkillDefinition, SkillBehavior, SkillRuntimeContext), 5-phase Technique Visual Framework (v196), VFXRegistry pooling/LOD. - Dimensional Rings, Relics left-side GUI, MontHua / Técnica da Espada Fluorescente (v189/v217) Mixin preserved verbatim. - Include v152 verbatim skill entries and v196 verbatim technique framework snippets. - Zhuqin (v205), relic spirit sword (v211), and robe (v214) textures applied exactly. - Per-world persistence + migration tool (v183). - Mixins fixed/validated; render hygiene & particle pooling/LOD validated. - Telemetry & diagnostic logs; server-authoritative validation; test suite verifying all UI behaviors, skill unlock atomicity, technique 5-phase behavior, meditation pose behavior (v225), and choice-of-animation-path. Edit v227: Fix and improve **Skill Tree (J)** in *Xianxia Grand Deluxe (Fabric 1.21.5)*. Problems: skill names cut off, fixed viewport hides nodes, and combat slot techniques appear in tree. Tree must only show **passive/stat skills**, not combat techniques. **SKILL TYPE SEPARATION:** Two categories — **Tree Skills** (passives/stats) in J menu, and **Slot Skills** (combat techniques) for K menu only. Examples: * Tree Skills → Defesa Espiritual, Qi Regen, Resistência, Velocidade, Salto Alto, Queda Suave. * Slot Skills → Explosão da Palma, Corte Celestial, Passos Celestiais. **FILTER TREE NODES:** ```java public List getTreeNodes(PlayerEntity p){ QiDataComponent qi=p.getComponent(ModComponents.QI_DATA); String manual=qi.getActiveManual(); return ALL_SKILLS.stream() .filter(s->s.getSkillType()==SkillType.TREE) .filter(s->s.isUniversal()||s.getManual().equals(manual)) .collect(Collectors.toList()); } ``` **ENUM:** ```java public enum SkillType {TREE, SLOT, HYBRID} ``` Combat techniques = SLOT. Tree renders only TREE/HYBRID. **TEXT FIX (wrap or scale):** ```java private void renderNodeText(DrawContext c,String t,int x,int y,int w){ int tw=textRenderer.getWidth(t); if(tw>w){Listlines=wrapText(t,w);int ly=y; for(String line:lines){c.drawText(textRenderer,line,x,ly,0xFFFFFF,true);ly+=10;}} else c.drawText(textRenderer,t,x,y,0xFFFFFF,true); } ``` or ```java private void renderScaledText(DrawContext c,String t,int x,int y,int w){ int tw=textRenderer.getWidth(t); float s=tw>w?(float)w/tw:1f; MatrixStack m=c.getMatrices();m.push();m.translate(x,y,0);m.scale(s,s,1); c.drawText(textRenderer,t,0,0,0xFFFFFF,true);m.pop(); } ``` **VIEWPORT / CAMERA FIX:** ```java private void updateCameraBounds(){ float minX=Float.MAX_VALUE,maxX=Float.MIN_VALUE,minY=Float.MAX_VALUE,maxY=Float.MIN_VALUE; for(SkillNode n:getTreeNodes(player)){ minX=Math.min(minX,n.x);maxX=Math.max(maxX,n.x); minY=Math.min(minY,n.y);maxY=Math.max(maxY,n.y);} minX-=100;maxX+=100;minY-=100;maxY+=100; float vw=width/zoom,vh=height/zoom; cameraX=MathHelper.clamp(cameraX,minX,maxX-vw); cameraY=MathHelper.clamp(cameraY,minY,maxY-vh); } ``` **PASSIVE SKILL JSON:** ```json {"id":"xianxia:mountain_endurance","name":"Resistência da Montanha", "type":"TREE","manual":"xianxia:mountain_fist","effect":"+10% dmg reduction"} ``` Universal nodes always show; manual-specific only when matching active manual. **NODE POSITIONING:** ```java private void calculateNodePositions(){ Listu=getUniversalNodes(),m=getManualNodes(); for(int i=0;itip=new ArrayList<>(); tip.add(Text.literal(h.getName()).formatted(Formatting.BOLD)); tip.add(Text.literal("Tipo: "+h.getType())); tip.add(Text.literal("Custo: "+h.getCost()+" pontos")); if(h.getRealmRequirement()>0) tip.add(Text.literal("Reino: "+h.getRealmRequirement())); tip.add(Text.literal(""));tip.add(Text.literal(h.getDescription()).formatted(Formatting.GRAY)); c.drawTooltip(textRenderer,tip,mx,my); } ``` **LEARNING TECHNIQUES:** ```java public void learnTechniqueFromManual(PlayerEntity p,Skill s){ QiDataComponent qi=p.getComponent(ModComponents.QI_DATA); if(s.getSkillType()==SkillType.SLOT){ qi.addLearnedTechnique(s.getId()); p.sendMessage(Text.literal("§aTécnica aprendida: "+s.getName()),false); }else if(s.getSkillType()==SkillType.TREE){ qi.addUnlockedTreeSkill(s.getId()); p.sendMessage(Text.literal("§aHabilidade desbloqueada: "+s.getName()),false); } } ``` **RESULT / DELIVERABLE:** Skill Tree (J) now shows **only passive/stat upgrades** — no combat slot skills. Names wrap or scale to fit. Camera scrolls to show all nodes dynamically. Universal passives align left; manual-specific right. Hovering nodes shows full tooltip. Combat skills learned from manuals go only to **K menu slots**, never appear in the tree. Everything fits visually and functionally. Clean, organized, synchronized Skill Tree