Skip to main content

Settings

This page explains all settings currently available in the admin panel and what they do in daily server operations.

Navigation path:

  • Server Admin -> Settings

Access requirements​

  • settings.view to see every setting.
  • settings.edit to change and save every setting — or single areas and settings below it, see Settings for moderators. Someone who may change only single settings sees just those, unless they also hold settings.view.

How the page works​

  • Areas: the settings are grouped into twelve areas, listed on the left (on a phone: a list you tap to open an area). The number next to an area is how many settings it holds.
  • Search: the search above the areas finds a setting by its name or help text, wherever it lives. Picking a hit opens its area, scrolls to the setting and highlights it briefly.
  • Previews: settings whose effect is easier to see than to describe — the colour palette, faction tags, channel names, the Discord leaderboards, the guest navigation, poker rake and a few more — have a Preview handle underneath. It opens a preview that follows your unsaved input.
  • Saving: as soon as you change something, a bar at the bottom shows how many changes are waiting and in which areas, with Discard and Save. Switching areas keeps your changes; one Save stores all of them. Leaving the page with unsaved changes asks first.
  • Old links to a settings tab (?tab=…) open the matching area.

Server​

Server is active​

Master on/off switch for server functionality. It sits on its own at the top of the Server area, in the Server status card. When disabled, feature execution is paused, but connection updates to Nitrado still continue so you can reactivate quickly.

The switch can also flip on its own: if Nitrado declines a payment, dzbot deactivates the server automatically. It stays off until you turn it back on here, and a banner in the admin area tells you while that is the case.

Server name​

Name used across dzbot where the original game server name is too long. Use a short project/community name for clean UI and messages.

Subdomain​

Your player-facing URL is based on this value: <subdomain>.dzbot.de. Keep it short and easy to share.

Email address​

Used for important server-related communication.

Timezone​

Used for scheduling behavior (for example scheduler task execution times) and for showing times. If scheduled times look wrong, verify this setting first.

It does not affect how your game server's logs are read: dzbot detects the clock those logs are written in by itself, because it follows the location of your Nitrado server rather than this setting.

Language​

Portal default language for your server context. If a player has not chosen a language yet, this setting defines default communication language.

Audit retention (months)​

How long administrative audit entries are kept, between 1 and 120 months. A shorter window permanently drops older entries; the change itself is recorded in the audit log.

Map & Bases​

The map your server runs, and how the base overview shows bases on it.

Map​

Chernarus, Livonia, Sakhal or Nasdara. Saving sets the map at Nitrado, and the server loads it on its next restart. You no longer need the Nitrado web interface for this. Until that restart, the help text below the field names the map still running.

Changing the map at Nitrado directly works too: dzbot notices on the next boot and updates this setting.

Every map keeps its own save. Switch back and the characters, bases and loot of that map are still there.

Share loot settings​

Who may see what dzbot reads from your server's mission files. Off by default.

What is shared — always as rough levels, never the exact numbers from your types.xml:

  • how rare each item is on your server (from not rare to extremely rare) and whether that differs from vanilla
  • where it is found (military, police, farms …) and how widely it is spread over the map
  • how long tents, storage and base building parts stay set up
  • whether your server is colder or warmer than vanilla and whether it has more or less loot overall and per kind of item (weapons, food, medical supplies …)
  • which of your shop sets contain the item — only sets players can see and buy, and no sets limited to groups

It is shown in the item wiki and on the map, together with your server's heli crashes, vehicles, contaminated zones, animal territories and spawns (see Events, spawns and loot from your server).

OptionWho sees it
OffNobody. The map and the web app's Wiki page show the vanilla values instead.
Members onlyPlayers of your server: in the web app, and on wiki.dzbot.de and map.dzbot.de under My servers when they are signed in. Guests see the vanilla layers.
PublicEveryone, guests too. Your server is also listed under Public servers on wiki.dzbot.de.

Who sees the web app's Wiki page at all is set apart from this: the right wiki.access and the Wiki switch under Guest pages. Switching sharing on reads your mission files right away; switching it off deletes what was read.

Base clean-up queue​

Turns on the Queue tab of the base overview and the on-site findings ("still standing" / "nothing left"). Off by default: without a team that actually drives out to decaying bases, the overview stays purely informational.

Smallest base size on the map​

Bases below this size are not drawn on the map by default. Viewers can deviate from it per session, and labels appear from Large upwards regardless.

Base size: small / medium / large / fortress from​

