> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botifymanager.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# settings

> Complete reference for all Botify settings — performance, API, thresholds, and more.

All settings **auto-save instantly** with a 300ms debounce — no Save button needed. Changes take effect immediately without restarting.

***

## System Info Banner

Displayed at the top of the Settings tab — shows your current hardware capacity:

| Info                   | Description                                     |
| ---------------------- | ----------------------------------------------- |
| **Total RAM**          | Total installed system memory                   |
| **Free RAM**           | Currently available memory                      |
| **CPU Cores**          | Logical CPU core count                          |
| **Est. Max Instances** | Calculated as `(available RAM − 1 GB) ÷ 100 MB` |

***

## General

| Setting                 | Key                       | Description                                                          | Default | Range |
| ----------------------- | ------------------------- | -------------------------------------------------------------------- | ------- | ----- |
| Multi-Roblox            | `multi_roblox`            | Enable multi-instance mutex bypass                                   | `true`  | —     |
| Auto Close Last Process | `auto_close_last_process` | Kill previous instance when re-launching same account                | `true`  | —     |
| Hide Usernames          | `hide_usernames`          | Mask usernames in the account list                                   | `false` | —     |
| Show Presence           | `show_presence`           | Live online/in-game status via Roblox Presence API                   | `true`  | —     |
| Developer Mode          | `dev_mode`                | Reveal advanced options (copy cookie, auth ticket, rbx-player links) | `false` | —     |
| Account Join Delay      | `account_join_delay`      | Seconds between each account launch                                  | `8`     | 1–30  |
| Presence Update Rate    | `presence_update_rate`    | Seconds between presence API polls                                   | `30`    | 5–120 |
| Not-in-Server Alert     | `stale_join_timeout`      | Alert if running account not detected in private server (minutes)    | `10`    | 5–60  |
| Stale Relaunch Delay    | `stale_relaunch_delay`    | Seconds between stale account relaunches                             | `5`     | 2–30  |

***

## Account Storage (MongoDB)

| Setting         | Key               | Description                                           |
| --------------- | ----------------- | ----------------------------------------------------- |
| Discord User ID | `discord_user_id` | Your Discord user ID (auto-set after OAuth2 login)    |
| PC Name         | `pc_name`         | Label for this machine — auto-populated from hostname |

***

## Connection & API

| Setting             | Key                   | Description                                      |
| ------------------- | --------------------- | ------------------------------------------------ |
| PRC API Key         | `prc_api_key`         | Your ER:LC PRC API key for server player queries |
| ERLC Server Code    | `erlc_server_code`    | Your private server code (e.g., `UTAHUSA`)       |
| Discord Webhook URL | `discord_webhook_url` | Webhook URL for live deployment notifications    |

***

## Launch Tuning

| Setting          | Key                | Default | Range |
| ---------------- | ------------------ | ------- | ----- |
| Batch Size       | `batch_size`       | `5`     | 1–15  |
| Wave Delay       | `wave_delay`       | `10s`   | 1–60s |
| Max Concurrent   | `max_concurrent`   | `30`    | 1–50  |
| Stagger Launches | `stagger_launches` | `true`  | —     |

<Tip>
  For 15+ simultaneous instances, set **Max Concurrent** to match your PC's capacity and enable **Ultra-Low GPU Mode**.
</Tip>

***

## Performance & Rendering

| Setting                     | Key                        | Description                                                              | Default       |
| --------------------------- | -------------------------- | ------------------------------------------------------------------------ | ------------- |
| Apply Performance FastFlags | `apply_performance_fflags` | Writes CPU-saving flags to Roblox `ClientAppSettings.json`               | `true`        |
| Low GPU Mode                | `low_gpu_mode`             | Reduces Roblox graphics settings to save VRAM                            | `true`        |
| Ultra-Low GPU Mode          | `ultra_low_gpu_mode`       | Caps FPS to 1 and disables all rendering (recommended for 15+ instances) | `false`       |
| Disable Audio               | `disable_audio`            | Disables Roblox audio across all instances                               | `true`        |
| Process Priority            | `process_priority`         | CPU scheduling priority for all Roblox processes                         | `BelowNormal` |

**Process Priority Options:** `Realtime` → `High` → `AboveNormal` → `Normal` → `BelowNormal` → `Idle`

<Warning>
  `Realtime` priority can starve other processes and destabilize your system. `BelowNormal` is recommended for 10+ instances.
</Warning>

