CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[2.0.27] - 2026-04-06

Added

• Native Unified Template Library Plan (Local Pending Patch): The pending native editor notes now track a unified "Template Library" surface mixing built-ins, saved slots, and history, so the C++ editor can mirror the newly shipped web and Java template-ecosystem workflow once the lock clears.

Changed

• Bumped local version to 2.0.27.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these unified-library follow-ups can be committed.

[2.0.26] - 2026-04-06

Added

• Native Template-to-Slot Shortcut Plan (Local Pending Patch): The pending native editor notes now track direct built-in-template slot saves so the C++ editor can mirror the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.26.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these template-slot follow-ups can be committed.

[2.0.25] - 2026-04-06

Added

• Native Template Browser Plan (Local Pending Patch): The pending native editor notes now track a browsable built-in template catalog so the C++ editor can mirror the newly shipped web and Java preset-summary workflow once the lock clears.

Changed

• Bumped local version to 2.0.25.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these template-browser follow-ups can be committed.

[2.0.24] - 2026-04-06

Added

• Native Compact Preset Family Plan (Local Pending Patch): The pending native editor notes now track grouped preset families plus curated starter templates so the C++ editor can mirror the newly shipped web and Java preset-browsing workflow once the lock clears.

Changed

• Bumped local version to 2.0.24.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these preset-family follow-ups can be committed.

[2.0.23] - 2026-04-06

Added

• Native Saved Template Slot Summary Plan (Local Pending Patch): The pending native editor notes now track compact saved-template slot summaries so the C++ editor can match the newly shipped web and Java template-recognition workflow once the lock clears.

Changed

• Bumped local version to 2.0.23.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these saved-template UX follow-ups can be committed.

[2.0.22] - 2026-04-05

Added

• Native Conversion-Pair Editing Plan (Local Pending Patch): The pending native editor notes now track focused first-pass touching-block conversion authoring so the C++ editor can align with the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.22.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these conversion-pair follow-ups can be committed.

[2.0.21] - 2026-04-05

Added

• Native Advanced Field-Effect Toggle Plan (Local Pending Patch): The pending native editor notes now track engine-backed field-effect toggles for gravity-ignore and field-wide color effects so the C++ editor can align with the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.21.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these field-effect follow-ups can be committed.

[2.0.20] - 2026-04-05

Added

• Native Block Gameplay Hooks Plan (Local Pending Patch): The pending native editor notes now track reward-piece assignment plus focused chain-behavior hooks for selected blocks so the C++ editor can align with the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.20.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these gameplay-hook follow-ups can be committed.

[2.0.19] - 2026-04-05

Added

• Native Richer Block Color Set Editing Plan (Local Pending Patch): The pending native editor notes now track multi-color block palette authoring so the C++ editor can align with the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.19.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these richer block palette follow-ups can be committed.

[2.0.18] - 2026-04-05

Added

• Native Deeper Block Rule Editing Plan (Local Pending Patch): The pending native editor notes now track focused second-pass block-rule controls like special colors, special chance/frequency, flashing, match-any-color, and counter behavior so the C++ editor can align with the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.18.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these deeper block-rule follow-ups can be committed.

[2.0.17] - 2026-04-05

Added

• Native Block Type / Color Controls Plan (Local Pending Patch): The pending native editor notes now track focused block authoring controls and piece block override assignment so the C++ editor can align with the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.17.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these block-authoring follow-ups can be committed.

[2.0.16] - 2026-04-05

Added

• Native Recent Action Breadcrumbs Plan (Local Pending Patch): The pending native editor notes now track a bounded recent-action panel for meaningful editor operations so the C++ editor can align with the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.16.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these breadcrumb-workflow follow-ups can be committed.

[2.0.15] - 2026-04-05

Added

• Native Center-All Helper Plan (Local Pending Patch): The pending native editor notes now track one-click centering of every rotation in the selected piece so the C++ editor can align with the newly shipped web and Java geometry workflow once the lock clears.

