PureMash Tweaks

PureMash Tweaks - Version 1.6.0 Changelog

Target Environment: Minecraft 26.1.2 / NeoForge
Previous Version: v1.5.0

1. Universal Cable System (3-in-1 Logistics)

Unified Logistics Conduits

  - Simultaneous 3-in-1 Resource Routing: Replaced separate item, fluid, and
    energy cables with a unified conduit block (Synthorium Universal Cable and
    Moldelonian Universal Cable) capable of routing Items, Fluids, and Forge
    Energy (FE) simultaneously through a single block space via the NeoForge
    Transfer API.
  - Tier Throughput Scaling:
      - Synthorium Universal Cable (Tier 1): Transfers up to 8
        items/cycle, 1,000 mB/t fluid, and 50,000 FE/t.
      - Moldelonian Universal Cable (Tier 2): Transfers up to 64
        items/cycle, 10,000 mB/t fluid, and 100,000 FE/t (configurable).
      - Speed Upgrade Scaling: Slot 0 accepts Speed Upgrades (Tiers 1, 2, and 3)
        to multiply transfer rates.
  - Connection & Wrench Mechanics (ConfigurationWrenchItem):
      - Shift + Right-Clicking a cable face with a wrench cycles its connection:
        Insert (Default) -> Extract (Nozzle) -> Disconnect -> Insert.
      - The GUI opens exclusively when right-clicking active extraction nozzles
        with an empty hand, preventing accidental interface popups.
      - Auto-connects to adjacent capability-providing blocks on placement and
        auto-disconnects when neighboring machines are broken.

Sub-Type Channels & Distribution Modes

  - Independent Channel Tabs: Each extracting side maintains independent
    configuration matrices [6 faces][3 channels] for Energy (Tab 0), Items
    (Tab 1), and Fluids (Tab 2).
  - 3 Distribution Modes:
      - Round-Robin: Cycles resource delivery sequentially across all connected
        destination containers.
      - Random: Randomly selects target destinations per transfer cycle.
      - Dynamically (Gradual): Real-time proportional distribution balancing
        delivery across all connected target containers simultaneously based on
        remaining capacity.
  - Redstone Control: Configurable per side and per channel (Ignored, Active on
    Signal / High, Active without Signal / Low).

