Changelog

Version: 1.1.26
Date: 2026-10-14
  Features:
    - Add first-class Gizmod Territory Service with multi-layer, overlapping chunk claims, spatial ownership queries, paginated coverage buffers, revision tracking, and deterministic claim tie-breaking.
    - Expose the shared service through gizmod_territory and the canonical gizmod territory_* API facade.
    - Add atomic provider-layer import for compatibility-safe migration of existing saves.

Version: 1.1.25
Date: 2026-10-07
  Bugfixes:
    - Fixed a crash when mounting the rideable Companion Bot caused by reading max_health from LuaEntityPrototype during the autonomous/ridden entity swap.

Version: 1.1.24
Date: 2026-10-07
  Changes:
    - Rideable Companion Bots and Hovercraft now use absolute world-direction steering: W/A/S/D command north/west/south/east, with diagonal combinations, instead of Factorio car-relative throttle/steering.
    - Native relative yaw/braking on both driven forms is neutralized while Gizmod drives speed/orientation through Factorio's normal collision solver. Hovercraft manual thrust still consumes its burner fuel at the original 900 kW-equivalent rate.

Version: 1.1.23
Date: 2026-10-07
  Bugfixes:
    - Fixed Companion Bots reporting "Vehicle is full" when the owner tried to ride them. Both autonomous and ridden companion car prototypes now expose a usable vehicle seat; Gizmod's runtime ownership/single-rider checks still prevent other players from taking over the bot.

Version: 1.1.22
Date: 2026-10-07
  Features:
    - Companion Bots are now directly rideable: entering an owned bot swaps it into a single-seat flight form using the engineer-on-bot directional sprite sheet, then restores the autonomous companion when the driver exits.
    - Companion flight ignores cliffs, trees, rocks, buildings, and other entities and may cross shallow/normal water, but deepwater/ocean tiles remain impassable.
    - Added a craftable personal Hovercraft unlocked by Crude Robotics. It crosses water and ocean tiles while retaining normal collisions with trees, rocks, cliffs, buildings, players, and vehicles.
  Changes:
    - Companion cargo, equipment-grid contents, burner fuel state, health, force, and ownership are preserved when switching between autonomous and ridden forms.
    - Companion and hovercraft directional artwork was repacked into exact runtime sprite atlases with matched shadow frames.

Version: 1.1.21
Date: 2026-10-07
  Features:
    - Companion Pickup Beam modules now perform construction and demolition work in addition to collecting loose items.
    - Companion Bots can revive nearby entity/tile ghosts using placement items from the bot cargo first, then the owning player's main inventory; a single placement may draw from both inventories when multiple items are required.
    - Companion Bots can mine nearby entities marked for deconstruction by their owner's force, returning mined items to bot cargo first or the player's inventory when cargo cannot accept the result.
  Changes:
    - Utility work rotates between ghost construction, marked deconstruction, and loose-item pickup so no one work type can permanently starve the others.

Version: 1.1.20
Date: 2026-10-07
  Changes:
    - Companion Bot starter kits no longer include rocket fuel; players receive only the two generators and four companion modules.

Version: 1.1.19
Date: 2026-10-07
  Changes:
    - Companion Bot starter loadouts are now delivered to the owning player's inventory instead of being auto-installed into the bot equipment grid.
    - Script/admin-spawned bots and player-crafted/starting bot items grant 2 companion generators, 1 shock defense, 2 pickup-beam modules, 1 medical-beam module, and 2 rocket fuel to the player.
    - Existing deployed owned bots receive the same inventory kit once when upgrading from the previous auto-install implementation.

Version: 1.1.18
Date: 07. 10. 2026
  Features:
    - Companion Bots now deploy with a complete 6x4 factory equipment loadout: two compact burner generators, one shock defense, two pickup/laser modules, and one medical module.
    - Each factory-installed burner generator starts with one rocket fuel in its fuel inventory.
    - Added a companion-only 2x2 burner generator equipment recipe unlocked by Crude Robotics.
  Changes:
    - The public companion-bot-equipment-names API now also reports the burner generator prototype name.
    - Existing deployed bots receive the factory loadout once on upgrade where the expected slots are free; player-installed equipment is never removed to make room.

Version: 1.1.17
Date: 07. 10. 2026
  Bugfixes:
    - Companion ownership now falls back to Factorio's native last_user when a construction robot or script build event has no player_index, fixing deployed bots that could remain unowned after being granted to another player.
    - Configuration rebuilds now repair previously unowned Companion Bots when a valid last_user is available.
    - Opening an otherwise unowned Companion Bot now safely claims it for that player; already-owned bots cannot be stolen this way.
  Changes:
    - Added companion-bot-owner and companion-bot-set-owner public APIs (plus underscore aliases) so Diplomacy and other gameplay mods can inspect or explicitly assign companion ownership.

Version: 1.1.16
Date: 07. 10. 2026
  Features:
    - Added Crude Robotics technology after Advanced Combinators; it unlocks the Companion Bot and all three companion equipment recipes together.
  Changes:
    - Companion Bots now choose ambient rest positions about 4.25-6 tiles from their owner, averaging roughly five tiles instead of hovering directly on top of the player. Their retargets walk around the player in short arcs instead of cutting straight through the player between opposite perches.
    - Reworked the companion and module recipes around early Crude Robotics materials instead of late-game robot frames, processing units, LDS, Tesla weapons, and laser turrets. Existing-save recipe availability is reconciled to Crude Robotics on configuration change.
  Bugfixes:
    - Rebuilt the 64-direction shadow sheet frame-by-frame from the actual Companion Bot sprite so shadow direction can no longer drift/reverse or scroll independently of the bot.

Version: 1.1.15
Date: 06. 10. 2026
  Features:
    - Added three companion-only 2x2 equipment modules for the Companion Bot's 6x4 grid: Shock Defense, Pickup Beam, and Medical Beam.
    - Shock Defense automatically chains electric damage through nearby enemies and renders attacks with a red native laser beam.
    - Pickup Beam collects nearby dropped item stacks into Companion Bot cargo with a yellow native laser beam.
    - Medical Beam heals the owning player's character while nearby and renders a green native laser beam.
  Changes:
    - Companion beam effects clone and tint Factorio's native laser-beam graphics instead of shipping duplicate beam art.
    - Added a public companion-bot-equipment-names API so Diplomacy and other gameplay mods can discover the stable equipment prototype names.
    - Existing saves immediately enable the new recipes when their owning unlock technology was already researched.

Version: 1.1.14
Date: 06. 10. 2026
  Changes:
    - Added a dedicated 64-direction Companion Bot shadow layer using the supplied Dependabot shadow sheet.
    - Offset the shadow slightly down/right from the hovering bot so its altitude reads more clearly during movement.

Version: 1.1.13
Date: 06. 10. 2026
  Changes:
    - Companion Bots now take roughly 10 seconds for a default character to mine/pick up, reducing accidental collection.

Version: 1.1.12
Date: 06. 10. 2026
  Changes:
    - Companion Bots now use ambient hover movement instead of holding one fixed diagonal follow offset.
    - Each bot periodically chooses a new nearby position at a varied distance and glides toward it, giving multiple companions naturally different motion.
    - Idle bots gradually vary their facing direction, while moving bots turn toward their glide target.
    - Catch-up speed still ramps aggressively when the engineer moves away, and long-distance/cross-surface recovery remains intact.

Version: 1.1.11
Date: 06. 10. 2026
  Features:
    - Added an Admin-tab Spawn Companion Bot recovery button for the selected player; it creates the deployed bot directly beside them and assigns ownership immediately.
    - Added the public companion-bot-spawn remote API (plus Lua-friendly aliases) so GZ-Diplomacy and other mods can create player-owned Companion Bots through Gizmod.
  Changes:
    - Promoted Companion Bots to a documented Gizmod service capability and added COMPANION_BOT_API.md.

Version: 1.1.10
Date: 06. 10. 2026
  Bugfixes:
    - Companion Bot starting equipment is now granted from a live tick instead of during player/scenario initialization, preventing freeplay startup from clearing it.
    - Added a one-time repair migration for 1.1.7-1.1.9 saves whose grant marker was set even though the bot item did not survive startup.
    - Rechecks unfulfilled Companion Bot starting entitlements when a player joins.

Version: 1.1.9
Date: 2026-10-06
  Bugfixes:
    - Fixed existing players not receiving the Companion Bot after enabling the startup option following the 1.1.8 migration.
    - Forward the configuration-change event to the Companion Bot subsystem and reconcile missing starting bots whenever the option is enabled.
  Migrations:
    - Added a repair migration that grants exactly one missing starting Companion Bot to eligible existing players.

