sdv-mp-gamepad-audit

The sdv-mp-gamepad-audit skill provides static code analysis to ensure robust multiplayer support and proper gamepad navigation within projects. It addresses the challenge of validating multiplayer interactions, per-player state management, and controller navigation, which are difficult to test reliably at runtime. By auditing code before manual testing, this skill helps developers catch potential issues early, reducing errors related to split-screen play, shared resources, and menu navigation. It focuses on critical areas such as state handling, context checks, mutex locking for shared objects, and unique keying for player-specific data, ensuring consistent and safe behavior across multiple players.

Key features of this skill include a structured audit checklist for per-screen state management using PerScreen<T>, context gating verification to prevent improper access to game world or player states, and mutex handling for shared furniture objects to prevent conflicts. It also enforces proper player data keying for save files and modData to avoid collisions in multiplayer environments, and provides utilities for iterating over all locations in a way that accounts for farmhands and other secondary players. These capabilities make it a comprehensive tool for code review and validation focused on multiplayer mechanics and gamepad input.

This skill is particularly useful for developers working on Stardew Valley mods or similar projects where split-screen multiplayer, per-player state, and controller navigation are important. It is designed to be run before committing changes, creating pull requests, or implementing features that impact multiple players or menus. By following its audit points, developers can ensure their code adheres to best practices for multiplayer safety and gamepad usability, ultimately improving the quality and reliability of their projects.