ggj2026/AGENTS.md

GGJ2026 Agent Notes

These notes are for coding agents working in this repo. Keep them short, actionable, and up to date.

Project Overview

• Unity project (2D). Main code in Assets/Scripts/.
• Input uses Unity Input System with Assets/InputSystem_Actions.inputactions.
• Scene of interest: Assets/Scenes/Level1.unity.

Input/Controllers

• Player controllers are PlayerPlatformerController and PlayerPickupController.
• Each controller instantiates its own InputActionAsset and can filter to a specific device.
• Device filtering is based on:
  • controlSchemeName == "Gamepad" and/or
  • gamepadIndex >= 0.
• When no matching gamepad is available, controllers ignore input until the device appears.
• Gamepad index inference:
  • actionMapName = Player -> index 0
  • actionMapName = Player2/Player3/... -> index (N-1)
• If you add/rename action maps, update inference or set gamepadIndex explicitly.

Level1 Scene Notes

• Player 2/3/4 are placed directly in the scene and set to Gamepad.
• Current expected indices:
  • Player2 -> gamepadIndex: 0
  • Player3 -> gamepadIndex: 1
  • Player4 -> gamepadIndex: 2
• If you want a 4th controller player, set gamepadIndex: 3 and ensure controlSchemeName: Gamepad.

Prefabs

• Assets/Prefabs/Player.prefab defaults to controlSchemeName: Keyboard&Mouse and gamepadIndex: -1.
• If you instantiate players at runtime, set gamepadIndex and controlSchemeName per player.

Editing Tips

• Use rg for searches (rg -n "term" Assets).
• Prefer apply_patch for small edits.
• Avoid touching Library/, Temp/, and Logs/.