Version: 1.1.8
Date: 2026-10-06
  Changes:
    - Added a Companion Bot starting-equipment migration for existing players.
    - When the startup option is enabled, upgrading players receive one Companion Bot unless they already have one in their inventory or have an owned bot deployed.
    - Enabling the startup option later also grants missing existing players once; per-player grant state prevents repeated configuration changes from duplicating bots.
    - If an existing player's inventory is full during the grant, the bot is safely spilled at the player's physical position instead of being lost.

Version: 1.1.7
Date: 2026-10-06
  Features:
    - Added a startup option to give every newly created player one Companion Bot as starting equipment.
    - Added a per-player Companion Bot checkbox to the GZ Dock. Turning it off parks owned companion bots and disables their work lights; turning it back on resumes following.

Version: 1.1.6
Date: 2026-10-06
  Features:
    - Added the Gizmod Companion Bot, a hovering engineer follower with a 6x4 equipment grid, reinforced defenses, cargo storage, and a built-in work light.
    - Added custom 64-direction Companion Bot graphics and automatic cross-surface follow behavior.
  Changes:
    - Companion Bots are excluded from generic RTS vehicle selection so their follower controller owns their movement.

Version: 1.1.5
Date: 2026-10-05
  Bugfixes:
    - Fixed a remaining multiplayer desync in the absorbed Task List GUI lifecycle.
    - Player joins now clear peer-local Task List controller caches and rebuild every player's Task List GUI in stable player-index order on every peer.
    - Task List refresh no longer branches on whether a peer-local GUI controller happens to exist; named GUI roots are always torn down and rebuilt deterministically.
  Notes:
    - This follows the 1.1.4 storage fix. Task data and simple UI preferences remain synchronized; live GUI/controller references remain runtime-local.

Version: 1.1.4
Date: 2026-10-05
  Bugfixes:
    - Fixed multiplayer desyncs caused by persisting Task List LuaGuiElement/controller references in synchronized storage.
    - Task List GUI controllers now live in runtime-local cache and are rebuilt deterministically when players join.

Version: 1.1.3
Date: 2026-10-05
  Changes:
    - Made the shared MASTER crafting group canonically GZ-owned.
    - Reapplied the Barreling tab after GZ MASTER routing so all fill/empty barrel recipes and barrel items stay together, including GZ fluids.
    - Preserved that barrel exception when dependent GZ mods create/reapply prototypes later in data-final-fixes.

Version: 1.1.2
Date: 2026-10-05
  Changes:
    - Added manifest-driven GZ Dock accessory controls for cross-mod checkboxes/buttons.
    - Reworked absorbed Bottleneck Lite indicators into a per-player runtime renderer and added the Dock visibility toggle.

Version: 1.1.1
Date: 2026-10-04
  Admin Tools:
    - Added a per-player Open Testing toggle to the Gizmod Admin tab.
    - Enabling Open Testing turns on LuaPlayer cheat mode and researches all technologies for the selected player's force.
    - Disabling Open Testing turns cheat mode back off without rolling back force research.

Version: 1.0.100
Date: 2026-10-01
  Map Pins:
    - Added a shared Gizmod custom map-pin service rendered in chart and chart-zoomed-in modes.
    - Pin icons use normal Factorio prototype icons through rich text, with automatic item/fluid/entity/recipe/etc. inference and explicit icon-type overrides.
    - Icons and labels use scale_with_zoom so they remain a constant readable screen size regardless of map zoom.
    - Added persistent add/upsert/update/remove/get/list/clear/status APIs with force/player visibility filters and per-source metadata.

Version: 1.0.99
Date: 2026-09-30
  Changes:
    - Reworked MASTER crafting organization around semantic rows instead of one row per owner mod.
    - Added shared Infrastructure and Boats & Water Transport rows; lighted poles route with infrastructure and boat-related content routes together across owning mods.
    - Preserved Chitin, Ecology, Chemistry, Hazmat, Economy, Diplomacy, Loot, RPG, Impact, World/Resources, Utilities, and Gizmod Tools as stable logical rows.

Version: 1.0.98
Date: 2026-09-30
  Changes:
    - Changed the default RTS vehicle-control toggle from Alt+R to Ctrl+R to avoid Factorio 2.0 red-wire shortcut conflict.

Version: 1.0.97
Date: 2026-09-30
  RTS Vehicle Control:
    - Added the reusable Gizmod RTS vehicle-control service with per-player box selection, additive selection, move orders, queued orders, formation-preserving destinations, and selection/target rendering.
    - Added built-in movement adapters for Car riding-state steering and SpiderVehicle autopilot.
    - Added provider registration, route callbacks, remote movement callbacks, arrival callbacks, and public remote methods for gameplay-mod integration.
    - Added the RTS vehicle control shortcut and Ctrl+R toggle.

Version: 1.0.96
Date: 2026-09-29
  Spiderlings:
    - Fixed unload targets that have a unit_number but are not resolvable through game.get_entity_by_unit_number().
    - Unload orders now fall back to deterministic position/name target resolution before treating a destination as unavailable.
    - This fixes Collector Spiderlings returning to the output hatch with cargo and retrying forever without transferring it.

Version: 1.0.95
Date: 2026-09-29
  Spiderlings:
    - Fixed Collector-style container unloading by routing container-family dropoffs through Factorio's entity-level insert API instead of relying on a selected inventory index.
    - Existing loaded Spiderlings already parked beside an unload target are scheduled for an immediate safe retry after configuration change.
    - Cargo remains fail-safe: a genuinely full destination still leaves the Spiderling loaded and waiting rather than spilling or despawning.

Version: 1.0.94
Date: 2026-09-29
  Spiderlings:
    - Entity-backed interaction orders now measure arrival from the target entity bounding box instead of its center, so SpiderVehicle collision/pathing cannot strand a Spiderling beside a chest or Collector hatch.
    - This closes the remaining Collector repeat-dispatch deadlock where the first group stayed permanently active on its unload order.

Version: 1.0.93
Date: 2026-09-29
  Spiderlings:
    - Spiderling orders now honor their radius as an arrival tolerance during the active service pass, so blocked entity centers no longer leave Spiderlings parked indefinitely outside chests, hatches, or other interaction targets.
    - Move, return, pickup, mine, remote-action, and unload orders can complete when the Spiderling is within the configured radius while Factorio continues to own all physical pathing/autopilot movement.
    - This fixes Collector Roboport Spiderlings getting stuck beside the output hatch after their first collection trip.

Version: 1.0.92
Date: 2026-09-29
  Spiderlings:
    - Made Spiderling cargo fail-safe: automatic group completion/destruction no longer spills a loaded trunk onto the ground.
    - Unload orders now wait and retry when the destination is full or temporarily unavailable, keeping cargo on the Spiderling.
    - Oversized remote-action results are retained as Spiderling-owned pending cargo instead of being spilled.
    - `gz-spiderlings-destroy` now refuses to destroy a loaded group unless `spill_cargo=true` is explicitly requested.

Version: 1.0.91
Date: 2026-09-29
  Integration:
    - Added the shared GZ Spiderlings service and generic Spiderling prototype to Gizmod.
    - Added the canonical `remote.call("gizmod", "gz-spiderlings", count, target_location, orders)` API plus retask, recall, destroy, and status operations.
    - Spiderlings are real miniature SpiderVehicles using Factorio autopilot; Gizmod scripts task assignment/actions but does not teleport movement.
    - Added reusable move, wait, pickup, mine, remote-action, unload, return, and looping patrol orders with per-Spiderling queues and group completion callbacks.
    - Generic Spiderlings use a four-slot trunk, no weapons/equipment grid, and have no producer-specific gameplay rules.
  Architecture:
    - Gizmod owns Spiderling entity/group/movement infrastructure; gameplay mods continue to own target selection, rewards, safety rules, and task semantics.

Version: 1.0.90
Date: 2026-09-29
  Integration:
    - Absorbed a shared Space Platform-style entity build/scaffold animation service into Gizmod so GZ mods no longer need the external space-platform-entity-build-animation-lib dependency.
    - Added space_platform_build_animation, space_platform_build_animation_legacy, and space_platform_build_animation_status to the public Gizmod remote API.
    - Added a legacy compatibility remote interface when the external library is absent, while deliberately never shadowing the real external mod when it is installed.
  Performance:
    - The shared animation service is idle when no animation tasks are queued and only processes short-lived rendering work while an effect is active.

Version: 1.0.89
Date: 2026-09-28
  Admin:
    - Added an admin-only technology unlock control to the GZ Hub Admin tab.
    - Admins can select any current force, enter a technology prototype name, and immediately mark that technology researched for that force.
    - Unlock actions validate the force/technology, report already-researched technologies without changing state, and write through Gizmod's structured debug log when enabled.

