CatSkinC

Added

• Myopia skin LOD for CatSkinC-managed remote skins. When enabled, distant players use lazily cached, pixel-perfect half, quarter, or eighth-resolution copies while GUI, inventory, and tab-list skins retain full resolution.
• A Myopia settings screen with an enabled toggle, a 4–128 block base-distance control, Normal and Panicked modes, and links to Minecraft's keybinding menu.
• Default keybindings for increasing and decreasing the Myopia range with the Up and Down arrow keys. All settings are persisted in catskinc.json.
• WebSocket client using native java.net.http.WebSocket (Java 11+) for high-performance real-time skin sync.
• Automatic protocol negotiation — client sends x-catskinc-protocol: 3 header on WebSocket handshake.
• Resilient connection management:
  • Exponential backoff reconnection (1.5s → 60s max).
  • Shared circuit breaker across REST, SSE, and WebSocket (unified failure tracking).
  • Automatic fallback to SSE when WebSocket fails or protocol is unsupported.
• Session-token authentication on WebSocket with auto-subscription to local player UUID.
• Protocol version verification in welcome message — closes connection on mismatch.
• In-game toast notifications for WebSocket-originated events (skin updates, server messages).

Changed

• Join flow now attempts WebSocket first, falls back to SSE on failure.
• Shared circuit breaker state between ServerApiClient and WebSocketClient — REST/SSE/WS failures all contribute to the same breaker.
• Heartbeat handling — application-level JSON ping/pong (30s) replaces binary WebSocket ping frames for consistency.
• Managed-skin texture cleanup now also releases all associated Myopia GPU textures and resets per-player LOD state.

Fixed

• Broadcast framing — WebSocket clients now receive raw JSON (SSE data: prefix stripped server-side).
• Handshake protocol header — added X-CatSkinC-Protocol to WebSocket upgrade request.
• Auth race — session token acquired synchronously before WebSocket connection attempt.
• Protocol defense — client verifies protocol_version in welcome message, closes on mismatch.
• Fallback trigger — SSE fallback now activates on abnormal post-connect disconnections, not just initial connect failure.
• Toast handler — implemented proper Toasts.info() with translatable titles.
• Select-Fetch race eliminated: selectSkin() now chains thenRun(refresh) so the POST completes before the GET, eliminating the 4-8s skin delay after upload.
• Pending selections cache: PENDING_SELECTIONS returns the uploaded skin URL immediately after select, avoiding old-skin flashing.
• LAST_CHECK on success only: failed fetches no longer reset the 5s poll timer, preventing a 15s blackout window.
• Fast-retry after null skin: retries fetch in 2s when the server has no cached skin yet, reducing initial sync from 15s to 2s.
• Poll interval reduced: 15s → 5s for faster periodic sync.
• SSE clear-skin handling: clears BASE_CACHE/TALKING_CACHE on null URL, so players properly revert to the default skin.
• SSE reconnect delay: added 1.5s–60s exponential backoff on stream close (was instant reconnect), preventing server flooding.
• Circuit breaker in SSE: SSE checks circuitOpenUntilMs before connecting, eliminating useless retries during outage.
• AtomicInteger: consecutiveFailures switched to AtomicInteger for correct failure counting.
• Always destroy old textures: removed identity check gate on texture release to prevent GPU memory leaks.
• Fixed HTTP 401 on skin downloads: Added signDownloadUrl() method that appends ?exp=&sig= HMAC-signed query parameters to download URLs using the client's requestSigningKey. This matches the server's verify_download_signature() check when ENFORCE_SIGNED_DOWNLOADS=true.
• Replaced per-player TextureManager registrations with a single shared dynamic texture: CatSkinC no longer registers per-player textures (catskinc:remote/<uuid>) with the vanilla TextureManager. Instead, downloaded NativeImage objects are cached in SKIN_IMAGES and pixel-copied into one shared catskinc:dynamic/active texture on each render frame. This prevents F3+S debug dumps from saving every player's skin to disk.
• Broadcast framing — WebSocket clients now receive raw JSON (SSE data: prefix stripped server-side).
• Handshake protocol header — added X-CatSkinC-Protocol to WebSocket upgrade request.
• Auth race — session token acquired synchronously before WebSocket connection attempt.
• Protocol defense — client verifies protocol_version in welcome message, closes on mismatch.
• Fallback trigger — SSE fallback now activates on abnormal post-connect disconnections, not just initial connect failure.
• Toast handler — implemented proper Toasts.info() with translatable titles.
• Select-Fetch race eliminated: selectSkin() now chains thenRun(refresh) so the POST completes before the GET, eliminating the 4-8s skin delay after upload.
• Pending selections cache: PENDING_SELECTIONS returns the uploaded skin URL immediately after select, avoiding old-skin flashing.
• LAST_CHECK on success only: failed fetches no longer reset the 5s poll timer, preventing a 15s blackout window.
• Fast-retry after null skin: retries fetch in 2s when the server has no cached skin yet, reducing initial sync from 15s to 2s.
• Poll interval reduced: 15s → 5s for faster periodic sync.
• SSE clear-skin handling: clears BASE_CACHE/TALKING_CACHE on null URL, so players properly revert to the default skin.
• SSE reconnect delay: added 1.5s–60s exponential backoff on stream close (was instant reconnect), preventing server flooding.
• Circuit breaker in SSE: SSE checks circuitOpenUntilMs before connecting, eliminating useless retries during outage.
• AtomicInteger: consecutiveFailures switched to AtomicInteger for correct failure counting.
• Always destroy old textures: removed identity check gate on texture release to prevent GPU memory leaks.
• Fixed HTTP 401 on skin downloads: Added signDownloadUrl() method that appends ?exp=&sig= HMAC-signed query parameters to download URLs using the client's requestSigningKey. This matches the server's verify_download_signature() check when ENFORCE_SIGNED_DOWNLOADS=true.
• Replaced per-player TextureManager registrations with a single shared dynamic texture: CatSkinC no longer registers per-player textures (catskinc:remote/<uuid>) with the vanilla TextureManager. Instead, downloaded NativeImage objects are cached in SKIN_IMAGES and pixel-copied into one shared catskinc:dynamic/active texture on each render frame. This prevents F3+S debug dumps from saving every player's skin to disk.
• Security: Request signing (HMAC-SHA256) applied to WebSocket upgrade request.
• Hardened transitive dependencies against Dependabot advisories. Added resolutionStrategy { force ... } constraints in build.gradle to pin patched versions of vulnerable transitive libraries on both the project and buildscript classpaths:
  • Netty → 4.1.136.Final (fixes GHSA-558v-64gr-wgg4 Bzip2Decoder infinite loop and related netty advisories).
  • Log4j → 2.25.4 (fixes Log4j TLS hostname verification, XML escaping, and related advisories).
  • Guava → 32.0.0-jre (fixes temp-dir and information-disclosure advisories).
  • Commons IO → 2.16.1, Commons Compress → 1.26.0, Commons Lang3 → 3.18.0.
  • Buildscript classpath: Commons Text → 1.12.0, Commons Beanutils → 1.11.0, Plexus Utils → 3.6.1.
• These libraries are Minecraft-provided runtime/build-tooling dependencies and are not bundled into the shipped mod JAR, so the end-user artifact is unaffected; the constraints keep the dev runtime and CI dependency graph clean.