jahro-troubleshooting

Files (1)

• SKILL.md

SKILL.md (first lines)

# Jahro Troubleshooting

Diagnose and fix common Jahro issues. Follow the decision tree for the reported symptom.

## Diagnostic Approach

1. **Identify the symptom** — match to a decision tree below
2. **Walk the tree** — check conditions in priority order
3. **Apply fix** — provide code snippet or configuration change
4. **VERIFY** — "Enter Play Mode, reproduce the original issue"
5. **If still broken** — continue down the tree or escalate

---

## Issue: Commands Not Appearing

The user added `[JahroCommand]` attributes but commands don't show in the console.

### Decision Tree

```
Commands not appearing
├── Is the method static or instance?
│   ├── Instance → Is RegisterObject called?
│   │   ├── No → FIX: Add OnEnable/OnDisable registration
│   │   └── Yes → Is the object active in scene?
│   │       ├── No → Object never enables → RegisterObject never runs
│   │       └── Yes → Continue below
│   └── Static → Continue below
├── Is the correct assembly selected?
│   └── Check Tools → Jahro Settings → Assemblies Selection
│       └── Is the assembly containing this class checked?
│           ├── No → FIX: Select the assembly
│           └── Yes → Continue below
├── Is Jahro enabled?
│   ├── Check Jahro.Enabled at runtime (log it)
│   ├── Check JAHRO_DISABLE in Scripting Define Symbols
│   └── Check Auto-disable + build type
├── Is the method public?
│   └── Private/internal methods → FIX: Make public
├── Are parameter types supported?
│   └── Only: int, float, bool, string, Vector2, Vector3, enum
│       └── Custom class params → FIX: Change to supported type
└── Assembly scanning order issue?
    └── Static commands discovered at startup; if class loaded late,
        try manual RegisterObject or dynamic registration
```

### Fix: Missing RegisterObject

```csharp
// Add to the class with instance [JahroCommand] methods:
void OnEnable()  => Jahro.RegisterObject(this);
void OnDisable() => Jahro.UnregisterObject(this);
```

### Fix: Wrong assembly selected

1. Open **Tools → Jahro Settings → General Settings**
2. Under **Assemblies Selection**, check the assembly containing your class
3. Your main game assembly is typically `Assembly-CSharp`

---

## Issue: Watcher Not Updating

Watcher entries appear but values are frozen or stale.

### Decision Tree

```
Watcher values not updating
├── Is the Watcher tab actually open?
│   └── Values are ONLY read when the Watcher UI is visible
│       └── FIX: Switch to the Watcher tab to see live updates
├── Is RegisterObject called?
│   ├── No → FIX: Add OnEnable/OnDisable registration
│   └── Yes → Continue below
├── Is the watched member a field or property?
│   ├── Field → Updates automatically when value changes
│   └── Property → Check the getter
│       ├── Does the getter reference stale data?
│       ├── Does the getter throw an exception? (silently caught)
│       └── Is it an expensive getter that's being throttled?
├── Was the object destroyed?
│   └── Object destroyed without OnDisable → watcher reads stale reference
│       └── FIX: Ensure UnregisterObject runs (OnDisable handles this)
├── Is it a static watcher?
│   └── Static watchers don't need RegisterObject but do need
│       the assembly selected in Jahro Settings
└── Is Jahro enabled?
    └── Same checks as commands: JAHRO_DISABLE, auto-disable, settings
```

### Fix: Property getter issues

```csharp
// BAD: getter may throw if Rigidbody is destroyed
[JahroWatch("Velocity", "Physics")]
public Vector3 Velocity => GetComponent<Rigidbody>().velocity;

// GOOD: null-safe getter
[JahroWatch("Velocity", "Physics")]
public Vector3 Velocity => TryGetComponent<Rigidbody>(out var rb) ? rb.velocity : Vector3.zero;
```

---

## Issue: Console Not Opening

User presses ~ (or triple-taps) but nothing happens.

### Decision Tree

```
Console not opening
├── Is Jahro enabled?
│   ├── Check Tools → Jahro Settings → Enable Jahro → must be ON
│   ├── Check JAHRO_DISABLE in Player Settings → Scripting Define Symbols

From jahro-console/unity-agent-skills, MIT.

More from jahro-console/unity-agent-skills