Stable v0.9v live: major optimization + queue safety update is now production ready. Legacy now includes v0.8v. 1.0v Planned is introduction-only for now.

Command & Cvar Reference

Accurate command list for NeuroDirector v0.9v stable, legacy compatibility, and the 1.0v command set.

Admin Commands

CommandDescriptionPermission
sm_neuro_tankQueue a forced Tank event.Admin
sm_neuro_blackoutTrigger blackout event immediately.Admin
sm_neuro_eventForce random event roll.Admin
sm_neuro_resetReset wipe counter and clear pending queue.Admin
sm_neuro_statusPrint state snapshot (wipes, blackout, queue, failsafe).Admin
sm_neuro_statsPrint spawn attempt/success/fail telemetry.Admin
sm_neuro_reloadcfgReload `sourcemod/neurodirector.cfg` and map profile.Admin
sm_neuro_preset <casual|hard|nightmare|insane>Apply tuned preset profile instantly.Admin
sm_neuro_versionPrint current plugin runtime version.Admin
sm_neuro_validate_mapcfgValidate map override config existence.Admin
sm_neuro_export_statsExport telemetry snapshot to CSV log file.Admin
sm_neuro_savepreset <name>Save current tuning values as named preset file.Admin
sm_neuro_loadpreset <name>Load named preset file from configs folder.Admin
sm_neuro_profilerShow average event/spawn timing metrics.Admin
sm_neuro_healthreportPrint cached survivor status and adaptive scale.Admin
sm_neuro_optimize_lightApply safe low-CPU tuning for weak hosts.Admin
sm_neuro_optimize_ultraApply aggressive low-CPU + max-stability profile.Admin
sm_neuro_optimize_titanApply extreme low-overhead profile (strongest optimization mode).Admin
sm_neuro_optimize_apexApply v0.9 stable apex optimization profile (highest throughput with safety lock).Admin
sm_neuro_queueauditShow queue usage against hard safety limit.Admin
sm_neuro_burstsafeApply stable-FPS burst-safe runtime profile.Admin
sm_neuro_setbudget <1..20>Edit nd_spawn_budget live at runtime.Admin
sm_neuro_settickrange <min> <max>Edit adaptive tick range (nd_spawn_tick_min/max) live.Admin
sm_neuro_setqueue <20..1000>Edit nd_queue_hard_limit live.Admin
sm_neuro_setdispatchms <0.2..10>Edit nd_dispatch_time_budget_ms live.Admin
sm_neuro_spawn_survivor [count]Spawn survivor bots (1-8) near active runtime session.Admin
sm_neuro_spawn_common [count]Queue direct common infected wave.Admin
sm_neuro_spawn_uncommon <type> [count]Spawn specific uncommon type (riot, ceda, clown, mudmen, roadcrew, fallen_survivor).Admin
sm_neuro_spawn_special <type> [count]Spawn specific special/boss type (smoker..charger, tank, witch).Admin
sm_neuro_spawn_prop <index> [count]Spawn supported prop models at aim position (index-driven catalog).Admin
sm_neuro_sethp <target> <hp>Set current health on selected targets.Admin
sm_neuro_setmaxhp <target> <maxhp>Set maximum health for selected targets.Admin
sm_neuro_setspeed <target> <multiplier>Set movement multiplier (`m_flLaggedMovementValue`).Admin
sm_neuro_infinite_ammo <0|1>Toggle infinite ammo through server cvar bridge.Admin

v0.9v Command Expansion (Mega Alias Suite)

Alias PatternDescriptionNotes
sm_nd_common_1..50Quick common wave presets.Pre-registered admin aliases.
sm_nd_uncommon_1..50Quick uncommon wave presets.Pre-registered admin aliases.
sm_nd_survivor_add_1..8Spawn 1-8 survivor bots quickly.Maps to `sb_add` burst calls.
sm_nd_hp_25..250Set caller HP presets in 5-point steps.Fast test/admin workflows.
sm_nd_maxhp_50..300Set caller max-HP presets in 5-point steps.Fast test/admin workflows.
sm_nd_speed_60..200Set caller speed from 0.60x to 2.00x.Step size: 0.05x.
sm_nd_prop_1..NSpawn configured prop model by index.`N` equals prop catalog size.
sm_nd_special_<type>_<count>Spawn specific infected presets.Supports core SI + tank + witch aliases.
sm_nd_infiniteammo_on/offOne-click infinite ammo state switch.Mapped to `sv_infinite_ammo`.

Total aliases: 318 registered commands in the v0.9v stable expansion suite.

