Configuration guide for FlameCord

The official complete configuration guide for your Minecraft server using FlameCord.

Logger

Settings for logging various server activities.

  • initialhandler: If false, disables logging of initial connection handling.
  • exceptions: If false, disables logging of exception traces. Recommended to keep false unless debugging.
  • dump: If false, disables memory dump logging.
  • detailed-connect-errors: If true, provides detailed errors during connection issues.

Custom MOTD

Customize the Message of the Day, player count, and server protocol shown in the server list.

  • motd.enabled: If true, enables the custom MOTD feature.
  • sample.enabled: If true, enables custom sample messages on player list hover.
  • protocol.enabled: If true, shows a custom protocol name (e.g., "Maintenance").
  • maxplayers.enabled: If true, fakes the maximum player count.
  • fakeplayers.enabled: If true, adds a fake number of players to the online count.

AntiBot

The core of FlameCord's protection. A multi-layered defense system to mitigate bot attacks.

Latency

Blocks connections with unusually high latency (ping).

  • enabled: If true, activates the high-latency check.
  • firewall: If true, automatically firewalls IPs that fail this check.
  • limit: The maximum allowed latency in milliseconds (e.g., 900ms).

Accounts

Limits the number of accounts that can join from a single IP address.

  • enabled: If true, limits accounts per IP.
  • limit: The maximum number of accounts allowed per IP (e.g., 3).

Country

Blocks or allows connections based on their country of origin.

  • enabled: If true, enables country filtering.
  • blacklist: A list of country codes (e.g., "CN", "RU") to block.

FastChat

Prevents players from spamming chat messages too quickly.

  • enabled: If true, enables the fast chat check.
  • time: The minimum time in milliseconds between messages (e.g., 1000ms).

Firewall

Manages the automatic firewalling of malicious IPs.

  • enabled: If true, activates the firewall system.
  • time: The duration in minutes that an IP remains firewalled (e.g., 60).
  • ipset: If true, uses the high-performance IPset on Linux (requires root).

Nickname

Blocks players with usernames matching known bot patterns.

  • enabled: If true, enables the nickname check.
  • blacklist: A list of names or patterns to block (e.g., "mcstorm").

Password

Prevents multiple accounts from using the same password to log in.

  • enabled: If true, enables the repeated password check.
  • limit: The maximum number of accounts that can use the same password.
  • login-commands: A list of your server's login/register commands.

RateLimit

Limits the number of new connections and pings per second from an IP.

  • enabled: If true, activates the rate limit.
  • connections-per-second: Max new connections per second from one IP.
  • pings-per-second: Max pings per second from one IP.

Reconnect

Asks suspicious new players to reconnect, a powerful filter against advanced bots.

  • enabled: If true, enables the reconnect check.
  • connections-trigger: Amount of connections per second to activate this check.

Proxy Check

Validates IPs against public lists of known proxies, VPNs, and malicious addresses.

  • enabled: If true, enables the proxy check.
  • online-check: If true, uses external APIs for real-time checks (requires email).
  • lists: The list of blocklist URLs to use.

Lockdown

A manual or automatic mode to temporarily block all new connections during a severe attack.

  • enabled: If true, the lockdown module is active.
  • period-limit: The number of connections per period to automatically trigger a lockdown.

Limbo

Redirects suspicious connections to an isolated "limbo" world for further verification (e.g., CAPTCHA).

  • enabled: If true, enables the limbo system.
  • trigger.connections: Number of connections within the period to activate limbo.

Packets

Monitors player packets to prevent server overload from packet abuse.

  • enabled: If true, activates the packet check system.
  • vls-to-kick: The violation level threshold at which a player is kicked.

Balancer

Distributes player connections evenly across multiple lobby servers.

  • enabled: If true, activates the balancer.
  • on-join: If true, balances players automatically when they first join.
  • fallback: If true, sends players to a lobby if their current server goes down.
  • servers: The list of servers to include in the balancing pool (e.g., "lobby1", "lobby2").

Maintenance Mode

Allows you to close the server to the public while allowing whitelisted staff to join.

  • enabled: If true, activates maintenance mode.
  • whitelist: A list of player names allowed to join during maintenance.