Version: 1.0.88
Date: 2026-09-28
  Diagnostics:
    - Added an admin-only Performance Capture section to the central GZ Hub Debug tab.
    - Automatically discovers registered mods exposing perf_capture_start/perf_capture_status/perf_capture_dump, with 10/30/60 second synchronized capture buttons and manual Dump Now.
    - Timed captures automatically dump at the end of the requested window; raw LuaProfiler samples remain in each provider's script-output/GIZMOD_logs/perf_<module>.log file.
    - Capture coordination is inert outside an active window and does not automatically enable verbose debug logging, keeping measurements cleaner.
  Multiplayer:
    - Capture window timing/target selection is kept in synchronized Gizmod storage while profiler objects and file output remain peer-local, so reconnecting clients cannot inject profiler state into the save checksum.

Version: 1.0.87
Date: 2026-09-28
  Multiplayer:
    - Identical mod re-registration is now a no-op for GZ Hub presentation refreshes, preventing reconnect-local registry calls from rebuilding synchronized GUI state unnecessarily.

Version: 1.0.86
Date: 2026-09-28
  Multiplayer:
    - Made Debugger diagnostic and profiler writes file-only so peer-local profiler/capture state can never enter synchronized storage or affect multiplayer checksums.
    - Converted debug status/read APIs to read synchronized settings without implicitly creating storage during peer-local diagnostic calls.
    - Cleans legacy synchronized diagnostic snapshots during deterministic init/config migration; module enable/auto-debug settings are preserved.

Version: 1.0.85
Date: 2026-09-27
  Performance:
    - Scripted bonus updates no longer destroy and rebuild every connected player's relative Bonuses GUI while it is closed.
    - Bonus presentation now refreshes immediately only for players actively viewing the native Bonuses GUI; closed views rebuild lazily when opened.

Version: 1.0.84
Date: 2026-09-27
  Fixes:
    - Fixed a crash while cleaning up the GZ control overlay when a player left with a non-GUI object such as an equipment grid open.
    - Hub screen cleanup now compares LuaPlayer.opened directly against the target GUI element instead of assuming the opened LuaObject has a name field.

Version: 1.0.83
Date: 2026-09-26
  Notifications / Discord:
    - Added opt-in Open Discord Bridge forwarding to the Notify API. Producers can set `discord = true` and optionally provide `discord_text` / `discord_label` without depending on ODB directly.
    - Registered the `gizmod.notification` ODB event. Bulk `notify_all` / `notify_force` delivery emits one Discord event per notice rather than one event per player card.
    - Notify-to-Discord never writes to Factorio chat; player-targeted notifications remain transient glass cards only.

Version: 1.0.82
Date: 2026-09-26
  Notifications:
    - Added the GIZMOD Notify API for transient connected-player popup cards with module/submodule source labels, elapsed-time display, explicit GZ glass tints, close controls, and optional links into relevant UIs.
    - Notifications use blue glass by default, remain fully visible for 10 seconds, then fade over 5 seconds before expiring.
    - Added Escape-aware dismissal: when no other GUI is open, Escape dismisses the oldest notification instead of opening the game menu; existing GUIs keep Escape priority.
    - Offline notification storage is intentionally not implemented yet; disconnecting clears active transient cards.
  Glass UI:
    - Added the explicit-color glass style resolver used by shared semantic UI such as notifications.
  Documentation:
    - Added NOTIFICATIONS_API.md and promoted Notifications to the 14th canonical GIZMOD service.

Version: 1.0.81
Date: 2026-09-26
  GUI:
    - Moved the MASTER crafting item group ahead of the vanilla Logistics tab.

Version: 1.0.80
Date: 2026-09-26
  Changes:
    - Bottleneck Lite now defaults to enabled so supported machines receive status indicators without requiring a startup-setting change.
    - Clarified that Bottleneck Lite remains a startup/prototype feature; changing its enable state requires restarting Factorio.

Version: 1.0.79
Date: 2026-09-26
  Documentation:
    - Added the root AGENTS.md integration charter with mod-specific authority rules and the canonical GIZMOD service/API guide.

Version: 1.0.78
Date: 2026-09-26
  Documentation:
    - Added root-level GIZMOD_API_SERVICES.md as the canonical architecture index for the 13 major GIZMOD service APIs.
    - Documented each service's purpose, authority boundary, intended use cases, technical entry points, and the rule to use existing APIs instead of adding parallel GIZMOD limbs.

Version: 1.0.77
Date: 2026-09-26
  Multiplayer Chat:
    - Restored Team as the default normal-chat route. Plain Factorio chat remains force-local unless the sender explicitly selects Everyone.
    - Existing saved chat routes are reset to Team once on upgrade so the old Everyone-by-default migration cannot leave all normal chat globally visible.
    - Reordered the Dock chat selector to Team / Everyone and clarified the route tooltip and Hub documentation.
    - Explicit Gizmod API/system chat routing is unchanged.

Version: 1.0.76
Date: 2026-09-25
  Settings:
    - Hid the absorbed Bottleneck Lite display-detail settings from the game options while retaining their fixed compatibility defaults internally.
    - Hid the absorbed Squeak Through per-group, blacklist, and collision-removal detail settings from the game options.
    - The top-level Gizmod enable toggles for Bottleneck Lite and Squeak Through remain visible.

Version: 1.0.75
Date: 2026-09-25
  Milestones:
    - Added an auction-house milestone presentation category for repeatable market announcements, rendered with an Auction House prefix and the producer-supplied color.
    - Open Discord Bridge milestone forwarding uses a hammer label for auction-house announcements.

Version: 1.0.74
Date: 2026-09-25
  Features:
    - Added the GIZMOD Item Tabs API with a stable MASTER crafting tab and per-mod rows.
    - GIZMOD is the implicit MASTER; the last mod to register as MASTER controls the tab name and may supply its icon, with the GIZMOD thumbnail as fallback.
    - Added begin_mod/finish_mod prototype capture so mods can claim everything they create without maintaining per-item lists.
  Compatibility:
    - Explicit Item Tabs API ownership now takes precedence over Gizmod's optional Barreling, Science Packs, Bioprocessing, and custom heuristic tabs.

Version: 1.0.73
Date: 2026-09-25
  Features:
    - Added the shared GIZMOD hazard-registry broker/API. Hazardous Materials publishes resolved fluid and item hazard records; downstream mods can query the same canonical snapshot.

Version: 1.0.72
Date: 2026-09-24
  Changes:
    - Color-coded GZ RPG Dock meters: XP white, HP red, MP blue, ST green.

Version: 1.0.71
Date: 2026-09-24
  Changes:
    - Widened the GZ Dock by 40 px using a launcher-row spacer so the RPG XP/HP/MP/ST meters have additional horizontal room.

Version: 1.0.70
Date: 2026-09-24
  Changes:
    - GZ Dock RPG meters now prefer the dedicated lightweight RPG dock_status endpoint.
    - XP/HP/MP/ST meter shell stays visible through transient RPG snapshot failures and retries automatically.

Version: 1.0.69
Date: 2026-09-24
  Fixes:
    - Fixed Gizmod failing to load because lib/hub.lua exceeded Lua's 200-local-variable limit.
    - Collapsed GUI-name constants into a single names table, leaving substantial local-variable headroom without changing Dock or Global Statistics behavior.

Version: 1.0.68
Date: 2026-09-24
  Global Statistics:
    - Added a synchronized cross-mod statistics broker to the Gizmod remote API. Mods can define, report, query, list, and snapshot canonical player/force/global statistics.
    - Added the Gizmod-owned Global Statistics window with rankings for team GDP, player deaths, player kills, most expensive science reached, and total science spent.
    - Gizmod now tracks player deaths and lifetime force science-pack consumption directly; other GZ mods can publish their own statistics into the same registry.

Version: 1.0.67
Date: 2026-09-24
  GZ Dock / RPG:
    - Made the XP/HP/MP/ST RPG meter block self-healing when a stale Dock layout is missing the frame or one of its meter children.
    - When GZ RPG is available, the 30-tick Dock refresh now redraws the Dock once and restores the four-meter block instead of silently leaving it absent.

Version: 1.0.66
Date: 2026-09-24
  Changes:
    - Restored GZ RPG meters in the GZ Dock as four stacked progress bars in XP, HP, MP, ST order.
    - RPG Dock meters update from GZ RPG's remote player snapshot and remain visible in minimized Dock mode.

Version: 1.0.65
Date: 2026-09-24
  Changes:
    - Increased the GZ Dock launcher baseline from 32x28 to 40x36 so Diplomacy and Economy icon buttons visually match the GZ, RPG, and TERRA launchers.
    - External Dock launchers now use the same 40x36 minimum height/width baseline for a consistent five-button row.