Substance — net build and placement events — at which a base reaches the next size band. Defaults are 10, 50, 250 and 1000; a fence is roughly five events. The bands are display filters only, so changing them discards nothing and applies immediately. Recalibrate on the Bases page derives all four from your own server's distribution.

Stats & Leaderboards​

Stats wipe date​

All leaderboards and player statistics only count data from this date on. Move it forward to reset every statistic — for example after a server wipe. Defaults to the date the server was created.

PvP kill: minimum victim survival time (minutes)​

Kills where the victim had been alive for less than this many minutes are spawn kills: they are marked Spawn Kill in the kill feed, in Discord, in the Log Explorer and for actions, and left out of every PvP kill statistic (kills, K/D, kill streak, longest kill) on leaderboards and player profiles. 0 counts every kill and marks none as a spawn kill. The default is 2 minutes: a kill within 120 seconds of the victim's spawn is a spawn kill. The victim's alive time is exact to the second during the first 5 minutes of a life and counted in 5-minute steps after that. Kills from before mid-October 2026 only know the 5-minute steps, so for them any value up to 5 means "killed before the victim's first 5-minute mark". See Kill context.

Discord Leaderboard Channel​

Choose the Discord text channel where dzbot keeps one message with your leaderboards up to date. It is refreshed every 15 minutes and redrawn right away when you change one of the leaderboard settings. If someone deletes the message, dzbot posts it again; if you clear or change the channel, dzbot removes it from the old one.

The numbers are the same as on the web leaderboard, including the stats wipe date and the ban and alt-account rules. Players who linked Discord are shown as mentions (without pinging anyone).

Use a channel of its own. A leaderboard pointed at the online players channel is skipped, because both would claim the same message. The bot needs View Channel, Send Messages, Read Message History and Embed Links there; missing permissions show up in the Discord audit like for the online players channel.

  • Leaderboards in Discord — which boards to show and in which order, at most 10. Empty means PvP kills, K/D ratio, longest kill and most active.
  • Discord leaderboard period — all-time since the stats wipe (default), this month or this week.

Whitelist & Accounts​

Whitelist enabled​

Only players on whitelist can join. Admins are automatically whitelisted. For reliable enforcement through dzbot, keep Synchronize player lists enabled.

Auto-whitelist linked players​

Players are added to whitelist automatically after successful account linking. Recommended for faster onboarding and less manual work. For this to reach your game server automatically, keep Synchronize player lists enabled.

Auto-whitelist multi-accounts of whitelisted players​

Accounts that share a game device with a whitelisted player are whitelisted too — even on a server they have never played on, as long as the device was seen on any server of your organization. Banned or blocked accounts are left out. See whitelist.

Synchronize player lists​

Synchronizes restriction (ban), priority, and whitelist lists from dzbot to your game server.

Important behavior:

  • Enabling this makes dzbot your source of truth for those lists.
  • Before the first sync, dzbot takes over every entry that so far only exists on Nitrado: bans become permanent bans, whitelist and priority entries land on the player. Only then are the lists on the game server overwritten.
  • Entries dzbot adds on its own (alt accounts of a banned or prioritized player) are not taken over.
  • Newly connected servers have it on. While it is off, the admin area shows a warning.

Disable account linking​

When enabled, no new accounts can be linked — neither through claiming nor through Discord connections. Existing links stay as they are.

Players must accept the rules​

When enabled, every page of the player portal redirects to the server rules until the player accepts them; the rules page is then open to every player, whatever their rights. Rules already published in Discord get an Accept rules button underneath (it disappears again when you switch this off). Off by default.

Default Groups​

Groups automatically assigned to new players. Useful for baseline permissions and starter access.

Include cross-server alt accounts in ban list​

Bans with Include all accounts always cover the device-linked accounts that have played on this server. When enabled, the ban list exported to Nitrado also includes the linked accounts that have only played on other servers of your organization.

This means: if a player is banned and that ban targets all linked accounts, every account sharing a device with them is banned here before it ever joins.

Requires Synchronize player lists to be enabled for the expanded ban list to reach your game server.

Disabled by default — opt in if you want those accounts kept off this server too.

For more details on how alt account coverage works in restrictions, see Restrictions concept.

Warning stages​

What a number of active warnings on this server leads to: each stage is a count and a ban duration (empty for a permanent ban), for example 3 → 1d, 5 → 7d, 7 → permanent. Reaching a stage bans the player automatically. Empty by default, which means warnings never ban. How warnings count and when a stage fires again is described under Warnings.

Factions​

Everything about factions in one place.

Max. faction leaders​

