Jump to content

List of config keys

From fCraft Wiki
Revision as of 04:12, 4 November 2011 by F (talk | contribs) (Security)
This page is a work in progress

General

Key Type Default Description Restrictions
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.

Chat

Key Type Default Description Restrictions
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 1-character prefixes in chat before player names. This can be used to set up IRC-style "+" and "@" prefixes for ops. "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 Yellow (E) Color of normal system messages (e.g. command feedback). Color code or name.
HelpColor Color Lime (A) Color of command usage examples in help. Color code or name.
SayColor Color Green (2) Color of messages produced by /Say command. Color code or name.
AnnouncementColor Color Green (2) 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 Aqua (B) Color of private and rank-wide messages. Color code or name.
MeColor Color Purple (5) Color of /Me command messages. Color code or name.
WarningColor Color Red (C) 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.

Worlds

Key Type Default Description Restrictions
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. Absolute path, or path relative to the working path. Leave blank for default value ("./maps/").

Security

Key Type Default Description Restrictions
VerifyNames Enumeration "Balanced" Name verification ensures that connecting players are not impersonating someone else. "Always" uses only the main verification method. It can sometimes produce false negatives - for example if server has just restarted, or if minecraft.net heartbeats are timing out. "Balanced" checks player's current and on-record IP address to eliminate false negatives. "Never" is dangerous, and may allow players to impersonate others. "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".