Version: 1.0.64
Date: 2026-09-24
  GZ Dock:
    - Changed the RPG launcher text to bold blue.
    - Styled the TERRA launcher text bold green, including the external Dock registration and fallback launcher paths.

Version: 1.0.63
Date: 2026-09-24
  GZ Dock:
    - Styled the GZ launcher text bold orange.
    - Styled the RPG launcher text bold green.

Version: 1.0.62
Date: 2026-09-24
  Changes:
    - Simplified the GZ Dock launcher row to GZ / Diplomacy flag / Blue Flux / RPG / TERRA.
    - Removed the Dock Chat helper launcher; chat routing remains available in the expanded Dock and Hub.
    - Removed the duplicate Dock Task List launcher and the separate New Task shortcut; the main Task List remains in Factorio's shortcut tray and on Ctrl+T.

Version: 1.0.61
Date: 2026-09-23
  Integration:
    - Added optional Open Discord Bridge 0.1.13+ integration for all player-facing Gizmod milestone completions and repeatable milestone announcements.
    - Gizmod registers `gizmod.milestone_completed` and `gizmod.milestone_announced` with the bridge and forwards structured milestone/context metadata.
    - Discord text is generated from milestone presentation data, with Factorio rich-text prototype tags converted to readable names.
    - Silent and historical-sync milestones remain unforwarded; bridge failures are isolated from normal milestone/event processing.

Version: 1.0.60
Date: 2026-09-23
  API:
    - Added built-in `gizmod.milestone-completed` and `gizmod.milestone-announced` events to the cross-mod Events API.
    - Third-party Gizmod-registered mods can subscribe to persistent milestone completions, technology milestones, and repeatable milestone announcements.
    - Milestone event payloads expose milestone/force/player metadata; plain-data milestone context is forwarded in the event envelope.
    - Historical technology synchronization during upgrades remains silent and does not emit retroactive completion events.

Version: 1.0.59
Date: 2026-09-23
  API:
    - Added milestone_announce for repeatable milestone-style broadcasts that do not grow permanent achievement history.

Version: 1.0.58
Date: 2026-09-23
  Milestones:
    - Added an optional per-milestone `color` field (`#RRGGBB` / `#RRGGBBAA`) for custom announcement presentation.
    - Existing achievement and shop-update colors remain the defaults when no override is supplied.

Version: 1.0.57
Date: 2026-09-21
  Fixes:
    - Fixed Rate Calculator GUI clicks crashing when Gizmod invalidated a LuaGuiElement before FLIB handled the same event.
    - Rate Calculator/FLIB event handlers now run before pre-existing Gizmod handlers, with an invalid-element guard between composed handlers.

Version: 1.0.56
Date: 2026-09-21
  Features:
    - Absorbed Squeak Through 2 0.2.0 into Gizmod with an enabled-by-default startup toggle.
    - Preserved Squeak Through category, blacklist, and collision-removal startup settings.
  Compatibility:
    - Gizmod now conflicts with standalone Squeak Through / Squeak Through 2 to prevent duplicate collision edits.

Version: 1.0.55
Date: 2026-09-20
  Features:
    - Absorbed Bottleneck Lite 1.3.4 with a Gizmod startup toggle, disabled by default.
    - Absorbed Chest Auto Sort 1.3.0 with a Gizmod startup toggle, enabled by default.
    - Absorbed Rate Calculator 3.3.8 with a Gizmod startup toggle, enabled by default.
  Integration:
    - Namespaced Rate Calculator runtime storage under Gizmod and composed its FLIB event libraries with existing Gizmod handlers.
    - Preserved upstream MIT license notices and translated locale files.
Version: 1.0.54
Date: 2026-09-20
  Diagnostics:
    - Added a profiler-aware Gizmod debugger output path for module diagnostics that need to preserve Factorio LuaProfiler values.
    - Profiler output is written under GIZMOD_logs/profile_<module>.log and remains governed by the central Gizmod debug/module enable state.
    - Debug module status now exposes the profiler log path.

Version: 1.0.53
Date: 2026-09-20
  Milestones:
    - Added a teal `shop-update` milestone presentation for public market/listing notifications.
    - Shop-update milestones support rich-text item icons in their localized milestone names and do not use the personal achievement prefix.

Version: 1.0.52
Date: 2026-09-19
  GZ Dock / RPG:
    - Added a compact GZ RPG status panel directly below the Dock launcher buttons.
    - Displays player name, level, current/required XP, HP, MP, stamina, and a next-level XP progress bar.
    - RPG vitals refresh every 30 ticks while the heavier Dock integrations retain their existing cadence.
    - The RPG status panel remains visible in minimized Dock mode and hides automatically when GZ RPG is unavailable.

Version: 1.0.51
Date: 2026-09-19
  Changes:
    - Added GZ RPG as a first-class standalone Dock launcher.
    - Added the permanent R launcher beside Diplomacy and Economy and wired it to gz_rpg.open.
    - Exempted the native GZ RPG window from the legacy third-party RPG GUI relocation logic.

Version: 1.0.50
Date: 2026-09-18
  Admin / Evolution:
    - Moved inverted destruction evolution controls beside the existing Enemy Evolution controls in the Admin tab.
    - Added independent adjustable per-kill amounts for enemy units, worms/turrets, and nests.
    - Defaults remain unit -0.000001, worm -0.000001, nest +0.000020, applied in 5-second batches.
    - While inversion is active, editing the vanilla Destruction evolution rate now updates the value that will be restored when inversion is disabled while keeping the live vanilla destruction factor suppressed at zero.

Version: 1.0.49
Date: 2026-09-18
  Bugfixes:
    - Fixed a crash in the custom Bonuses GUI cleanup when loading an existing save or changing the mod set.
    - Force targets are now resolved through the Factorio 2.x game.forces table instead of the nonexistent LuaGameScript.get_force().

# Gizmod 1.0.48

## Added

- Clean-room scripted bonus card service for Factorio's Bonuses GUI.
- Force-scoped and player-scoped bonus cards, with player cards overriding same-named force cards.
- Native `gizmod` remote API: `bonus_set`, `bonus_get`, `bonus_remove`, `bonus_list`, `bonus_open`, and `bonus_status`.
- `/gzbonus` launcher for early-game access when the vanilla Bonuses button is disabled.
- Automatic cleanup of bonus cards owned by mods that are removed.

---

Version: 1.0.46
Date: 2026-09-18
  Features:
    - Added /gzdock-reset to clear the current player's saved GZ Dock position/minimized state and redraw it at the safe upper-left default.
    - Admins may use /gzdock-reset <player name> to recover another player's off-screen Dock.

Version: 1.0.45
Date: 2026-09-17
  GZ Dock:
    - Added a minimize/restore button beside Refresh.
    - Minimized Dock preserves the existing launcher row/order and the player Flux balance only.
    - Threat, Loot, Chat route, and integrated Stats sections are hidden while minimized.
    - Minimized state is remembered per player and survives Dock redraws/reconnects.

Version: 1.0.44
Date: 2026-09-17
  Changes:
    - Added admin-only GZ-Hub Game Option: Destruction evolution batch interval (seconds), configurable from 1 to 300 seconds.
    - Inverted destruction evolution now defaults to a 5-second batch interval instead of a fixed 1-second interval.
    - Enemy death events remain counter-only; one combined evolution write is performed per affected surface when the configured interval expires.
    - Changing the batch interval preserves accumulated pending kills.

Version: 1.0.43
Date: 2026-09-17
  Changes:
    - Inverted destruction evolution now batches enemy death counts for 60 ticks and applies at most one evolution-factor update per affected surface per second.
    - Death events only increment synchronized unit/worm and nest counters; no evolution factor read/write occurs in the death-event hot path.
    - Vanilla destruction-factor suppression is checked on the same one-second cadence.

Version: 1.0.42
Date: 2026-09-17
  Game Options:
    - Added admin-only GZ-Hub Game Options toggle: Invert destruction evolution.
    - While enabled, enemy unit/worm deaths reduce surface evolution by 0.000001 each and enemy nest destruction increases evolution by 0.00002.
    - Factorio's normal spawner-destruction evolution factor is temporarily suppressed while the rule is active; its previous value is restored when the option is disabled.
    - Kill deltas are accumulated per surface and applied once per tick to keep large combat events lightweight and deterministic.

Version: 1.0.41
Date: 2026-09-17
  Multiplayer / Desync:
    - Event, subscription, mod-registry, and milestone re-registration now preserves the original registered_tick instead of rewriting synchronized metadata with the caller's current game tick.
    - Makes same-owner registration idempotent and prevents reconnect-only registration paths in client runtimes from mutating Gizmod storage.

Version: 1.0.40
Date: 2026-09-16
  Performance:
    - Technology milestone completion now uses a dedicated indexed state-write path with no announcement work, context allocation, or cloned return payload on on_research_finished.
    - Gizmod remains tracking-only for technology milestones; player-facing research announcements are owned by GZ Diplomacy.