Advanced Filtering Engine (CableFilter) & Targeted Routing

  - Filter Policy: Independent Whitelist (Allow) and Blacklist (Block) modes.
  - Target Identifiers: Supports Item IDs, Fluid IDs (with animated liquid
    sprite previews), and Tags (#c:ingots, #c:fluids/water, etc.).
  - Mod ID Namespace Filtering: Matches entire mod namespaces using @modid
    (e.g., @ae2, @minecraft) with dynamic Creative Tab icon rendering.
  - NBT Metadata Matching: 3 operational modes (Ignore NBT, Exact NBT Match, and
    Fuzzy / Partial NBT Match).
  - Durability & Charge Conditions: Evaluates item damage using custom
    mathematical operators (<, <=, >, >=, =, !=) or percentage thresholds
    (5%, 25%, 50%, 75%, 100%).
  - Container Slot Sequencing: Restricts insertion to specific slot indices
    (e.g., 6, 1, 4) or fills sequentially starting from a designated slot index.
  - Stock Limit (Cap): Configurable per-slot quota (from 1 up to 10,000,000
    items) that advances to subsequent slots or containers once reached.
  - Distribution Filter Tool (DistributionFilterItem):
      - Shift + Right-Click on any container in the world to bind its X, Y, Z
        coordinates, target face, and dimension.
      - Shift + Right-Click in the air or on the same block to unbind.
      - Displays dynamic holographic foil when bound and includes dimension
        safety validation to prevent cross-dimensional conflicts.
      - Inserting a bound filter into a Cable Filter GUI enables priority
        routing (1 to 99) and container-specific stock quotas.

2. Synthesis Table & 9x9 Crafting Ecosystem

Standalone High-Speed 9x9 Crafting Workstation

  - 83-Slot Architecture:
      - Slots 0–80: 9x9 input crafting matrix (81 slots).
      - Slot 81: Output result slot.
      - Slot 82: Dedicated Memory Card slot (active during Automation mode).
  - Memory Card Workflow (MemoryCardItem):
      - Craft Mode (Mode 0): Locks automation to the recipe pattern encoded on
        the card. External logistics insert ingredients strictly into designated
        grid slots.
      - Add / Encoder Mode (Mode 1): Encodes the physical 9x9 grid layout and
        output item onto a blank card via the "Save" button without consuming
        crafting ingredients.
      - Clearing Cards: Looking straight up (pitch < -60 degrees) and
        right-clicking while holding an encoded Memory Card wipes its stored
        recipe data.
  - Transaction Snapshot Journal: Full transactional rollback protection
    prevents grid jamming if external systems deliver incomplete ingredient
    batches.
  - Zero-Tick Auto-Ejection: Completed outputs push automatically into adjacent
    inventories or Applied Energistics 2 / Refined Storage networks with zero
    tick delays.
  - Holographic Rendering:
      - GUI Ghost Overlay: Renders semi-transparent ghost item overlays in empty
        slots when a configured card is inserted.
      - 3D World Hologram (SynthesisTableRenderer): Displays a rotating,
        floating 3D preview of the output item above the table when automation
        is active.

3. Multifunctional Compressor Overhaul

  - Energy Requirement: Integrated Forge Energy (FE) requirement with a base
    internal buffer of 5,000,000 FE.
  - 3 Operational Modes:
      - Compression Mode (Mode 0 - 50 FE/t): Compresses items into block forms
        (default 9:1 ratio). Scans global crafting recipes automatically for
        valid 9-to-1 conversions.
      - Singularity Condensation Mode (Mode 1 - 250 FE/t): Condenses high item
        volumes into concentrated Singularities (default cost: 1,000 items).
      - Dust Crusher Mode (Mode 2 - 100 FE/t): Pulverizes ingots, raw ores, and
        blocks into dusts. Raw ores yield doubled dust outputs.
  - Safe-Refund Mass Accumulator: Changing modes or harvesting the machine
    refunds all accumulated input items from internal buffers back to Slot 0 or
    drops them safely into the world.
  - Recipe Locking: Toggleable lock button restricts inputs strictly to the item
    currently assigned to Slot 0, rejecting foreign items.
  - Upgrades & Auto-Ejection: Accepts Speed, Capacity, Duplication, and Stack
    Processing upgrades in Slots 2–4 with instant 0-tick output ejection.

4. Alchemical Synthesizer

  - Hydraulic, Mechanical & Pure Electric Processing:
      - Universal Hydraulic Tank (16,000 mB): Accepts any registered liquid via
        the interactive bucket valve in Slot 0.
      - Pure Electric Smelting (Route C): Automatically scans smelting and
        blasting registries to smelt ores and dusts using 100% electricity (100
        to 500 FE/t, 20 to 35 ticks) without requiring fluids or tools.
      - Hydrothermal & Mechanical Refining (Routes A & B): Uses water/lava
        catalysts and tools (Pickaxes, Shovels, Axes, Paxels) in Slot 2 to wash,
        crush, and recycle equipment into scraps and nuggets.
      - Direct Redstone Charging: Inserting Redstone (+5,000 FE) or Redstone
        Blocks (+45,000 FE) in Slot 1 recharges the internal 5,000,000 FE
        buffer.
  - 20-Slot Output Matrix: High-capacity output buffer (Slots 3–22) with
    automatic 0-tick push to adjacent containers.
  - Upgrades Supported: Slots 23–25 support Speed, Capacity, Duplication, and
    Stack Processing upgrades.

5. PureMash Energy Generator & Thermodynamics

  - High-Density Energy Generation:
      - Base capacity of 400,000,000 FE (expandable via Capacity Upgrades up
        to 2,000,000,000 FE).
      - 64-bit client synchronization prevents integer overflow on GUI energy
        bars.
  - Supported Dense Fuels:
      - Moldelonian Block: 15,000 FE/t (12,000 ticks burn time, 1500 °C max
        temp).
      - Moldelonian Ingot: 5,000 FE/t (1,200 ticks burn time, 1200 °C max temp).
      - Uranium Storage Block: 8,000 FE/t (18,000 ticks burn time, 1400 °C max
        temp).
      - Uranium Ingot / Raw / Dust: 3,000 FE/t (1,800 ticks burn time, 1000 °C
        max temp).
      - Synthorium Block: 2,500 FE/t (6,000 ticks burn time, 800 °C max temp).
      - Synthorium Ingot: 1,000 FE/t (600 ticks burn time, 600 °C max temp).
      - Synthorium Scrap: 500 FE/t (200 ticks burn time, 400 °C max temp).
      - Redstone Block & Dust: 300 FE/t (1,200t) and 200 FE/t (120t).
      - Coal Block, Coal & Charcoal: Standard burn values.
  - Thermodynamics & Steam Production:
      - 20,000 mB Coolant Tank (Water) and 100,000 mB Steam Output Tank.
      - Coolant consumption absorbs heat above 100 °C, keeping efficiency
        at 100% and converting Water into Steam at a 1:10 ratio (1 mB Water
        -> 10 mB Steam).
      - Overheating penalty: Operating dry above 200 °C reduces generation
        efficiency down to 25%.
  - Hysteresis Auto-Pause: Freezes fuel consumption upon reaching 100% capacity
    and resumes burning once stored energy drops to 75%.
  - Byproducts & Charging Port:
      - 25% base chance (multiplied by Duplication Upgrades) to produce residual
        nuggets (Moldelonian, Synthorium, or Uranium Nuggets) in Slots 4–6 upon
        fuel completion.
      - Slot 7 wirelessly charges energy-storing items at up to 50,000 FE/t.

6. Energy Storage & 3D Fluid Tanks

  - PureMash Energy Battery: Stores 50,000,000 FE with an I/O transfer rate
    of 1,500,000 FE/t (retains stored charge when mined).
  - Creative Energy Battery: Supplies infinite energy (10,000,000 FE/t transfer
    rate) with a continuous holographic foil effect.
  - Standard Fluid Tank (32,000 mB): Stores liquids with bidirectional bucket
    interaction and data retention when broken.
  - Creative Fluid Tank (1,000,000 mB): Infinite fluid source. Right-click with
    a bucket to lock a liquid; Shift + Right-Click with an empty hand to clear.
    Displays infinity / infinity in tooltips.
  - 3D Fluid Geometry Rendering:
      - Implemented FluidTankSpecialRenderer, FluidTankItemModelUnbaked, and
        FluidBox UV clamping.
      - Renders volumetric 3D liquid inside glass reservoirs across placed
        blocks, GUI previews, third-person hand rendering, and item drops
        without texture atlas bleeding.

7. Chunk Loader System

  - Area Coverage (Levels 0 to 6):
      - Level 0: Disabled (OFF), unloads forced chunks and removes boundaries.
      - Level 1: 1x1 Chunk.
      - Level 2: 3x3 Chunks.
      - Level 3: 5x5 Chunks.
      - Level 4: 9x9 Chunks (Drains 500 FE/t).
      - Level 5: 15x15 Chunks (Drains 2,500 FE/t).
      - Level 6: 17x17 Chunks (Drains 5,000 FE/t).
  - Moldelonian Core Requirement: Levels 4–6 require an active Moldelonian Core
    in Slot 0. If the core runs out of energy or is removed, the loader
    automatically downgrades to Level 3 (5x5) and alerts the player.
  - Proximity Restriction: Placement is prevented if another Chunk Loader is
    active within a 10-block radius.
  - Visual Boundary Outlines (ChunkLoaderRenderer): Interactive "B" button
    toggles in-world emissive 3D boundary walls.

8. Meta-Enchantments System

Overload (Max Level III)

  - Extended Interaction Reach: Adds +1.0 block interaction and entity reach per
    level (+3.0 blocks at Level III) on tools and weapons.
  - Bedrock Breaking: Synthorium and Moldelonian Pickaxes and Paxels enchanted
    with Overload can mine Bedrock (temporarily converts to fake_bedrock and
    drops vanilla Bedrock).
  - Creative Armor Flight: Equipping a full set of Overload-enchanted Synthorium
    or Moldelonian armor grants creative flight with an on-screen HUD.
      - Level I: 2.0 minutes (2,400 ticks) flight gauge.
      - Level II: 3.5 minutes (4,200 ticks) flight gauge.
      - Level III: Infinite flight (infinity).
      - Toggle flight on or off using the X key
        (key.puremashtweaks.toggle_flight).
  - PureMash Core Block Acceleration: Applying Overload to a placed PureMash
    Core Block accelerates crop growth and tile entity ticks in a cubic area
    (Level I: 3x3x3 / +100%, Level II: 5x5x5 / +300%, Level III: 7x7x7 / +800%).
    Shift + Right-Click toggles visual bounding box rendering. Proximity
    restriction enforces a 10-block distance between Core Blocks.

Overclock (Max Level II)

  - Anvil Level Cap Expansion: Combining items or books with Overclock on an
    anvil allows other enchantments to surpass their native vanilla level caps:
      - Overclock I: +1 level beyond native limit (e.g., Sharpness VI,
        Protection V, Fortune IV, Looting IV).
      - Overclock II: +2 levels beyond native limit (e.g., Sharpness VII,
        Protection VI, Fortune V, Looting V).
  - Visual Formatting (EnchantmentMixin): Overclocked enchantments render in
    Bright Cyan (#00E5FF) in tooltips.
  - Mod Compatibility Plugin (PureMashMixinPlugin): Anvil mixins automatically
    yield when Apothic Enchanting or Zenith is installed to avoid conflicts.

Overdrive (Max Level IV)

  - Universal Tag Expansion (#puremashtweaks:enchantable/overdrive): Compatible
    with all tools, swords, axes, hoes, and armors (vanilla and modded).
  - Area-of-Effect Mining (Tools & Paxels):
      - Level I: 1x1 with container teleportation.
      - Level II: 3x3 area.
      - Level III: 5x5 area.
      - Level IV: 7x7 area.
      - Context-aware filtering: Mining stone only breaks stone/ores; digging
        dirt only excavates ground.
  - Tree Feller: Breaking logs with an Axe or Paxel fells the entire tree trunk
    and canopy upward.
  - Melee Cleave (Swords): Expanded sweeping attacks on hostile mobs (Level
    II: 2.5m, Level III: 3.5m, Level IV: 5.0m sweep radius) with safety
    protection for tamed pets and armor stands.
  - Wireless Container Teleportation: Shift + Right-Click any container with an
    Overdrive tool or wrench to bind coordinates. Mined drops teleport directly
    into storage. Highlighted in-world with a lime green bounding box (#55FF55).
  - Mobility & Kinetic Armor:
      - +5% movement speed per level (+20% at Level IV) and +0.5 block step
        height (toggleable via the C key, key.puremashtweaks.toggle_overdrive).
      - Boots grant 100% fall damage immunity accompanied by wind charge burst
        particles and sound.

9. Materials, Equipment & Upgrades

Synthorium Tier (Tier 1 Reinforced)

  - Material Properties: Durability: 3,000, Mining Speed: 15.0F, Base Material
    Damage: 12.0F.
  - Tool Stats:
      - Synthorium Sword: 22.0 Damage / 1.6 Attack Speed.
      - Synthorium Axe: 24.0 Damage / 1.0 Attack Speed.
      - Synthorium Paxel: 25.0 Damage / 1.1 Attack Speed.
      - Synthorium Pickaxe: 18.0 Damage / 1.2 Attack Speed.
      - Synthorium Shovel: 16.5 Damage / 1.0 Attack Speed.
      - Synthorium Hoe: 11.0 Damage / 4.0 Attack Speed.
  - Synthorium Armor: 34 Total Armor Defense (Helmet 6, Chestplate 12,
    Leggings 10, Boots 6), 20.0 Armor Toughness (5.0/piece), 80% Knockback
    Resistance (0.2/piece).
  - Synthorium Apple (Rare): Absorption II (2m), Resistance II (45s),
    Regeneration III (20s), Fire Resistance (3m), Speed II (1m).
  - Crafting Components: Synthorium Scrap, Ingot, Nugget, Dust, Plate, Rod, and
    Block.

Moldelonian Tier (Endgame Supreme Tier)

  - Material Properties: Durability: 6,500, Mining Speed: 20.0F, Base Material
    Damage: 30.0F, Enchantability: 30.
  - Tool Stats:
      - Moldelonian Sword: 60.0 Damage / 1.8 Attack Speed.
      - Moldelonian Axe: 62.0 Damage / 1.2 Attack Speed.
      - Moldelonian Paxel: 65.0 Damage / 1.3 Attack Speed.
      - Moldelonian Pickaxe: 52.0 Damage / 1.4 Attack Speed.
      - Moldelonian Shovel: 48.0 Damage / 1.2 Attack Speed.
      - Moldelonian Hoe: 33.0 Damage / 4.0 Attack Speed.
  - Moldelonian Paxel 4-in-1 Utility (PaxelItem):
      - Pickaxe mining, Axe log stripping, copper scraping, and wax removal,
        Shovel path creation and campfire extinguishing, Hoe tilling.
  - Moldelonian Armor: 100 Total Armor Defense (Helmet 18, Chestplate 36,
    Leggings 28, Boots 18), 50.0 Armor Toughness (12.5/piece), 100% Knockback
    Immunity (0.25/piece).
  - Moldelonian Apple (Epic / Foil): Instant Health II, Absorption V (3m),
    Resistance IV (35s), Regeneration V (30s), Strength III (1m30s), Fire
    Resistance (5m), Night Vision (3m), Saturation (5s).
  - Moldelonian Core: 500,000,000 FE portable battery with passive wireless
    inventory charging at 500,000 FE/t (pulses every 4 ticks).
  - Smithing Upgrades: Upgraded from Synthorium gear on a vanilla Smithing Table
    using the Moldelonian Smithing Template and a Moldelonian Ingot.

PureMash Core

  - Creative Chip (PureMashCoreItem): Epic creative component featuring an
    animated cyan sine-wave name color cycle (#00FFFF to #004B4B).

Machine Upgrade Cards (8 Dedicated Cards)

  - Speed Upgrade Tier 1: Adds +2 operation speed.
  - Speed Upgrade Tier 2: Adds +4 operation speed.
  - Speed Upgrade Tier 3: Exponential operational speed multiplier (up to +256x
    speed).
  - Capacity Upgrade Tier 1 (2x): Doubles internal energy capacity.
  - Capacity Upgrade Tier 2 (5x): Quintuples internal energy capacity.
  - Duplication Upgrade Tier 1 (15%): Grants a 15% duplicate output chance.
  - Duplication Upgrade Tier 2 (50%): Grants a 50% duplicate output chance.
  - Stack Processing Upgrade: Processes up to 64 items simultaneously per cycle.

10. Dynamic Singularities & In-Memory Asset Engine

  - In-Memory Virtual Resource Pack (PureMashDynamicPackResources):
      - Dynamically generates model JSONs, item definitions, and two-layer
        textures in memory via AddPackFindersEvent for custom singularities
        defined in config JSONs, eliminating missing texture errors without
        writing to disk.
  - Cosmic Singularity (CosmicSingularityRecipe):
      - Dynamically scans and requires all active built-in, modded, and custom
        config singularities in real-time.
      - Features an animated full-spectrum RGB hue shifting effect and an
        oversized GUI halo aura.
  - Singularity Void Protection (NoPureMashSingularityDrop):
      - Prevents singularities from being dropped into the world or lost on
        inventory overflow.
      - Intercepts drops and stores pending singularities in world saved data
        (PendingSingularitySavedData) to restore them when the player is nearby.

11. World Generation, Structures & Archaeology

Illusioner House Structure

  - Worldgen Placement: Generates in Dark Forest biomes with surface terrain
    adaptation (TerrainAdjustment.BEARD_BOX and
    Heightmap.Types.WORLD_SURFACE_WG).
  - Isolation Distance: Spawns at least 14 chunks away from Woodland Mansions.
  - Illusioner Respawn Manager (IllusionerRespawnManager): The Illusioner boss
    spawns with persistence and automatically respawns 5 in-game days (120,000
    ticks) after being defeated.
  - Loot Vaults:
      - Ground Floor Chests (3 Chests): Iron, Gold, Diamonds, Emeralds,
        Amethyst, Synthorium Scraps/Nuggets, rare foods, enchanted books
        (Overload I, Overclock I, Overdrive I), and Tier 1 upgrades.
      - Tower Summit Chests (4 High-Tier Chests): Mineral blocks, Netherite,
        Synthorium Ingots/Blocks, Totems of Undying, Enchanted Golden Apples,
        high-tier books (Overload II/III, Overclock II, Overdrive II/III), and
        Tier 2/3 machine upgrades.

Archaeology & Ores

  - Suspicious End Stone (SuspiciousEndStoneBlock): Generates naturally across
    End Highlands and Midlands surfaces (3 veins per chunk, Y=55 to Y=75).
    Brushing drops the Moldelonian Smithing Template, New Horizons music disc,
    Moldelonian Blocks, Shulker Shells, and resources. Manually placed blocks
    remain empty.
  - Synthorium Debris Ore: Generates in deepslate layers (Y = -64 to 0) in
    standard, rare, and epic vein sizes.

12. In-Game Documentation (GuideME)

  - Integrated Guide Book (puremashtweaks:guide):
      - Craftable Guide Book (4 Synthorium Ingots, 4 Glass Panes, 1 Book)
        registered in the PureMash creative tab.
      - Includes custom 9x9 recipe display layout (LytSynthesis9x9Recipe) and
        interactive 3D structures (<GameScene>).
      - Quick lookup: Hover over any mod item in inventory/JEI and press G to
        open its page.
  - 14 Comprehensive Chapters (English & Portuguese):
    1.  Progression Overview (index.md)
    2.  Synthorium Metallurgy & Equipment (synthorium.md)
    3.  Moldelonian Archaeology & Endgame (moldelonian.md)
    4.  The Illusioner House (illusioner_house.md)
    5.  Synthesis Table 9x9 Automation (synthesis_table.md)
    6.  Multifunctional Compressor (multifunctional_compressor.md)
    7.  Alchemical Synthesizer (alchemical_synthesizer.md)
    8.  PureMash Energy Generator (puremash_generator.md)
    9.  Universal Cables & Logistics (universal_cables.md)
    10. Storage & Utilities (storage_and_utilities.md)
    11. Machine Upgrades (upgrades.md)
    12. Endgame Cores & Creative Tier (end_game_and_cores.md)
    13. Singularities & Music Discs (singularities_and_music.md)
    14. Cross-Mod Compatibility & Credits (compatibility.md, credits.md)

13. Mod Integrations & Compatibility

  - KubeJS Integration (PureMashKubeJSPlugin):
      - Custom recipe schemas exposed for 9x9 Shaped Synthesis
        (shaped_synthesis), 9x9 Shapeless Synthesis (shapeless_synthesis),
        Multifunctional Compressor (compression, singularity, dust), and
        Alchemical Synthesizer (alchemical).
  - Silent Gear: Full material definitions for Synthorium, Moldelonian, and
    Synthorium Rods with custom stats, traits (Sturdy IV/V, Flexible III,
    Synergistic III/V, Magnetic II, Malleable III, Void Ward, Flame Ward), and
    repair tags.
  - Productive Bees & Metalworks:
      - SynthBee (Netherite Bee + Diamond Bee) and MoldelBee (conversion via
        Moldelonian Block).
      - Centrifuge recipes for honeycombs yielding Synthorium/Moldelonian
        nuggets, wax, and honey.
      - Foundry crucible melting (2,200 °C / 2,900 °C) and casting recipes for
        ingots, blocks, plates, rods, nuggets, and apples.
  - Mystical Agriculture: Crop registrations for Synthorium (Tier 4) and
    Moldelonian (Tier 5) with fallback recipe support for Creative Essence.
  - Jade / WAILA: Dynamic tooltips displaying live FE transfer rates and
    extraction faces on Universal Cables, animated progress flows on Compressors
    and Synthesizers, and 9x9 recipe flow visualization on the Synthesis Table.
  - Just Enough Items (JEI): Custom recipe categories with animated progress
    bars, fuel statistics, recipe transfer handlers, and ghost ingredient
    dragging for the Cable Filter screen.

14. Core Architecture, Networking & Advancements

  - Network Serialization (CustomPacketPayload):
      - Migrated all network payloads to explicit StreamCodec.composite and
        StreamCodec.of implementations (ToggleFlightPayload,
        ToggleOverdrivePayload, UpdateCableFilterPayload,
        OpenCableFilterPayload, CloseFilterToCablePayload,
        DeleteCableFilterPayload, ToggleCompressorModePayload,
        ToggleCompressorLockPayload, SyncFlightPayload, SyncOverdrivePayload,
        SyncSynthesisRecipesPayload).
      - Dedicated server recipe synchronization via
        ServerSideEvents.onDatapackSync eliminates client recipe
        desynchronization.
  - Configuration & Hot-Reload: Split configuration files into
    puremashtweaks-common.toml and puremashtweaks-client.toml with real-time
    live reload support (onConfigLoad and onConfigReload).
  - Advancement Grand Finale (PureMashAdvancementCompletionHandler): Completing
    all 28 PureMash Tweaks advancements triggers a 7.5-second (150-tick) finale
    countdown, plays the custom beyond_the_final_stage_achievements_completed
    audio track, and rewards the Beyond The Final Stage music disc.