View source for Config version history

fCraft's configuration file (<code>config.xml</code>) format has changed a lot over the years. A version number has been used to automatically handle upgrades. First version was '''100'''. Current version of fCraft ({{LatestVersion}}) can read all config file starting with version '''111'''. Some of the format versions were reversed internally before release, or tried out in experimental versions only. Opening up <code>config.xml</code> in ConfigGUI and saving changes will automatically upgrade it to the lastest format. This page details the history of changes to the format.
==0.6xx==
{| class="wikitable"
!Config Version
!fCraft Release
!SVN Revision
!Date
!Changes
|-
|169
|{{Changelog|0.641}}
|r2134
|16 August 2013
|Added HeartbeatUrl config key
|-
|168
|{{Changelog|0.640}}
|r2119
|30 July 2013
|Added AllowEmailAccounts key

Added {{perm|ViewEmails}} permission.
|-
|167
|{{Changelog|0.640}}
|r2083
|23 July 2013
|Added BackupOnMapChange key

Removed useless BackupOnJoin key
|-
|166
|{{Changelog|0.639}}
|r1910
|7 December 2012
|Added BypassHttpsCertificateValidation and MoveEmoteDotToEndOfMessage keys
|-
|165
|{{Changelog|0.639}}
|r1896
|4 December 2012
|Added RankPrefixesOnDisplayedNames key
|-
|164
|{{Changelog|0.636}}
|r1828
|10 October 2012
|Removed IRCShowNewlinesFromIRC key
|-
|163
|{{Changelog|0.636}}
|r1823
|9 October 2012
|Added IRCShowNewlinesFromIRC and IRCShowEmotesFromServer keys

Renamed key IRCUseColor to IRCShowColorsFromServer

Renamed key IRCAllowMinecraftEmotes to IRCShowEmotesFromIRC

Replaced IRCStripMinecraftColors key with IRCShowColorsFromIRC
|-
|162
|{{Changelog|0.635}}
|r1800
|3 October 2012
|Added {{perm|UseEmotes}} permission and IRCAllowMinecraftEmotes key
|-
|161
|{{Changelog|0.634}}
|r1792
|28 September 2012
|Removed HeartbeatToWoMDirect, WoMDirectDescription, and WoMDirectFlags keys
|-
|160
|{{Changelog|0.632}}
|r1744
|6 September 2012
|Renamed "IRC" LogType to "IRCStatus", and added "IRCChat" LogType.
|-
|159
|{{Changelog|0.630}}
|r1650
|14 August 2012
|Added {{perm|UndoAll}} permission
|-
|158
|{{Changelog|0.630}}
|r1644
|12 August 2012
|Added {{perm|UseTimers}} and {{perm|FlushWorlds}} permissions (previously combined with {{perm|Say}} and {{perm|ManageWorlds}} permissions)
|-
|157
|{{Changelog|0.620}}
|r1586
|14 June 2012
|Added IRCStripMinecraftColors key
|-
|156
|unreleased
|r1473
|25 February 2012
|Removed AutoRankEnabled key
|-
|155
|{{Changelog|0.620}}
|r1464
|24 February 2012
|Added WoMDirectDescription and WoMDirectFlags keys
|-
|154
|unreleased
|r1312
|17 December 2011
|Added SeparateWorldAndGlobalChat key (default: false)
|-
|153
|unreleased
|r1284
|4 December 2011
|Added PlayerDBProvider data

Removed BackupDataOnStartup key
|-
|152
|{{Changelog|0.611}}
|r1242
|20 November 2011
|Removed LoadPlugins key

Changed the way config keys are organized in <code>config.xml</code>

Before:
 <fCraftConfig>
   <Section name="blah">
     <KeyName>Value</KeyName>
   </Section>
 </fCraftConfig>

After:
 <fCraftConfig>
   <Settings>
     <ConfigKey key="KeyName" value="Value" default="DefaultValue" />
   </Settings>
 </fCraftConfig>
|-
|151
|{{Changelog|0.610}}
|r1169
|27 October 2011
|Added MaxUndoStates key

Added fillLimit rank attribute.

Changed defaults for some keys:
*BlockDBEnabled to "true"
*WomEnableEnvExtensions to "false"
*IRCBotAnnounceServerEvents to "true"
|-
|150
|{{Changelog|0.600}}
|r1066
|2 October 2011
|Removed WoMDirectDescription key
|-
|149
|{{Changelog|0.600}}
|r1061
|30 September 2011
|Added HeartbeatToWoMDirect, WoMDirectDescription, and WoMEnableEnvExtensions keys
|-
|148
|{{Changelog|0.600}}
|r1014
|21 September 2011
|Added BlockDBAutoEnable and BlockDBAutoEnableRank keys

Moved BlockDBEnabled to Security ConfigSection
|-
|147
|{{Changelog|0.600}}
|r926
|1 September 2011
|Renamed EnableBlockDB key to BlockDBEnabled
|-
|146
|{{Changelog|0.600}}
|r910
|22 August 2011
|Renamed BackupInterval key to DefaultBackupInterval
|-
|145
|{{Changelog|0.600}}
|r794
|25 July 2011
|Added {{perm|UndoOthersActions}} permission.
|-
|144
|{{Changelog|0.600}}
|r787
|25 July 2011
|Added {{perm|DrawAdvanced}} permission.
|-
|143
|unreleased
|r676
|23 June 2011
|Added LoadPlugins key (unused)
|-
|142
|{{Changelog|0.600}}
|r638
|5 June 2011
|Added BackupDataOnStartup key.
|}

==0.5xx==
{| class="wikitable"
!Config Version
!fCraft Release
!SVN Revision
!Date
!Changes
|-
|141
|{{Changelog|0.534}}
|r622
|30 May 2011
|Added RestartInterval key.
|-
|140
|{{Changelog|0.534}}
|r616
|25 May 2011
|Added {{perm|Spectate}} permission.
|-
|139
|{{Changelog|0.530}}
|r578
|7 May 2011
|Fixed XML structure messed up by 138. Sections are now saved into <Section> elements.
|-
|138
|unreleased
|r577
|6 May 2011
|Removed SaveOnShutdown key.

Tweaked range checks on some keys.

Grouped key tags into section tags.

When saving, keys with default values are now commented out.
|-
|137
|{{Changelog|0.530}}
|r556
|22 April 2011
|Added BandwidthUseMode key.
|-
|136
|{{Changelog|0.530}}
|r528
|22 April 2011
|Added {{perm|BringAll}} permission.
|-
|135
|{{Changelog|0.520}}
|r526
|10 April 2011
|Added RequireKickReason and AnnounceRankChangeReasons keys

Added {{perm|ViewPlayerIPs}} permission
|-
|134
|{{Changelog|0.520}}
|r520
|7 April 2011
|Replaced LimitOneConnectionPerIP key with MaxConnectionsPerIP
|-
|133
|{{Changelog|0.520}}
|r517
|6 April 2011
|Added {{perm|UseColorCodes}} permission
|-
|132
|{{Changelog|0.510}}
|r477
|26 March 2011
|Added BackupBeforeUpdate, RunBeforeUpdate, and RunAfterUpdate keys

Renamed UpdateMode key to UpdaterMode
|-
|131
|{{Changelog|0.510}}
|r460
|18 March 2011
|Changed default for IRCNick from "fBot" to "MinecraftBot"

Relaxed range limits on many integer keys.

Renamed ProcessPriority value "Low" to "Idle", to match WinAPI

Renamed AutomaticUpdates key to UpdateMode

Renamed IRCBot key to IRCBotEnabled
|-
|130
|{{Changelog|0.503}}
|r413
|2 February 2011
|Added ShowBannedConnectionMessages key
|-
|129
|{{Changelog|0.501}}
|r405
|29 January 2011
|Added ShowConnectedMessages key
|-
|128
|{{Changelog|0.500}}
|r379
|15 January 2011
|Added ConsoleName key
|-
|127
|{{Changelog|0.500}}
|r367
|8 January 2011
|Removed PreventSecurityCircumvention key

Added per-rank AllowSecurityCircumvention setting instead
|-
|126
|unreleased
|r366
|8 January 2011
|Added PreventSecurityCircumvention key
|-
|125
|{{Changelog|0.500}}
|r356
|8 January 2011
|Removed LogPath and DataPath keys, in favor of [[command line options]]
|-
|124
|{{Changelog|0.500}}
|r354
|26 December 2010
|Added HeartbeatEnabled key
|-
|123
|{{Changelog|0.500}}
|r346
|19 December 2010
|Added IRCBotAnnounceServerEvents key
|-
|122
|{{Changelog|0.500}}
|r341
|16 December 2010
|Added IRCUseColor key
|-
|121
|{{Changelog|0.500}}
|r335
|11 December 2010
|Renamed SendRedundantBlockUpdates key to RelayAllBlockUpdates
|-
|120
|unreleased
|r332
|4 December 2010
|Added DataPath key
|-
|119
|unreleased
|r331
|4 December 2010
|Added LogPath and MapPath keys
|-
|118
|{{Changelog|0.500}}
|r318
|17 November 2010
|Added MeColor and WarningColor keys
|}

==0.4xx==
{| class="wikitable"
!Config Version
!fCraft Release
!SVN Revision
!Date
!Changes
|-
|116
|{{Changelog|0.491}}
|r272
|17 October 2010
|Added AutoRankEnabled key
|-
|115
|{{Changelog|0.491}}
|r265
|15 October 2010
|Added IRCThreads key
|-
|114
|{{Changelog|0.484}}
|r244
|10 October 2010
|Added IRCRegisteredNick, IRCNickServ, and IRCNickServMessage keys
|-
|113
|{{Changelog|0.484}}
|r243
|10 October 2010
|Removed IRCBotQuitMsg config key
|-
|112
|{{Changelog|0.480}}
|r235
|2 October 2010
|Removed PingInterval config key

Removed inactive ControlPhysics and AddLandmarks permissions
|-
|111
|{{Changelog|0.480}}
|r231
|29 September 2010
|Renamed lots of config keys:
*DefaultClass             -> DefaultRank
*ClassColorsInChat        -> RankColorsInChat
*ClassColorsInWorldNames  -> RankColorsInWorldNames
*ClassPrefixesInChat      -> RankPrefixesInChat
*ClassPrefixesInList      -> RankPrefixesInList
*PatrolledClass           -> PatrolledRank
*RequireClassChangeReason -> RequireRankChangeReason
*AnnounceClassChanges     -> AnnounceRankChanges
Renamed XML elements:
*Classes     -> Ranks
*PlayerClass -> Rank
Removed "rank" from PlayerClass/Rank object.

Made the order of Rank elements determine the relative index.
|}

==Legacy versions==
Versions of config.xml prior to '''111''' cannot be loaded by modern fCraft. There are provided here for completeness' sake.
{| class="wikitable"
!Config Version
!fCraft Release
!SVN Revision
!Date
!Changes
|-
|110
|{{Changelog|0.473}}
|r227
|15 September 2010
|Added {{perm|ShutdownServer}} and {{perm|Mute}} permissions.
|-
|109
|{{Changelog|0.472}}
|r226
|15 September 2010
|Added PatrolledClass key

Added Patrol permission
|-
|108
|{{Changelog|0.471}}
|r224
|14 September 2010
|Added IP key

Capped MaxPlayers at 128
|-
|107
|{{Changelog|0.460}}
|r214
|8 September 2010
|Added ShowJoinedWorldMessages and ClassColorsInWorldNames keys

Removed ChangeName permission
|-
|106
|{{Changelog|0.451}}
|r212
|4 September 2010
|Added IRCDelay key
|-
|105
|{{Changelog|0.451}}
|r205
|29 August 2010
|Added SubmitCrashReports key

Removed PolicyColorCodesInChat, PolicyIllegalCharacters, and RunOnStartup keys
|-
|104
|{{Changelog|0.450}}
|r198
|26 August 2010
|Added IRCBotAnnounceServerJoins and IRCBotAnnounceIRCJoins keys

Removed IRCBotMsg key
|-
|103
|{{Changelog|0.443}}
|r190
|23 August 2010
|Added {[perm|UseSpeedHack}} permission

Added PrivateMessageColor and IRCColor keys
|-
|102
|{{Changelog|0.440}}
|r171
|20 August 2010
|Added RequireBanReason, RequireClassChangeReason, AnnounceKickAndBanReasons, AnnounceClassChanges keys

Removed AnnounceUnverifiedNames key
|-
|101
|{{Changelog|0.428}}
|r134
|2 August 2010
|Added per-class draw limits and antigrief detection

Removed AntigriefBlockCount and AntigriefBlockInterval keys
|-
|100
|colspan="4" align="center"|<code>config.xml</code> was not versioned prior to this
|}
[[Category:Dev]][[Category:Config]]