Skip to main content
The CSAFAP configuration system is designed to be both powerful and user-friendly. All customization happens through .cfg files that use CS2’s alias and command syntax.

​
Configuration Hierarchy

Configurations are organized in a hierarchical structure: 
csafap/
├── MAIN.cfg              # User-facing configuration
├── logic.cfg             # Core framework logic (don't edit)
├── addons/
│   ├── loader.cfg        # Loads all subsystems
│   ├── AveYo.cfg         # Ticker-based binds
│   └── .vtest            # Ticker script
├── maps/                 # Map-specific configs
├── movement/             # Movement configurations  
├── crosshair/            # Crosshair and viewmodel
└── practice_mode/        # Practice mode configs
Only MAIN.cfg is meant to be edited by users. The framework files (logic.cfg, loader.cfg, etc.) should not be modified unless you’re developing custom features.

​
User Configuration: MAIN.cfg

The MAIN.cfg file is your control panel for customizing the framework.

​
Setting Your Sensitivity

The most important configuration: 
// From MAIN.cfg:6
alias resetsens "sensitivity 1.0 ; m_yaw 0.022 ; sensitivity_y_scale 1"
Replace 1.0 with your actual in-game sensitivity. This ensures auto line-ups work correctly while preserving your normal aim sensitivity.
If you use a custom m_yaw or sensitivity_y_scale, set those values here as well. The framework will use these to restore your settings after line-ups.

​
Customizing Keybinds

Base keybinds control access to major features: 
// From MAIN.cfg:9-12
bind "M" +map_action          // Map selection + practice mode
bind "J" +T_action            // T-side line-ups
bind "H" +CT_action           // CT-side line-ups
bind "K" +crosshair_action    // Crosshairs, rapid fire, snap-tap
Change the keys to match your preferences. Use scancode binds for non-QWERTY keyboards: 
bind scancode70 +map_action  // Scancode for M on AZERTY

​
FaceIt Alternative Binds

For servers that don’t support standard auto line-ups: 
// From MAIN.cfg:14-15 (remove // to enable)
//bind "J" +fAC_T_action   // T smokes for FaceIt
//bind "H" +fAC_CT_action  // CT smokes for FaceIt

​
Ticker-Based Features

Advanced features using AveYo’s ticker system: 
// From MAIN.cfg:19-23
bind "space" +JumpThrow        // CS:GO-style jumpthrow
bind "N" +WJumpThrow           // CS:GO-style W-jumpthrow  
bind "mwheeldown" desubJ       // Desubtick jumping (better bhop)
//bind "CAPSLOCK" +CrouchJump  // Crouch-jump bind
//bind "Ralt" toggle_rapid     // Toggle rapid fire/follow-recoil
Ticker features require the launch option:
-testscript "../../csgo/cfg/csafap/addons/.vtest"

​
Enabling Features at Launch

Optionally load features automatically when the game starts: 
// From MAIN.cfg:28-33
//exec csafap/movement/default              // Default WASD
//alias load_movement load_null             // Null binds (snap-tap)
//alias load_movement load_desub            // Desubtick WASD
//alias load_follow_recoil load_rpd         // Rapid fire
//alias load_follow_recoil load_flw         // Better follow-recoil
//alias load_follow_recoil load_rpdflw      // Rapid + follow-recoil
Remove the // prefix to enable a feature.

​
Rapid Fire / Follow-Recoil Requirements

If using rapid fire or follow-recoil modes: 
// From MAIN.cfg:36-47
//bind 1 "ef_slot1"      // Primary
//bind 2 "ef_slot2"      // Secondary  
//bind 3 "ef_slot3"      // Melee
//bind 4 "ef_slot4"      // Cycle nades
//bind 5 "ef_slot5"      // Bomb
//bind c "ef_slot6"      // HE grenade
//bind f "ef_slot7"      // Flash
//bind g "ef_slot8"      // Smoke
//bind z "ef_slot9"      // Decoy
//bind v "ef_slot10"     // Molotov/incendiary
//bind q "ef_lastinv"    // Quickswitch
These enhanced slot binds enable proper weapon detection for the rapid fire and follow-recoil systems.

​
Crosshair and Viewmodel

Insert your preferred crosshair and viewmodel settings: 
// From MAIN.cfg:51-52
alias reset_crosshair "cl_crosshairstyle 4; cl_crosshair_recoil 0; cl_crosshairsize 1.8; ..."
alias reset_viewmodel "viewmodel_presetpos 1;viewmodel_fov 90;viewmodel_offset_x 1;..."
The framework will restore these settings when switching between pro player configs.

​
Map-Specific Configurations