Changed

• Bumped local version to 2.0.15.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these center-all follow-ups can be committed.

[2.0.14] - 2026-04-05

Added

• Native Recent Share / Import History Plan (Local Pending Patch): The pending native editor notes now track bounded recent-history recall for imported/shared rulesets so the C++ editor can align with the newly shipped web and Java workflow once the lock clears.

Changed

• Bumped local version to 2.0.14.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these history-workflow follow-ups can be committed.

[2.0.12] - 2026-04-05

Added

• Native Empty Rotation Cleanup Plan (Local Pending Patch): The pending native editor notes now track one-click empty-rotation cleanup so the C++ editor can align with the newly shipped web and Java cleanup workflow once the lock clears.

Changed

• Bumped local version to 2.0.12.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these cleanup follow-ups can be committed.

[2.0.8] - 2026-04-05

Added

• Native Preset Shortcut Plan (Local Pending Patch): The pending native editor notes now track one-click classic preset buttons so the C++ editor can align with the newly shipped web and Java shortcut workflow once the lock clears.

Changed

• Bumped local version to 2.0.8.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these shortcut-workflow follow-ups can be committed.

[2.0.7] - 2026-04-05

Added

• Native Preset Slot Plan (Local Pending Patch): The pending native editor notes now track quick preset save/load slots so the C++ editor can stay aligned with the newly shipped web and Java iteration workflow once the lock clears.

Changed

• Bumped local version to 2.0.7.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these editor workflow follow-ups can be committed.

[2.0.6] - 2026-04-05

Added

• Native Movement / Randomizer Toggle Plan (Local Pending Patch): The pending native editor notes now track parity for next-piece, hold-piece, bag/randomizer, hard-drop punch-through, and movement/kick rule toggles so the C++ port can align with the newly shipped web and Java editors once the lock clears.

Changed

• Bumped local version to 2.0.6.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these editor-authoring follow-ups can be committed.

[2.0.5] - 2026-04-05

Added

• Native Advanced Rule Toggle Plan (Local Pending Patch): The pending native editor notes now track parity for advanced gameplay-rule toggles so the C++ port can align with the newly shipped web and Java editors once the lock clears.

Changed

• Bumped local version to 2.0.5.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these editor-authoring follow-ups can be committed.

[2.0.4] - 2026-04-05

Added

• Native Rotation Overview (Local Pending Patch): The pending native custom editor patch is now documented to include direct rotation-overview navigation so it can stay aligned with the web and Java editors once the lock clears.

Changed

• Bumped local version to 2.0.4.

Validation

• Native repo is still waiting on the existing workspace submodule lock before these follow-up editor UX changes can be committed.

[2.0.3] - 2026-04-05

Added

• Native Duplication Workflow (Local Pending Patch): The local native custom editor patch now includes duplicate-piece and duplicate-rotation controls so parity stays aligned with the web and Java editors.

Changed

• Bumped local version to 2.0.3.

Validation

• Native git remains blocked by the existing workspace submodule lock, so this duplication patch is documented locally and waiting to be committed.

[2.0.2] - 2026-04-05

Added

• Native Delete Controls: The local native custom editor patch now includes remove-piece and remove-rotation controls alongside the earlier add/clear/navigation actions.

Changed

• Bumped local version to 2.0.2.
• Native editor state now recovers selection after destructive edits.

Validation

• Ran git diff --check on the custom editor source files after the follow-up patch.

[2.0.1] - 2026-04-05

Added

• Native Custom Piece Editing: src/Puzzle/CustomGameEditor.cpp now supports live piece creation, rotation creation, rotation clearing, piece/rotation navigation, and an interactive 4x4 cell grid for editing rotation block offsets.
• Editor State Summary: Added native labels showing current piece, current rotation, total piece count, total rotation count, current filled-cell count, and key rule summary fields.

