--- name: roblox-combat-systems description: Design, implement, and review Roblox combat systems. Use for melee, ranged, abilities, cooldowns, hit detection, damage validation, status effects, enemy AI hooks, combat UI, balance knobs, VFX/SFX, and exploit-resistant remotes. --- # Roblox Combat Systems ## Goal Make combat readable, responsive, and server-authoritative. ## Authority - Let the client request intent, animation, aim direction, or target candidate. - Let the server validate range, cooldown, line of sight, team, state, and damage. - Never let the client decide final hit, damage, reward, kill credit, or loot. - Rate-limit combat remotes. - Use deterministic balance tables shared or mirrored carefully. ## Combat Loop Design: - Anticipation, action, impact, recovery. - Clear cooldowns and ability availability. - Strong feedback for hit, miss, crit, block, dodge, and death. - Enemy tells and fair counterplay. - Early encounters that teach through safe repetition. ## Implementation Areas - Hitboxes and raycasts. - Cooldown and stamina/energy systems. - Damage types and modifiers. - Status effects with duration, stacking, and cleanup. - Enemy AI target selection and leash rules. - Reward grants tied to server-confirmed contribution. ## MCP Workflow 1. Locate combat scripts with `script_search` and `script_grep`. 2. Read attack, damage, enemy, and reward scripts with `script_read`. 3. Inspect remotes and combat instances with `search_game_tree` and `inspect_instance`. 4. Edit with `multi_edit`. 5. Playtest attacks using `start_stop_play`, `user_keyboard_input`, `user_mouse_input`, and `screen_capture`. 6. Check `get_console_output`. ## Output Return: - Combat state flow. - Server validations. - Balance knobs. - Feedback hooks. - Exploit and regression tests. ## Next Validate every combat remote and damage path with `roblox-security-economy`, add impact with `roblox-animation-audio-feedback`, and verify with `roblox-playtest-qa` and `roblox-mobile-playtest`.