$ show isHarryh/Ark-Pets
Ark-Pets is a desktop pet simulator application built on Java 17, designed to render Spine 2D character models on the user's desktop with physics simulation and interactive behaviors. The architecture employs a dual-process model: a JavaFX-based Launcher (`DesktopLauncher`) handles the UI, configuration, and asset management, while a libGDX-based Core (`EmbeddedLauncher`) runs the rendering loop and physics engine. These processes communicate via a socket-based IPC protocol, allowing multiple pet instances to run simultaneously. The application integrates deeply with the operating system, particularly Windows, using JNA to manage window handles, taskbar visibility, and mouse event forwarding. It features a custom physics engine (`Plane.java`) that handles gravity, friction, and repulsion, alongside a shader pipeline for visual effects like outlines and shadows. Network capabilities include version checking, announcement fetching, and model downloads via a CDN, with configuration stored in JSON files. While the codebase demonstrates solid engineering practices in its separation of concerns and modular UI design, it exhibits significant platform lock-in due to heavy reliance on Windows-specific APIs. Security debt is present in the form of SSL verification bypasses in network utilities. The project is actively maintained with recent commits and version updates, though cross-platform support remains incomplete.
The LLM identified 4 files worth highlighting for reuse:
Implements a self-contained physics engine handling gravity, friction, barriers, and electrostatic repulsion. The logic is decoupled from rendering, making it reusable for other 2D physics simulations. It demonstrates non-trivial math for collision detection and state transitions.
A hierarchy of transition classes (`TransitionFloat`, `TransitionVector2`) with `EasingFunction` support. This pattern abstracts smooth animation logic, allowing developers to interpolate values over time without managing frame-by-frame updates. It is a reusable pattern for UI and game state animations.
Abstracts background task execution with progress dialogs and error handling. It provides a standardized way to run long-running operations (downloads, file operations) without blocking the JavaFX UI thread. The pattern is easily extractable for other JavaFX applications needing async task management.
Defines the enumeration of operations (LOGIN, LOGOUT, TRANSPARENT_MODE) for the Inter-Process Communication protocol between the Launcher and Core. This centralizes the network contract, making the dual-process architecture maintainable and testable. It demonstrates a clean separation of protocol definition from implementation.