**Remove All FastFlags Now** — Click this button to strip all injected FastFlags from `ClientAppSettings.json` and disable `apply_performance_fflags`.

***

## Memory & CPU Optimizer

| Setting                    | Key                         | Description                                               | Default |
| -------------------------- | --------------------------- | --------------------------------------------------------- | ------- |
| Process Optimizer (Master) | `process_optimizer_enabled` | Master switch for ALL RAM/CPU optimizations               | `true`  |
| Working Set Trim           | `working_set_trim`          | Trim Roblox memory — drops \~450MB to \~80MB per instance | `true`  |
| Trim Only in Game          | `trim_only_in_game`         | Wait for bots to fully load (\~2 min) before first trim   | `true`  |
| Trim Interval              | `trim_interval`             | Seconds between working set trims                         | `120`   |
| Aggressive Trim            | `aggressive_trim`           | Use `EmptyWorkingSet` for maximum RAM reduction           | `false` |
| CPU Affinity Pinning       | `cpu_affinity_pinning`      | Pin each Roblox instance to specific CPU cores            | `true`  |
| Cores per Instance         | `cores_per_instance`        | CPU cores assigned to each Roblox instance                | `2`     |
| Kill Crash Handlers        | `kill_crash_handlers`       | Auto-kill `RobloxCrashHandler.exe` (\~20MB per instance)  | `true`  |
| Memory Warning %           | `memory_warn_threshold`     | Warn when system RAM usage exceeds this percentage        | `85%`   |

<Info>
  See the [Process Optimizer](/process-optimizer) page for a full technical breakdown of each component and RAM impact data.
</Info>

***

## Cookie Management

| Setting                     | Key                             | Default |
| --------------------------- | ------------------------------- | ------- |
| Auto Cookie Refresh         | `auto_cookie_refresh`           | `true`  |
| Refresh Interval (hours)    | `cookie_refresh_interval_hours` | `24`    |
| Delay Between Refreshes (s) | `cookie_refresh_delay`          | `5`     |

***

## Security

| Setting              | Key                    | Description                               | Default |
| -------------------- | ---------------------- | ----------------------------------------- | ------- |
| Encrypt Account Data | `encrypt_account_data` | DPAPI encryption for `account_store.json` | `false` |

<Warning>
  Enabling DPAPI encryption ties your local data to your Windows user account. Switching Windows users or reinstalling Windows will require re-adding all accounts from scratch.
</Warning>

***

## Server Thresholds

| Setting            | Key                | Default | Description                                    |
| ------------------ | ------------------ | ------- | ---------------------------------------------- |
| Deploy Threshold   | `deploy_threshold` | `35`    | Deploy bots when player count drops below this |
| Remove at (High)   | `remove_at_39`     | `39`    | Remove 2 bots when server reaches this count   |
| Remove at (Medium) | `remove_at_38`     | `38`    | Remove 1 bot when server reaches this count    |

***

## Webhook Appearance

| Setting      | Key                    | Default   |
| ------------ | ---------------------- | --------- |
| Accent Color | `webhook_accent_color` | `#3b82f6` |

The accent color is applied as the sidebar stripe on all Discord webhook embeds sent by Botify (bot deployments, errors, status changes).

***

## Multi-Roblox Support

Botify holds the Roblox singleton mutex on startup to allow multiple instances to run simultaneously.

| Setting      | Key            | Default | Description                        |
| ------------ | -------------- | ------- | ---------------------------------- |
| Multi-Roblox | `multi_roblox` | `true`  | Enable multi-instance mutex bypass |

* Initialized automatically on app start (up to **30-second timeout**)
* Mutex is released on app close
* Requires **Administrator privileges** — if admin was not granted, this feature will not function

<Warning>
  If **Multi-Roblox** fails to initialize, only one Roblox instance will launch at a time. Ensure Botify is run as Administrator and no other mutex-bypass tools (e.g., Bloxstrap) are running simultaneously.
</Warning>

***

## Discord Webhook Integration

Configure a Discord webhook to receive live notifications from Botify:

| Event                    | What Gets Sent                          |
| ------------------------ | --------------------------------------- |
| Bot deployment started   | Mode, account count, server code        |
| Auto-remove triggered    | How many bots were removed and why      |
| Ghost server detected    | Trigger conditions and cooldown timer   |
| Cookie refresh completed | Success/failure counts                  |
| Error events             | Error type, affected account, timestamp |
| Status changes           | Engine start/stop events                |

Set your webhook URL in **Settings → Connection & API → Discord Webhook URL**.