True Aim - Configuration Guide

Quick Start

Toggle the overlay: Press F8 (keyboard) or L3/Left Stick Click (gamepad) during gameplay to show/hide the directional input overlay.

Access settings: Open the BepInEx Configuration Manager (default: F1) to customize all options.

Controls

Toggle Key

Default: F8

Primary keyboard key to toggle the attack zone overlay on/off during gameplay.

Secondary Toggle Key (Alternative)

Default: LeftStickButton (L3)

Alternative toggle using the gamepad left stick click. Useful for quick toggling without leaving gameplay controls.

Visual Settings

Halo Radius

Default: 2.5 units

Controls the distance of the attack zone arcs from Hornet. Smaller values keep the guide closer to the character, while larger values provide more visual space but may obscure the environment.

Recommendation: Adjust based on your screen size and preferred visual density.

Adaptive Halo Radius

Default: Enabled

Automatically adjusts the halo radius based on equipped Crest and Longclaw status. When enabled:

• Each Crest has optimized radius values (e.g., Shaman: 5.75, Toolmaster: 4.6)
• Longclaw tool equipping affects radius calculations
• Manual radius setting is overridden, manual radius value has been fine-tuned for visual balance, while this feature shows your attack reach

Disable this if you prefer a consistent visual size regardless of equipment.

Active Zone Opacity

Range: 0.0 - 1.0
Default: 0.6

Transparency of the currently selected attack direction (where your stick is pointing). Higher values = more visible.

Inactive Zone Opacity

Range: 0.0 - 1.0
Default: 0.2

Transparency of non-selected attack zones. Lower values keep them subtle while maintaining spatial awareness.

Indicator Start Offset

Range: 0.0 - 1.0
Default: 0.6

Distance from Hornet's center where the directional arrow begins. Increase this if the arrow overlaps with character sprites and you prefer it doesn't. Setting this to 1.0 will completely hide the arrow indicator.

Gameplay Options

Input Hold Duration

Range: 0.0 - 1.0 seconds
Default: 0.15s

Determines how long the attack zone remains highlighted after releasing the left stick. Brief retention helps confirm your input direction without visual clutter.

Tip: Increase to 0.3-0.5s if you prefer more persistent feedback during fast movement.

Attack Zone Persist Time

Range: 0.0 - 2.0 seconds
Default: 0.4s

The duration that attack zones remain visible after executing an attack, regardless of stick input.

Show Facing Zone

Default: Enabled

Highlights the attack zone in Hornet's facing direction, even when the stick is neutral. Useful for understanding hitbox orientation during stationary attacks.

Attack Effect Toggle

Default: Enabled

Enables/disables visual feedback during attacks:

• Pulse animation: Arcs expand outward on attack
• Cooldown fill: Progressive arc fill during attack recovery
• Charge swell: 1.0x → 1.5x expansion during nail charge

Disable for minimal distraction if you only want directional guidance.

Colors

Quick Presets

Select from themed color schemes (some unlock through gameplay):

• Default: Balanced visibility (cyan/magenta/yellow)
• High Contrast: Maximum visibility (white/red/green)
• Muted: Softer tones for reduced eye strain
• Bilewater: Toxic green theme
• Mount Fay: Cool purple/blue tones
• Crimson: Red/orange aggressive palette
• Abyss: Dark void aesthetic

Custom Colors

Override preset colors manually:

Primary Color (Horizontal): Left/Right attack zones
Secondary Color (Down): Downward attack zones
Tertiary Color (Up): Upward attack zones

Note: Alpha (transparency) values are ignored - use Active/Inactive Opacity settings instead.

Developer Features

Developer Mode

Default: Disabled

Unlocks advanced debugging tools. Enable for technical analysis or troubleshooting.

Debug Overlay (F11)

Requires: Developer Mode enabled

Press F11 in-game to display comprehensive technical information:

• Real-time FSM state monitoring
• Attack detection status
• Charge timer tracking
• cState flags
• DPI-aware scaling for high-resolution displays

Use cases:

• Understanding attack frame data
• Verifying mod compatibility
• Debugging custom attacks

Verbose Logging

Default: Disabled

Outputs detailed frame-by-frame data to the BepInEx console. Warning: Generates significant log volume - only enable when investigating specific issues.

Language Support

Available Languages:

• English
• Simplified Chinese (简体中文)
• Japanese (日本語)
• Korean (한국어)
• Spanish (Español)
• French (Français)
• German (Deutsch)
• Russian (Русский)

A game restart is recommended to apply most changes.

Tips & Tricks

Finding Your Preferred Setup:

1. Start with default settings during normal gameplay
2. Adjust radius until arcs feel "right" for your screen
3. Lower inactive opacity if you find non-selected zones distracting
4. Experiment with color presets - thematic options may improve clarity in different biomes
5. Enable attack effects to learn attack recovery timing

Performance Optimization:

• Disable attack effects if experiencing frame drops
• Use lower opacity values to reduce visual processing
• Disable debug overlay when not needed (normally, you won't be able to access it unless you enable dev mode.)

Accessibility:

• High Contrast preset for visibility impairments
• Larger radius values for distant viewing
• Longer input hold duration for slower-paced play

Troubleshooting

Overlay not appearing:

• Verify mod is loaded (check BepInEx console on startup)
• Press toggle key (F8) - overlay may be disabled
• Ensure you're in active gameplay (not menus/cutscenes)

Colors look wrong:

• Check if a preset override is active
• Verify language settings didn't reset configuration (normally it shouldn't)
• Try applying a different preset, then reapply custom colors

Performance issues:

• Disable Developer Mode and debug overlay
• Turn off attack effects
• Reduce halo radius
• Lower active/inactive opacity

Configuration not saving:

• Check BepInEx folder permissions
• Ensure Configuration Manager is installed
• Manually edit BepInEx/config/com.trueaim.silksong.cfg if needed