Debugging

Real-Time Weapon Behavior Analysis

Overview

The ARS plugin provides two complementary approaches for recoil/spread debugging and visualization:

Debugging and Visualization

🔧 Component-Based Debugging

Step-by-Step Configuration:

  1. Locate ARSRecoilSpreadManager

  • Open your character controller

  • Navigate to Components panel → ARSRecoilSpreadManager

  1. Access Debug Settings

  • Find Debug Setting In Details panel

  1. Toggle Debug States

Property
Effect
Recommended Use

bEnableDebug

Global debug visualization

Testing both Player and NPC weapons

bDebugLocalPlayerOnly

Player-centric debug

Focused player testing

Best Practice: ✅ Keep bDebugLocalPlayerOnly=True during multiplayer tests to avoid visual clutter


⌨️ Console Commands:

You can use Unreal Editor console commands to eaisly enable/disable debug visualization. You can type below commands to 'cmd' see in Unreal Editor while editor is running.

Essential Commands

Command
Scope
Usage Example (Disable: 0 | Enable: 1)

ars.EnableDebug [0/1]

Global toggle

ars.EnableDebug 1

ars.EnableDebugLocalPlayerOnly [0/1]

Player-specific

ars.EnableDebugLocalPlayerOnly 0


🔍 Troubleshooting Guide

Issue
Solution

No debug visuals

1. Verify ARSRecoilSpreadManager exists 2. Check console command spelling

Local player debug not working

Run ars.EnableDebug 1 first

Performance drops

Disable debug in shipping builds


Last updated