Core Configuration
Core configuration controls framework-wide behavior such as command parsing, plugin loading, menu input, console filtering, console logging, unlocker toggles, and Steam auth mode.
Config File
Edit the following file:
addons/swiftlys2/configs/core.jsonc
The file is created from core.example.jsonc on first startup. Missing keys, or keys with an incompatible type, are replaced with their default value and written back to this file on load. Change the location with -sw_path if SwiftlyS2 is installed elsewhere - see CLI Options.
Global Settings
| Key | Type | Default | Description |
|---|---|---|---|
CommandPrefixes | string[] | ["!"] | Prefixes recognized for normal command execution. |
CommandSilentPrefixes | string[] | ["/"] | Prefixes recognized for silent command execution. |
AutoHotReload | boolean | true | Reloads a plugin automatically when its .dll file changes. |
ProfilerLevel | number | 0 | Default profiler level. 0 disables profiling, 1 enables EventPipe profiling. |
ConsoleFilter | boolean | true | Enables console filtering on startup - see Console Filter. |
PatchesToPerform | string[] | [] | Identifiers of the game data patches applied on startup. Identifiers that do not exist for the current game are logged and skipped. |
CS2ServerGuidelines | string | "https://blog.counter-strike.net/index.php/server_guidelines/" | URL of the CS2 server guidelines. Only registered on CS2, and not read by the core at the moment. |
Follow<Game>ServerGuidelines | boolean | true | Keeps SwiftlyS2 inside the server guidelines: while enabled, protected schema fields and loadout item access throw instead of returning data. Key name depends on the current game, e.g. FollowCS2ServerGuidelines. |
Language | string | "en" | Default language code, used when a player has no language of its own. |
UsePlayerLanguage | boolean | true | Prefers the language reported by the player's game client for translations. |
ManualLoadPlugins | boolean | false | Skips plugin loading on startup; plugins are then loaded with sw plugins load from the server console. |
PluginLoadOrder | string[] | [] | Plugin IDs loaded on startup, in the listed order, when ManualLoadPlugins is true. |
DotnetCrashTracerLevel | number | 0 | .NET crash tracer level. A value greater than 0 enables the tracer. |
WindowsFullDump | boolean | false | Windows-only crash dump toggle. Not read by the core at the moment, so it has no effect. |
Unlocker Settings
Unlocker controls which restricted engine features are exposed.
| Key | Type | Default | Description |
|---|---|---|---|
Convars | boolean | false | Removes the restricted flag from locked convars on startup. |
ConCommands | boolean | false | Removes the restricted flag from locked console commands. |
Console Logger Settings
ConsoleLogger controls console output logging and log file rotation.
| Key | Type | Default | Description |
|---|---|---|---|
Enable | boolean | true | Enables console logging to files in logs/console/. |
ManagedEnable | boolean | true | Also writes managed (.NET) plugin logs to files in logs/managed/. |
WriteIntervalMs | number | 2000 | Interval, in milliseconds, between log file writes. Values below 1 fall back to 2000. |
Rotation.Enable | boolean | true | Enables log file rotation, applied on startup and after every write. |
Rotation.Mode | string | "file_count" | Rotation mode. Available: "file_count", "time_interval". Any other value leaves rotation inactive. |
Rotation.AvailableModes | string[] | ["file_count", "time_interval"] | Rotation modes listed for Rotation.Mode. |
Rotation.MaximumFiles | number | 60 | Maximum number of rotated log files to keep (file_count mode). Values below 1 disable this rotation. |
Rotation.DeleteOlderThanHours | number | 168 | Deletes rotated log files older than this many hours (time_interval mode). Values below 1 disable this rotation. |
Menu Settings
Menu controls input mode, navigation behavior, and menu sounds.
| Key | Type | Default | Description |
|---|---|---|---|
AvailableInputModes | string[] | ["button", "wasd"] | Menu input modes listed for InputMode. |
InputMode | string | "button" | Active menu input mode. "wasd" enables WASD navigation, any other value uses the Menu.Buttons mappings. |
NavigationPrefix | string | "➤" | Prefix shown for the currently selected menu item. |
ItemsPerPage | number | 5 | Number of menu items shown per page, used by menus that do not set their own limit. Values are clamped between 1 and 5. |
Menu Buttons
| Key | Default |
|---|---|
Exit | "tab" |
Scroll | "shift" |
ScrollBack | "f" |
Use | "e" |
Values are matched case-insensitively against a fixed set of key names: mouse1, mouse2, space, ctrl, w, a, s, d, e, esc, r, alt, shift, weapon1, weapon2, grenade1, grenade2, tab, f. A name outside this set leaves the action unbound, so the key never triggers it.
Menu Sound
Menu.Sound defines the sound played for menu actions.
| Action | Name | Volume |
|---|---|---|
Exit | "Vote.Failed" | 0.75 |
Scroll | "UI.ContractType" | 0.75 |
Use | "Vote.Cast.Yes" | 0.75 |
SteamAuth Settings
SteamAuth controls Steam authentication mode.
| Key | Type | Default | Description |
|---|---|---|---|
AvailableModes | string[] | ["flexible", "strict"] | Steam auth modes listed for Mode. |
Mode | string | "flexible" | Active Steam auth mode. With "flexible" the Steam ID of a player who has not completed Steam authentication is still returned, any other value returns 0 until authentication succeeds. |
Notes
- Every key is read while the core starts, so restart the server after editing
core.jsonc. Console filtering is the exception:sw confilter enableandsw confilter disabletoggle it at runtime without writing the change back to the file - see Console Filter. - The
SetSchemaHammerUniqueIdpatch is applied on startup even whenPatchesToPerformis empty. - A key with an incompatible type is reset to its default, while an individual array entry with an incompatible type is skipped with a logged error and the remaining entries are kept.
ConsoleLogger.Rotation.AvailableModes,Menu.AvailableInputModesandSteamAuth.AvailableModesonly list the values theirModecounterpart understands; the core does not validateModeagainst them.