List of config keys
Normally you should use ConfigGUI to edit the parameters. But if you're feeling adventurous, you could try editing it by hand. Below is a list of all configuration keys in
config.xml. Edit at your own risk!
See also: config version history.
|ServerName||String||"Custom Minecraft Server (fCraft)"||The name of the server, as shown on the welcome screen and the official server list (if server is public).||Between 1 and 64 characters long.|
|MOTD||String||"Welcome to the server!"||MOTD (Message Of The Day) is a message shown to connecting players right under the server name. It may be left blank. If WoMEnableEnvExtensions is enabled, non-WoM users will not see this.||Between 0 and 64 characters long.|
|MaxPlayers||Integer||20||Maximum number of players on the server. Having more players uses more RAM and more bandwidth. If a player's rank is given a "reserved slot" on the server, they can join even if server is full.||Between 1 and 1000.|
|MaxPlayersPerWorld||Integer||20||Maximum number of players allowed to be on the same world at the same time. Minecraft protocol limits total number of players per world to 128. Note that having more people on a world increases everyone's bandwidth use.||Between 1 and 128.|
|DefaultRank||Rank||Blank ("lowest rank")||New players will be assigned this rank by default. It's generally a good idea not to give new players many powers until they prove themselves trustworthy.||Full rank name. Leave blank for "lowest rank."|
|IsPublic||True/False||False||Public servers are listed on minecraft.net server list, so expect random players to join. Private servers can only be joined by players who already know the server port/address or URL. Note that the URL changes if your computer's IP or server's port change.||"True" or "False"|
|Port||Integer||25565||Port number on your local machine that fCraft uses to listen for incoming connections. If you are behind a router, you may need to set up port forwarding. You may also need to add a firewall exception for ServerGUI/ServerCLI/ConfigGUI. Note that your server's URL will change if you change the port number.||Between 1 and 65535.|
|UploadBandwidth||Integer (KB/s)||100||Total available upload bandwidth, in kilobytes per second (KB/s). This number is used to pace drawing commands to prevent server from overwhelming the Internet connection with data.||Between 1 and 32767.|
|RankColorsInChat||True/False||True||Whether to color player names in chat and in-game based on their rank.||"True" or "False"|
|RankColorsInWorldNames||True/False||True||Whether to color world names in chat based on their build/access permissions.||"True" or "False"|
|RankPrefixesInChat||True/False||False||Whether to show rank prefixes in chat before player names. This can be used to set up IRC-style "+" and "@" prefixes for ops.||"True" or "False"|
|RankPrefixesOnDisplayedNames||True/False||False||Whether to prepend rank prefixes to players with a custom DisplayedName set.||"True" or "False"|
|RankPrefixesInList||True/False||False||Whether to show prefixes in the player list. As a side-effect, Minecraft client will not show custom skins for players with prefixed names.||"True" or "False"|
|ShowConnectionMessages||True/False||True||Whether to announce players joining or leaving the server in chat.||"True" or "False"|
|ShowJoinedWorldMessages||True/False||True||Whether to show messages when players change worlds.||"True" or "False"|
|SystemMessageColor||Color||Color of normal system messages (e.g. command feedback).||Color code or name.|
|HelpColor||Color||Color of command usage examples in help.||Color code or name.|
|SayColor||Color||Color of messages produced by /Say command.||Color code or name.|
|AnnouncementColor||Color||Color of announcements and rules. Default is dark-green. Note that this default color can be overridden by colorcodes in announcement and rule files.||Color code or name.|
|PrivateMessageColor||Color||Color of private and rank-wide messages.||Color code or name.|
|MeColor||Color||Color of /Me command messages.||Color code or name.|
|WarningColor||Color||Color of error and warning messages.||Color code or name.|
|AnnouncementInterval||Integer (Minutes)||0 ("disabled")||Announcement interval, in minutes. Set to 0 to disable announcements. Announcements are shown to all players, one line at a time, in random order.||Between 1 and 2147483647, or 0 to disable.|
|DefaultBuildRank||Rank||Blank ("default rank")||When new worlds are created with the /WLoad command, the build permission for new worlds will default to this rank.|| Full rank name.
Leave blank for "default rank."
|MapPath||Path||Blank ("./maps/")||Custom path for storing map files. If you change this value, make sure to move the map files before starting the server again. If folder does not exist, fCraft will attempt to create it. Requires a full server restart to change the setting (cannot be updated with /Reload). If the command-line "mappath" parameter is given, this setting is overridden.|| Absolute path, or path relative to the working path.
Leave blank for default value ("./maps/").
|VerifyNames||Enumeration||"Balanced"|| Name verification ensures that connecting players are not impersonating someone else.
||"Never" / "Balanced" / "Always"|
|MaxConnectionsPerIP||Integer||0 ("unlimited")||Restricts the number of connections allowed from any one IP address. Note that all players on the same LAN will share an IP, and may be prevented from joining together.||Between 1 and 2147483647, or 0 for "unlimited".|
|AllowUnverifiedLAN||True/False||False||Allow players from your local network (LAN) to connect without name verification. May be useful if minecraft.net is blocked on your LAN for some reason, or your LAN friends are having trouble joining. Warning: Unverified players can log in with ANY name - even as you! Do not enable this on public networks.||"True" or "False"|
|PatrolledRank||Rank||Blank ("default rank")||When players use /Patrol or /SpecPatrol commands, they will be teleported to players of this (or lower) rank. "Patrolling" means teleporting to other players to check on them, usually while hidden.||Full rank name. Leave blank for "default rank."|
|AntispamMessageCount||Integer||4||Number of messages that a player needs to type within AntispamInterval seconds to trigger the AntiSpam warning. Set this to 0 to disable AntiSpam.||Between 2 and 64, or 0 for "unlimited".|
|AntispamInterval||Integer||5||Number of seconds over which the player needs to type AntispamMessageCount messages to trigger AntiSpam warning. Set this to 0 to disable AntiSpam.||Between 1 and 64, or 0 for "unlimited".|
|AntispamMuteDuration||Integer (Seconds)||5||Duration of automatic mute if AntiSpam is triggered, in seconds. Set this to 0 to disable automatic mute (and only leave the warning).||Between 1 and 86400, or 0 for "disabled".|
|AntispamMaxWarnings||Integer||2||Number of warnings given to a player (number of times AntiSpam is triggered) before the player is kicked. Set this to 0 to disable automatic kicks.||Between 1 and 64, or 0 for "disabled".|
|PaidPlayersOnly||True/False||False||Only allow players who have a paid Minecraft account (not recommended). This will help filter out griefers with throwaway accounts, but will also prevent many legitimate players from joining.||"True" or "False"|
|RequireBanReason||True/False||False||Require players to specify a reason/memo when banning or unbanning someone.||"True" or "False"|
|RequireKickReason||True/False||False||Require players to specify a reason/memo when kicking someone.||"True" or "False"|
|RequireRankChangeReason||True/False||False||Require players to specify a reason/memo when promoting or demoting someone.||"True" or "False"|
|AnnounceKickAndBanReasons||True/False||True||Announce the reason/memo in chat when someone gets kicked/banned/unbanned.||"True" or "False"|
|AnnounceRankChanges||True/False||True||Announce promotions and demotions in chat.||"True" or "False"|
|AnnounceRankChangeReasons||True/False||True||Announce the reason/memo in chat when someone gets promoted or demoted.||"True" or "False"|
|BlockDBEnabled||True/False||True||If enabled, allows edit information to be stored per-block. Enables /BlockDB, /BInfo, /UndoArea, and /UndoPlayer commands. Requires a full server restart to change the setting (cannot be updated with /Reload).||"True" or "False"|
|BlockDBAutoEnable||True/False||True||Automatically enabled BlockDB on all worlds editable by a certain rank or below. Has no effect unless BlockDBEnabled is set to "True"||"True" or "False"|
|BlockDBAutoEnableRank||Rank||Blank ("default rank")||Worlds editable by players of this rank (or below) will have BlockDB enabled automatically. Has no effect unless BlockDBEnabled and BlockDBAutoEnable are set to "True"||Full rank name. Leave blank for "default rank."|
Saving and Backup
|SaveInterval||Integer (Seconds)||90||Auto-save interval for loaded map files. A higher setting (120+ seconds) is recommended for busy servers with many maps. If disabled (set to 0), maps are only saved when a world is unloaded or when the server is shut down.||Between 10 and 2147483647 seconds, or 0 for "disabled".|
|BackupOnStartup||True/False||False||Whether to create a backup of every map when the server starts.||"True" or "False"|
|BackupOnMapChange||True/False||True|| Create backups every time a world's map is replaced, by
||"True" or "False"|
|BackupOnlyWhenChanged||True/False||False||Only create backups if the map was modified since last backup.||"True" or "False"|
|DefaultBackupInterval||Integer (Minutes)||20||Default interval for saving periodic map backups for loaded worlds. A world is considered "loaded" if there is at least one player on it. This setting can be overridden on a per-world basis. Set to 0 to disable periodic backups by default.||Between 1 and 2147483647 minutes, or 0 for "disabled".|
|MaxBackups||Integer (Files)||0 ("unlimited")||Maximum number of backup files that fCraft should keep. If exceeded, oldest backups will be deleted first.||Between 1 and 2147483647 backups, or 0 for "unlimited".|
|MaxBackupSize||Integer (MB)||0 ("unlimited")||Maximum combined filesize of all backups, in MB. If exceeded, oldest backups will be deleted first.||Between 1 and 2147483647 MB, or 0 for "unlimited".|
|BackupDataOnStartup||True/False||False||Create backups of server data (PlayerDB, IPBanList, config.xml, and worlds.xml) on server startup. Backups are zipped and placed into "databackups" directory.||"True" or "False"|
|LogMode||Enumeration||"OneFile"|| Log file organization:
||"OneFile" / "SplitBySession" / "SplitByDay"|
|MaxLogs||Integer (Files)||0 ("unlimited")||Maximum number of log files to keep. If exceeded, oldest logs will be erased first. Set this to 0 to keep all logs.||Between 1 and 2147483647 logfiles, or 0 for "unlimited".|
|IRCBotEnabled||True/False||False||fCraft includes an IRC (Internet Relay Chat) client for relaying messages to and from any IRC network. Note that encrypted IRC (via SSL) is not supported.||"True" or "False"|
|IRCBotNick||String||"MinecraftBot"||IRC bot's nickname. If the nickname is taken, fCraft will append an underscore (_) to the name and retry.||Between 1 and 30 characters long.|
|IRCBotNetwork||String||"irc.esper.net"||Host or address of the IRC network.||A valid IP address (without the port number), or hostname.|
|IRCBotPort||Integer||6667||Port number of the IRC network. Most networks use port 6667.||Between 1 and 65535.|
|IRCBotChannels||String||"#changeme"||Comma-separated list of channels to join. Channel names should include the hash (#). One some IRC networks, channel names are case-sensitive.||Cannot be left blank.|
|IRCBotForwardFromServer||True/False||False||If checked, all chat messages on IRC are shown in the game. Otherwise, only IRC messages starting with a hash (#) will be relayed.||"True" or "False"|
|IRCBotForwardFromIRC||True/False||False||If checked, all chat messages from the server are shown on IRC.||"True" or "False"|
|IRCBotAnnounceServerJoins||True/False||False||Show a message on IRC when someone joins or leaves the server.||"True" or "False"|
|IRCBotAnnounceIRCJoins||True/False||False||Show a message in-game when someone joins or leaves the IRC channel.||"True" or "False"|
|IRCBotAnnounceServerEvents||True/False||True||Announce server events (kicks, bans, promotions, demotions) on IRC.||"True" or "False"|
|IRCRegisteredNick||True/False||False||Enable if bot's nickname is registered or requires identification/authentication.||"True" or "False"|
|IRCNickServ||String||"NickServ"|| Name of the nickname registration service bot
("Q" on QuakeNet, "NickServ" on most others). This setting has no effect is IRCRegisteredNick is disabled.
|Between 1 and 32 letters, a valid service bot name.|
|IRCNickServMessage||String||"IDENTIFY passwordGoesHere"|| Message to send to nickname registration service bot after connecting.
Replace "passwordGoesHere" with your actual nick password. This setting has no effect is IRCRegisteredNick is disabled.
|IRCMessageColor||Color||Color of IRC messages and event announcements, as seen on the server/in-game.||Color code or name.|
|IRCShowColorsFromServer||True/False||True||Whether colors in server messages should be shown on IRC.||"True" or "False"|
|IRCShowEmotesFromServer||True/False||True||Whether emotes in servers messages should be shown on IRC.||"True" or "False"|
|IRCShowColorsFromIRC||True/False||False||Whether colors in IRC messages (both ^K colorcodes and &-colorcodes) should be shown in-game.||"True" or "False"|
|IRCShowEmotesFromIRC||True/False||False||Whether Minecraft emote keywords and symbols in IRC messages should be shown in-game.||"True" or "False"|
|IRCDelay||Integer (Milliseconds)||750|| Minimum delay (in milliseconds) between messages sent to IRC. Many networks have strict message rate limits, so a delay of at least 500ms is recommended.
If the bot cannot send messages quickly enough, consider using dual bots (see IRCThreads key).
|Between 0 and 10000.|
|IRCThreads||Integer (Bots)||1|| Number of IRC bots to operate simultaneously. Using multiple bots helps bypass message rate limits on some servers.
Note that some networks frown upon having multiple connections from one IP. It is recommended to leave this at 1 unless you are having specific issues with IRC bots falling behind on messages. This key can only be changed manually in config.xml, there is no corresponding ConfigGUI form.
|Between 1 and 3.|
|Warning: Altering advanced settings may decrease your server's stability and performance. If you're not sure what these settings do, you probably shouldn't change them...|
|SubmitCrashReports||True/False||True|| Crash reports are created when serious unexpected errors occur. Being able to receive crash reports helps identify bugs and improve fCraft!
The report consists of the error information, OS and runtime versions, a copy of config.xml, and last 25 lines of the log file. Reports are confidential and are not displayed publicly.
|"True" or "False"|
|UpdaterMode||Enumeration||"Prompt"|| fCraft can automatically update to latest stable versions. If enabled, the update check is done on-startup. Possible values are:
||"Disabled" / "Notify" / "Prompt" / "Auto"|
|RunBeforeUpdate||String||Blank||Command to execute (via operating system's shell) before the update is applied. Ran by the updater.||Can be left blank.|
|RunAfterUpdate||String||Blank||Command to execute (via operating system's shell) after the update is applied.||Can be left blank.|
|RelayAllBlockUpdates||True/False||False|| When a player places or deletes a block, vanilla Minecraft server relays the action back.
This is not needed, and only wastes bandwidth. However, you may need to enable this to make some Minecraft bots work.
|"True" or "False"|
|NoPartialPositionUpdates||True/False||False|| Minecraft protocol specifies 4 different movement packet types.
One of them sends absolute position, and other 3 send incremental relative positions. You may use this option to disable the relative updates. It is recommended to leave this disabled (it wastes bandwidth).
|"True" or "False"|
|ProcessPriority||Enumeration||"Normal"||fCraft process priority. It is recommended to leave fCraft at default priority. Setting this below ""Normal"" may starve fCraft of resources. Setting this above ""Normal"" may slow down other software on your machine. See ProcessPriorityClass documentation for details.||"Idle" / "BelowNormal" / "Normal" / "AboveNormal" / "High" / "RealTime"|
|BlockUpdateThrottling||Integer (Blocks/Second)||2048|| The maximum number of block changes that can be sent to each client per second.
Unmodified Minecraft client can only handle about 2500 updates per second. Setting this any higher may cause lag. Setting this lower will slow down drawing commands (like cuboid).
|Between 10 and 2147483647 blocks/seconds|
|TickInterval||Integer (Milliseconds)||100|| The rate at which fCraft applies block updates, in milliseconds.
Lowering this will slightly reduce bandwidth and CPU use, but will add latency to block placement.
|Between 10 and 10000 milliseconds|
|LowLatencyMode||True/False||False|| This mode reduces movement and block-placement lag by up to 200ms, at the cost of vastly increased bandwidth use.
It's only practical if you have a very fast connection with few players, or if your server is LAN-only. Note that this may make the lag **worse** for players with low-speed, low-bandwidth connections.
|"True" or "False"|
|MaxUndo||Integer (Blocks)||2000000|| The number of blocks that players can undo at a time. Only the most-recent draw command can be undo, so the actual
limit also depends on rank draw limits. Saving undo information takes up 8 bytes per block. If set to 0, there is no limit.
|Between 1 and 2147483647 blocks per command, or 0 for "unlimited"|
|MaxUndoStates||Integer (Commands)||5|| The number of states (commands to reverse) that /Undo can go back to.
Increasing the number of undo states also raises the maximum potential memory use per-player.
|Between 1 and 100 commands.|
|ConsoleName||String||"(console)"||Displayed name of the Console pseudoplayer. You may use any printable characters, and even color codes.||Between 1 and 64 characters.|
|AutoRankEnabled||True/False||False||***EXPERIMENTAL/UNSUPPORTED*** Enables AutoRank.||"True" or "False"|
|HeartbeatEnabled||True/False||True||Enable heartbeat to minecraft.net. If disabled, heartbeat data is written to heartbeatdata.txt instead.||"True" or "False"|
|WoMEnableEnvExtensions||True/False||False||If enabled, allows changing worlds' environment settings for WoM clients via /Env||"True" or "False"|
|IP||IP Address||Blank ("automatic").||If the machine has more than one available IP address (for example if you have more than one NIC) you can use this setting to make fCraft bind to the same IP every time. Do not set this key unless you know exactly what you're doing.||Any valid IP address. Leave blank to let fCraft choose the IP automatically (default).|
|BandwidthUseMode||Enumeration||"Normal"|| Determines the bandwidth use mode. High/Highest settings will reduce jitter of player movement, but increase bandwidth use. Low/Lowest settings will introduce some popping in/out of players and increase jitter, but will reduce bandwidth use. Detailed options:
||"VeryLow" / "Low" / "Normal" / "High" / "VeryHigh"|
|RestartInterval||Integer (Seconds)||0 ("disabled")||Automatically restarts the server after a given number of seconds.||Between 1 and 2147483647 seconds, or 0 to disable automatic restarts.|
|BypassHttpsCertificateValidation||True/False||False||Bypasses validation of HTTPS certificates, for heartbeat connections. May be useful under Mono.||"True" or "False"|
|MoveEmoteDotToEndOfMessage||True/False||True||Moves the emote suffix from end-of-line to immediately after its usage. It's just a cosmetic preference.||"True" or "False"|
URL to send heartbeats to. This config key is added in case a server uses an alternative login/heartbeat service, such as