How many members of a faction may hold the leader role. Default 1.

Faction tags​

Shows each faction's tag behind its members' names, in the web app and on Discord. Off by default. Three more settings in the Factions area belong to it:

  • Who may set faction tags — admins only, or also faction members who may edit their faction's details.
  • Faction tag format — where the tag goes, with {name} and {tag}; default {name} [{tag}]. The Preview handle shows a name with the tag.
  • Show the main account's tag on alt accounts — alt accounts show the tag of their main account, visible to everyone.

See Faction tags.

Allow faction alliances​

Lets factions found named alliances, invite further factions, leave and vote members out; a faction can be in several alliances. Allies do not trigger their partners' base alarms (can be turned off per alarm), cannot collect bounties on each other, and a kill or hit between allies is recorded as an alliance violation on the faction page. See Alliances.

On by default. Turning it off hides all alliances and they no longer count anywhere; existing alliances are kept for when it is turned on again.

Alliance violation notifications​

Lets faction members sign up on the faction page for a Discord DM whenever a member of their faction kills an ally or is killed by one. Each member decides for themselves; the message does not name a location. See Alliance violations.

Off by default.

Show faction members on the map​

Lets faction members share their location with their own faction; the faction then sees them as a separate layer on the map. Every member decides for themselves on the faction page — nothing is shown until a member opts in. See Factions in player view.

Off by default. Turning it off hides all shared locations immediately; the members' choices are kept for when it is turned on again.

Allow sharing locations with allies​

Lets members who share their location also make it visible to allied factions — each member picks This faction only or Faction and allies. Only works while Show faction members on the map is on.

On by default; members still share with their own faction only until they choose otherwise.

Excluded flags (available flags dialog)​

Flags hidden from players in the available flags dialog. Excluded flags stay selectable in the faction flag pickers.

Discord category for faction chats​

When set, dzbot creates a private channel in this category for every faction, visible only to its members through the faction's Discord role. Setting it creates the channels for all existing factions. Channels are renamed with their faction and deleted with it. When the category is full (50 channels), dzbot creates a follow-up category "<name> 2". Clearing the setting keeps the channels but stops maintaining them. See Faction and alliance chats.

Discord category for alliance chats​

The same for alliances: one private channel per active alliance, visible to the members of all its factions. The channel is deleted when the alliance ends.

Faction leader role​

The Discord role every faction leader gets. dzbot grants it when a member receives the leader right in a faction and removes it when they lose it.

Faction role name​

What each faction's Discord role is called, with {name} for the faction name: with {name} (S1) the role of the faction Wolves is called Wolves (S1), with S1 {name} it is S1 Wolves. Use it when several servers share one Discord, so their faction roles stay apart. Default {name} — the role carries just the faction name. Changing it renames the existing faction roles within a few moments.

Discord Connection​

The player slash commands (/bank, /bet, /faction, /event and the others) need no setting: they are available on every Discord with the dzbot bot as soon as this server is connected, and follow the rights of each player's groups. Only the leaderboard channel (under Stats & Leaderboards) belongs to them. See Discord commands.

Discord Server​

Connects dzbot to your Discord guild. This field shows the Discord servers available through your connected Discord account, so you can select a server even before the dzbot bot has joined it. After saving a new selection, dzbot checks bot installation status in the background. If a server you expect is missing, reconnect your Discord account so dzbot can refresh the guild list with the guilds OAuth scope. If dzbot is not installed yet, the warning link on this page opens Discord's bot authorization dialog with the selected server preselected.

Owned Discord Categories (shared guilds)​

Only needed when two or more game servers share one Discord guild. Select the Discord categories that belong to this server; incoming Discord events in channels inside them (tickets, AI companion) are routed to this server. Leave the list empty to make this server the fallback that handles everything not claimed by another server.

See Multiple game servers in one Discord guild for the full setup guide and pitfalls.

Discord Support Channel​

Choose the Discord text channel for support/task notifications (for example log access requests).

Discord Online Players Channel​

Choose the Discord text channel where dzbot keeps an updated online players message.

Voice channel counters​

Live numbers as the names of locked voice channels: players online, kills, deaths, longest kill and best kill streak of the day, open bounties, the most players at once today and the number of different players today. Switch on the counters you want and, if you like, change the name — {value} marks where the number goes; empty means the default in the server's language.

dzbot creates the channels in a category of their own and renames them at most every six minutes, only when a number changed. Switching a counter off deletes its channel. See Voice channel counters for what each number counts and what the bot needs.