Fixed

• Header / Implementation Drift: src/Puzzle/CustomGameEditor.h now correctly declares CustomGameEditorControl, matching the existing implementation and references in BobsGame.h / OKGame.h.

Changed

• Bumped version to 2.0.1.

Validation

• Ran git diff --check against src/Puzzle/CustomGameEditor.h and src/Puzzle/CustomGameEditor.cpp with no whitespace/errors reported.

[1.7.0] - 2026-03-18

Added

• Visualizer Shaders Modernization: Restored the projectM submodule to the C++ build.
• SDL3 Compatibility: Modernized internal projectM shader source generation to use #version 330 core (replacing the deprecated #version 330), satisfying the strict requirements of modern OpenGL context profiles requested by SDL3.

Changed

• Bumped version to 1.7.0.
• Re-enabled add_subdirectory(lib/projectm) and linked the projectM target in okgame/CMakeLists.txt.

[1.6.0] - 2026-03-18

Added

• C++ Network Engine: Integrated Poco::Net::WebSocket and Poco::JSON to build a native C++ NetworkManager compatible with the Node.js socket.io server.
• C++ Matchmaking UI: Created GameSelectorMenuPanel and LobbyMenuPanel using the native BobMenu UI system.
• Unified Multiplayer: C++ engine now natively supports querying the server for active rooms, creating rooms, and joining rooms across platforms.

Changed

• Bumped version to 1.6.0.
• okgame/CMakeLists.txt updated to link Poco::Net, Poco::JSON, Poco::Util, and Poco::Foundation.
• Refactored NDButton in C++ to open the new GameSelector rather than directly launching the offline engine.

[1.5.0] - 2026-03-17

Added

• Java Lobby Leaderboard: LobbyScreen.java in the Java fork now displays real-time high scores for Marathon mode, matching the Web client's functionality.
• Improved Matchmaking: Upgraded NetworkManager.java to support fetching leaderboards and handling overloaded room management methods.
• Aesthetic Polish: Added emoji icons (🔒) to password-protected rooms in the Java lobby list for better visual feedback.

Fixed

• Improved thread safety in Java network callbacks by ensuring all UI updates are posted to the main application thread.

Changed

• Bumped version to 1.5.0.

[1.4.0] - 2026-03-17

Added

• Matchmaking UI Polish: Added support for creating and joining private rooms with passwords across both Java and Web clients.
• Node.js Server: Server now properly parses stringified objects when receiving createRoom and joinRoom events to support multiple client architectures.

Changed

• Bumped version to 1.4.0.

[1.3.0] - 2026-03-17

Added

• Java Lobby Screen: Implemented a full-featured LobbyScreen in Java using Scene2D, featuring dynamic room listing, joining, and creation.
• Improved Engine Accessors: Added static accessors (Engine.GUIManager(), Engine.ND()) to the base Engine class for cleaner inter-component communication in Java.
• Global Network Manager: Refactored the Java client to use a persistent, global NetworkManager instance, enabling cross-scene multiplayer state.

Fixed

• Resolved circular dependency issues in Java UI initialization by lazy-loading components in GUIManager.
• Corrected button routing in Java GameSelector to point to the new LobbyScreen.
• Fixed initialization bugs in Java Block and BobColor serialization.

Changed

• Bumped version to 1.3.0.
• LobbyScreen in Java now polls for room updates every 5 seconds, matching the Web fork's behavior.

[1.2.0] - 2026-03-17

Added

• Client Settings UI: Added SettingsScene.ts to the Web fork to allow users to customize their display name.
• LocalStorage Persistence: Web client now saves and loads the playerName via the browser's localStorage API.
• Java Player Identity: The Java client now appends a pseudo-random identifier (JavaPlayer_XXX) to distinguish multiple instances when reporting scores.

Changed

• Bumped version to 1.2.0.
• Web MainMenuScene.ts updated to route the "Settings" button to the new SettingsScene.