Version: 1.0.39
Date: 2026-09-12
  Admin:
    - Changed Time, Destruction, and Pollution evolution controls to edit the global enemy evolution rate factors instead of rewriting accumulated/current evolution contributions.
    - Increased evolution-rate field precision so Factorio's small default time/pollution factors round-trip correctly.
    - Added Global Starting Area Size, applying one saved starting-area override to all current surfaces and automatically to newly created surfaces.

Version: 1.0.38
Date: 2026-09-04
  Multiplayer Chat:
    - Removed destructive player.clear_console() calls from GIZMOD chat routing. GIZMOD no longer erases and reconstructs Factorio's real chat/console stream.
    - Normal chat now preserves Factorio's native force delivery. The Everyone route only forwards the message to connected players on other forces; Team adds no extra delivery.
    - Everyone is now the default normal-chat route. Existing saved chat routes are reset to Everyone once on upgrade so legacy Team/Admin/DM state cannot make whole players disappear from cross-force chat.
    - The normal-chat selector now exposes only Everyone and Team because on_console_chat cannot safely turn already-sent native team chat into a private Admin/DM channel. Explicit GIZMOD chat APIs retain routed Admin/DM support.
    - GIZMOD chat history clearing now clears only GIZMOD's private history and never clears any player's Factorio console.

Version: 1.0.37
Date: 2026-08-30
  Fixes:
    - Made the permanent GZ Dock expose TERRA whenever GZ-Terra's direct guide interface is available, even if an older/stale Hub registry record lacks the newer Dock metadata.
    - The direct fallback is suppressed when the normal external Dock registration is present, so there can never be two TERRA buttons.
    - The fallback is resolved only when the Dock is built or redrawn and adds no periodic runtime work.

Version: 1.0.36
Date: 2026-08-30
  GZ Dock:
    - Added a compact "Apex Threat" line beneath the Flux balance when GZ-Threat is installed.
    - The line shows GZ-Threat's effective world Apex Strain Evolution level and refreshes with the Dock's existing once-per-second status pulse.
    - Tooltip includes total Apex and active-team count when supplied by GZ-Threat.

Version: 1.0.35
Date: 2026-08-30
  GZ Dock:
    - Added opt-in external Dock launchers for registered GZ-Hub panels.
    - Registered mods can provide a short Dock caption/tooltip and an optional direct remote open action without being hard-coded into Gizmod.
    - Registry changes now redraw the Dock for connected players, so launchers registered after Gizmod's configuration handler appear immediately.
    - This fixes GZ-Terra's TERRA launcher being available in GZ-Hub but missing from the permanent GZ Dock.

Version: 1.0.34
Date: 2026-08-26
  Admin:
    - Fixed Enemy Base Frequency, Size, and Scale fields being effectively non-editable on some clients.
    - Replaced Factorio numeric-filtered widgets for these three controls with ordinary textfields.
    - Apply Base Settings still performs authoritative numeric validation and accepts decimal values from 0 through 6.
    - Widened the fields and added explicit input tooltips.
  Notes:
    - No enemy-base generation, regeneration, territory-buffer, or cleanup behavior changed.

Version: 1.0.33
Date: 2026-08-26
  Admin:
    - Regenerate Bases ±10k now respects GZ-Diplomacy player territory.
    - Claimed territory is expanded by a conservative 512-tile safety buffer; protected chunks are neither cleared of existing spawners/worms nor passed to Factorio enemy-base regeneration.
    - Territory just outside the ±10k management box is queried too when its 512-tile buffer can overlap the box.
    - If GZ-Diplomacy is installed but too old to provide the territory query API, regeneration aborts instead of silently ignoring territory protection.
  Performance:
    - Territory protection is calculated only when the admin explicitly clicks Regenerate Bases ±10k.

Version: 1.0.32
Date: 2026-08-26
  Multiplayer:
    - Replaced eager GZ-Hub construction with a one-page-at-a-time multiplayer renderer.
    - Pressing G now builds only a static Home page. Hidden Settings, Admin, Chat, Debug, APIs, Installed Mods, and external panels are not constructed.
    - External remote panel builders are called only when that exact panel is explicitly selected.
    - Threat Admin status, runtime-prototype status, debug module initialization/status, and other page-specific reads are not touched by plain Hub opening.
    - Multiplayer Hub uses fixed synchronized geometry and does not auto-center from client presentation dimensions.
    - Multiplayer glass styling is fixed to deterministic blue instead of consulting runtime-per-user appearance during synchronized GUI construction.
    - Multiplayer Dock launcher navigation no longer writes a debug-log entry merely for opening a GUI.
    - Integrated Stats remain in the permanent Dock; multiplayer Hub no longer creates a second dynamic Stats footer.
  Diagnostics:
    - Any future section-specific desync is isolated to the exact navigation section that was selected.

Version: 1.0.31
Date: 2026-08-26
  Admin:
    - Added Enemy Bases / ±10k Management to the Admin/Misc tab.
    - Added editable enemy-base Frequency, Size, and Scale controls for the admin's current surface. Scale maps to the enemy-base autoplace control's richness/scale value.
    - Added Apply Base Settings for future enemy-base generation.
    - Added Regenerate Bases ±10k, which removes existing enemy spawners/worms inside x/y ±10,000 and re-runs autoplacement only on already-generated chunks intersecting that region.
    - Added Kill All Biters ±10k for enemy unit entities.
    - Added Kill All Spawners/Worms ±10k for enemy unit-spawners and worm turrets.
    - Mass cleanup uses entity removal rather than combat deaths, avoiding loot floods and intentional spawner-kill evolution changes.
  Diagnostics:
    - Enemy-base setting changes, regeneration, and both cleanup actions are logged through Gizmod debug logging.

Version: 1.0.30
Date: 2026-08-26
  Admin:
    - Added Enemy Evolution controls to Admin/Misc for the admin's current surface.
    - Overall enemy evolution can be set directly as 0-100%.
    - Added independent controls for Factorio's raw accumulated Time, Pollution, and Spawner-Kill enemy evolution components, using LuaForce's dedicated evolution-factor APIs.
    - Added Refresh so the panel can re-read engine values after either type of evolution adjustment.
    - When GZ-Threat 0.1.42+ is installed, added effective world-level controls for Apex, Biomass/Size, Speed, Damage, and Swarm/Quantity.
    - Threat Apply creates a persistent world-level admin override; Return to Research Levels clears it and immediately restores research/team-derived values.
    - All evolution/Threat adjustments revalidate player.admin at click time and are logged through Gizmod debug output.
  Performance:
    - No periodic work added; all reads/writes occur only when opening or clicking the Admin panel.

Version: 1.0.29
Date: 2026-08-26
  Admin:
    - Added an Admin tab to GZ-Hub, visible only to admins.
    - Added a dropdown containing every player stored in the current game/save, including offline players.
    - Added a Factorio item-with-quality selector, quantity field, and Give Item button for bug-recovery item replacement.
    - Quality is preserved in the actual inserted item stack; Normal and every loaded quality tier are supported by the native selector.
    - When GZ-Economy 1.1.25+ is installed, added Flux tier/amount controls that credit the selected player's current team/force ledger.
    - Item and Flux recovery actions are routed through Gizmod debug logging when debug logging is enabled.
  Safety:
    - All recovery controls validate player.admin at execution time, not only when drawing the tab.
    - Item/Flux quantities are positive integers capped at 1,000,000,000 per click.
    - Full inventories receive only the amount that fits; the admin is told the exact inserted/requested count.

Version: 1.0.28
Date: 2026-08-25
  Multiplayer:
    - Fixed a GZ-Hub desync introduced by the 1.0.23 API index cache. The remote-interface snapshot was module-local, so a joining client rebuilt it at its own join tick while the server retained the startup snapshot; opening the Hub then constructed different synchronized API-tab GUI state on each peer.
    - The API snapshot is now stored in synchronized save storage. Joining peers inherit the authoritative snapshot and never rebuild it merely because their Lua runtime is new.
    - Configuration changes still invalidate the snapshot once; it is rebuilt deterministically on the next live tick.
    - Multiplayer GZ-Hub sizing and Dock clamping no longer depend on display_resolution or display_scale.
    - Automatic foreign/RPG GUI relocation is disabled in multiplayer because it reads presentation-only GUI geometry and previously persisted those locations in synchronized storage.
    - Obsolete stored foreign-GUI positions are cleared when a multiplayer runtime initializes.
  Diagnostics:
    - Added deterministic Gizmod debug breadcrumbs for G/D/E/C/T Dock button clicks.
  Notes:
    - Single-player adaptive Hub sizing and foreign-GUI relocation are preserved.