Discord Killfeed Channel​

Choose the Discord text channel where dzbot posts PvP kill events.

Discord Damage Feed Channel​

Choose the Discord text channel where dzbot posts PvP damage events.

Discord rules channel​

The channel where dzbot publishes your server rules. Use Sync with Discord on the rules page to post the current rules there.

Synchronization of Discord names​

Synchronizes Discord nicknames with in-game player names. Makes support and moderation easier. With faction tags on, nicknames carry the tag too.

Remove connected role on ban​

When enabled, banned players lose their Connected Discord role for the length of the ban. The role comes back automatically when the ban expires or is lifted, as long as the player is still linked.

Anonymize Discord channel names​

Names ticket channels ticket-7kqm and base-alarm channels base-alarm-7kqm — after their code — instead of after the ticket's subject or the faction and player the alarm belongs to. Anyone who can see your channel list can otherwise read those names.

New servers have this on. Servers that existed when the setting was introduced were left as they were, so turn it on deliberately if you want it. Switching it either way renames the channels that already exist.

Discord dropdown behavior​

  • The guild, role, channel, and category fields load live data from Discord. A role or channel you create, rename, or delete in Discord shows up the next time the page loads.
  • If one is still missing, click the reload button next to the dropdown to fetch roles and channels from Discord again.
  • Select and save Discord Server first.
  • After saving, reload Server Admin → Settings → Discord Connection to refresh the available channel and category dropdowns for that server.
  • If a previously saved Discord selection is no longer available, dzbot keeps the saved value until you replace or clear it.

Tickets​

Discord Tickets Channel Prefix​

Controls the prefix used for Discord ticket channel names. Use a short, readable prefix such as ticket or support.

Tickets Auto Archive​

If enabled, closing a ticket archives it immediately. This removes the Discord channel instead of leaving it in the closed state and sends the reopen/view DM flow to participants.

Shop & Payments​

Players may schedule orders​

Players can pick a later restart for an order instead of the next one. The order is delivered at the first restart from the chosen time on.

Price for Base Alarm​

Hourly price for base alarm usage. Set to -1 to turn off buying base alarms: factions can no longer buy new alarms, and the faction page shows a short note instead of the buy button. Alarms that already exist keep running at the price they were bought for.

Discord Base Alarms Category​

Choose the Discord category where dzbot creates and manages base alarm channels.

Referral reward amount​

How much currency a player receives when someone they referred claims their account. 0 turns referrals off.

Maximum single payment​

Upper limit for one support payment (player checkout and manual entry), in euros. The default of 250 € keeps single receipts within the German small-amount limit (§ 33 UStDV), so invoices need no recipient address. Servers in other countries can raise it.

Bounties & Bookmaker​

Hitman payout (in %)​

How much bounty value is paid to the killer. Remaining amount stays with server logic.

Minimum bounty amount​

Minimum value required when players create a bounty.

Bookmaker payout percentage​

Share of the total pot paid out to the winners. The rest is destroyed.

Bookmaker minimum and maximum bet​

The smallest and largest amount a player can stake per entry. Global defaults — bookmakers can override them per bet.

Bookmaker odds visibility​

Whether players can see the odds (how the stakes are spread) of a bet.

Casino​

Slot machine, wheel of fortune, blackjack and roulette, plus the voice and text chat of the game tables.

Casino Bet​

Fixed stake for one slot machine spin. Players cannot change it.

Casino Initial Jackpot​

Jackpot reset amount after a jackpot win. See Slot Machine for how the jackpot fills and pays out.

Casino Free Games Per Day​

Number of free casino plays each player gets per day. Set to 0 to disable only the daily server free games. Free games are consumed before paid spins and do not count against the paid daily spin limit. Wheel of Fortune bonus free games are separate stored player rewards and can still exist even when this setting is 0.

Casino Max Daily Spins​

Maximum number of paid slot machine spins per player within any 24 hours. Free games do not count.

Casino Free Spin Jackpot Rate​

Share of the stake, in percent, that a losing free spin adds to the slot jackpot. Default 70.

Wheel of Fortune Spin Limit​

Maximum number of wheel spins each player can use during the configured interval. Set to 0 to disable free spins. If the Wheel of Fortune Spin Price is also 0, the wheel is disabled entirely.

Wheel of Fortune Spin Interval​

Defines when the wheel spin limit resets. Available values are day, week, and month.

Wheel of Fortune Spin Price​

Price players pay per spin when they have no free spins remaining. Set to 0 to disable paid spins.