[1.1.0] - 2026-03-17

Added

• Matchmaking Persistence: Implemented robust JSON-based file persistence for leaderboards (leaderboards.json) in the Node.js server.
• Web Lobby Leaderboard: LobbyScene.ts in the Web fork now requests and displays real-time top scores for Marathon mode next to the active room list.
• Cross-Platform Score Reporting: Both Java and Web clients now automatically send telemetry (score, lines, time) to the server's reportScore endpoint when a game over event triggers.
• Audio Polish (C++): Updated AudioManager.cpp visualizer callbacks to correctly utilize the new SDL3_mixer signature (MIX_PostMixCallback) and correctly convert float streams to 16-bit integers.

Fixed

• Fixed C++ AudioManager buffer iteration handling for projectM audio data injections.
• Addressed potential parsing failures in Node.js server when handling stringified JSON payloads from Java's Gson library.

Changed

• Bumped version to 1.1.0.

[1.0.0] - 2026-03-17

Added

• Full Multiplayer Cross-Play: Java and Web clients can now play in the same rooms with synchronized PRNG seeds and real-time board visualization.
• Java Opponent Board: Implemented real-time opponent board rendering in the Java fork, side-by-side with the player board.
• Java GameSelector Menu: Created a new Scene2D menu in Java to choose between local and network play.
• Synchronized Room Lifecycle: Java client now correctly handles gameStart and joinedRoom events from the Node.js server.
• High-Frequency Sync (Java): Java BobsGame now sends state frames every 5 frames, matching the Web fork's performance.

Fixed

• Re-added removeListener and optimized NetworkManager lifecycle in Java to prevent event duplication.
• Fixed NullPointerException risks in Java Block and Grid state application.
• Cleaned up Java BobsGame initialization flow to support async network events.

Changed

• Bumped version to 1.0.0.
• Unified the "Multiplayer Lobby" experience across both primary forks.

[0.9.0] - 2026-03-17

Added

• Complete API parity in Java NetworkManager including listRooms, createRoom, joinRoom, sendFrame, and customizable on event listeners.
• Implemented GameStateData POJOs in Java GameLogic for robust JSON serialization via Gson.
• Java Grid and GameLogic now support full getState() and applyState() operations matching the Web fork.
• BobColor utility in Java now supports toInt() and fromInt(int) static parsers for compact color serialization.

Fixed

• Re-added NetworkManager constructor and removeListener cleanup in GameLogic to prevent memory leaks during state transitions.
• Adjusted Block initialization in Grid.applyState to match correct constructor signatures.
• Cleaned up obsolete test directories in bobsgameonlinejava that referenced missing/refactored internal packages.

Changed

• Bumped version to 0.9.0.
• NetworkManager now maintains a HashMap of listeners internally, allowing event subscriptions before socket connection is fully established.

[0.8.0] - 2026-03-17

Added

• Real-time opponent board rendering in Web fork (isOpponent config in PuzzleRenderer).
• High-frequency "Frame Synchronization" in Web multiplayer via getState/applyState.
• Web NetworkManager now extends EventEmitter for robust internal event handling.
• Integrated BobColor serialization into Grid state for accurate cross-client board visualization.

Fixed

• Multiple TypeScript type errors in Grid.ts, Block.ts, and NetworkManager.ts.
• Resolved EventEmitter override conflicts in Web networking layer.
• Corrected Block instantiation in applyState to use proper grid and blockType references.

Changed

• Bumped version to 0.8.0.
• PuzzleScene layout updated to side-by-side boards in multiplayer mode.

[0.7.0] - 2026-03-17

Added

• Mock business logic in Java LoginScreen and CreateNewAccount for immediate state transitions.
• Fully simulated Steamworks SDK linking with local stubs (lib/steam) so okgame can compile with HAVE_STEAMWORKS=1.
• Web Lobby transition logic: LobbyScene now correctly waits for a gameStart server event before pushing the PuzzleScene.
• Full room lifecycle in Node.js server (creates room, waits for max players, then emits gameStart with synced seed).

