Configuration
Settings are split by purpose. Start with configs/config.lua, then change the files for the features you want to customize. Each file has a complete downloadable reference in Full Config Files in the sidebar.
Config Map
Shared settings
| File | Controls | Reference |
|---|---|---|
configs/config.lua | Locale, debugging, and config loading. | Main config |
configs/shared/admin.lua | Admin command, ACE permissions, placement tools. | Admin |
configs/shared/cabinets.lua | Arcade groups, seats, labels, and blips. | Cabinets |
configs/shared/rules.lua | Fighter/stage availability and casual match options. | Rules |
configs/shared/net.lua | Input delay and resync bandwidth. | Networking |
configs/shared/progression.lua | Unlock catalog, prices, packs, titles, banners, and rewards. | Progression catalog |
Client settings
| File | Controls | Reference |
|---|---|---|
configs/client/props.lua | Model, spawn/interaction distance, camera, animation, blips. | Props |
configs/client/ui.lua | Keys, controller input, graphics, CRT effect, and audio defaults. | UI |
Server settings
| File | Controls | Reference |
|---|---|---|
configs/server/economy.lua | Admission, account, wagers, and house cut. | Economy |
configs/server/limits.lua | Interaction checks, rate limits, timeouts, and stall detection. | Limits |
configs/server/stats.lua | Leaderboard eligibility, size, and caching. | Stats |
configs/server/logs.lua | Enabled audit events. | Logs |
configs/server/progression.lua | Reward limits, challenge resets, shop rotation, and season clock. | Progression rules |
configs/server/ranked.lua | Ranked queue, rules, tiers, season, and rewards. | Ranked |
configs/server/tournaments.lua | Cup schedule, brackets, check-in, stages, and prizes. | Tournaments |
configs/server/party.lua | Party size, invitations, lobby filling, and Quick Play. | Parties |
configs/server/social.lua | Friends, requests, profile search, history, and notifications. | Social |
Applying Changes
Back up your settings, make the change, then restart sd-smashdown during a quiet period. A restart interrupts active games; let players finish first. Arcade edits made through the admin panel save and apply live.
Two different progression files
shared/progression.lua defines what players can unlock and buy. server/progression.lua defines when and how they earn rewards and when the shop, challenges, and season change.
Common Changes
| Goal | Setting |
|---|---|
| Free admission | CreditPrice = 0 in server/economy.lua. |
| Disable betting | Wager.Enabled = false in server/economy.lua. |
| Change arcade positions | Admin panel, or Groups in shared/cabinets.lua. |
| Force casual hazards off | Hazards = false in shared/rules.lua. |
| Turn off controller forwarding | Gamepad = false in client/ui.lua. |
| Disable CRT effect by default | Crt = false in client/ui.lua. |
| Make all fighters and skins available | Enabled = false in server/progression.lua; see the feature dependencies below. |
| Disable ranked or tournaments | Set Enabled = false in the respective server config. |
| Change language | Locale in config.lua, with a matching translation in locales/. |
Feature Dependencies
Progression provides persistent profiles and ownership. Ranked and tournaments depend on progression and a healthy match verifier. Social features also depend on progression, and parties depend on social being enabled.
Turning progression off unlocks fighters and skins for casual play and disables its reward/shop flow. It does not turn off admission, wagers, or the separate arcade statistics system.
Networking and Limits
The default InputDelay = 2 is measured in simulation frames. The supported range is 0–6; increasing it can reduce rollback for distant players at the cost of less immediate input. Start with the default and test with your actual players before adjusting it.
Leave relay rate limits and resync limits at their defaults unless you are diagnosing a measured issue. MatchTimeoutMinutes should remain above the longest match your rules allow. StallSeconds controls how long an unresponsive player's input can stop before they are dropped; setting it to 0 disables that check.
Debugging
Debug and DebugPrints in configs/config.lua are off by default. Enable only the output needed for a test, capture the relevant server and F8 errors, and turn verbose logging back off afterwards. Commands & Logging covers status checks and audit events.