1.0v Command Set

CommandPurposeStatus
sm_neuro_v1_brainmapRender AI flow map with live node pressure metrics.1.0v
sm_neuro_v1_pathheatExport survivor route heatmap and pressure annotations.1.0v
sm_neuro_v1_lane_coreForce core lane dispatch policy profile.1.0v
sm_neuro_v1_lane_burstForce burst lane with strict fairness clamps.1.0v
sm_neuro_v1_lane_recoveryForce recovery-biased low stress behavior.1.0v
sm_neuro_v1_guardrailApply anti-spike runtime safety guard set.1.0v
sm_neuro_v1_horde_shapeSelect horde formation template by map geometry.1.0v
sm_neuro_v1_special_budgetSet per-type special infected pressure budget.1.0v
sm_neuro_v1_event_lockLock current event branch for validation runs.1.0v
sm_neuro_v1_event_unlockRelease event lock and restore adaptive picking.1.0v
sm_neuro_v1_ai_trace_onEnable high-detail AI reasoning trace mode.1.0v
sm_neuro_v1_ai_trace_offDisable AI reasoning trace mode.1.0v
sm_neuro_v1_export_graphsDump runtime graph metrics for dashboards.1.0v
sm_neuro_v1_profile_canaryRun canary profile validation suite.1.0v
sm_neuro_v1_profile_rollbackRollback to last stable profile snapshot.1.0v
sm_neuro_v1_obj_weightSet objective weighting multiplier live.1.0v
sm_neuro_v1_entropyTune anti-repetition entropy injection strength.1.0v
sm_neuro_v1_queue_lane_dumpPrint queue lanes and pending urgency score.1.0v
sm_neuro_v1_sync_snapshotSave full runtime state snapshot for regression tests.1.0v
sm_neuro_v1_sync_restoreRestore previously saved runtime snapshot.1.0v

Core Runtime Cvars

CvarDescriptionDefault
nd_enableMaster enable switch.1
nd_director_intervalSeconds between event rolls.12.0
nd_event_chanceChance each roll triggers an event.52
nd_wipe_triggerWipes required before punitive wave.5
nd_blackout_durationBlackout duration seconds.30.0
nd_blackout_min_delayMinimum auto-blackout delay.60.0
nd_blackout_max_delayMaximum auto-blackout delay.120.0

Spawn & Performance Cvars

CvarDescriptionDefault
nd_common_waveCommon infected per baseline wave.24
nd_special_waveSpecial infected per baseline wave.3
nd_uncommon_waveUncommon infected per baseline wave.5
nd_tank_waveTank count for boss-level waves.1
nd_spawn_tickDispatcher tick interval.0.32
nd_spawn_budgetMax spawn attempts per tick.2
nd_count_refreshEntity recount cache refresh interval.0.55
nd_max_common_aliveCommon/uncommon hard cap.56
nd_max_special_aliveSpecial infected hard cap.7
nd_max_tank_aliveTank hard cap.2

Advanced Safety Cvars

CvarDescriptionDefault
nd_adaptive_enableEnable adaptive difficulty model.1
nd_recovery_durationRecovery window length.25.0
nd_recovery_scalePressure scale while in recovery.0.65
nd_boss_lockoutBoss repeat lockout window.70.0
nd_spawn_los_checkEnable LOS-based spawn validation.1
nd_spawn_min_distMin spawn distance from survivors.450.0
nd_spawn_max_distMax spawn distance from survivors.1200.0
nd_failsafe_failuresFailures before failsafe throttle.12
nd_failsafe_cooldownFailsafe throttle duration.30.0
nd_survivor_cache_refreshSurvivor metric cache refresh interval.0.70
nd_spawn_tick_minFastest adaptive dispatcher tick.0.14
nd_spawn_tick_maxSlowest adaptive dispatcher tick.0.90
nd_failsafe_director_backoffDirector tick interval multiplier during failsafe.2.0
nd_debug_eventsLog detailed event-skip reasons.0
nd_dispatch_time_budget_msMax CPU time spent per spawn-dispatch tick.0.35
nd_los_attemptsLOS validation attempts before fallback spawn.4
nd_event_jitter_pctRandomized interval jitter for less predictable pacing.12.0
nd_queue_hard_limitQueue hard cap to prevent runaway spawn backlog.80
nd_lowpop_scaleScale pressure down when only 1-2 survivors remain alive.0.80

1.0v coming soon: planned mega update with 150+ new features across pacing profiles, admin tooling, and analytics.