Changed

• Bumped version to 0.7.0.
• NetworkManager connect method safely ignores redundant connection attempts, allowing seamless LobbyScene to PuzzleScene transitions.

[0.6.0] - 2026-03-17

Added

• Completed Java UI migration from legacy TWL to modern LibGDX Scene2D.
• Ported all core menus (LoginScreen, StuffMenu, GameStore, PlayerEditMenu, etc.) to Scene2DPanel architecture.
• Fully implemented interactive LobbyScene in Web fork with dynamic room list and room creation.
• Unified UI lifecycle management in Java Engine class using Stage and Skin.
• Added compatibility stubs for legacy Java menus to ensure stable build during migration.

Fixed

• Resolved multiple TypeScript errors in bobsgameweb related to scene management and networking.
• Fixed StateManager type reference in Web fork by exporting StateManagerClass.
• Corrected various layout and theme issues in the Java fork.

Changed

• Bumped version to 0.6.0.
• Modernized base Scene class in Web fork to store configuration and manager references.

[0.5.2] - 2026-03-17

Added

• Integrated LibGDX Stage and Skin into the base Engine class for modern UI support in Java.
• Created Scene2DPanel base class in Java to replace legacy MenuPanel with LibGDX Scene2D.
• Modernized CreateNewAccount screen in Java using TextField, Label, and TextButton.
• Enhanced Node.js socket.io server with room creation, joining, and listing logic.
• Added LobbyScene.ts shell to Web fork for multiplayer room management.

Fixed

• Fixed UI layout consistency in Java fork by centralizing Skin management in GLUtils.

Changed

• Bumped version to 0.5.2.

[0.5.1] - 2026-03-17

Added

• SteamManager in C++ fork (stubbed implementation for Steamworks SDK).
• NetworkManager in Java fork using socket.io-client-java for unified multiplayer.
• GameLogicListener interface in Java to match TypeScript EventEmitter patterns.

Fixed

• Fixed missing SpriteManager in BobsGameStadium.java.
• Restored missing GLUtils.java drawing methods for broad codebase compatibility.
• Fixed SDL_SetWindowFullscreen parameter change in SDL3.

Changed

• Bumped version to 0.5.1.
• Updated BobsGame.java to support optional network initialization.

[0.5.0] - 2026-03-17

Added

• Advanced Java Renderer with Sprite support in LibGDX.
• Automatic batch/shape state switching in GLUtils.java for optimized Java rendering.
• NetworkManager in TypeScript fork using socket.io-client.
• Simple WebSocket server in bobsgameweb/server for multiplayer testing.
• garbageSent event in GameLogic for multiplayer synchronization.

Fixed

• Fixed 10+ TypeScript compilation errors in bobsgameweb.
• Corrected SDL3 Gamepad button/axis constants in ControlsManager.cpp.
• Fixed performance-heavy state switching in Java renderer.

Changed

• Bumped version to 0.5.0.
• Modernized LibretroGame.cpp to use SDL_AudioStream for better audio quality and compatibility.

[0.4.0] - 2026-03-16

Added

• GameManager interface in Java fork to unify BobsGame and BobsGameStadium engines.
• SDL3 support in C++ fork (modernized main.cpp and ControlsManager).
• Parity fields in Java BlockType to match TypeScript and C++ expectations.

Fixed

• All compilation errors in bobsgameonlinejava.
• Redundant enum definitions in Java fork (unified into GameType.java).
• SDL3 event and gamepad constant naming in C++ fork.

Changed

• Bumped version to 0.4.0.
• Modernized ControlsManager to use SDL_Gamepad API.

[0.3.0] - 2026-03-08

Added