Version: 1.0.27
Date: 2026-08-25
  UI:
    - Reordered the permanent GZ Dock: G/D/E/C/T launcher controls are at the top, Loot is in the middle section, and enabled integrated Stats GUI sensors are at the bottom.
    - Added a refresh/redraw button to the GZ Dock titlebar.
    - Redrawing destroys and reconstructs the Dock from current state while preserving the player's saved Dock position.
    - Dock Stats reuse the integrated Stats GUI's cached per-player sensor captions and update with the existing once-per-second Dock refresh.
  Performance:
    - No additional sensor calculations or periodic loops were added.

Version: 1.0.26
Date: 2026-08-25
  Bugfixes:
    - Integrated Stats GUI no longer creates any standalone top-right screen overlay.
    - Stats GUI now only computes/caches enabled per-player sensor captions for GZ-Hub.
    - Fixed the Hub Stats footer being clipped outside the Hub by reserving explicit vertical space beneath the tabbed pane.
    - The Hub Stats footer now uses a visible inside-frame container at the bottom of GZ-Hub.
    - Legacy 1.0.24/1.0.25 Stats GUI overlay windows are destroyed automatically on init/configuration migration.
  Performance:
    - Sensor calculations remain once per second; GZ-Hub only renders cached captions.

Version: 1.0.25
Date: 2026-08-25
  Features:
    - Added a Stats GUI footer at the bottom of GZ-Hub, visible beneath every Hub tab.
    - The footer mirrors every integrated Stats GUI sensor enabled for that player, including externally registered compatible StatsGui custom sensors.
    - Footer values reuse Stats GUI's existing once-per-second cached captions rather than recalculating sensors.
  Bugfixes:
    - Updated the Hub Stats GUI status section to recognize Gizmod's integrated Stats GUI instead of checking for the standalone StatsGui mod.

Version: 1.0.24
Date: 2026-08-25
  Features:
    - Absorbed Even Distribution Lite behind the startup option "Enable Even Distribution"; original per-player timing/balance/cursor settings are retained.
    - Absorbed Stats GUI behind the startup option "Enable Stats GUI"; research, position, evolution, pollution, playtime, and daytime sensors remain independently configurable per player.
    - Preserved the StatsGui remote compatibility interface for external sensor/preprocessor extensions.
    - Added "Normalize all titles and descriptions" as a startup data-stage option using the supplied sentence-case normalization set.
  Integration:
    - Added conflicts with standalone StatsGui, EvenDistributionLite, and enforce_sentence_case to prevent duplicate handlers/UI.
    - Jump was intentionally not integrated.
  Licensing:
    - Included the upstream MIT notices for Even Distribution Lite and Stats GUI.

Version: 1.0.23
Date: 2026-08-25
  Changes:
    - Remote-interface discovery is now snapshotted once per server/Lua runtime on the first live tick after the save/server loads.
    - Opening the APIs tab and calling gizmod.api_index now use the cached server-start snapshot instead of rescanning remote.interfaces.
    - Configuration changes invalidate the in-memory snapshot so the next live tick captures the updated loaded-mod interface set.
    - The APIs tab now places the core gizmod interface first under a dedicated Gizmod APIs section, with all other interfaces separated below under Other / Third-Party Interfaces.
  Performance:
    - Interface enumeration runs once per server runtime; there is no menu-open enumeration cost.

Version: 1.0.22
Date: 2026-08-25
  Features:
    - Added an APIs tab to the GZ Hub/GZ Menu.
    - The APIs tab enumerates Factorio's live remote.interfaces registry, alphabetizes every interface and method, and displays per-interface and total method counts.
    - The index includes Gizmod and every other loaded mod automatically; no hand-maintained interface list is required.
    - Added remote.call("gizmod", "api_index") and remote.call("gizmod", "api_describe", interface_name) for programmatic access to the same live index.
  Notes:
    - API discovery occurs only when requested/opened and adds no periodic runtime work.

Version: 1.0.21
Date: 2026-08-23
  Changes:
    - Moved the absorbed Quality Seeds subsystem out of Gizmod and into GZ-Tweaks.
    - Gizmod no longer defines Quality Seeds settings, cultivator/spore prototypes, graphics, or runtime hooks.
  Compatibility:
    - Prototype IDs and Quality Seeds setting IDs are preserved by GZ-Tweaks 1.0.9 so existing saves can transition ownership without replacing placed cultivators.

Version: 1.0.20
Date: 2026-08-23
  Features:
    - Absorbed Quality Seeds 1.3.3 into Gizmod.
    - Added default-on startup setting "Enable Quality Seeds"; disabling it removes all cultivator/spore prototypes and runtime behavior.
    - Preserved Balanced Cultivation and Freeplace Cultivators settings under their original IDs/defaults.
  Compatibility:
    - Ported Quality Seeds 2.1 recipe categories/probabilities/freshness fields and recycler icon paths back to Factorio 2.0.
    - Added incompatibility with standalone quality-seeds to prevent duplicate prototypes.

Version: 1.0.19
Date: 2026-08-23
  Changes:
    - Completed GZ Loot integration in the permanent GZ Dock.
    - The Dock loot block now displays Total, Active, Collected, and Next Drop from GZ Loot's compact status API.
    - The Dock hamburger opens GZ Loot's existing detailed drop window, eliminating the need for a separate top-flow loot HUD.

Version: 1.0.18
Date: 2026-08-23
  Changes:
    - Technology milestones are now silent in Gizmod so GZ-Diplomacy can provide the single team-aware research announcement without duplicate internal-force messages.
    - Manual milestones/achievements now use the orange Magic-style announcement and prefer the completing player's name when available.

Version: 1.0.17
Date: 2026-08-21
  Changes:
    - Added the Gizmod cross-mod Events API for synchronous named event broadcasts between registered mods.
    - Added event registration/discovery plus exact-event and wildcard subscriptions using remote-interface listener endpoints.
    - Event delivery is fault-isolated so one listener error is logged without aborting the producer or other listeners.
    - Event payloads are copied and restricted to plain Lua data; mods pass stable indexes/IDs instead of LuaObject userdata.
    - Source mods are excluded from their own broadcasts by default, with an explicit include_source option when self-delivery is wanted.
    - Added /gizevents and EVENTS_API.md integration documentation.

Version: 1.0.16
Date: 2026-08-21
  Changes:
    - Added the Gizmod force-aware Milestones API with automatic global announcements when a force/team first completes a milestone.
    - Added built-in milestones for Factorio's essential vanilla and Space Age technologies, derived from the runtime technology prototypes.
    - Added remote registration and manual-completion APIs so other mods can add technology or custom milestones.
    - Existing researched technologies are silently synchronized on upgrade so established saves do not receive historical milestone spam.

Version: 1.0.15
Date: 2026-08-21
  Changes:
    - Replaced the global startup Glass UI color controls with one runtime-per-user Glass UI color setting.
    - Added None, Purple, Blue, Green, Yellow, Orange, Red, and Pink Glass UI choices; Blue remains the default.
    - Glass UI now skins Gizmod-owned Hub, Dock, and Task List windows per player without recoloring vanilla/global GUI prototypes.

Version: 1.0.14
Date: 2026-08-20
  Changes:
    - Replaced the permanent standalone GZ launcher button with the full GZ Dock.
    - The GZ Dock is now always visible on the HUD instead of appearing only while inventory/controller GUI is open.
    - Inventory open/close no longer creates or destroys the Dock.
    - Preserved the draggable Dock and per-player saved position; new players default to the old upper-left launcher area.
    - The permanent Dock continues to host GZ Hub, Diplomacy, Economy, Chat, Task List, Economy balance, and Loot controls.

Version: 1.0.11
Date: 2026-06-05
  Changes:
    - Added live Debug Viewer section to the GZ Hub Debug tab.
    - Debug Viewer reads Gizmod debug storage directly and shows current payload plus recent session entries.
    - Added Refresh, module select buttons, and Print Summary for in-game debug inspection.
    - Gizmod debug_log now keeps live current payloads and per-module recent-entry rings in storage, alongside script-output JSON/JSONL files.
    - Added remote API helpers live_debug_modules and live_debug_snapshot.

Version: 1.0.10
Date: 2026-06-05
  Changes:
    - Absorbed Task List into Gizmod and added a GZ Dock [T] launcher.
    - Added a compact GZ Loot HUD block inside the GZ Dock: hamburger/details button plus Next Drop status.
    - Gizmod now queries gz-loot.ui_status / compact_status and renders the loot status itself.
    - Disabled the absorbed Task List top-flow active-task button so task UI no longer creates independent HUD clutter.
    - Added TaskList as an incompatible standalone mod because its functionality is now absorbed.
    - Added flib as a required dependency for the absorbed Task List GUI/runtime helpers.

