jahro-troubleshooting

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

// 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