The list of environment variables used by the server.
Default: ../admin/admin.html
Moderation panel template. You don't need to restart a server after update the content of this file.
Default: ../admin/passwords.txt
Moderation panel access list file. You don't need to restart a server after update the content of this file.
Default: 10 for BTR, 0 (disabled) for other game types
Timeout in minutes for inactive (AFK) user, after which they will be disconnected.
Default: false
Enable or disable filter for usernames. Some unicode chars in the usernames cause client lags.
Default: https://login.airmash.online/key
Public key server url. Required by user accounts. Only https is supported.
Default: "/"
Game server URL base path.
Default: "127.0.0.1"
Pre-defined bots IP list and CIDR blocks. Parsed as array, use , as delimiter. Applies when whitelist is enabled.
Use the commands to update the list without restarting a server.
Example: "127.0.0.1,127.0.0.2,127.0.0.3" will be parsed as ["127.0.0.1", "127.0.0.2", "127.0.0.3"].
Default: ""
Automatically add prefix to bot names, helps to prevent mimicry. Non-bot players cannot use this prefix.
Example: "[bot] " (don't forget a space at the end if you want to use it as separator), the bot with a requested name Lunokhod will receive an assigned name [bot] Lunokhod.
Default: 70
Speed of firewall as it burns toward centre of map, in map units per second.
Default: 70
Number of seconds to wait between matches.
Default: ../cache
Path to the cache directory. Relative (to app.js root) or full path.
Default: ../certs
Path to the certificates directory. Relative (to app.js root) or full path.
Must contain privkey.pem and fullchain.pem files (if ENDPOINTS_TLS is true).
Default: 0
Votemute abuse prevention. Requires voters to have a score exceeding the provided threshold percentile.
Valid values are in the range [0, 1). Recommended value is 0.5.
Default: 60
To use /votemute, player must play at least this many seconds.
Default: 30
The maximum number of seconds that can be randomly added to the basic interval of the base shield respawning.
Default: false
Turn on/off CTF extra spawns in the middle of the map.
Default: true
Turn on/off features like /usurp or /elections applicable only to Q-bots in CTF. Affects only CTF mode.
Default: false
Turn on/off endpoint TLS.
Default: undefined
It is preferable to set it 1 in the production, can affect performance. See uWebSockets.js. package repository for more info.
Default: false
Add periodic CTF-like base infernos.
Default: europe
Set an alternative spawn zone for FFA. Valid zones are europe, canada, latam, and asia.
Default: 0.0.0.0
Server host or IP.
Default: true
Enable or disable auto kick policy based on invalid protocol implementation ACK packets. Normally, you don't need to turn it off.
Default: true
Enable or disable auto kick policy based on invalid protocol implementation BACKUP packets. Normally, you don't need to turn it off.
Default: true
Enable or disable auto kick policy based on invalid protocol implementation PONG packets. Normally, you don't need to turn it off.
Default: false
Enable or disable assistance tracking in killing. With this option enabled, the reward for killing a player is distributed among all those who dealt the damage.
Default: ../logs/chat.log
Chat logs file path. Relative (to app.js root) or full path. Set to empty to turn off chat file logs.
Default: ../logs/airbattle.log
Logs file path. Relative (to app.js root) or full path. Set to empty to turn off file logs.
Default: info
Levels: debug, info, warn, error, fatal, silent. Silent level disables all log streams.
Default: true
Save performance samples into log. Performance is measured every 5 seconds.
Default: false
Send log messages to stdout. It's better not to turn on both the output in the file and in the console at the same time in production.
Default: 3
Limiting the number of simultaneous connections from one IP.
Default: true
Enable of disable moderation panel.
Default: admin
The server exports this URL path to allow privileged players to moderate the game.
Default: production
Environment: development or production. Also affects the work of some dependencies.
Default: 140
Bucket volume per player for all incoming packets. Leak volume is 35 per second.
If the limit is exceeded, the player will be kicked for packets flooding. The penalty for repeated violation is regulated with PACKETS_FLOODING_AUTOBAN.
Default: 2
Bucket volume per player for all chat packets (public chat, team and whisper). Set the leak volume with PACKETS_LIMIT_CHAT_LEAK.
If the limit is exceeded, the player will be asked to stop spam. The penalty for repeated violation is mute for 10 minutes.
Default: 1
Leak volume per second for the chat bucket. For fine-tuning the anti-spam.
Default: 100
Bucket volume per player for the KEY packets (movement/special key presses and releases). Leak volume is 20 per second.
If the limit is exceeded, the player will be kicked for packets flooding. The penalty for repeated violation is regulated with PACKETS_FLOODING_AUTOBAN.
Default: 3
Bucket volume per player for say chat packets. Leak volume is one per second.
If the limit is exceeded, the player will be notified about message skip. No other penalty.
Default: true
Enable or disable auto ban policy for packets flooding.
Default: 3501
Server port.
Default FFA: 0.5
Default CTF: 0.02
Default BTR: 0.5
Probability of shields and inferno boxes spawn. Valid value: [0..1]. Set 0 to disable shields and inferno boxes spawn.
The map is split into chunks (32 in FFA and BTR, 80 in CTF). Each chunk can hold no more than 1 powerup at a time (periodicals powerups aren't counted). One by one, once per minute, the chunks are checked for spawning possibilities. If powerup was picked up or despawned, the chunk will have a timeout to spawn of 5 minutes. After 5 minutes, considering the probability value, a powerup may be spawned again.
Set 1 for guaranteed powerup spawn after 5 minutes timeout, but don't forget about POWERUPS_SPAWN_LIMIT.
The default values are empirical (selected during testing). Change the value with care, it may affect the balance of the games.
Default FFA: 0.4
Default CTF: 0.05
Default BTR: 0.25
Limit (percentage of the chunks amount) of shields and inferno spawns per minute. Valid value: [0..1]. Set 0 to disable shields and inferno boxes spawn. Example: 0.5 value in FFA mode means, that 16 (0.5 * 32 chunks) powerups is the maximum amount of boxes can be spawned per minute.
The default values are empirical (selected during testing). Change the value with care, it may affect the balance of the games.
Default: false
Allows the teammates to see prowlers while in the spectate mode. Anti-cheating feature (false = active). If active, only no-spectating teammates can see stealthed prowlers.
The setting option is left for compatibility.
Default: 5500
The maximum zoom value limit of the client.
Default: JOLLY
Server chat bot country flag. Valid flag codes.
Default: Server
Server chat bot name.
Default: ab-ffa
Server room name.
Default: FFA
Types: FFA, CTF or BTR.
Default: ../data/user-stats.json
Default: false
Allows cross-server synchronization of user stats, via the airmash.online sync service.
Public servers in the games list should set this to true. Development or private servers should leave this as false.
Default: ""
Superuser password to run some commands. Must be filled.
Default: ../data/sync-state.json
Default FFA: 0.65
Default CTF: 0.8
Maximum probability of upgrade box drop. Valid values: [0..1]. Must be greater than UPGRADES_DROP_MIN_CHANCE. Set 0 to disable upgrades drop.
Look at the code for details.
The default values are empirical (selected during testing). Change the value with care, it may affect the balance of the games.
Default FFA: 0.35
Default CTF: 0.5
Minimum probability of upgrade box drop. Valid values: [0..1]. Must be lower than UPGRADES_DROP_MAX_CHANCE. Set 1 to drop upgrades every time the player dies.
Look at the code for details.
The default values are empirical (selected during testing). Change the value with care, it may affect the balance of the games.
Default: ``
Set the upgrades fever schedule by pattern: <schedule item> [, <schedule item>]. Each schedule item defines the interval at which the event is active, at any other time the event is disabled. The schedule must not contain any intersections (there are no validators!). Timezone is a host (container) timezone.
The schedule is ignored if the event was toggled manually with /server upgrades fever commands. Use /server upgrades fever auto to revert to schedule mode.
Schedule item params:
┌───────────── second (0-59) of the start
│ ┌───────────── minute (0-59) of the start
│ │ ┌───────────── hour (0-23) of the start
│ │ │ ┌───────────── day of the week (0 - 6) (Sunday to Saturday) of the start
│ │ │ │
* * * * <duration in minutes>
Example: the schedule 0 30 16 0 390, 0 0 14 4 720, 0 0 12 6 1440 will run fever event on Sundays from 16:30 to 23:00, Thursdays from 14:00 to 02:00 the next day and Saturdays from 12:00 to 12:00 the next day.
Default: true
Enable or disable user accounts. Requires valid AUTH_LOGIN_SERVER_KEY_URL.
Default: true
Disabling will improve game server performance.
Default: ""
The player will receive these messages after joining to the game. Parsed as array, use %split% as a delimiter and %username% to address the player.
Example: "Hello, %username%!%split%Welcome to AB FFA server." will be sent as two whisper messages for the player with name "wight": "Hello, wight!" and "Welcome to AB FFA server.".
Default: true
Enable or disable bots ip list.
By default, the project is built into the ./dist/ directory.