Version: 1.0.9
Date: 2026-06-05
  Changes:
    - Gizmod now owns the compact GZ Economy Flux HUD by querying gz_economy.ui_status / compact_status and rendering icon/count output inside the GZ Dock.
    - The dock refreshes the compact Flux display while open instead of relying on GZ Economy's old independent top-flow label.
    - Foreign RPG-style screen windows are stacked under the GZ Dock, and the stack follows the dock when it is dragged.
    - This establishes the Gizmod-owned UI router pattern: modules provide data/actions; Gizmod owns the visible HUD surface.

Version: 1.0.8
Date: 2026-06-05
  Changes:
    - Moved the inventory-time GZ control strip into a draggable side dock so it no longer sits over the quickbar/weapon-slot area.
    - The GZ Dock now defaults below the upper-left mod GUI strip and remembers per-player drag location while avoiding off-screen placement.
    - Consolidated the G/D/E/C launcher controls and chat route selector inside the single dock frame.

Version: 1.0.7
Date: 2026-06-05
  Changes:
    - Moved the inventory-time GZ control strip to the bottom-left companion position near the quickbar instead of the upper-left clutter zone.
    - Added safe foreign RPG window choreography: GIZMOD scans top-level screen GUI roots, moves likely RPG/MFerrari windows into a reserved slot while inventory is open, and restores their original positions when inventory closes.
    - Added /gizgui to print and log top-level screen GUI roots for finding foreign window names without owning their internals.

Version: 1.0.5
Date: 2026-06-02
  Changes:
    - Changed the continuous mining trigger to Ctrl+Shift+right mouse.

Version: 1.0.4
Date: 2026-06-02
  Changes:
    - Fixed a bug with the auto-mining feature.
    - Changed the continuous mining trigger to Ctrl+Shift+right mouse.

Version: 1.0.3
Date: 2026-06-01
  Changes:
    - Fixed a little oopsie in the independency list.

Version: 1.0.2
Date: 2026-05-31
  Changes:
    - Absorbed RealisticReactorGlow by ouk_ouk. We hope you like blue!

Version: 1.0.1
Date: 2026-05-25
  Changes:
    - IYKYK

Version: 0.3.15
Date: 2026-05-25
  Changes:
    - Added Gizmod remote debug-session activation APIs so dependent mods can request active debug logging during on_init/startup.
    - Added set_debug_enabled, set_module_debug_enabled, set_module_auto_debug_enabled, and request_debug_session remote calls.
    - request_debug_session enables the global debug gate, enables the requesting module, enables automatic output for that module, and returns the canonical module debug status.

Version: 0.3.14
Date: 2026-05-23
  Bugfixes:
    - More poorly implemented GPL trash is incompatible
    - Adjustable Quality is an optional dependency

Version: 0.3.13
Date: 2026-05-23
  Bugfixes:
    - I will not YOLO again
    - I will not YOLO again
    - I will not...

Version: 0.3.12
Date: 2026-05-22
  Bugfixes:
    - Added Foundations by 0n0w1c to the optional dependencies because everyone deserves to have a pretty base.

Version: 0.3.10
Date: 2026-05-21
  Bugfixes:
    - Added and re-added a bunch of incomplete/unstable/poorly executed mods to the incompatible list. Added PlanetsLib because I can't be arsed to test every *yawn* Planet mod the Foundry invented over the last couple of years for mods that refuse to use the API.

Version: 0.3.9
Date: 2026-05-21
  Bugfixes:
    - Debug output now appends every event to session_<module>.jsonl for the full loaded session instead of only keeping current/previous snapshots.
    - current_<module>.json and previous_<module>.json remain as quick last-event convenience files.
    - The Debug tab now shows the session JSONL path alongside the current snapshot path.

Version: 0.3.8
Date: 2026-05-21
  Changes:
    - Kept the 0.3.7 placeable medium/big display-panel entities.
    - Kept Economy on the standalone gz_economy.open launcher path; GUI windows are owned by the module again.
    - No GUI display-panel remote shell path was reintroduced.

Version: 0.3.7
Date: 2026-05-21
  Changes:
    - Removed the mistaken GUI display-panel remote shell path; standalone modules should open their own windows through their own remote APIs again.
    - Reduced the Economy launcher to the canonical gz_economy.open call instead of sweeping old compatibility method names.
    - Added actual placeable medium and big display-panel entities integrated from Larger Display Panels (MIT), excluding the giant/huge panel.
    - Added a conflict with the standalone larger-display-panels mod to prevent duplicate prototype names.

Version: 0.3.6
Date: 2026-05-21
  Bugfixes:
    - Reinstall the Gizmod remote interface on load/init/configuration change so upgraded saves cannot retain stale remote-call closures.
    - Fixes Economy display panel calls falling back to older create_display_panel code after updates.

Version: 0.3.5
Date: 2026-05-20
  Changes:
    - Widened the GZ Hub by 160px so core tabs have more room before horizontal overflow.
    - Widened Gizmod-owned medium and big display panels by 160px; Economy and other standalone panels using the core shell inherit the wider layout.
    - Increased core hub panel fallback/minimum widths so registered panels have more horizontal space by default.

Version: 0.3.4
Date: 2026-05-20
  Bugfixes:
    - Fixed Gizmod remote display-panel APIs calling require() during runtime remote calls.
  Features:
    - Added a central Debug tab with every registered module and core-owned debug/auto-output toggles.
    - Added gizmod.is_debug_enabled(module_id) as a short alias for module debug-state checks.
  Changes:
    - Removed per-module debug tabs in favor of the central Debug tab.

Version: 0.3.3
Date: 2026-05-20
  Features:
    - Added Gizmod-owned standard display panel shells: medium and big.
    - Added remote API: display_panel_sizes, open_display_panel/create_display_panel, close_display_panel, and create_scroll_body.
    - Standard display panels own the frame, titlebar, close button, size limits, and scroll shell so modules can render content into a provided body.
    - Hub-owned tabs now use a central scrolling body instead of each module/panel needing bespoke scroll rules.
    - Added underscore/plain open aliases for the future Diplomacy launcher path.

Version: 0.3.2
Date: 2026-05-20
  Fixes:
    - Added gz_economy.open to the Economy standalone launcher call list so current GZ Economy warehouse-only builds open from the Gizmod Economy button instead of reporting not ready.

Version: 0.3.1
Date: 2026-05-19
  Features:
    - loader-utils by Protocol mutates the loader prototype globally in data-final-fixes, so just in case I want to use a loader, that has been marked incompatible.

Version: 0.3.0
Date: 2026-05-19
  Features:
    - Added a GZ Hub debugger button to export the loaded runtime prototype view to JSON.
    - Added /gizproto for runtime prototype export/status/category-filter workflows.
    - Runtime prototype exports write category files and an index under script-output/GIZMOD_exports/runtime_prototypes/.
    - Core registry now advertises runtime-prototype-export and script-output-runtime-prototypes capabilities.

Version: 0.2.30
Date: 2026-05-19
  Changes:
    - Screenshot selection no longer pauses gameplay before the drag-select interaction.
    - Fixed armed screenshot cursor doing nothing after freeze by keeping the selection-tool interaction live until the selected-area event fires.
    - /gizshot status now reports live-selection and pause-bypassed counters.

Version: 0.2.29
Date: 2026-05-19
  Fixes:
    - Screenshot selection now freezes gameplay only when one player is connected.
    - In multiplayer sessions with multiple connected players, Ctrl+Shift+S still equips the selection tool but does not pause the simulation.
    - Added screenshot status fields for multiplayer-unpaused sessions, connected players, and current freeze mode.

Version: 0.2.28
Date: 2026-05-19
  Features:
    - Added a core Gizmod screenshot area tool bound to Ctrl+Shift+S.
    - The hotkey freezes gameplay, places a hidden selection tool in the cursor, and writes selected-area screenshots to script-output/GIZMOD_screenshots.
    - Added /gizshot status/start/cancel and safe cancel handling through Q, cursor clear, and player leave.

Version: 0.2.27
Date: 2026-05-17
  Fixes:
    - Fixed GZ Hub debug toggles so the global debug switch can apply immediately from the hub.
    - Added the global Gizmod debug toggle directly to module debug panels so module debug state and effective state update together.
    - Module debug checkboxes now refresh their panel immediately after being changed, so status text no longer stays stale.
    - Core /gizdebug now follows the global debug switch without requiring a hidden per-module core toggle.

Version: 0.2.26
Date: 2026-05-17
  Changes:
    - Added core-owned per-module debug controls to the GZ Hub for registered modules.
    - Registered modules with debug capability now get Enable debug output and Enable automatic output checkboxes without creating their own Factorio Mod Settings entries.
    - Added module-aware debug API checks for debug output and automatic output gates.