Each map has its own configuration directory: 
maps/
├── mirage/
│   ├── mirage.cfg            # Map initialization
│   ├── mirage_CT_labels.cfg  # CT wheel labels
│   ├── mirage_CT_cmd.cfg     # CT wheel commands
│   ├── mirage_T_labels.cfg   # T wheel labels
│   ├── mirage_T_cmd.cfg      # T wheel commands  
│   └── wheel_curr_map.cfg    # Current map marker
├── dust2/
├── inferno/
└── ...

​
Label Configuration

Defines what text appears in radio tiles: 
// Example: mirage_CT_labels.cfg
cl_radial_radio_tab_0_text_1 "#CFG_MIRAGE_WINDOW"
cl_radial_radio_tab_0_text_2 "#CFG_MIRAGE_TOP_MID"  
cl_radial_radio_tab_0_text_3 "#CFG_MIRAGE_CONNECTOR"

​
Command Configuration

Defines what executes when a tile is selected: 
// Example: mirage_CT_cmd.cfg
cl_radial_radio_tab_0_text_1 cmd";exec_window_lineup;
cl_radial_radio_tab_0_text_2 cmd";exec_topmid_lineup;
cl_radial_radio_tab_0_text_3 cmd";exec_connector_lineup;
Commands must:
  • Start with cmd";
  • End with ;
  • Cannot contain " characters (use aliases instead)

​
Movement Configurations

Movement configs modify WASD behavior:

​
Default Movement

// From movement/default.cfg
bind W +forward
bind A +left
bind S +back
bind D +right

​
Null Binds (Snap-Tap)

// From movement/nullWASD.cfg  
bind W +nullW
bind A +nullA
bind S +nullS
bind D +nullD
When using null binds, pressing an opposite direction key automatically releases the first key.

​
Desubtick Movement

// From movement/desubtickWASD.cfg
bind W +desubtickW
bind A +desubtickA  
bind S +desubtickS
bind D +desubtickD
Movement inputs wait for the next tick rather than being subticked.
Standard CS2 movement with subtick precision. Best for most players.

​
Adding Custom Line-ups

To add your own line-up to the framework:

​
Step 1: Find the Angle

In-game with sv_cheats 1, position yourself and use: 
getpos
Note the setpos coordinates and setang angles.

​
Step 2: Calculate Yaw/Pitch

Use the formula: 
X = angle_degrees / (sensitivity × m_yaw)
For the framework’s standard sensitivity: 
X = angle_degrees / (1.0 × 0.022)
X = angle_degrees / 0.022
Since version 2.15, vertical angles are zeroed at -89° instead of 0°. Add +4045.45454545 to your calculated pitch value.

​
Step 3: Create Alias in logic.cfg

Add your line-up alias: 
alias my_custom_lineup "yaw 1234.5 1 1; pitch 2345.6 0 0"

​
Step 4: Add Label in platform_english.txt

"CFG_MY_LINEUP"    "My Custom Smoke\n from spawn 1\n \n \n \n \n "

​
Step 5: Add to Map Label Config

In csafap/maps/[mapname]_labels.cfg: 
cl_radial_radio_tab_0_text_7 "#CFG_MY_LINEUP"

​
Step 6: Add to Map Command Config

In csafap/maps/[mapname]_cmd.cfg: 
cl_radial_radio_tab_0_text_7 cmd";my_custom_lineup;
Use the same tile number (e.g., text_7) in both label and command configs.

​
Practice Mode Configuration

Practice mode has its own configuration structure: 
practice_mode/
├── prac.cfg              # Practice mode initialization
├── prac_labels.cfg       # Practice command labels
├── prac_cmd.cfg          # Practice commands
├── selectmap_labels.cfg  # Map selection labels  
├── selectmap_cmd.cfg     # Map change commands
└── maps/                 # Map-specific practice configs
When practice mode is enabled, the framework:
  1. Loads practice-specific radio wheel configurations
  2. Converts the map wheel to changelevel commands
  3. Converts CT wheel to spawn teleports
  4. Converts T wheel to practice commands (god, noclip, sv_cheats, etc.)

​
Advanced: Ticker System

The ticker system enables frame-perfect input through a .vtest script: 
// From addons/.vtest
Test_WaitForCheckPoint frame_end

W!  // Called every frame
W!
A!
A!
S!
S!
D!
D!
M1!
M2!
JT!
J!

Test_Run  // Loop
This script calls special aliases every frame, enabling:
  • Null movement binds
  • Jumpthrow binds
  • Rapid fire
  • Follow-recoil
Ticker aliases use ! suffix (e.g., W!, M1!, JT!) and are chained through multiple alias substitutions per frame.

Build docs developers (and LLMs) love

Get started for freeTalk to us