When both the spin limit and spin price are 0, the wheel is fully disabled. When the spin limit is 0 and the spin price is greater than 0, the wheel runs in pay-to-spin only mode — players always pay the configured price per spin without any free spins.

Display odds on Wheel of Fortune​

Controls whether the wheel visually exposes the configured prize odds.

When enabled, slice sizes match the configured prize weights. When disabled, all slices use the same visual size so players cannot infer odds from the wheel layout.

Blackjack Min Bet​

Lowest amount a player may place on a blackjack hand.

Blackjack Max Bet​

Highest amount a player may place on a blackjack hand.

Blackjack daily limit​

Most a player may stake at blackjack per day. 0 turns the limit off.

Roulette minimum bet​

The smallest stake a player may place on a roulette field.

Roulette maximum inside and outside bet​

The largest stake per round on an inside bet (single numbers and small groups) and on an outside bet (red/black, odd/even, dozens, columns).

Roulette daily limit​

Most a player may stake at roulette per day. 0 turns the limit off.

Roulette betting time in seconds​

How long each round accepts bets before the ball rolls, between 25 and 90.

Voice and text chat​

Adds a chat room to pages such as the roulette table and each poker table, where players can write and — after opting in — talk. Off by default. See Voice and text chat.

Poker​

See Poker.

Poker Smallest Big Blind​

The lowest blind level a newly opened poker table may use. Players are offered every level of the series 10, 20, 50, 100, 200, 500 … between this and the largest big blind. See Poker.

Poker Largest Big Blind​

The highest blind level a newly opened poker table may use. Changing the range only affects new tables.

Poker House Share Percent​

Share of every poker pot with a flop that the house keeps (the rake), between 0 and 10. 0 takes nothing. The house share is destroyed, not paid to anyone.

Poker House Share Cap In Big Blinds​

The most the house takes from one poker hand, counted in big blinds, between 0 and 20. 0 means no cap.

Poker Seconds Per Decision​

Time a poker player has for each decision, between 10 and 120. When it runs out the player checks if that is free and folds otherwise.

Poker Daily Loss Limit​

Most a player may lose at poker per day — buy-ins minus cash-outs. 0 turns it off. Money still on a table counts as lost until the player stands up.

Portal & App​

Colour palette​

The accent colour of the player portal and the guest pages: amber (default), teal, cyan, fuchsia, lime or orange. The Preview handle under the cards shows a slice of the player area in the picked palette; nothing changes for players until you save. The admin area keeps its own colour, and status colours (delivered, pending, banned, …) look the same in every palette.

Server home page​

Optional Markdown content (per language) shown on the public home page of your server portal. When set, a Home tab appears in the navigation so visitors can get back to it.

Search engines read it too: its first sentences (after the heading) become the description under your server in Google results, so open with what makes your server worth joining. Without a home page text the description is a generic line built from your server name, platform and map.

Guest pages​

Which pages visitors can open without logging in, each with its own switch: rules, killfeed (positions are never shown to guests), factions, map (see The map for guests — while the server is paid or in its trial it is also offered on map.dzbot.de), wiki (see On a server's web app — with your loot where you share it publicly, vanilla values otherwise), leaderboard, public player profiles (see Public player profiles), events, achievements (without individual player progress) and support. The preview shows the navigation guests get.

Every page switched on here — plus the home page and public custom pages — is listed for search engines in German and English, so your server can be found by its name. Pages that are switched off stay out of search results.

Default visibility of custom pages​

Who sees the custom pages that do not set their own visibility: Public (guests too), Logged-in players (default) or Specific groups. Changing it affects every page set to Use server default at once.

Groups for custom pages​

The groups whose members see those pages while the default visibility is Specific groups. With that visibility, saving without a group is refused — the pages would be hidden from everyone.

Show PWA install prompt​

When enabled, players are asked through a banner and a dialog to install the app on their device. Turn it off if players should always use the browser.

App name​

The name on the home screen and in the install dialog when players add the app to their device. Falls back to the server subdomain when empty.

High-impact side effects to know​

  • Changing Subdomain updates your server subdomain mapping.
  • Changing Discord Server triggers a Discord bot installation check.
  • Changing Whitelist enabled, Auto-whitelist linked players or Auto-whitelist multi-accounts of whitelisted players triggers a server list sync update job with nitrado (see whitelist).

These are expected behaviors and help keep your server state in sync.

Also in Discord: /server switches the whitelist, account linking and Discord nickname sync, restarts the server and manages site alerts — with the same rights as on this page.