Version: 0.2.25
Date: 2026-05-17
  Changes:
    - Moved the debug logging toggle out of Factorio Mod Settings and into the GZ Hub Settings tab.
    - Gizmod now stores the debug logging enable flag in its own runtime storage surface.
    - The remote debug API still writes rolling current_/previous_ JSON snapshots only when the Gizmod hub toggle is enabled.

Version: 0.2.23
Date: 2026-05-17
  Features:
    - Added a runtime-global Gizmod debug logging toggle.
    - Added core remote debug API calls for Gizmod-family modules.
    - Debug logs write rolling local JSON snapshots to script-output/GIZMOD_logs as current_<module>.json and previous_<module>.json.
    - Added /gizdebug for manually verifying the core debug writer when logging is enabled.

Version: 0.2.22
Date: 2026-05-17
  Changes:
    - Wired optional Gizmod crafting tabs to their dedicated graphics: barrel, science, and bioprocessing.
    - Custom comma-separated item-type tabs now use the magma asterisk graphic by default.
    - Corrected Gizmod tab icon size metadata to 128 for the bundled tab sprites.

Version: 0.2.21
Date: 2026-05-17
  Changes:
    - Enabled Gizmod UI color mask by default.
    - Updated the default Gizmod UI tint to R 25, G 175, B 255, A 150.

Version: 0.2.20
Date: 2026-05-17
  Features:
    - Added optional Gizmod crafting tabs for Barreling, Science Packs, and Bioprocessing.
    - Added a startup comma-separated custom item-type tab setting for grouping matching items/recipes into their own tabs.
    - Gizmod settings tab now reports the current custom item-type tab list.

# Gizmod 0.2.18 patch note

- Added a series of hilarious and hilariously broken, incomplete, GPL-licensed mods to the incompatible list.

---

# Gizmod 0.2.18 patch note

- Added a small D/E launcher row under the GZ button for standalone Diplomacy and Economy windows.
- Removed Diplomacy and Economy registered panels from the main GZ Hub tab list; they now launch as standalone app windows.
- Kept the GZ Hub focused on core settings, installed-mod registry status, and non-standalone panels.
- Added `gz-standalone-launcher-buttons` to core capabilities.

---

# Gizmod 0.2.17 patch note

- Added startup option `gizmod-enable-burner-fuel-leeching`.
- When enabled, Gizmod sets `allow_burner_leech = true` on burner-powered inserter prototypes during data-final-fixes.
- Added a read-only GZ Hub note showing whether the startup option is currently enabled.
- Added `burner-fuel-leeching` to Gizmod Core Registry capabilities.

---

# Gizmod 0.2.8 patch note

- Added Q/ESC close handling for the GZ Hub.
- The GZ Hub frame now clears player.opened before destruction so ESC does not leave stale GUI state.
- Updated the GZ button tooltip to document L open and Q/ESC close.

---

# Gizmod 0.2.5 patch note

- Folded Color UI style behavior into Gizmod core as built-in GZ UI color controls.
- Added startup settings for enabling the color mask, choosing RGBA tint, and selecting white level 1-12.
- Added local Gizmod graphics paths for the GUI brightness variants.
- Added `gz-ui-color-core` to the core registry capabilities.
- Added a hard conflict with external `colorui` so the standalone mod and core implementation do not both mutate GUI sprites.

---

# Gizmod 0.2.4 patch note

- Removed the hardcoded legacy Economy tab from the GZ Hub.
- GZ Hub now treats GZ Economy as warehouse/Supply Depot only, even if an older Economy build tries to register an Economy panel.
- Selecting `economy` through the hub API now falls back to Installed GZ Mods instead of creating a hub tab.
- Other registered external panels still mount normally.

---

# Gizmod 0.2.3 patch note

- Removed the editable Stats GUI tab from the GZ Hub.
- Added a read-only Stats GUI Status section at the bottom of Installed GZ Mods.
- Stats GUI Status shows active/inactive checkboxes for the known StatsGui boxes and the optional movement-speed add-on.
- Added note that StatsGui settings should be changed from Factorio's normal Mod Settings menu.
- Replaced the prior direct StatsGui bridge capability with read-only `statsgui-status-surface`.
- Corrected the GZ Hub button tooltip to show the current L hotkey.

---

# Gizmod 0.2.2 patch note

- Added duplicate-safe handling for registry-mounted Economy panels.
- If a registered external panel matches `economy`, Gizmod skips the legacy hardcoded Economy tab.
- Older GZ Economy builds still get the fallback hardcoded Economy tab.

---

# Gizmod 0.2.1 patch note

- Added registry-mounted external GZ Hub panels.
- External mods can register `panels` entries through `remote.call("gizmod", "register", spec)`.
- Hub now renders registered external panels as first-class tabs before Installed GZ Mods.
- This lets GZ-RPG mount its RPG panel inside the Gizmod container instead of using a standalone button.

---

# Gizmod 0.1.9 patch note

- Added GZ Hub hotkey / embedded settings integration pass.
- Current patch generated in ChatGPT workspace.

---

# Gizmod ACTIVE

## 0.1.8 - Direct StatsGui Bridge in Gizmod

- Moved the StatsGui bridge behavior into Gizmod.
- Gizmod now writes StatsGui runtime-per-user settings directly from the GZ Hub.
- Patched StatsGui 1.6.2 is no longer required for the hub controls.
- Optional StatsGui dependency lowered back to `? StatsGui >= 1.6.1`.
- Stats GUI tab now reports that Gizmod owns the bridge surface when settings are available.
- Added registry capability `statsgui-direct-settings-bridge`.

## 0.1.7 - GZ Hub / StatsGui Settings Mirror

- Added `lib/hub.lua` as the unified GZ Main Hub surface.
- Added top-left `GZ` hub button plus `/gzhub` command.
- Added tabbed GZ Hub container with:
  - GZ Hub registry overview.
  - Gizmod floating text/icon settings.
  - Stats GUI per-player settings mirror when StatsGui is installed.
  - One metadata tab for each registered Gizmod-family mod.
- Hid Gizmod runtime-global settings from the normal game settings menu so GZ options move into the hub.
- Added optional dependency on StatsGui for clean in-game settings mirroring.
- Existing registry/floating text APIs remain unchanged.

# Gizmod 0.1.4 Active Notes

## Fixed

- Floating icons no longer read or write `LuaRenderObject.tint` during `on_tick`.
- Sprite icons still float upward and expire at TTL; they just do not alpha-fade at runtime.
- This fixes the crash: `LuaRenderObject doesn't contain key tint`.


## Hotfix

- Removed custom font prototype definitions.
- Floating text now uses vanilla built-in Factorio fonts directly:
  - magic -> default-large-bold
  - standard -> default-bold
- Fixes startup failure: `font prototype ... Locale font paths are empty`.

---

# Gizmod 0.1.2 Active Notes

## Added

- Shared floating text service using `rendering.draw_text`.
- Shared floating icon service using `rendering.draw_sprite`.
- Shared floating combo service for icon + text events.
- Runtime damage number listener.
- Remote API on the existing `gizmod` interface:
  - `floating_text(spec)`
  - `floating_icon(spec)`
  - `floating_combo(spec)`
  - `damage_number(spec)`
  - `floating_text_status()`
  - `clear_floating_text()`
- Commands:
  - `/giztext <message>`
  - `/gizicon <sprite>`
  - `/gizcombo <sprite> <message>`
  - `/gizfloat`

## Settings

- `gizmod-enable-floating-text`
- `gizmod-enable-damage-numbers`
- `gizmod-floating-text-color-mode`
- `gizmod-floating-text-style`
- `gizmod-floating-text-ttl`
- `gizmod-floating-text-max-active`

## Remote API examples

    remote.call("gizmod", "floating_text", {
      text = "Bioflux fed",
      surface = player.surface,
      position = player.position,
      ttl = 90,
      style = "magic",
      color_mode = "bordered-white"
    })

    remote.call("gizmod", "floating_icon", {
      sprite = "item.bioflux",
      surface = player.surface,
      entity = player.character,
      ttl = 90,
      scale = 0.75
    })

    remote.call("gizmod", "floating_combo", {
      sprite = "item.bioflux",
      text = "+ fed",
      surface = player.surface,
      entity = player.character,
      ttl = 90,
      style = "magic",
      color_mode = "bordered-white"
    })

    remote.call("gizmod", "damage_number", {
      amount = 42,
      entity = event.entity
    })

## Notes

- Uses built-in Factorio fonts only. No bundled external font file.
- Uses `rendering.draw_sprite` for icons and `rendering.draw_text` for text.
- `Max floating texts on screen` counts floating events, including icon-only and icon+text combos.