• Synchronized Puzzle logic across C++, Java, and TypeScript forks.
• Ported GameLogic, Grid, Block, Piece, and GameType properties and methods to Java and TS.
• Implemented full chain detection logic using GameType rules in all forks.
• Added 25+ standard easing functions to Easing class.

Changed

• Modernized Java version to Java 21 and LibGDX 1.12.1.
• Consolidated Java source tree into src/main/java.
• Upgraded C++ version to SDL3 (In Progress).
• Refactored Piece architecture to use static inner classes for Rotation and BlockOffset.

[0.2.0] - 2026-03-07

Changed

• Initial consolidation of Java fork.
• Modernized Networking to Netty 4.
• Added LibGDX dependency foundation.

Added

• GitHub Actions CI/CD pipeline (.github/workflows/build.yml)
• Windows build with VS2022, Ninja, MSVC
• Linux build with GCC, Ninja, ccache
• Submodule and build caching for faster CI runs
• Concurrency control to cancel stale builds

[0.1.7] - 2025-01-11

Added

• Comprehensive AGENTS.md with full project documentation (architecture, conventions, code map).
• Subdirectory AGENTS.md files for src/Engine/, src/Puzzle/, src/Utility/.
• Complete SUBMODULES.md dashboard documenting all 89 submodules with versions.
• Created .github/copilot-instructions.md for VS Code Copilot integration.

Changed

• Rewrote CLAUDE.md, GEMINI.md, GPT.md to reference LLM_INSTRUCTIONS.md as master.
• Standardized LLM instruction files with role-specific focus areas.

[0.1.6] - 2025-12-27

Changed

• Updated all submodules to latest versions (merged upstream changes).
• Fixed lib/SDL, lib/SDL_image, lib/SDL_mixer, lib/SDL_ttf, lib/SDL_net to track SDL2 branch to avoid conflicts with SDL3.
• Updated SUBMODULES.md with detailed version and date information.
• Merged feature branches into main.

[0.1.5] - 2025-12-27

Fixed

• Refactored EnginePart::getCurrentMap and Entity::getCurrentMap to return std::shared_ptr<Map>.
• Updated BobEvent, Cameraman, RandomCharacter to match the new getCurrentMap signature.
• Updated RamioGuy::render and ScreenSprite::render to use std::shared_ptr<BobTexture>.
• Fixed Gwen GetModuleFileNameW error by using GetModuleFileNameA.
• Fixed Map.h include path for CTPL.

[0.1.4] - 2025-12-27

Fixed

• Fixed build error in ProjectM.hpp (missing include Renderer/RenderContext.hpp).
• Fixed build error in Entity.h (covariant return type mismatch).
• Fixed ControlsManager.h syntax error.
• Fixed BobSprite.h include path.

[0.1.3] - 2025-12-25

Changed

• Refactored BobsGame static texture members to use std::shared_ptr.
• Updated Grid.cpp to use .get() for texture rendering calls.
• Centralized versioning to VERSION.md.
• Updated version.php to read from VERSION.md.
• Consolidated LLM instructions into LLM_INSTRUCTIONS.md.
• Updated ROADMAP.md and SUBMODULES.md.

[0.1.2] - 2025-12-25

Added

• Implemented preset loading for projectM visualizer in BobsGame::init().
• Completed visualizer integration (Build, Render, Input, Preset Loading).

[0.1.1] - 2025-12-25

Added

• Integrated projectM build configuration in CMakeLists.txt.
• Updated AGENTS.md to reference LLM_INSTRUCTIONS.md.

[0.1.0] - 2025-12-25

Added

• Initial changelog creation.
• Added VERSION.md and version.txt for centralized versioning.
• Added LLM_INSTRUCTIONS.md for unified AI agent instructions.
• Added SUBMODULES.md dashboard for submodule management.
• Added ROADMAP.md to track project progress.

Changed

• Consolidated LLM instructions into LLM_INSTRUCTIONS.md.
• Updated AGENTS.md to reference the central instructions.