config/FutilityChat.ini

@@ -1,34 +1,31 @@
 [default FutilityChat]
+;   This feature allows to configure color of text chat messages.
 autoEnable=true
-;=  How to color text chat messages?
+;   How to color text chat messages?
-;=
+;       1. `CCS_DoNothing` - do not change color in any way;
-;=  1. `CCS_DoNothing` - do not change color in any way;
+;       2. `CCS_TeamColorForced` - force players' team colors for
-;=  2. `CCS_TeamColorForced` - force players' team colors for
+;           their messages;
-;=      their messages;
+;       3. `CCS_ConfigColorForced` - force `configuredColor` value for
-;=  3. `CCS_ConfigColorForced` - force `configuredColor` value for
+;           players' messages;
-;=      players' messages;
+;       4. `CCS_TeamColorCustom` - use players' team colors for
-;=  4. `CCS_TeamColorCustom` - use players' team colors for
+;           their messages by default, but allow to change color with formatted
-;=      their messages by default, but allow to change color with formatted tags
+;           tags (e.g. "Stop right there, {$crimson criminal} scum!");
-;=      (e.g. "Stop right there, {$crimson criminal} scum!");
+;       5. `CCS_ConfigColorCustom` - use `configuredColor` value for
-;=  5. `CCS_ConfigColorCustom` - use `configuredColor` value for
+;           messages by default, but allow to change color with formatted
-;=      messages by default, but allow to change color with formatted
+;           tags (e.g. "Stop right there, {$crimson criminal} scum!");
-;=      tags (e.g. "Stop right there, {$crimson criminal} scum!");
+;   Default is `CCS_DoNothing`, corresponding to vanilla behaviour.
-;=
-;=  Default is `CCS_DoNothing`, corresponding to vanilla behaviour.
 colorSetting=CCS_DoNothing
-;=  Color that will be used if either of `CCS_ConfigColorForced` or
+;   Color that will be used if either of `CCS_ConfigColorForced` or
-;=  `CCS_ConfigColorCustom` options were used in `colorSetting`.
+;   `CCS_ConfigColorCustom` options were used in `colorSetting`.
-;=  Default value is white: (R=255,G=255,B=255,A=255), has no vanilla
+;   Default value is white: (R=255,G=255,B=255,A=255),
-;=  equivalent.
+;   has no vanilla equivalent.
 configuredColor=(R=255,G=255,B=255,A=255)
-;=  Allows to modify team color's value for the chat messages
+;       Allows to modify team color's value for the chat messages
-;=  (if either of `CCS_TeamColorForced` or `CCS_TeamColorCustom` options
+;   (if either of `CCS_TeamColorForced` or `CCS_TeamColorCustom` options
-;=  were used) to be lighter or darker.
+;   were used) to be lighter or darker.
-;=  This value is clamped between -1 and 1:
+;       This value is clamped between -1 and 1.
-;=
+;           * `0` means using the same color;
-;=  * `0` means using the same color;
+;           * range (0; 1) - gives you lighter colors (`1` being white);
-;=  * range (0; 1) - gives you lighter colors (`1` being white);
+;           * range (-1; 0) - gives you darker colors (`-1` being black);
-;=  * range (-1; 0) - gives you darker colors (`-1` being black);
+;   Default value is `0.6`, has no vanilla equivalent.
-;=
-;=  Default value is `0.6`, has no vanilla equivalent.
 teamColorModifier=0.6

config/FutilityNicknames.ini

@@ -1,67 +1,64 @@
 [default FutilityNicknames]
-;=  This feature allows to configure nickname limitations for the server.
+;       This feature allows to configure nickname limitations for the server.
-;=  It allows you to customize vanilla limitations for nickname length and
+;       It allows you to customize vanilla limitations for nickname length and
-;=  color with those of your own design. Enabling this feature overwrites
+;   color with those of your own design. Enabling this feature overwrites
-;=  default behaviour.
+;   default behaviour.
 autoEnable=true
-;=  How to treat whitespace characters inside players' nicknames.
+;   How to treat whitespace characters inside players' nicknames.
-;=
+;       * `NSA_DoNothing` - does nothing, leaving whitespaces as they are;
-;=  * `NSA_DoNothing` - does nothing, leaving whitespaces as they are;=
+;       * `NSA_Trim` - removes leading and trailing whitespaces for nicknames;
-;=  * `NSA_Trim` - removes leading and trailing whitespaces for nicknames;=
+;       * `NSA_Simplify` - removes leading and trailing whitespaces
-;=  * `NSA_Simplify` - removes leading and trailing whitespaces
+;           for nicknames, also reducing a sequence of whitespaces inside
-;=      for nicknames, also reducing a sequence of whitespaces inside
+;           nickname to a single space, e.g. "my   nick" becomes "my nick".
-;=      nickname to a single space, e.g. "my   nick" becomes "my nick".
+;   Default is `NSA_DoNothing`, same as on vanilla.
-;=
-;=  Default is `NSA_DoNothing`, same as on vanilla.
 spacesAction=NSA_DoNothing
-;=  How to treat colored nicknames.
+;   How to treat colored nicknames.
-;=  * `NCP_ForbidColor` - completely strips down any color from nicknames;=
+;       * `NCP_ForbidColor` - completely strips down any color from nicknames;
-;=  * `NCP_ForceTeamColor` - forces all nicknames to have player's current
+;       * `NCP_ForceTeamColor` - forces all nicknames to have player's current
-;=      team's color;=
+;           team's color;
-;=  * `NCP_ForceSingleColor` - allows nickname to be painted with a single
+;       * `NCP_ForceSingleColor` - allows nickname to be painted with a single
-;=      color (sets nickname's color to that of the first character);=
+;           color (sets nickname's color to that of the first character);
-;=  * `NCP_AllowAnyColor` - allows nickname to be colored in any way player
+;       * `NCP_AllowAnyColor` - allows nickname to be colored in any way player
-;=      wants.
+;           wants.
-;=  Default is `NCP_ForbidColor`, same as on vanilla.
+;   Default is `NCP_ForbidColor`, same as on vanilla.
 colorPermissions=NCP_ForbidColor
-;=  Set this to `true` if you wish to replace all whitespace characters with
+;       Set this to `true` if you wish to replace all whitespace characters with
-;=  underscores and `false` to leave them as is.
+;   underscores and `false` to leave them as is.
-;=  Default is `true`, same as on vanilla. However there is one difference:
+;       Default is `true`, same as on vanilla. However there is one difference:
-;=  Futility replaces all whitespace characters (including tabulations,
+;   Futility replaces all whitespace characters (including tabulations,
-;=  non-breaking spaces, etc.) instead of only ' '.
+;   non-breaking spaces, etc.) instead of only ' '.
 replaceSpacesWithUnderscores=true
-;=  Set this to `true` to remove single 'quotation marks' and `false` to
+;   Set this to `true` to remove single 'quotation marks' and `false` to
-;=  leave them. Default is `false`, same as on vanilla.
+;   leave them. Default is `false`, same as on vanilla.
 removeSingleQuotationMarks=false
-;=  Set this to `true` to remove dobule 'quotation marks' and `false` to
+;   Set this to `true` to remove dobule 'quotation marks' and `false` to
-;=  leave them. Default is `true`, same as on vanilla.
+;   leave them. Default is `true`, same as on vanilla.
 removeDoubleQuotationMarks=true
-;=  Max allowed nickname length. Negative values disable any length limits.
+;   Max allowed nickname length. Negative values disable any length limits.
-;=
+; 
-;=  NOTE #1: `0` resets all nicknames to be empty and,
+;   NOTE #1: `0` resets all nicknames to be empty and,
-;=  if `correctEmptyNicknames` is set to `true`, they will be replaced with
+;       if `correctEmptyNicknames` is set to `true`, they will be replaced with
-;=  one of the fallback nicknames
+;       one of the fallback nicknames
-;=  (see `correctEmptyNicknames` and `fallbackNickname`).
+;       (see `correctEmptyNicknames` and `fallbackNickname`).
-;=
+;   NOTE #2: Because of how color swapping in vanilla Killing Floor works,
-;=  NOTE #2: Because of how color swapping in vanilla Killing Floor works,
+;       every color swap makes text count as being about 4 characters longer.
-;=  every color swap makes text count as being about 4 characters longer.
+;       So if one uses too many colors in the nickname, for drawing functions
-;=  So if one uses too many colors in the nickname, for drawing functions
+;       it will appear to be longer than it actually is and it *will* mess up
-;=  it will appear to be longer than it actually is and it *will* mess up
+;       UI. Unless you are using custom HUD it is recommended to keep this value
-;=  UI. Unless you are using custom HUD it is recommended to keep this value
+;       at default `20` and forbid colored nicknames
-;=  at default `20` and forbid colored nicknames
+;       (by setting `colorPermissions=NCP_ForbidColor`). Or to allow only one
-;=  (by setting `colorPermissions=NCP_ForbidColor`). Or to allow only one
+;       color (by setting `colorPermissions=NCP_ForceSingleColor` or
-;=  color (by setting `colorPermissions=NCP_ForceSingleColor` or
+;       `colorPermissions=NCP_ForceTeamColor`) and reducing `maxNicknameLength`
-;=  `colorPermissions=NCP_ForceTeamColor`) and reducing `maxNicknameLength`
+;       to `16` (20 characters - 4 for color swap).
-;=  to `16` (20 characters - 4 for color swap).
+;           If you want to increase the limit above that, you can also do your
-;=  If you want to increase the limit above that, you can also do your
+;       own research by testing nicknames of various length on
-;=  own research by testing nicknames of various length on
+;       screen resolutions you care about.
-;=  screen resolutions you care about.
 maxNicknameLength=20
-;=  Should we replace empty player nicknames with a random fallback nickname
+;   Should we replace empty player nicknames with a random fallback nickname
-;=  (defined in `fallbackNickname` array)?
+;   (defined in `fallbackNickname` array)?
 correctEmptyNicknames=true
-;=  Array of fallback nicknames that will be used to replace any empty nicknames
+;   Array of fallback nicknames that will be used to replace any empty nicknames
-;=  if `correctEmptyNicknames` is set to `true`.
+;   if `correctEmptyNicknames` is set to `true`.
 fallbackNickname="Fresh Meat"
 fallbackNickname="Rotten Meat"
 fallbackNickname="Troll Meat"
@@ -73,21 +70,20 @@ fallbackNickname="Boar Meat"
 fallbackNickname="Walrus Meat"
 fallbackNickname="Bug Meat"
 fallbackNickname="Horse Meat"
-;=  Guaranteed order of applying changes (only chosen ones) is as following:
+;   Guaranteed order of applying changes (only chosen ones) is as following:
-;=  1. Trim/simplify spaces;=
+;       1. Trim/simplify spaces;
-;=  2. Remove single and double quotation marks;=
+;       2. Remove single and double quotation marks;
-;=  3. Enforce max limit of nickname's length;=
+;       3. Enforce max limit of nickname's length;
-;=  4. Replace empty nickname with fallback nickname (no further changes
+;       4. Replace empty nickname with fallback nickname (no further changes
-;=      will be applied to fallback nickname in that case);=
+;           will be applied to fallback nickname in that case);
-;=  5. Enforce color limitation;=
+;       5. Enforce color limitation;
-;=  6. Replace remaining whitespaces with underscores.
+;       6. Replace remaining whitespaces with underscores.
-;=
+; 
-;=  NOTE #1: as follows from the instruction described above, no changes will
+;   NOTE #1: as follows from the instruction described above, no changes will
-;=  ever be applied to fallback nicknames (unless player's nickname
+;       ever be applied to fallback nicknames (unless player's nickname
-;=  coincides with one by pure accident).
+;       coincides with one by pure accident).
-;=
+;   NOTE #2: whitespaces inside steam nicknames are converted into underscores
-;=  NOTE #2: whitespaces inside steam nicknames are converted into underscores
+;       before they are passed into the game and this is a change Futility
-;=  before they are passed into the game and this is a change Futility
+;       cannot currently abort.
-;=  cannot currently abort.
+;       Therefore all changes relevant to whitespaces inside nicknames will only
-;=  Therefore all changes relevant to whitespaces inside nicknames will only
+;       be applied to in-game changes.
-;=  be applied to in-game changes.

sources/Commands/ACommandDB.uc

@@ -1,6 +1,6 @@
 /**
  *  Command for working with databases.
- *      Copyright 2021-2023 Anton Tarasenko
+ *      Copyright 2021-2022 Anton Tarasenko
  *------------------------------------------------------------------------------
  * This file is part of Acedia.
  *
@@ -74,54 +74,47 @@ var protected const int TDB_CANNOT_BE_CREATED, TNO_DEFAULT_COMMAND, TBAD_DBLINK;
 
 protected function BuildData(CommandDataBuilder builder)
 {
-    builder.Group(P("admin"));
+    builder.Name(P("db")).Group(P("admin"))
-    builder.Summary(P("Read and edit data in your databases."
+        .Summary(P("Read and edit data in your databases."
         @ "Databases' values are addressed with links:"
         @ "\"<db_name>:<json_path>\""));
-    builder.SubCommand(T(TCREATE));
+    builder.SubCommand(T(TCREATE))
-    builder.ParamText(T(TDATABASE_NAME));
+        .ParamText(T(TDATABASE_NAME))
-    builder.Describe(P("Creates new database with a specified name."));
+        .Describe(P("Creates new database with a specified name."));
-    builder.SubCommand(T(TDELETE));
+    builder.SubCommand(T(TDELETE))
-    builder.ParamText(T(TDATABASE_NAME));
+        .ParamText(T(TDATABASE_NAME))
-    builder.Describe(P("Completely deletes specified database."));
+        .Describe(P("Completely deletes specified database."));
-    builder.SubCommand(T(TLIST));
+    builder.SubCommand(T(TLIST))
-    builder.Describe(P("Lists available databases."));
+        .Describe(P("Lists available databases."));
-    builder.SubCommand(T(TREAD));
+    builder.SubCommand(T(TREAD))
-    builder.ParamText(T(TDATABASE_LINK));
+        .ParamText(T(TDATABASE_LINK))
-    builder.Describe(P("Reads data from location given by the `databaseLink`."));
+        .Describe(P("Reads data from location given by the `databaseLink`."));
-    builder.SubCommand(T(TSIZE));
+    builder.SubCommand(T(TSIZE))
-    builder.ParamText(T(TDATABASE_LINK));
+        .ParamText(T(TDATABASE_LINK))
-    builder.Describe(P("Gets amount of elements inside JSON array or object at"
+        .Describe(P("Gets amount of elements inside JSON array or object at"
             @ "location given by the `databaseLink`."));
-    builder.SubCommand(T(TKEYS));
+    builder.SubCommand(T(TKEYS))
-    builder.ParamText(T(TDATABASE_LINK));
+        .ParamText(T(TDATABASE_LINK))
-    builder.Describe(P("Lists keys of JSON object at location given by"
+        .Describe(P("Lists keys of JSON object at location given by"
             @ "the `databaseLink`."));
-    builder.SubCommand(T(TREMOVE));
+    builder.SubCommand(T(TREMOVE))
-    builder.ParamText(T(TDATABASE_LINK));
+        .ParamText(T(TDATABASE_LINK))
-    builder.Describe(P("Removes data from location given by the `databaseLink`."));
+        .Describe(P("Removes data from location given by the `databaseLink`."));
-    builder.SubCommand(T(TWRITE));
+    builder.SubCommand(T(TWRITE))
-    builder.ParamText(T(TDATABASE_LINK));
+        .ParamText(T(TDATABASE_LINK))
-    builder.ParamJSON(T(TJSON_VALUE));
+        .ParamJSON(T(TJSON_VALUE))
-    builder.Describe(P("Writes specified JSON value into location given by"
+        .Describe(P("Writes specified JSON value into location given by"
             @ "the `databaseLink`."));
-    builder.Option(T(TINCREMENT));
+    builder.Option(T(TINCREMENT))
-    builder.Describe(F("Specifying this option for any of the"
+        .Describe(F("Specifying this option for any of the"
             @ "{$TextEmphasis 'write'} subcommands will cause them to append"
             @ "data to the old one, instead of rewriting it."));
 }
 
 protected function PushPlayer(EPlayer nextPlayer, Database callDatabase)
 {
-    local EPlayer playerCopy;
+    queueWaitingListPlayers[queueWaitingListPlayers.length] =
-
+        EPlayer(nextPlayer.Copy());
-    if (nextPlayer != none) {
-        playerCopy = EPlayer(nextPlayer.Copy());
-    }
-    if (callDatabase != none) {
-        callDatabase.NewRef();
-    }
-    queueWaitingListPlayers[queueWaitingListPlayers.length] = playerCopy;
     queueWaitingListDatabases[queueWaitingListDatabases.length] = callDatabase;
 }
 
@@ -135,10 +128,9 @@ protected function EPlayer PopPlayer(Database relevantDatabase)
 
     while (i < queueWaitingListDatabases.length)
     {
-        if (queueWaitingListDatabases[i].IsEqual(relevantDatabase))
+        if (queueWaitingListDatabases[i] != relevantDatabase)
         {
             result = queueWaitingListPlayers[i];
-            queueWaitingListDatabases[i].FreeSelf();
             queueWaitingListPlayers.Remove(i, 1);
             queueWaitingListDatabases.Remove(i, 1);
             break;
@@ -152,11 +144,8 @@ protected function EPlayer PopPlayer(Database relevantDatabase)
     return none;
 }
 
-protected function Executed(
+protected function Executed(CallData arguments, EPlayer instigator)
-    CallData arguments,
+{
-    EPlayer instigator,
-    CommandPermissions permissions
-) {
     local AcediaObject  valueToWrite;
     local DBPointerPair pair;
     local Text          subCommand;
@@ -246,11 +235,11 @@ private function DBPointerPair TryLoadingDB(BaseText databaseLink)
     if (databaseLink == none) {
         return result;
     }
-    result.database = _server.db.Load(databaseLink);
+    result.database = _.db.Load(databaseLink);
     if (result.database == none) {
         return result;
     }
-    result.pointer = _server.db.GetPointer(databaseLink);
+    result.pointer = _.db.GetPointer(databaseLink);
     return result;
 }
 
@@ -259,12 +248,12 @@ protected function CreateDatabase(EPlayer instigator, Text databaseName)
     if (instigator == none) {
         return;
     }
-    if (_server.db.ExistsLocal(databaseName))
+    if (_.db.ExistsLocal(databaseName))
     {
         callerConsole.WriteLine(T(TDB_ALREADY_EXISTS));
         return;
     }
-    if (_server.db.NewLocal(databaseName) != none) {
+    if (_.db.NewLocal(databaseName) != none) {
         callerConsole.WriteLine(T(TDB_CREATED));
     }
     else {
@@ -277,7 +266,7 @@ protected function DeleteDatabase(EPlayer instigator, Text databaseName)
     if (instigator == none) {
         return;
     }
-    if (_server.db.DeleteLocal(databaseName)) {
+    if (_.db.DeleteLocal(databaseName)) {
         callerConsole.WriteLine(T(TDA_DELETED));
     }
     else {
@@ -294,7 +283,7 @@ protected function ListDatabases(EPlayer instigator)
     if (instigator == none) {
         return;
     }
-    availableDatabases = _server.db.ListLocal();
+    availableDatabases = _.db.ListLocal();
     console = callerConsole;
     console.Write(T(TAVAILABLE_DATABASES));
     for (i = 0; i < availableDatabases.length; i += 1)
@@ -332,8 +321,7 @@ protected function OutputStatus(
 protected function DisplayData(
     Database.DBQueryResult  result,
     AcediaObject            data,
-    Database                source,
+    Database                source)
-    int                     requestID)
 {
     local Text      printedJSON;
     local EPlayer   instigator;
@@ -354,8 +342,7 @@ protected function DisplayData(
 protected function DisplaySize(
     Database.DBQueryResult  result,
     int                     size,
-    Database                source,
+    Database                source)
-    int                     requestID)
 {
     local Text      sizeAsText;
     local EPlayer   instigator;
@@ -378,8 +365,7 @@ protected function DisplaySize(
 protected function DisplayKeys(
     Database.DBQueryResult  result,
     ArrayList               keys,
-    Database                source,
+    Database                source)
-    int                     requestID)
 {
     local int           i;
     local Text          nextKey;
@@ -413,8 +399,7 @@ protected function DisplayKeys(
 
 protected function DisplayResponse(
     Database.DBQueryResult  result,
-    Database                source,
+    Database                source)
-    int                     requestID)
 {
     local EPlayer instigator;
 
@@ -425,7 +410,6 @@ protected function DisplayResponse(
 
 defaultproperties
 {
-    preferredName = "db"
     TCREATE                 = 0
     stringConstants(0)      = "create"
     TDELETE                 = 1
@@ -457,25 +441,25 @@ defaultproperties
     TQUERY_COMPLETED        = 14
     stringConstants(14)     = "{$TextPositive Database query was completed!}"
     TQUERY_INVALID_POINTER  = 15
-    stringConstants(15)     = "{$TextFailure Query was provided with an invalid JSON pointer.}"
+    stringConstants(15)     = "{$TextNegative Query was provided with an invalid JSON pointer.}"
     TQUERY_INVALID_DB       = 16
-    stringConstants(16)     = "{$TextFailure Operation could not finish because database is damaged and unusable.}"
+    stringConstants(16)     = "{$TextNegative Operation could not finish because database is damaged and unusable.}"
     TQUERY_INVALID_DATA     = 17
-    stringConstants(17)     = "{$TextFailure Query data is invalid.}"
+    stringConstants(17)     = "{$TextNegative Query data is invalid.}"
     TAVAILABLE_DATABASES    = 18
     stringConstants(18)     = "{$TextEmphasis Available databases:} "
     TDA_DELETED             = 19
     stringConstants(19)     = "{$TextPositive Database was deleted.}"
     TDB_DOESNT_EXIST        = 20
-    stringConstants(20)     = "{$TextFailure Database with specified name does not exist.}"
+    stringConstants(20)     = "{$TextNegative Database with specified name does not exist.}"
     TDB_ALREADY_EXISTS      = 21
-    stringConstants(21)     = "{$TextFailure Database with specified name already exists.}"
+    stringConstants(21)     = "{$TextNegative Database with specified name already exists.}"
     TDB_CREATED             = 22
     stringConstants(22)     = "{$TextPositive Database was created.}"
     TDB_CANNOT_BE_CREATED   = 23
-    stringConstants(23)     = "{$TextFailure Database cannot be created.}"
+    stringConstants(23)     = "{$TextNegative Database cannot be created.}"
     TNO_DEFAULT_COMMAND     = 24
-    stringConstants(24)     = "{$TextFailure Default command does nothing. Use on of the sub-commands.}"
+    stringConstants(24)     = "{$TextNegative Default command does nothing. Use on of the sub-commands.}"
     TBAD_DBLINK             = 25
-    stringConstants(25)     = "{$TextFailure Database could not be read for the specified link.}"
+    stringConstants(25)     = "{$TextNegative Database could not be read for the specified link.}"
 }

sources/Commands/ACommandDosh.uc

@@ -29,23 +29,23 @@ protected function Finalizer()
 
 protected function BuildData(CommandDataBuilder builder)
 {
-    builder.Group(P("gameplay"));
+    builder.Name(P("dosh")).Group(P("gameplay"))
-    builder.Summary(P("Changes amount of money."));
+        .Summary(P("Changes amount of money."));
     builder.RequireTarget();
-    builder.ParamInteger(P("amount"));
+    builder.ParamInteger(P("amount"))
-    builder.Describe(P("Gives (or takes if negative) players a specified <amount>"
+        .Describe(P("Gives (or takes if negative) players a specified <amount>"
             @ "of money."));
-    builder.SubCommand(P("set"));
+    builder.SubCommand(P("set"))
-    builder.ParamInteger(P("amount"));
+        .ParamInteger(P("amount"))
-    builder.Describe(P("Sets player's money to a specified <amount>."));
+        .Describe(P("Sets player's money to a specified <amount>."));
-    builder.Option(P("min"));
+    builder.Option(P("min"))
-    builder.ParamInteger(P("minValue"));
+        .ParamInteger(P("minValue"))
-    builder.Describe(F("Players will retain at least this amount of dosh after"
+        .Describe(F("Players will retain at least this amount of dosh after"
             @ "the command's execution. In case of conflict, overrides"
             @ "'{$TextEmphasis --max}' option. `0` is assumed by default."));
-    builder.Option(P("max"), P("M"));
+    builder.Option(P("max"), P("M"))
-    builder.ParamInteger(P("maxValue"));
+        .ParamInteger(P("maxValue"))
-    builder.Describe(F("Players will have at most this amount of dosh after"
+        .Describe(F("Players will have at most this amount of dosh after"
             @ "the command's execution. In case of conflict, it is overridden"
             @ "by '{$TextEmphasis --min}' option."));
     announcer = ACommandDosh_Announcer(
@@ -55,9 +55,8 @@ protected function BuildData(CommandDataBuilder builder)
 protected function ExecutedFor(
     EPlayer     target,
     CallData    arguments,
-    EPlayer     instigator,
+    EPlayer     instigator)
-    CommandPermissions permissions
+{
-) {
     local int oldAmount, newAmount;
     local int amount, minValue, maxValue;
 
@@ -89,6 +88,6 @@ protected function ExecutedFor(
     }
 }
 
-defaultproperties {
+defaultproperties
-    preferredName = "dosh"
+{
 }

sources/Commands/ACommandFeature.uc

@@ -20,194 +20,211 @@
 class ACommandFeature extends Command
     dependson(PendingConfigsTool);
 
-var private class<Feature> selectedFeatureClass;
+var private class<Feature>  selectedFeatureClass;
-var private Text selectedFeatureName;
+var private Text            selectedConfigName;
-var private Text selectedConfigName;
 
-var private PendingConfigsTool pendingConfigs;
+var private PendingConfigsTool          pendingConfigs;
-var private ACommandFeature_Announcer announcer;
+var private ACommandFeature_Announcer   announcer;
 
-protected function Constructor() {
+protected function Constructor()
-    pendingConfigs = PendingConfigsTool(_.memory.Allocate(class'PendingConfigsTool'));
+{
+    pendingConfigs =
+        PendingConfigsTool(_.memory.Allocate(class'PendingConfigsTool'));
     super.Constructor();
 }
 
-protected function Finalizer() {
+protected function Finalizer()
+{
     _.memory.Free(announcer);
     _.memory.Free(pendingConfigs);
     super.Finalizer();
 }
 
-protected function BuildData(CommandDataBuilder builder) {
+protected function BuildData(CommandDataBuilder builder)
-    builder.Group(P("admin"));
+{
-    builder.Summary(P("Managing features."));
+    builder.Name(P("feature")).Group(P("admin"))
-    builder.Describe(P("Command for managing features and their configs."));
+        .Summary(P("Managing features."))
-    builder.SubCommand(P("enable"));
+        .Describe(P("Command for managing features and their configs."));
-    builder.ParamText(P("feature"),, P("feature"));
+    builder.SubCommand(P("enable"))
-    builder.OptionalParams();
+        .ParamText(P("feature"),, P("feature"))
-    builder.ParamText(P("config"));
+        .OptionalParams()
-    builder.Describe(P("Enables specified <feature>. If <config> isn't specified -"
+        .ParamText(P("config"))
+        .Describe(P("Enables specified <feature>. If <config> isn't specified -"
             @ "choses the \"default\" one, making new config with default"
             @ "settings if it doesn't exist."));
-    builder.SubCommand(P("disable"));
+    builder.SubCommand(P("disable"))
-    builder.ParamText(P("feature"),, P("feature"));
+        .ParamText(P("feature"),, P("feature"))
-    builder.Describe(P("Disables specified <feature>."));
+        .Describe(P("Disables specified <feature>."));
-    builder.SubCommand(P("showconf"));
+    builder.SubCommand(P("showconf"))
-    builder.ParamText(P("feature"),, P("feature"));
+        .ParamText(P("feature"),, P("feature"))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamText(P("config"));
+        .ParamText(P("config"))
-    builder.Describe(P("Show given <config> for the given <feature>."));
+        .Describe(P("Show given <config> for the given <feature>."));
-    builder.SubCommand(P("editconf"));
+    builder.SubCommand(P("editconf"))
-    builder.ParamText(P("feature"),, P("feature"));
+        .ParamText(P("feature"),, P("feature"))
-    builder.ParamText(P("config"));
+        .ParamText(P("config"))
-    builder.ParamText(P("variable_path"));
+        .ParamText(P("variable_path"))
-    builder.ParamJSON(P("value"));
+        .ParamJSON(P("value"))
-    builder.Describe(P("Changes a value inside given <config> of the given"
+        .Describe(P("Changes a value inside given <config> of the given"
             @ "<feature> by setting value at JSON path <variable_path> to"
             @ "the JSON value <value>. Changes won't be immediately applied to"
             @ "the game and kept as pending."));
-    builder.SubCommand(P("saveconf"));
+    builder.SubCommand(P("saveconf"))
-    builder.ParamText(P("feature"),, P("feature"));
+        .ParamText(P("feature"),, P("feature"))
-    builder.ParamText(P("config"));
+        .ParamText(P("config"))
-    builder.Describe(P("Saves pending changes for the given <config> of the given"
+        .Describe(P("Saves pending changes for the given <config> of the given"
             @ "<feature>."));
-    builder.SubCommand(P("newconf"));
+    builder.SubCommand(P("newconf"))
-    builder.ParamText(P("feature"),, P("feature"));
+        .ParamText(P("feature"),, P("feature"))
-    builder.ParamText(P("config"));
+        .ParamText(P("config"))
-    builder.Describe(P("Creates new config for the given <feature>."));
+        .Describe(P("Creates new config for the given <feature>."));
-    builder.SubCommand(P("removeconf"));
+    builder.SubCommand(P("removeconf"))
-    builder.ParamText(P("feature"),, P("feature"));
+        .ParamText(P("feature"),, P("feature"))
-    builder.ParamText(P("config"));
+        .ParamText(P("config"))
-    builder.Describe(P("Removes specified <config> of the specified <feature>."));
+        .Describe(P("Removes specified <config> of the specified <feature>."));
-    builder.SubCommand(P("autoconf"));
+    builder.SubCommand(P("autoconf"))
-    builder.ParamText(P("feature"),, P("feature"));
+        .ParamText(P("feature"),, P("feature"))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamText(P("config"));
+        .ParamText(P("config"))
-    builder.Describe(P("Changes current auto config config of the specified"
+        .Describe(P("Changes current auto config config of the specified"
             @ "<feature>. Auto config is a config that is supposed to be"
             @ "automatically enabled at the start of the Acedia, unless"
             @ "otherwise specified for the loader."));
-    builder.Option(P("all"));
+    builder.Option(P("all"))
-    builder.Describe(F("Affects subcommand {$TextEmphasis showconf} by making it"
+        .Describe(F("Affects subcommand {$TextEmphasis showconf} by making it"
             @ "show all available configs."));
-    builder.Option(P("save"));
+    builder.Option(P("save"))
-    builder.Describe(F("Affects subcommand {$TextEmphasis editconf} by making it"
+        .Describe(F("Affects subcommand {$TextEmphasis editconf} by making it"
             @ "also save all pending changes."));
     announcer = ACommandFeature_Announcer(
         _.memory.Allocate(class'ACommandFeature_Announcer'));
 }
 
-protected function Executed(
+protected function Executed(CallData arguments, EPlayer instigator)
-    CallData arguments,
+{
-    EPlayer instigator,
-    CommandPermissions permissions
-) {
     local bool saveFlag, allFlag;
 
     announcer.Setup(none, instigator, othersConsole);
-    saveFlag = arguments.options.HasKey(P("save"));
+    saveFlag    = arguments.options.HasKey(P("save"));
-    allFlag = arguments.options.HasKey(P("all"));
+    allFlag     = arguments.options.HasKey(P("all"));
     SelectFeatureAndConfig(arguments);
     if (arguments.subCommandName.IsEmpty()) {
         ShowAllFeatures();
-    } else if (arguments.subCommandName.Compare(P("enable"))) {
+    }
+    else if (arguments.subCommandName.Compare(P("enable"))) {
         EnableFeature();
-    } else if (arguments.subCommandName.Compare(P("disable"))) {
+    }
+    else if (arguments.subCommandName.Compare(P("disable"))) {
         DisableFeature();
-    } else if (arguments.subCommandName.Compare(P("showconf"))) {
+    }
+    else if (arguments.subCommandName.Compare(P("showconf"))) {
         ShowSelectedConfigs(allFlag);
-    } else if (arguments.subCommandName.Compare(P("editconf"))) {
+    }
+    else if (arguments.subCommandName.Compare(P("editconf")))
+    {
         EditFeatureConfig(
             arguments.parameters.GetText(P("variable_path")),
             arguments.parameters.GetItem(P("value")),
             saveFlag);
-    } else if (arguments.subCommandName.Compare(P("saveconf"))) {
+    }
+    else if (arguments.subCommandName.Compare(P("saveconf"))) {
         SaveFeatureConfig();
-    } else if (arguments.subCommandName.Compare(P("newconf"))) {
+    }
+    else if (arguments.subCommandName.Compare(P("newconf"))) {
         NewFeatureConfig();
-    } else if (arguments.subCommandName.Compare(P("removeconf"))) {
+    }
+    else if (arguments.subCommandName.Compare(P("removeconf"))) {
         RemoveFeatureConfig();
-    } else if (arguments.subCommandName.Compare(P("autoconf"))) {
+    }
+    else if (arguments.subCommandName.Compare(P("autoconf"))) {
         SetAutoFeatureConfig();
     }
-    _.memory.Free2(selectedConfigName, selectedFeatureName);
+    _.memory.Free(selectedConfigName);
     selectedConfigName = none;
-    selectedFeatureName = none;
 }
 
-protected function SelectFeatureAndConfig(CallData arguments) {
+protected function SelectFeatureAndConfig(CallData arguments)
+{
     local Text featureClassName, userGivenConfigName;
 
-    selectedFeatureName = arguments.parameters.GetTextBy(P("/feature/alias"));
+    featureClassName = arguments.parameters.GetText(P("feature"));
-    featureClassName = arguments.parameters.GetTextBy(P("/feature/value"));
     selectedFeatureClass = LoadFeatureClass(featureClassName);
     if (selectedFeatureClass == none && !arguments.subCommandName.IsEmpty()) {
-        _.memory.Free(selectedFeatureName);
-        selectedFeatureName = none;
         return;
     }
     _.memory.Free(featureClassName);
     userGivenConfigName = arguments.parameters.GetText(P("config"));
-    if (userGivenConfigName != none) {
+    if (userGivenConfigName != none)
+    {
         selectedConfigName = userGivenConfigName.LowerCopy();
         userGivenConfigName.FreeSelf();
     }
     pendingConfigs.SelectConfig(selectedFeatureClass, selectedConfigName);
 }
 
-protected function EnableFeature() {
+protected function EnableFeature()
-    local bool wasEnabled;
+{
-    local Text oldConfig, newConfig;
+    local bool      wasEnabled;
-    local Feature instance;
+    local Text      oldConfig, newConfig;
+    local Feature   instance;
 
-    wasEnabled = selectedFeatureClass.static.IsEnabled();
+    wasEnabled  = selectedFeatureClass.static.IsEnabled();
-    oldConfig = selectedFeatureClass.static.GetCurrentConfig();
+    oldConfig   = selectedFeatureClass.static.GetCurrentConfig();
-    newConfig = PickConfigBasedOnParameter();
+    newConfig   = PickConfigBasedOnParameter();
     //  Already enabled with the same config!
-    if (oldConfig != none && oldConfig.Compare(newConfig, SCASE_INSENSITIVE)) {
+    if (oldConfig != none && oldConfig.Compare(newConfig, SCASE_INSENSITIVE))
-        announcer.AnnounceFailedAlreadyEnabled(selectedFeatureName, newConfig);
+    {
+        announcer.AnnounceFailedAlreadyEnabled(selectedFeatureClass, newConfig);
         _.memory.Free(newConfig);
         _.memory.Free(oldConfig);
         return;
     }
     //  Try enabling and report the result
     instance = selectedFeatureClass.static.EnableMe(newConfig);
-    if (instance == none) {
+    if (instance == none)
+    {
         announcer.AnnounceFailedCannotEnableFeature(
-            selectedFeatureName,
+            selectedFeatureClass,
             newConfig);
-    } else if (wasEnabled) {
+    }
+    else if (wasEnabled)
+    {
         announcer.AnnounceSwappedConfig(
-            selectedFeatureName,
+            selectedFeatureClass,
             oldConfig,
             newConfig);
-    } else {
+    }
-        announcer.AnnounceEnabledFeature(selectedFeatureName, newConfig);
+    else {
+        announcer.AnnounceEnabledFeature(selectedFeatureClass, newConfig);
     }
     _.memory.Free(newConfig);
     _.memory.Free(oldConfig);
 }
 
-protected function DisableFeature() {
+protected function DisableFeature()
-    if (!selectedFeatureClass.static.IsEnabled()) {
+{
-        announcer.AnnounceFailedAlreadyDisabled(selectedFeatureName);
+    if (!selectedFeatureClass.static.IsEnabled())
+    {
+        announcer.AnnounceFailedAlreadyDisabled(selectedFeatureClass);
         return;
     }
     selectedFeatureClass.static.DisableMe();
     //  It is possible that this command itself is destroyed after above command
     //  so do the check just in case
     if (IsAllocated()) {
-        announcer.AnnounceDisabledFeature(selectedFeatureName);
+        announcer.AnnounceDisabledFeature(selectedFeatureClass);
     }
 }
 
-protected function ShowSelectedConfigs(bool showAllFeatures) {
+protected function ShowSelectedConfigs(bool showAllFeatures)
-    local int i;
+{
-    local array<Text> availableConfigs;
+    local int                   i;
-    local MutableText configList;
+    local array<Text>           availableConfigs;
-    local class<FeatureConfig> configClass;
+    local MutableText           configList;
+    local class<FeatureConfig>  configClass;
 
-    if (showAllFeatures) {
+    if (showAllFeatures)
+    {
         configClass = selectedFeatureClass.default.configClass;
         if (configClass != none) {
             availableConfigs = configClass.static.AvailableConfigs();
@@ -218,7 +235,8 @@ protected function ShowSelectedConfigs(bool showAllFeatures) {
         _.memory.FreeMany(availableConfigs);
         return;
     }
-    if (selectedConfigName != none) {
+    if (selectedConfigName != none)
+    {
         ShowFeatureConfig(selectedConfigName);
         return;
     }
@@ -230,32 +248,35 @@ protected function ShowSelectedConfigs(bool showAllFeatures) {
     _.memory.Free(configList);
 }
 
-protected function ShowFeatureConfig(BaseText configName) {
+protected function ShowFeatureConfig(BaseText configName)
-    local MutableText dataAsJSON;
+{
-    local HashTable currentData, pendingData;
+    local MutableText   dataAsJSON;
+    local HashTable     currentData, pendingData;
 
     if (configName == none) {
         return;
     }
     currentData = GetCurrentConfigData(configName);
-    if (currentData == none) {
+    if (currentData == none)
+    {
         announcer.AnnounceFailedNoDataForConfig(
-            selectedFeatureName,
+            selectedFeatureClass,
             configName);
         return;
     }
     //  Display current data
     dataAsJSON = _.json.PrettyPrint(currentData);
-    announcer.AnnounceCurrentConfig(selectedFeatureName, configName);
+    announcer.AnnounceCurrentConfig(selectedFeatureClass, configName);
     callerConsole.Flush().WriteLine(dataAsJSON);
     _.memory.Free(dataAsJSON);
     //  Display pending data
     pendingConfigs.SelectConfig(selectedFeatureClass, configName);
     pendingData = pendingConfigs.GetPendingConfigData();
-    if (pendingData != none) {
+    if (pendingData != none)
+    {
         dataAsJSON = _.json.PrettyPrint(pendingData);
         announcer.AnnouncePendingConfig(
-            selectedFeatureName,
+            selectedFeatureClass,
             configName);
         callerConsole.Flush().WriteLine(dataAsJSON);
         _.memory.Free(dataAsJSON);
@@ -264,17 +285,20 @@ protected function ShowFeatureConfig(BaseText configName) {
     _.memory.Free(currentData);
 }
 
-protected function Text PickConfigBasedOnParameter() {
+protected function Text PickConfigBasedOnParameter()
-    local Text resolvedConfig;
+{
-    local class<FeatureConfig> configClass;
+    local Text                  resolvedConfig;
+    local class<FeatureConfig>  configClass;
 
     configClass = selectedFeatureClass.default.configClass;
-    if (configClass == none) {
+    if (configClass == none)
-        announcer.AnnounceFailedNoConfigClass(selectedFeatureName);
+    {
+        announcer.AnnounceFailedNoConfigClass(selectedFeatureClass);
         return none;
     }
     //  If config was specified - simply check that it exists
-    if (selectedConfigName != none) {
+    if (selectedConfigName != none)
+    {
         if (configClass.static.Exists(selectedConfigName)) {
             return selectedConfigName.Copy();
         }
@@ -284,12 +308,13 @@ protected function Text PickConfigBasedOnParameter() {
     //  If it wasn't specified - try auto config instead
     resolvedConfig = configClass.static.GetAutoEnabledConfig();
     if (resolvedConfig == none) {
-        announcer.AnnounceFailedNoConfigProvided(selectedFeatureName);
+        announcer.AnnounceFailedNoConfigProvided(selectedFeatureClass);
     }
     return resolvedConfig;
 }
 
-protected function class<Feature> LoadFeatureClass(BaseText featureClassName) {
+protected function class<Feature> LoadFeatureClass(BaseText featureClassName)
+{
     local class<Feature> featureClass;
 
     if (featureClassName == none) {
@@ -302,10 +327,10 @@ protected function class<Feature> LoadFeatureClass(BaseText featureClassName) {
     return featureClass;
 }
 
-protected function ShowAllFeatures() {
+protected function ShowAllFeatures()
-    local int i;
+{
-    local array< class<Feature> > availableFeatures;
+    local int                       i;
-
+    local array< class<Feature> >   availableFeatures;
     availableFeatures = _.environment.GetAvailableFeatures();
     for (i = 0; i < availableFeatures.length; i ++) {
         ShowFeature(availableFeatures[i]);
@@ -338,47 +363,45 @@ protected function ShowFeature(class<Feature> featureClass)
     _.memory.Free(configList);
 }
 
-protected function MutableText PrintConfigList(class<Feature> featureClass) {
+protected function MutableText PrintConfigList(class<Feature> featureClass)
-    local int i;
+{
-    local Text autoConfig, enabledConfig;
+    local int                   i;
-    local ListBuilder configList;
+    local Text                  autoConfig;
-    local MutableText result, nextConfig;
+    local ListBuilder           configList;
-    local array<Text> availableConfigs;
+    local MutableText           result, nextConfig;
-    local class<FeatureConfig> configClass;
+    local array<Text>           availableConfigs;
+    local class<FeatureConfig>  configClass;
 
     if (featureClass == none)   return none;
     configClass = featureClass.default.configClass;
     if (configClass == none)    return none;
 
-    availableConfigs = configClass.static.AvailableConfigs();
+    availableConfigs    = configClass.static.AvailableConfigs();
-    enabledConfig = featureClass.static.GetCurrentConfig();
+    autoConfig          = configClass.static.GetAutoEnabledConfig();
-    autoConfig = configClass.static.GetAutoEnabledConfig();
+    configList          = ListBuilder(_.memory.Allocate(class'ListBuilder'));
-    configList = ListBuilder(_.memory.Allocate(class'ListBuilder'));
+    for (i = 0; i < availableConfigs.length; i += 1)
-    for (i = 0; i < availableConfigs.length; i += 1) {
+    {
         nextConfig = availableConfigs[i].MutableCopy();
-        if (enabledConfig != none && enabledConfig.Compare(nextConfig, SCASE_INSENSITIVE)) {
-            nextConfig.ChangeDefaultColor(_.color.TextPositive);
-        }
         if (pendingConfigs.HasPendingConfigFor(featureClass, nextConfig)) {
             nextConfig.Append(F("{$TextEmphasis *}"));
         }
         configList.Item(nextConfig);
         _.memory.Free(nextConfig);
-        if (autoConfig != none && autoConfig.Compare(availableConfigs[i], SCASE_INSENSITIVE)) {
+        if (    autoConfig != none
-            if (autoConfig.Compare(enabledConfig, SCASE_INSENSITIVE)) {
+            &&  autoConfig.Compare(availableConfigs[i], SCASE_INSENSITIVE))
-                configList.Comment(F("{$TextPositive auto enabled}"));
+        {
-            } else {
+            configList.Comment(F("{$TextPositive auto enabled}"));
-                configList.Comment(F("{$TextNegative auto enabled}"));
-            }
         }
     }
     result = configList.GetMutable();
-    _.memory.Free3(configList, autoConfig, enabledConfig);
+    _.memory.Free(configList);
+    _.memory.Free(autoConfig);
     _.memory.FreeMany(availableConfigs);
     return result;
 }
 
-protected function MutableText PrettyPrintValueAt(BaseText pathToValue) {
+protected function MutableText PrettyPrintValueAt(BaseText pathToValue)
+{
     local MutableText   printedValue;
     local AcediaObject  value;
     local HashTable     relevantData;
@@ -390,7 +413,8 @@ protected function MutableText PrettyPrintValueAt(BaseText pathToValue) {
     if (relevantData != none) {
         value = relevantData.GetItemBy(pathToValue);
     }
-    if (value != none) {
+    if (value != none)
+    {
         printedValue = _.json.PrettyPrint(value);
         _.memory.Free(value);
     }
@@ -398,7 +422,11 @@ protected function MutableText PrettyPrintValueAt(BaseText pathToValue) {
     return printedValue;
 }
 
-protected function EditFeatureConfig(BaseText pathToValue, AcediaObject newValue, bool saveConfig) {
+protected function EditFeatureConfig(
+    BaseText        pathToValue,
+    AcediaObject    newValue,
+    bool            saveConfig)
+{
     local MutableText printedOldValue;
     local MutableText printedNewValue;
     local PendingConfigsTool.PendingConfigToolResult error;
@@ -416,20 +444,26 @@ protected function EditFeatureConfig(BaseText pathToValue, AcediaObject newValue
     }
     else if (error == PCTE_ExpectedObject) {
         announcer.AnnounceFailedExpectedObject();
-    } else if (error == PCTE_BadPointer) {
+    }
+    else if (error == PCTE_BadPointer)
+    {
         announcer.AnnounceFailedBadPointer(
-            selectedFeatureName,
+            selectedFeatureClass,
             selectedConfigName,
             pathToValue);
-    } else if (printedOldValue == none) {
+    }
+    else if (printedOldValue == none)
+    {
         announcer.AnnounceConfigNewValue(
-            selectedFeatureName,
+            selectedFeatureClass,
             selectedConfigName,
             pathToValue,
             printedNewValue);
-    } else {
+    }
+    else
+    {
         announcer.AnnounceConfigEdited(
-            selectedFeatureName,
+            selectedFeatureClass,
             selectedConfigName,
             pathToValue,
             printedOldValue,
@@ -444,18 +478,21 @@ protected function EditFeatureConfig(BaseText pathToValue, AcediaObject newValue
     _.memory.Free(newValue);
 }
 
-protected function SaveFeatureConfig() {
+protected function SaveFeatureConfig()
-    local BaseText enabledConfigName;
+{
-    local HashTable pendingData;
+    local BaseText              enabledConfigName;
-    local class<FeatureConfig> configClass;
+    local HashTable             pendingData;
+    local class<FeatureConfig>  configClass;
 
     configClass = selectedFeatureClass.default.configClass;
-    if (configClass == none) {
+    if (configClass == none)
-        announcer.AnnounceFailedNoConfigClass(selectedFeatureName);
+    {
+        announcer.AnnounceFailedNoConfigClass(selectedFeatureClass);
         return;
     }
     pendingData = pendingConfigs.GetPendingConfigData();
-    if (pendingData == none) {
+    if (pendingData == none)
+    {
         announcer.AnnounceFailedPendingConfigMissing(selectedConfigName);
         return;
     }
@@ -464,11 +501,13 @@ protected function SaveFeatureConfig() {
     configClass.static.SaveData(selectedConfigName, pendingData);
     //  Re-apply config if it is active?
     enabledConfigName = selectedFeatureClass.static.GetCurrentConfig();
-    if (selectedConfigName.Compare(enabledConfigName, SCASE_INSENSITIVE)) {
+    if (selectedConfigName.Compare(enabledConfigName, SCASE_INSENSITIVE))
+    {
         selectedFeatureClass.static.EnableMe(selectedConfigName);
-        announcer.AnnouncePublicPendingConfigSaved(selectedFeatureName);
+        announcer.AnnouncePublicPendingConfigSaved(selectedFeatureClass);
-    } else {
+    }
-        announcer.AnnouncePrivatePendingConfigSaved(selectedFeatureName, selectedConfigName);
+    else {
+        announcer.AnnouncePrivatePendingConfigSaved(selectedFeatureClass);
     }
     _.memory.Free(enabledConfigName);
     pendingData.FreeSelf();
@@ -476,104 +515,128 @@ protected function SaveFeatureConfig() {
     return;
 }
 
-protected function NewFeatureConfig() {
+protected function NewFeatureConfig()
-    local BaseText enabledConfigName;
+{
-    local class<FeatureConfig> configClass;
+    local BaseText              enabledConfigName;
+    local class<FeatureConfig>  configClass;
 
     configClass = selectedFeatureClass.default.configClass;
-    if (configClass == none) {
+    if (configClass == none)
-        announcer.AnnounceFailedNoConfigClass(selectedFeatureName);
+    {
+        announcer.AnnounceFailedNoConfigClass(selectedFeatureClass);
         return;
     }
-    if (configClass.static.Exists(selectedConfigName)) {
+    if (configClass.static.Exists(selectedConfigName))
-        announcer.AnnounceFailedConfigAlreadyExists(selectedFeatureName, selectedConfigName);
+    {
+        announcer.AnnounceFailedConfigAlreadyExists(
+            selectedFeatureClass,
+            selectedConfigName);
         return;
     }
-    if (!configClass.static.NewConfig(selectedConfigName)) {
+    if (!configClass.static.NewConfig(selectedConfigName))
+    {
         announcer.AnnounceFailedBadConfigName(selectedConfigName);
         return;
     }
     enabledConfigName = selectedFeatureClass.static.GetCurrentConfig();
-    if (selectedConfigName.Compare(enabledConfigName, SCASE_INSENSITIVE)) {
+    if (selectedConfigName.Compare(enabledConfigName, SCASE_INSENSITIVE))
+    {
         selectedFeatureClass.static.EnableMe(selectedConfigName);
-        announcer.AnnouncePublicPendingConfigSaved(selectedFeatureName);
+        announcer.AnnouncePublicPendingConfigSaved(selectedFeatureClass);
     }
     _.memory.Free(enabledConfigName);
-    announcer.AnnounceConfigCreated(selectedFeatureName, selectedConfigName);
+    announcer.AnnounceConfigCreated(selectedFeatureClass, selectedConfigName);
 }
 
-protected function RemoveFeatureConfig() {
+protected function RemoveFeatureConfig()
+{
     local class<FeatureConfig> configClass;
 
     configClass = selectedFeatureClass.default.configClass;
-    if (configClass == none) {
+    if (configClass == none)
-        announcer.AnnounceFailedNoConfigClass(selectedFeatureName);
+    {
+        announcer.AnnounceFailedNoConfigClass(selectedFeatureClass);
         return;
     }
-    if (!configClass.static.Exists(selectedConfigName)) {
+    if (!configClass.static.Exists(selectedConfigName))
+    {
         announcer.AnnounceFailedConfigDoesNotExist(
-            selectedFeatureName,
+            selectedFeatureClass,
             selectedConfigName);
         return;
     }
     pendingConfigs.RemoveConfig();
     configClass.static.DeleteConfig(selectedConfigName);
-    announcer.AnnounceConfigRemoved(selectedFeatureName, selectedConfigName);
+    announcer.AnnounceConfigRemoved(selectedFeatureClass, selectedConfigName);
 }
 
-protected function SetAutoFeatureConfig() {
+protected function SetAutoFeatureConfig()
-    local Text currentAutoEnabledConfig;
+{
-    local class<FeatureConfig> configClass;
+    local Text                  currentAutoEnabledConfig;
+    local class<FeatureConfig>  configClass;
 
     configClass = selectedFeatureClass.default.configClass;
-    if (configClass == none) {
+    if (configClass == none)
-        announcer.AnnounceFailedNoConfigClass(selectedFeatureName);
+    {
+        announcer.AnnounceFailedNoConfigClass(selectedFeatureClass);
         return;
     }
-    if (selectedConfigName != none && !configClass.static.Exists(selectedConfigName)) {
+    if (    selectedConfigName != none
-        announcer.AnnounceFailedConfigDoesNotExist(selectedFeatureName, selectedConfigName);
+        &&  !configClass.static.Exists(selectedConfigName))
+    {
+        announcer.AnnounceFailedConfigDoesNotExist(
+            selectedFeatureClass,
+            selectedConfigName);
         return;
     }
     currentAutoEnabledConfig = configClass.static.GetAutoEnabledConfig();
     if (selectedConfigName == none && currentAutoEnabledConfig == none) {
-        announcer.AnnounceFailedAlreadyNoAutoEnabled(selectedFeatureName);
+        announcer.AnnounceFailedAlreadyNoAutoEnabled(selectedFeatureClass);
     }
     else if (selectedConfigName != none &&
-        selectedConfigName.Compare(currentAutoEnabledConfig, SCASE_INSENSITIVE)) {
+        selectedConfigName.Compare(currentAutoEnabledConfig, SCASE_INSENSITIVE))
+    {
         announcer.AnnounceFailedAlreadySameAutoEnabled(
-            selectedFeatureName,
+            selectedFeatureClass,
             selectedConfigName);
-    } else {
+    }
+    else
+    {
         configClass.static.SetAutoEnabledConfig(selectedConfigName);
-        if (selectedConfigName != none) {
+        if (selectedConfigName != none)
+        {
             announcer.AnnounceAutoEnabledConfig(
-                selectedFeatureName,
+                selectedFeatureClass,
                 selectedConfigName);
-        } else {
+        }
-            announcer.AnnounceRemovedAutoEnabledConfig(selectedFeatureName);
+        else {
+            announcer.AnnounceRemovedAutoEnabledConfig(selectedFeatureClass);
         }
     }
     _.memory.Free(currentAutoEnabledConfig);
 }
 
-private function HashTable GetCurrentConfigData(BaseText configName) {
+private function HashTable GetCurrentConfigData(BaseText configName)
+{
     local class<FeatureConfig> configClass;
 
     if (configName == none) {
         return none;
     }
     configClass = selectedFeatureClass.default.configClass;
-    if (configClass == none) {
+    if (configClass == none)
-        announcer.AnnounceFailedNoConfigClass(selectedFeatureName);
+    {
+        announcer.AnnounceFailedNoConfigClass(selectedFeatureClass);
         return none;
     }
     return configClass.static.LoadData(configName);
 }
 
-private function HashTable GetCurrentSelectedConfigData() {
+private function HashTable GetCurrentSelectedConfigData()
+{
     return GetCurrentConfigData(selectedConfigName);
 }
 
-defaultproperties {
+defaultproperties
-    preferredName = "feature"
+{
 }

sources/Commands/ACommandFeature_Announcer.uc

@@ -75,8 +75,8 @@ protected function Finalizer()
 }
 
 public final function AnnounceEnabledFeature(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText configName)
+    BaseText        configName)
 {
     local int                   i;
     local array<TextTemplate>   templates;
@@ -93,12 +93,12 @@ public final function AnnounceEnabledFeature(
     }
     templates = MakeArray(enabledFeature);
     for (i = 0; i < templates.length; i += 1) {
-        templates[i].Reset().Arg(featureName).Arg(configName);
+        templates[i].Reset().ArgClass(featureClass).Arg(configName);
     }
     MakeAnnouncement(enabledFeature);
 }
 
-public final function AnnounceDisabledFeature(BaseText featureName)
+public final function AnnounceDisabledFeature(class<Feature> featureClass)
 {
     local int                   i;
     local array<TextTemplate>   templates;
@@ -114,15 +114,15 @@ public final function AnnounceDisabledFeature(BaseText featureName)
     }
     templates = MakeArray(disabledFeature);
     for (i = 0; i < templates.length; i += 1) {
-        templates[i].Reset().Arg(featureName);
+        templates[i].Reset().ArgClass(featureClass);
     }
     MakeAnnouncement(disabledFeature);
 }
 
 public final function AnnounceSwappedConfig(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText oldConfig,
+    BaseText        oldConfig,
-    BaseText newConfig)
+    BaseText        newConfig)
 {
     local int                   i;
     local array<TextTemplate>   templates;
@@ -142,7 +142,7 @@ public final function AnnounceSwappedConfig(
     {
         templates[i]
             .Reset()
-            .Arg(featureName)
+            .ArgClass(featureClass)
             .Arg(oldConfig)
             .Arg(newConfig);
     }
@@ -150,7 +150,7 @@ public final function AnnounceSwappedConfig(
 }
 
 public final function AnnouncePublicPendingConfigSaved(
-    BaseText featureName)
+    class<Feature> featureClass)
 {
     local int                   i;
     local array<TextTemplate>   templates;
@@ -167,30 +167,30 @@ public final function AnnouncePublicPendingConfigSaved(
     }
     templates = MakeArray(pendingConfigSavedPublic);
     for (i = 0; i < templates.length; i += 1) {
-        templates[i].Reset().Arg(featureName);
+        templates[i].Reset().ArgClass(featureClass);
     }
     MakeAnnouncement(pendingConfigSavedPublic);
 }
 
-public final function AnnouncePrivatePendingConfigSaved(BaseText featureName, BaseText configName)
+public final function AnnouncePrivatePendingConfigSaved(
+    class<Feature> featureClass)
 {
     if (!pendingConfigSavedPrivate.initialized)
     {
         pendingConfigSavedPrivate.initialized = true;
         pendingConfigSavedPrivate.toSelfReport = _.text.MakeTemplate_S(
-            "Config \"%2\" for feature {$TextEmphasis `%1`} was"
+            "Active config for feature {$TextEmphasis `%1`} was"
             @ "{$TextNeutral modified}");
     }
     pendingConfigSavedPrivate.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass);
-        .Arg(configName);
     MakeAnnouncement(pendingConfigSavedPrivate);
 }
 
 public final function AnnounceCurrentConfig(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!showCurrentConfig.initialized)
     {
@@ -200,14 +200,14 @@ public final function AnnounceCurrentConfig(
     }
     showCurrentConfig.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(showCurrentConfig);
 }
 
 public final function AnnouncePendingConfig(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!showPendingConfig.initialized)
     {
@@ -217,14 +217,14 @@ public final function AnnouncePendingConfig(
     }
     showPendingConfig.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(showPendingConfig);
 }
 
 public final function AnnounceConfigCreated(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!configCreated.initialized)
     {
@@ -235,14 +235,14 @@ public final function AnnounceConfigCreated(
     }
     configCreated.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(configCreated);
 }
 
 public final function AnnounceConfigRemoved(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!configRemoved.initialized)
     {
@@ -253,17 +253,17 @@ public final function AnnounceConfigRemoved(
     }
     configRemoved.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(configRemoved);
 }
 
 public final function AnnounceConfigEdited(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config,
+    BaseText        config,
-    BaseText pathToValue,
+    BaseText        pathToValue,
-    BaseText oldValue,
+    BaseText        oldValue,
-    BaseText newValue)
+    BaseText        newValue)
 {
     if (!configEdited.initialized)
     {
@@ -275,7 +275,7 @@ public final function AnnounceConfigEdited(
     }
     configEdited.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config)
         .Arg(pathToValue)
         .Arg(oldValue)
@@ -284,10 +284,10 @@ public final function AnnounceConfigEdited(
 }
 
 public final function AnnounceConfigNewValue(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config,
+    BaseText        config,
-    BaseText pathToValue,
+    BaseText        pathToValue,
-    BaseText newValue)
+    BaseText        newValue)
 {
     if (!configEditedNew.initialized)
     {
@@ -298,7 +298,7 @@ public final function AnnounceConfigNewValue(
     }
     configEditedNew.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config)
         .Arg(pathToValue)
         .Arg(newValue);
@@ -306,8 +306,8 @@ public final function AnnounceConfigNewValue(
 }
 
 public final function AnnounceAutoEnabledConfig(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!autoEnabled.initialized)
     {
@@ -318,13 +318,13 @@ public final function AnnounceAutoEnabledConfig(
     }
     autoEnabled.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(autoEnabled);
 }
 
 public final function AnnounceRemovedAutoEnabledConfig(
-    BaseText featureName)
+    class<Feature> featureClass)
 {
     if (!removedAutoEnabled.initialized)
     {
@@ -335,12 +335,12 @@ public final function AnnounceRemovedAutoEnabledConfig(
     }
     removedAutoEnabled.toSelfReport
         .Reset()
-        .Arg(featureName);
+        .ArgClass(featureClass);
     MakeAnnouncement(removedAutoEnabled);
 }
 
 public final function AnnounceFailedAlreadyNoAutoEnabled(
-    BaseText featureName)
+    class<Feature> featureClass)
 {
     if (!failedAlreadyNoAutoEnabled.initialized)
     {
@@ -352,13 +352,13 @@ public final function AnnounceFailedAlreadyNoAutoEnabled(
     }
     failedAlreadyNoAutoEnabled.toSelfReport
         .Reset()
-        .Arg(featureName);
+        .ArgClass(featureClass);
     MakeAnnouncement(failedAlreadyNoAutoEnabled);
 }
 
 public final function AnnounceFailedAlreadySameAutoEnabled(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!failedAlreadySameAutoEnabled.initialized)
     {
@@ -370,14 +370,14 @@ public final function AnnounceFailedAlreadySameAutoEnabled(
     }
     failedAlreadySameAutoEnabled.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(failedAlreadySameAutoEnabled);
 }
 
 public final function AnnounceFailedConfigAlreadyExists(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!failedConfigAlreadyExists.initialized)
     {
@@ -388,14 +388,14 @@ public final function AnnounceFailedConfigAlreadyExists(
     }
     failedConfigAlreadyExists.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(failedConfigAlreadyExists);
 }
     
-public final function AnnounceFailedConfigDoesNotExist(
+    public final function AnnounceFailedConfigDoesNotExist(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!failedConfigDoesNotExists.initialized)
     {
@@ -406,7 +406,7 @@ public final function AnnounceFailedConfigDoesNotExist(
     }
     failedConfigDoesNotExists.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(failedConfigDoesNotExists);
 }
@@ -424,7 +424,7 @@ public final function AnnounceFailedToLoadFeatureClass(BaseText failedClassName)
 }
 
 public final function AnnounceFailedNoConfigProvided(
-    BaseText featureName)
+    class<Feature> featureClass)
 {
     if (!failedNoConfigProvided.initialized)
     {
@@ -433,7 +433,7 @@ public final function AnnounceFailedNoConfigProvided(
             "{$TextFailure No config specified} and {$TextFailure no"
             @ "auto-enabled config} exists for feature {$TextEmphasis `%1`}");
     }
-    failedNoConfigProvided.toSelfReport.Reset().Arg(featureName);
+    failedNoConfigProvided.toSelfReport.Reset().ArgClass(featureClass);
     MakeAnnouncement(failedNoConfigProvided);
 }
 
@@ -463,8 +463,8 @@ public final function AnnounceFailedPendingConfigMissing(BaseText config)
 }
 
 public final function AnnounceFailedCannotEnableFeature(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!failedCannotEnableFeature.initialized)
     {
@@ -475,13 +475,13 @@ public final function AnnounceFailedCannotEnableFeature(
     }
     failedCannotEnableFeature.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(failedCannotEnableFeature);
 }
 
 public final function AnnounceFailedNoConfigClass(
-    BaseText featureName)
+    class<Feature> featureClass)
 {
     if (!failedNoConfigClass.initialized)
     {
@@ -491,7 +491,7 @@ public final function AnnounceFailedNoConfigClass(
             @ "class! This is most likely caused by its faulty"
             @ "implementation");
     }
-    failedNoConfigClass.toSelfReport.Reset().Arg(featureName);
+    failedNoConfigClass.toSelfReport.Reset().ArgClass(featureClass);
     MakeAnnouncement(failedNoConfigClass);
 }
 
@@ -508,7 +508,7 @@ public final function AnnounceFailedBadConfigName(BaseText configName)
 }
 
 public final function AnnounceFailedAlreadyDisabled(
-    BaseText featureName)
+    class<Feature> featureClass)
 {
     if (!failedAlreadyDisabled.initialized)
     {
@@ -517,13 +517,13 @@ public final function AnnounceFailedAlreadyDisabled(
             "{$TextFailure Cannot disable} feature {$TextEmphasis `%1`}: it is"
             @ "already {$TextNegative disabled}");
     }
-    failedAlreadyDisabled.toSelfReport.Reset().Arg(featureName);
+    failedAlreadyDisabled.toSelfReport.Reset().ArgClass(featureClass);
     MakeAnnouncement(failedAlreadyDisabled);
 }
 
 public final function AnnounceFailedAlreadyEnabled(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!failedAlreadyEnabled.initialized)
     {
@@ -534,14 +534,14 @@ public final function AnnounceFailedAlreadyEnabled(
     }
     failedAlreadyEnabled.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(failedAlreadyEnabled);
 }
 
 public final function AnnounceFailedNoDataForConfig(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config)
+    BaseText        config)
 {
     if (!failedNoDataForConfig.initialized)
     {
@@ -552,7 +552,7 @@ public final function AnnounceFailedNoDataForConfig(
     }
     failedNoDataForConfig.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config);
     MakeAnnouncement(failedNoDataForConfig);
 }
@@ -570,9 +570,9 @@ public final function AnnounceFailedExpectedObject()
 }
 
 public final function AnnounceFailedBadPointer(
-    BaseText featureName,
+    class<Feature>  featureClass,
-    BaseText config,
+    BaseText        config,
-    BaseText pointer)
+    BaseText        pointer)
 {
     if (!failedBadPointer.initialized)
     {
@@ -583,7 +583,7 @@ public final function AnnounceFailedBadPointer(
     }
     failedBadPointer.toSelfReport
         .Reset()
-        .Arg(featureName)
+        .ArgClass(featureClass)
         .Arg(config)
         .Arg(pointer);
     MakeAnnouncement(failedBadPointer);

sources/Commands/ACommandGod.uc

@@ -46,21 +46,21 @@ protected function Finalizer()
 
 protected function BuildData(CommandDataBuilder builder)
 {
-    builder.Group(P("gameplay"));
+    builder.Name(P("god")).Group(P("gameplay"))
-    builder.Summary(P("Command for making player immortal."));
+        .Summary(P("Command for making player immortal."));
-    builder.RequireTarget();
+    builder.RequireTarget()
-    builder.Describe(P("Gives targeted players god status, making them"
+        .Describe(P("Gives targeted players god status, making them"
             @ "invincible."));
-    builder.SubCommand(P("list"));
+    builder.SubCommand(P("list"))
-    builder.Describe(P("Reports godhood status of targeted players."));
+        .Describe(P("Reports godhood status of targeted players."));
-    builder.SubCommand(P("strip"));
+    builder.SubCommand(P("strip"))
-    builder.Describe(P("Strips targeted players from the godhood status."));
+        .Describe(P("Strips targeted players from the godhood status."));
-    builder.Option(P("demi"));
+    builder.Option(P("demi"))
-    builder.Describe(P("This flag makes targeted players \"demigods\" instead -"
+        .Describe(P("This flag makes targeted players \"demigods\" instead -"
             @ "they still cannot die, but they can take any non-lethal"
             @ "damage."));
-    builder.Option(P("unmovable"));
+    builder.Option(P("unmovable"))
-    builder.Describe(P("This flag also prevents targeted players from being"
+        .Describe(P("This flag also prevents targeted players from being"
             @ "affected by the momentum trasnferred from damaging attacks."));
     announcer = ACommandGod_Announcer(
         _.memory.Allocate(class'ACommandGod_Announcer'));
@@ -69,9 +69,8 @@ protected function BuildData(CommandDataBuilder builder)
 protected function ExecutedFor(
     EPlayer     target,
     CallData    arguments,
-    EPlayer     instigator,
+    EPlayer     instigator)
-    CommandPermissions permissions
+{
-) {
     local GodStatus newGodStatus;
 
     announcer.Setup(target, instigator, othersConsole);
@@ -216,7 +215,6 @@ private final function UpdateHealthSignalConnection()
 
 defaultproperties
 {
-    preferredName = "god"
     TDAMAGE             = 0
     stringConstants(0) = "damage"
     TMOMENTUM           = 1

sources/Commands/ACommandInventory.uc

@@ -34,57 +34,57 @@ var protected const int TLISTS_SKIPPED;
 
 protected function BuildData(CommandDataBuilder builder)
 {
-    builder.Group(P("gameplay"));
+    builder.Name(T(TINVENTORY)).Group(P("gameplay"))
-    builder.Summary(P("Manages player's inventory."));
+        .Summary(P("Manages player's inventory."))
-    builder.Describe(P("Command for displaying and editing players' inventories."
+        .Describe(P("Command for displaying and editing players' inventories."
             @ "If called without specifying subcommand - simply displays"
             @ "targeted player's inventory."));
     builder.RequireTarget();
-    builder.SubCommand(T(TADD));
+    builder.SubCommand(T(TADD))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TITEMS));
+        .ParamTextList(T(TITEMS))
-    builder.Describe(P("This command adds items (based on listed templates) to"
+        .Describe(P("This command adds items (based on listed templates) to"
             @ "the targeted player's inventory."
             @ "Instead of templates item aliases can be specified."));
-    builder.SubCommand(T(TREMOVE));
+    builder.SubCommand(T(TREMOVE))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TITEMS));
+        .ParamTextList(T(TITEMS))
-    builder.Describe(P("This command removes items (based on listed templates)"
+        .Describe(P("This command removes items (based on listed templates)"
             @ "from the targeted player's inventory."
             @ "Instead of templates item aliases can be specified."));
-    builder.SubCommand(T(TSET));
+    builder.SubCommand(T(TSET))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TITEMS));
+        .ParamTextList(T(TITEMS))
-    builder.Describe(P("This command acts like combination of two commands -"
+        .Describe(P("This command acts like combination of two commands -"
             @ "first removing all items from the player's current inventory and"
             @ "then adding specified items. first clears inventory"
             @ "(based on specified options) and then "));
-    builder.Option(T(TEQUIP));
+    builder.Option(T(TEQUIP))
-    builder.Describe(F("Affect items currently equipped by the targeted player."
+        .Describe(F("Affect items currently equipped by the targeted player."
             @ "Releveant for a {$TextEmphasis remove} subcommand."));
-    builder.Option(T(TLIST));
+    builder.Option(T(TLIST))
-    builder.Describe(P("Include weapons from specified group into the list."));
+        .Describe(P("Include weapons from specified group into the list."))
-    builder.ParamTextList(T(TLISTS_NAMES));
+        .ParamTextList(T(TLISTS_NAMES));
-    builder.Option(T(TAMMO));
+    builder.Option(T(TAMMO))
-    builder.Describe(P("When adding weapons - signals that their"
+        .Describe(P("When adding weapons - signals that their"
             @ "ammo / charge / whatever has to be filled after addition."));
-    builder.Option(T(TKEEP));
+    builder.Option(T(TKEEP))
-    builder.Describe(F("Removing items by default means simply destroying them."
+        .Describe(F("Removing items by default means simply destroying them."
             @ "This flag makes command to try and keep them in some form."
             @ "Success for all items is not guaranteed."));
-    builder.Option(T(THIDDEN));
+    builder.Option(T(THIDDEN))
-    builder.Describe(F("Some of the items in the inventory are"
+        .Describe(F("Some of the items in the inventory are"
             @ "{$TextEmphasis hidden} and are not supposed to be seem by"
             @ "the player. To avoid weird behavior, {$TextEmphasis inventory}"
             @ "command by default ignores them when affecting groups of items"
             @ "(like when removing all items) unless they're directly"
             @ "specified. This flag tells it to also affect hidden items."));
-    builder.Option(T(TFORCE));
+    builder.Option(T(TFORCE))
-    builder.Describe(P("Sometimes adding and removing items is impossible due to"
+        .Describe(P("Sometimes adding and removing items is impossible due to"
             @ "the limitations imposed by the game. This option allows to"
             @ "ignore some of those limitation."));
-    builder.Option(T(TALL), P("A"));
+    builder.Option(T(TALL), P("A"))
-    builder.Describe(F("This flag is used when removing items. If user has"
+        .Describe(F("This flag is used when removing items. If user has"
             @ "specified any weapon templates - it means"
             @ "\"remove all items with these tempaltes from inventory\","
             @ "but if user has not specified any templated it simply means"
@@ -94,9 +94,8 @@ protected function BuildData(CommandDataBuilder builder)
 protected function ExecutedFor(
     EPlayer     target,
     CallData    arguments,
-    EPlayer     instigator,
+    EPlayer     instigator)
-    CommandPermissions permissions
+{
-) {
     local InventoryTool tool;
     local ArrayList     itemsArray, specifiedLists;
     LoadUserFlags(arguments.options);
@@ -287,7 +286,6 @@ protected function array<Text> LoadItemsList(
 
 defaultproperties
 {
-    preferredName = "inventory"
     TINVENTORY      = 0
     stringConstants(0)  = "inventory"
     TADD            = 1

sources/Commands/ACommandNick.uc

@@ -34,31 +34,30 @@ protected function Finalizer()
 
 protected function BuildData(CommandDataBuilder builder)
 {
-    builder.Group(P("gameplay"));
+    builder.Name(P("nick")).Group(P("gameplay"))
-    builder.Summary(P("Changes nickname."));
+        .Summary(P("Changes nickname."));
     builder.RequireTarget();
-    builder.ParamRemainder(P("nick"));
+    builder.ParamRemainder(P("nick"))
-    builder.Describe(P("Changes nickname of targeted players to <nick>."));
+        .Describe(P("Changes nickname of targeted players to <nick>."));
-    builder.Option(P("plain"));
+    builder.Option(P("plain"))
-    builder.Describe(P("Take nickname exactly as typed, without attempting to"
+        .Describe(P("Take nickname exactly as typed, without attempting to"
             @ "treat it like formatted string."));
-    builder.Option(P("fix"), P("f"));
+    builder.Option(P("fix"), P("f"))
-    builder.Describe(P("In case of a nickname with erroroneous formatting or"
+        .Describe(P("In case of a nickname with erroroneous formatting or"
             @ "invalid default color (specified with `--color`),"
             @ "try to fix/ignore it instead of simply rejecting it."));
-    builder.Option(P("color"));
+    builder.Option(P("color"))
-    builder.Describe(P("Color to use for the nickname. In case nickname is already"
+        .Describe(P("Color to use for the nickname. In case nickname is already"
-            @ "colored, this flag will only affects uncolored parts."));
+            @ "colored, this flag will only affects uncolored parts."))
-    builder.ParamText(P("default_color"));
+        .ParamText(P("default_color"));
     announcer = ACommandNick_Announcer(
         _.memory.Allocate(class'ACommandNick_Announcer'));
 }
 
 protected function Executed(
     CallData    arguments,
-    EPlayer     callerPlayer,
+    EPlayer     callerPlayer)
-    CommandPermissions permissions
+{
-) {
     local Text                                                  givenName;
     local array<FormattingErrorsReport.FormattedStringError>    errors;
 
@@ -90,9 +89,8 @@ protected function Executed(
 protected function ExecutedFor(
     EPlayer     target,
     CallData    arguments,
-    EPlayer     instigator,
+    EPlayer     instigator)
-    CommandPermissions permissions
+{
-) {
     local Text alteredVersion;
 
     if (!foundErrors || arguments.options.HasKey(P("fix")))
@@ -128,6 +126,6 @@ protected function bool TryChangeDefaultColor(BaseText specifiedColor)
     return false;
 }
 
-defaultproperties {
+defaultproperties
-    preferredName = "nick"
+{
 }

sources/Commands/ACommandSpawn.uc

@@ -30,76 +30,72 @@ protected function Finalizer()
 
 protected function BuildData(CommandDataBuilder builder)
 {
-    builder.Group(P("debug"));
+    builder.Name(P("spawn")).Group(P("debug"))
-    builder.Summary(P("Spawns new entity on the map."));
+        .Summary(P("Spawns new entity on the map."));
-    builder.ParamText(P("template"),, P("entity"));
+    builder.ParamText(P("template"),, P("entity"))
-    builder.Describe(P("Spawns new entity based on the given template at the point"
+        .Describe(P("Spawns new entity based on the given template at the point"
             @ "player is currently looking at."));
-    builder.SubCommand(P("at"));
+    builder.SubCommand(P("at"))
-    builder.ParamText(P("template"),, P("entity"));
+        .ParamText(P("template"),, P("entity"))
-    builder.ParamNumber(P("x"));
+        .ParamNumber(P("x"))
-    builder.ParamNumber(P("y"));
+        .ParamNumber(P("y"))
-    builder.ParamNumber(P("z"));
+        .ParamNumber(P("z"))
-    builder.Describe(P("Spawns new entity based on the given template at"
+        .Describe(P("Spawns new entity based on the given template at"
             @ "the point, given by the coordinates"));
     announcer = ACommandSpawn_Announcer(
         _.memory.Allocate(class'ACommandSpawn_Announcer'));
 }
 
 protected function Executed(
-    CallData arguments,
+    CallData    arguments,
-    EPlayer instigator,
+    EPlayer     instigator)
-    CommandPermissions permissions
+{
-) {
+    local Text      template;
-    local HashTable value;
+    local Vector    spawnLocation;
-    local Vector spawnLocation;
 
     announcer.Setup(none, instigator, othersConsole);
-    value = arguments.parameters.GetHashTable(P("template"));
+    template = arguments.parameters.GetText(P("template"));
     if (arguments.subCommandName.IsEmpty()) {
-        SpawnInInstigatorSight(instigator, value);
+        SpawnInInstigatorSight(instigator, template);
-    } else if (arguments.subCommandName.Compare(P("at"), SCASE_INSENSITIVE)) {
+    }
+    else if (arguments.subCommandName.Compare(P("at"), SCASE_INSENSITIVE))
+    {
         spawnLocation.x = arguments.parameters.GetFloat(P("x"));
         spawnLocation.y = arguments.parameters.GetFloat(P("y"));
         spawnLocation.z = arguments.parameters.GetFloat(P("z"));
-        SpawnAt(instigator, value, spawnLocation);
+        SpawnAt(instigator, template, spawnLocation);
     }
-    _.memory.Free(value);
+    _.memory.Free(template);
 }
 
 private final function SpawnAt(
-    EPlayer instigator,
+    EPlayer     instigator,
-    HashTable value,
+    BaseText    template,
-    Vector spawnLocation
+    Vector      spawnLocation)
-) {
+{
-    local Text humanReadable, template;
     local EPlaceable result;
 
-    humanReadable = value.GetText(P("alias"));
-    template = value.GetText(P("value"));
     result = _server.kf.world.Spawn(template, spawnLocation);
     if (result != none) {
-        announcer.AnnounceSpawned(humanReadable);
+        announcer.AnnounceSpawned(template);
-    } else {
+    }
-        announcer.AnnounceSpawningFailed(humanReadable);
+    else {
+        announcer.AnnounceSpawningFailed(template);
     }
-    _.memory.Free2(humanReadable, result);
+    _.memory.Free(result);
 }
 
 private final function SpawnInInstigatorSight(
-    EPlayer instigator,
+    EPlayer     instigator,
-    HashTable value
+    BaseText    template)
-) {
+{
-    local EPlaceable result;
+    local EPlaceable        result;
-    local Vector spawnLocation;
+    local Vector            spawnLocation;
-    local TracingIterator iter;
+    local TracingIterator   iter;
-    local Text humanReadable, template;
 
-    humanReadable = value.GetText(P("alias"));
-    template = value.GetText(P("value"));
     iter = _server.kf.world.TracePlayerSight(instigator);
-    iter.LeaveOnlyVisible();
+    if (iter.LeaveOnlyVisible().HasFinished())
-    if (iter.HasFinished()) {
+    {
         announcer.AnnounceFailedTrace();
         return;
     }
@@ -107,18 +103,22 @@ private final function SpawnInInstigatorSight(
     result = _server.kf.world.Spawn(template, spawnLocation);
     //  Shift position back a little and try again;
     //  this should fix a ton of spawning failures
-    if (result == none) {
+    if (result == none)
-        spawnLocation = spawnLocation + Normal(iter.GetTracingStart() - spawnLocation) * 100;
+    {
+        spawnLocation = spawnLocation +
+            Normal(iter.GetTracingStart() - spawnLocation) * 100;
         result = _server.kf.world.Spawn(template, spawnLocation);
     }
     if (result != none) {
-        announcer.AnnounceSpawned(humanReadable);
+        announcer.AnnounceSpawned(template);
-    } else {
-        announcer.AnnounceSpawningFailed(humanReadable);
     }
-    _.memory.Free4(result, iter, humanReadable, result);
+    else {
+        announcer.AnnounceSpawningFailed(template);
+    }
+    _.memory.Free(result);
+    _.memory.Free(iter);
 }
 
-defaultproperties {
+defaultproperties
-    preferredName = "spawn"
+{
 }

sources/Commands/ACommandTrader.uc

@@ -38,60 +38,60 @@ protected function Finalizer()
 
 protected function BuildData(CommandDataBuilder builder)
 {
-    builder.Group(P("gameplay"));
+    builder.Name(T(TTRADER)).Group(P("gameplay"))
-    builder.Summary(P("Manages trader time and available traders."));
+        .Summary(P("Manages trader time and available traders."))
-    builder.Describe(P("Enables of disables trading."));
+        .Describe(P("Enables of disables trading."))
-    builder.ParamBoolean(T(TENABLE));
+        .ParamBoolean(T(TENABLE));
-    builder.SubCommand(T(TTIME));
+    builder.SubCommand(T(TTIME))
-    builder.Describe(F("Changes current trader time if numeric value is specified."
+        .Describe(F("Changes current trader time if numeric value is specified."
             @ "You can also pause trader countdown by specifying"
             @ "{$TextEmphasis pause} or turn it back on with"
-            @ "{$TextEmphasis unpause}."));
+            @ "{$TextEmphasis unpause}."))
-    builder.ParamText(T(TTRADER_TIME));
+        .ParamText(T(TTRADER_TIME));
-    builder.SubCommand(T(TLIST));
+    builder.SubCommand(T(TLIST))
-    builder.Describe(P("Lists names of all available traders and"
+        .Describe(P("Lists names of all available traders and"
             @ "marks closest one to the caller."));
-    builder.SubCommand(T(TOPEN));
+    builder.SubCommand(T(TOPEN))
-    builder.Describe(P("Opens specified traders."));
+        .Describe(P("Opens specified traders."))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TTRADERS));
+        .ParamTextList(T(TTRADERS));
-    builder.SubCommand(T(TCLOSE));
+    builder.SubCommand(T(TCLOSE))
-    builder.Describe(P("Closes specified traders."));
+        .Describe(P("Closes specified traders."))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TTRADERS));
+        .ParamTextList(T(TTRADERS));
-    builder.SubCommand(T(TAUTO_OPEN));
+    builder.SubCommand(T(TAUTO_OPEN))
-    builder.Describe(P("Sets whether specified traders are open automatically."));
+        .Describe(P("Sets whether specified traders are open automatically."))
-    builder.ParamBoolean(T(TAUTO_OPEN_QUESTION));
+        .ParamBoolean(T(TAUTO_OPEN_QUESTION))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TTRADERS));
+        .ParamTextList(T(TTRADERS));
-    builder.SubCommand(T(TSELECT));
+    builder.SubCommand(T(TSELECT))
-    builder.Describe(P("Selects specified trader."));
+        .Describe(P("Selects specified trader."))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamText(T(TTRADER));
+        .ParamText(T(TTRADER));
-    builder.SubCommand(T(TBOOT));
+    builder.SubCommand(T(TBOOT))
-    builder.Describe(P("Boots all players from specified traders. If no traders"
+        .Describe(P("Boots all players from specified traders. If no traders"
-            @ "were specified - assumes that all of them should be affected."));
+            @ "were specified - assumes that all of them should be affected."))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TTRADERS));
+        .ParamTextList(T(TTRADERS));
-    builder.SubCommand(T(TENABLE));
+    builder.SubCommand(T(TENABLE))
-    builder.Describe(P("Enables specified traders."));
+        .Describe(P("Enables specified traders."))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TTRADERS));
+        .ParamTextList(T(TTRADERS));
-    builder.SubCommand(T(TDISABLE));
+    builder.SubCommand(T(TDISABLE))
-    builder.Describe(P("Disables specified traders."));
+        .Describe(P("Disables specified traders."))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamTextList(T(TTRADERS));
+        .ParamTextList(T(TTRADERS));
-    builder.Option(T(TALL));
+    builder.Option(T(TALL))
-    builder.Describe(P("If sub-command targets shops, this flag will make it"
+        .Describe(P("If sub-command targets shops, this flag will make it"
             @ "target all the available shops."));
-    builder.Option(T(TCLOSEST));
+    builder.Option(T(TCLOSEST))
-    builder.Describe(P("If sub-command targets shops, this flag will make it also"
+        .Describe(P("If sub-command targets shops, this flag will make it also"
             @ "target closest shop to the caller."));
-    builder.Option(T(TIGNORE_DOORS));
+    builder.Option(T(TIGNORE_DOORS))
-    builder.Describe(F("When used with {$TextEmphasis select} sub-command, it will"
+        .Describe(F("When used with {$TextEmphasis select} sub-command, it will"
             @ "neither open or close doors."));
-    builder.Option(T(TIGNORE_PLAYERS), P("I"));
+    builder.Option(T(TIGNORE_PLAYERS), P("I"))
-    builder.Describe(P("Normally commands that close doors will automatically boot"
+        .Describe(P("Normally commands that close doors will automatically boot"
             @ "players from inside to prevent locking them in. This flag forces"
             @ "this command to leave players inside. However they can still be"
             @ "booted out at the end of trading time. Also it is impossible to"
@@ -100,11 +100,8 @@ protected function BuildData(CommandDataBuilder builder)
         _.memory.Allocate(class'ACommandTrader_Announcer'));
 }
 
-protected function Executed(
+protected function Executed(CallData arguments, EPlayer instigator)
-    CallData arguments,
+{
-    EPlayer instigator,
-    CommandPermissions permissions
-) {
     local bool newTradingStatus;
 
     announcer.Setup(none, instigator, othersConsole);
@@ -635,7 +632,6 @@ protected function WriteTraderTags(ETrader traderToWrite, bool isClosest)
 
 defaultproperties
 {
-    preferredName = "trader"
     TLIST               = 0
     stringConstants(0)  = "list"
     TOPEN               = 1

sources/Commands/ACommandUserData.uc

@@ -1,6 +1,6 @@
 /**
  *  Command for changing amount of money players have.
- *      Copyright 2022-2023 Anton Tarasenko
+ *      Copyright 2022 Anton Tarasenko
  *------------------------------------------------------------------------------
  * This file is part of Acedia.
  *
@@ -21,23 +21,24 @@ class ACommandUserData extends Command;
 
 var private array<EPlayer> playerQueue;
 
+//  TODO: Finish this command after JSON parameters are added
 protected function BuildData(CommandDataBuilder builder)
 {
-    builder.Group(P("admin"));
+    builder.Name(P("userdata")).Group(P("admin"))
-    builder.Summary(P("Allows to read and write custom user data for players."));
+        .Summary(P("Allows to read and write custom user data for players."));
     builder.RequireTarget();
-    builder.ParamText(P("groupName"));
+    builder.ParamText(P("groupName"))
-    builder.OptionalParams();
+        .OptionalParams()
-    builder.ParamText(P("dataName"));
+        .ParamText(P("dataName"))
-    builder.Describe(F("Reads user data stored for targeted user under group"
+        .Describe(P("Reads user data stored for targeted user under group"
             @ "{$TextEmphasis `groupName`} and name"
             @ "{$TextEmphasis `dataName`}. If {$TextEmphasis `dataName`} is"
-            @ "omitted, the data inside the whole group will be read."));
+            @ "omitted, the data inside the whjole group will be read."));
-    builder.SubCommand(P("write"));
+    builder.SubCommand(P("write"))
-    builder.ParamText(P("groupName"));
+        .ParamText(P("groupName"))
-    builder.ParamText(P("dataName"));
+        .ParamText(P("dataName"))
-    builder.ParamJSON(P("newData"));
+        .ParamObject(P("newData"))
-    builder.Describe(F("Stores new user data {$TextEmphasis `newData`} for"
+        .Describe(P("Stores new user data {$TextEmphasis `newData`} for"
             @ "targeted user under group {$TextEmphasis `groupName`} and name"
             @ "{$TextEmphasis `dataName`}."));
 }
@@ -45,85 +46,74 @@ protected function BuildData(CommandDataBuilder builder)
 protected function ExecutedFor(
     EPlayer     target,
     CallData    arguments,
-    EPlayer     instigator,
+    EPlayer     instigator)
-    CommandPermissions permissions
+{
-) {
     local AcediaObject  userData;
-    local Text          groupName, dataName;
 
-    groupName   = arguments.parameters.GetText(P("groupName"));
+    if (arguments.subCommandName.IsEmpty())
-    dataName    = arguments.parameters.GetText(P("dataName"));
+    {
-    userData    = arguments.parameters.GetItem(P("newData"));
+        target
-    if (arguments.subCommandName.IsEmpty()) {
+            .GetIdentity()
-        ReadUserData(target, groupName, dataName);
+            .ReadPersistentData(
+                arguments.parameters.GetText(P("groupName")),
+                arguments.parameters.GetText(P("dataName")))
+            .connect = UserDataRead;
     }
-    else {
+    else
-        WriteUserData(target, groupName, dataName, userData);
+    {
+        userData = arguments.parameters.GetHashTable(P("newData"));
+        target
+            .GetIdentity()
+            .WritePersistentData(
+                arguments.parameters.GetText(P("groupName")),
+                arguments.parameters.GetText(P("dataName")),
+                userData);
     }
-    _.memory.Free(dataName);
+    playerQueue[playerQueue.length] = target;
-    _.memory.Free(groupName);
+    target.NewRef();
 }
 
-private final function ReadUserData(
+private final function UserDataRead(
-    EPlayer     targetPlayer,
+    Database.DBQueryResult  result,
-    BaseText    groupName,
+    AcediaObject            userData,
-    BaseText    dataName)
+    Database                source)
 {
-    local User          identity;
-    local AcediaObject  rawData;
-    local MutableText   dataAsJSON;
     local Text          targetPlayerName;
+    local EPlayer       targetPlayer;
+    local MutableText   asJSON;
 
-    identity = targetPlayer.GetIdentity();
+    if (playerQueue.length <= 0)
-    if (identity == none) {
+    {
+        targetPlayer
+            .BorrowConsole()
+            .UseColorOnce(_.color.TextFailure)
+            .Write(F("There was an internal error with `userdata` command. "))
+            .Write(P("Please report it!"));
+        return;
+    }
+    targetPlayer = playerQueue[0];
+    playerQueue.Remove(0, 1);
+    if (result != DBR_Success)
+    {
+        targetPlayer
+            .BorrowConsole()
+            .UseColorOnce(_.color.TextFailure)
+            .Write(F("There was an error reading user data, error code: "))
+            .WriteLine(_.text.FromInt(int(result)));
         return;
     }
     targetPlayerName = targetPlayer.GetName();
-    rawData = identity.GetPersistentData(groupName, dataName);
+    asJSON = _.json.PrettyPrint(userData);
-    dataAsJSON = _.json.PrettyPrint(rawData);
     targetPlayer.BorrowConsole()
-        .Write(F("User data for player "))
+        .Write(F("{$TextPositive User data for player}"))
         .Write(targetPlayerName)
-        .Write(P(": "))
+        .Write(P(":"))
-        .WriteLine(dataAsJSON);
+        .WriteLine(asJSON);
-    _.memory.Free(dataAsJSON);
+    _.memory.Free(targetPlayer);
-    _.memory.Free(rawData);
+    _.memory.Free(asJSON);
     _.memory.Free(targetPlayerName);
-    _.memory.Free(identity);
 }
 
-private final function WriteUserData(
+defaultproperties
-    EPlayer         targetPlayer,
-    BaseText        groupName,
-    BaseText        dataName,
-    AcediaObject    rawData)
 {
-    local User identity;
-    local Text targetPlayerName;
-
-    identity = targetPlayer.GetIdentity();
-    if (identity == none) {
-        return;
-    }
-    targetPlayerName = targetPlayer.GetName();
-    if (identity.SetPersistentData(groupName, dataName, rawData))
-    {
-        targetPlayer.BorrowConsole()
-            .Write(P("User data for player "))
-            .Write(targetPlayerName)
-            .WriteLine(F(" was {$TextPositive successfully} changed!"));
-    }
-    else
-    {
-        targetPlayer.BorrowConsole()
-            .Write(P("User data for player "))
-            .Write(targetPlayerName)
-            .WriteLine(F(" has {$TextPositive failed} to change!"));
-    }
-    _.memory.Free(targetPlayerName);
-    _.memory.Free(identity);
-}
-
-defaultproperties {
-    preferredName = "userdata"
 }

sources/Features/FutileChat/FutilityChat.uc

@@ -1,6 +1,6 @@
 /**
- *  Config class for storing map lists.
+ *      Config object for `FutilityChat_Feature`.
- *      Copyright 2022-2023 Anton Tarasenko
+ *      Copyright 2022 Anton Tarasenko
  *------------------------------------------------------------------------------
  * This file is part of Acedia.
  *
@@ -21,7 +21,8 @@ class FutilityChat extends FeatureConfig
     perobjectconfig
     config(FutilityChat);
 
-enum ChatColorSetting {
+enum ChatColorSetting
+{
     CCS_DoNothing,
     CCS_TeamColorForced,
     CCS_ConfigColorForced,
@@ -29,45 +30,16 @@ enum ChatColorSetting {
     CCS_ConfigColorCustom
 };
 
-/// How to color text chat messages?
+var public config ChatColorSetting  colorSetting;
-///
+var public config Color             configuredColor;
-/// 1. `CCS_DoNothing` - do not change color in any way;
+var public config float             teamColorModifier;
-/// 2. `CCS_TeamColorForced` - force players' team colors for
-///     their messages;
-/// 3. `CCS_ConfigColorForced` - force `configuredColor` value for
-///     players' messages;
-/// 4. `CCS_TeamColorCustom` - use players' team colors for
-///     their messages by default, but allow to change color with formatted tags
-///     (e.g. "Stop right there, {$crimson criminal} scum!");
-/// 5. `CCS_ConfigColorCustom` - use `configuredColor` value for
-///     messages by default, but allow to change color with formatted
-///     tags (e.g. "Stop right there, {$crimson criminal} scum!");
-///
-/// Default is `CCS_DoNothing`, corresponding to vanilla behaviour.
-var public config ChatColorSetting colorSetting;
-/// Color that will be used if either of `CCS_ConfigColorForced` or
-/// `CCS_ConfigColorCustom` options were used in `colorSetting`.
-/// Default value is white: (R=255,G=255,B=255,A=255), has no vanilla
-/// equivalent.
-var public config Color configuredColor;
-/// Allows to modify team color's value for the chat messages
-/// (if either of `CCS_TeamColorForced` or `CCS_TeamColorCustom` options
-/// were used) to be lighter or darker.
-/// This value is clamped between -1 and 1:
-///
-/// * `0` means using the same color;
-/// * range (0; 1) - gives you lighter colors (`1` being white);
-/// * range (-1; 0) - gives you darker colors (`-1` being black);
-///
-/// Default value is `0.6`, has no vanilla equivalent.
-var public config float teamColorModifier;
 
-protected function HashTable ToData() {
+protected function HashTable ToData()
+{
     local HashTable data;
-    local Text colorAsText;
+    local Text      colorAsText;
-
     data = __().collections.EmptyHashTable();
-    data.SetString(P("colorSetting"), StringFromColorSetting(colorSetting));
+    data.SetString(P("colorSetting"), string(colorSetting));
     colorAsText = _.color.ToText(configuredColor);
     data.SetItem(P("configuredColor"), colorAsText);
     _.memory.Free(colorAsText);
@@ -75,21 +47,24 @@ protected function HashTable ToData() {
     return data;
 }
 
-protected function FromData(HashTable source) {
+protected function FromData(HashTable source)
+{
     local Text storedText;
-
+    if (source == none) {
-    if (source != none) {
+        return;
-        storedText = source.GetText(P("colorSetting"));
-        colorSetting = ColorSettingFromText(storedText);
-        _.memory.Free(storedText);
-        storedText = source.GetText(P("configuredColor"));
-        _.color.Parse(storedText, configuredColor);
-        _.memory.Free(storedText);
-        teamColorModifier = source.GetFloat(P("teamColorModifier"), 0.5);
     }
+    storedText = source.GetText(P("colorSetting"));
+    colorSetting = ColorSettingFromText(storedText);
+    _.memory.Free(storedText);
+    storedText = source.GetText(P("configuredColor"));
+    _.color.Parse(storedText, configuredColor);
+    _.memory.Free(storedText);
+    teamColorModifier = source.GetFloat(P("teamColorModifier"), 0.5);
 }
 
-private function ChatColorSetting ColorSettingFromText(BaseText permissions) {
+private function ChatColorSetting ColorSettingFromText(
+    BaseText permissions)
+{
     if (permissions == none) {
         return CCS_DoNothing;
     }
@@ -108,34 +83,17 @@ private function ChatColorSetting ColorSettingFromText(BaseText permissions) {
     return CCS_DoNothing;
 }
 
-private function string StringFromColorSetting(ChatColorSetting permissions) {
+protected function DefaultIt()
-    if (permissions == CCS_DoNothing) {
+{
-        return "DoNothing";
+    colorSetting        = CCS_DoNothing;
-    }
+    configuredColor     = _.color.RGB(255, 255, 255);
-    if (permissions == CCS_TeamColorForced) {
+    teamColorModifier   = 0.6;
-        return "TeamColorForced";
-    }
-    if (permissions == CCS_ConfigColorForced) {
-        return "ConfigColorForced";
-    }
-    if (permissions == CCS_TeamColorCustom) {
-        return "TeamColorCustom";
-    }
-    if (permissions == CCS_ConfigColorCustom) {
-        return "ConfigColorCustom";
-    }
-    return "DoNothing";
-}
-
-protected function DefaultIt() {
-    colorSetting = CCS_DoNothing;
-    configuredColor = _.color.RGB(255, 255, 255);
-    teamColorModifier = 0.6;
 }
 
-defaultproperties {
+defaultproperties
+{
     configName = "FutilityChat"
-    colorSetting = CCS_DoNothing
+    colorSetting        = CCS_DoNothing
-    configuredColor = (R=255,G=255,B=255,A=255)
+    configuredColor     = (R=255,G=255,B=255,A=255)
-    teamColorModifier = 0.6
+    teamColorModifier   = 0.6
 }

sources/Features/FutileChat/FutilityChat_Feature.uc

@@ -1,6 +1,6 @@
 /**
- *  Config class for storing map lists.
+ *  This feature allows to configure color of text chat messages.
- *      Copyright 2022-2023 Anton Tarasenko
+ *      Copyright 2022 Anton Tarasenko
  *------------------------------------------------------------------------------
  * This file is part of Acedia.
  *
@@ -20,82 +20,123 @@
 class FutilityChat_Feature extends Feature
     dependson(FutilityChat);
 
-var private /*config*/ FutilityChat.ChatColorSetting colorSetting;
+//  How to color text chat messages?
-var private /*config*/ Color configuredColor;
+//      1. `CCS_DoNothing` - do not change color in any way;
-var private /*config*/ float teamColorModifier;
+//      2. `CCS_TeamColorForced` - force players' team colors for
+//          their messages;
+//      3. `CCS_ConfigColorForced` - force `configuredColor` value for
+//          players' messages;
+//      4. `CCS_TeamColorCustom` - use players' team colors for
+//          their messages by default, but allow to change color with formatted
+//          tags (e.g. "Stop right there, {$crimson criminal} scum!");
+//      5. `CCS_ConfigColorCustom` - use `configuredColor` value for
+//          messages by default, but allow to change color with formatted
+//          tags (e.g. "Stop right there, {$crimson criminal} scum!");
+//  Default is `CCS_DoNothing`, corresponding to vanilla behaviour.
+var private /*config*/ FutilityChat.ChatColorSetting    colorSetting;
+//  Color that will be used if either of `CCS_ConfigColorForced` or
+//  `CCS_ConfigColorCustom` options were used in `colorSetting`.
+//  Default value is white: (R=255,G=255,B=255,A=255),
+//  has no vanilla equivalent.
+var private /*config*/ Color                            configuredColor;   
+//      Allows to modify team color's value for the chat messages
+//  (if either of `CCS_TeamColorForced` or `CCS_TeamColorCustom` options
+//  were used) to be lighter or darker.
+//      This value is clamped between -1 and 1.
+//          * `0` means using the same color;
+//          * range (0; 1) - gives you lighter colors (`1` being white);
+//          * range (-1; 0) - gives you darker colors (`-1` being black);
+//  Default value is `0.6`, has no vanilla equivalent.
+var private /*config*/ float                            teamColorModifier;
 
-/// Keep track of whether we connected to necessary signals, so that we can
+//  Keep track of whether we connected to necessary signals, so that we can
-/// connect to them or disconnect from them once setting get updated
+//  connect to them or disconnect from them once setting get updated
 var private bool connectedToSignal;
 
-protected function OnEnabled() {
+protected function OnDisabled()
-    if (colorSetting != CCS_DoNothing) {
+{
-        _.chat.OnMessage(self).connect = ReformatChatMessage;
+    if (connectedToSignal)
-    }
+    {
-}
+        connectedToSignal = false;
-
-protected function OnDisabled() {
-    if (colorSetting != CCS_DoNothing) {
         _.chat.OnMessage(self).Disconnect();
     }
 }
 
 protected function SwapConfig(FeatureConfig config)
 {
-    local bool configRequiresSignal;
+    local bool          configRequiresSignal;
-    local FutilityChat newConfig;
+    local FutilityChat  newConfig;
-
     newConfig = FutilityChat(config);
     if (newConfig == none) {
         return;
     }
-    colorSetting = newConfig.colorSetting;
+    colorSetting            = newConfig.colorSetting;
-    configuredColor = newConfig.configuredColor;
+    configuredColor         = newConfig.configuredColor;
-    teamColorModifier = newConfig.teamColorModifier;
+    teamColorModifier       = newConfig.teamColorModifier;
-    configRequiresSignal = (colorSetting != CCS_DoNothing);
+    configRequiresSignal    = (colorSetting != CCS_DoNothing);
+    //  Enable or disable censoring if `IsAnyCensoringEnabled()`'s response
+    //  has changed.
+    if (!connectedToSignal && configRequiresSignal)
+    {
+        connectedToSignal = true;
+        _.chat.OnMessage(self).connect = ReformatChatMessage;
+    }
+    if (connectedToSignal && !configRequiresSignal)
+    {
+        connectedToSignal = false;
+        _.chat.OnMessage(self).Disconnect();
+    }
 }
 
 private function bool ReformatChatMessage(
-    EPlayer sender,
+    EPlayer     sender,
     MutableText message,
-    bool teamMessage
+    bool        teamMessage)
-) {
+{
-    local Text messageCopy;
+    local Text                  messageCopy;
-    local BaseText.Formatting defaultFormatting;
+    local BaseText.Formatting   defaultFormatting;
-
     if (sender == none)                 return true;
     if (message == none)                return true;
     if (colorSetting == CCS_DoNothing)  return true;
 
     defaultFormatting.isColored = true;
-    if (colorSetting == CCS_TeamColorForced || colorSetting == CCS_TeamColorCustom) {
+    if (    colorSetting == CCS_TeamColorForced
+        ||  colorSetting == CCS_TeamColorCustom)
+    {
         defaultFormatting.color = ModColor(sender.GetTeamColor());
-    } else {
+    }
+    else {
         defaultFormatting.color = configuredColor;
     }
     if (message.StartsWith(P("|"))) {
         message.Remove(0, 1);
-    } else if (colorSetting != CCS_TeamColorForced && colorSetting != CCS_ConfigColorForced) {
+    }
+    else if (   colorSetting != CCS_TeamColorForced
+            &&  colorSetting != CCS_ConfigColorForced)
+    {
         messageCopy = message.Copy();
-        class'FormattingStringParser'.static.ParseFormatted(messageCopy, message.Clear());
+        class'FormattingStringParser'.static
+            .ParseFormatted(messageCopy, message.Clear());
         _.memory.Free(messageCopy);
     }
     message.ChangeDefaultFormatting(defaultFormatting);
     return true;
 }
 
-private function Color ModColor(Color inputColor) {
+private function Color ModColor(Color inputColor)
+{
     local Color mixColor;
     local Color outputColor;
     local float clampedModifier;
-
     if (Abs(teamColorModifier) < 0.001) {
         return inputColor;
     }
     clampedModifier = FClamp(teamColorModifier, -1.0, 1.0);
     if (clampedModifier > 0) {
         mixColor = _.color.White;
-    } else {
+    }
+    else
+    {
         mixColor = _.color.Black;
         clampedModifier *= -1.0;
     }
@@ -106,6 +147,7 @@ private function Color ModColor(Color inputColor) {
     return outputColor;
 }
 
-defaultproperties {
+defaultproperties
+{
     configClass = class'FutilityChat'
 }

sources/Features/FutileNickames/FutilityNicknames.uc

@@ -1,6 +1,6 @@
 /**
- *  Config class for storing map lists.
+ *      Config object for `FutileNickames_Feature`.
- *      Copyright 2022-2023 Anton Tarasenko
+ *      Copyright 2022 Anton Tarasenko
  *------------------------------------------------------------------------------
  * This file is part of Acedia.
  *
@@ -21,108 +21,62 @@ class FutilityNicknames extends FeatureConfig
     perobjectconfig
     config(FutilityNicknames);
 
-enum NicknameSpacesAction {
+enum NicknameSpacesAction
+{
     NSA_DoNothing,
     NSA_Trim,
     NSA_Simplify
 };
 
-enum NicknameColorPermissions {
+enum NicknameColorPermissions
+{
     NCP_ForbidColor,
     NCP_ForceTeamColor,
     NCP_ForceSingleColor,
     NCP_AllowAnyColor
 };
 
-/// How to treat whitespace characters inside players' nicknames:
+var public config NicknameSpacesAction      spacesAction;
-///
+var public config NicknameColorPermissions  colorPermissions;
-/// * `NSA_DoNothing` - does nothing, leaving whitespaces as they are;
+var public config bool                      replaceSpacesWithUnderscores;
-/// * `NSA_Trim` - removes leading and trailing whitespaces for nicknames;
+var public config bool                      removeSingleQuotationMarks;
-/// * `NSA_Simplify` - removes leading and trailing whitespaces
+var public config bool                      removeDoubleQuotationMarks;
-///     for nicknames, also reducing a sequence of whitespaces inside
+var public config bool                      correctEmptyNicknames;
-///     nickname to a single space, e.g. "my   nick" becomes "my nick".
+var public config int                       maxNicknameLength;
-///
+var public config array<string>             fallbackNickname;
-/// Default is `NSA_DoNothing`, same as on vanilla.
-var public config NicknameSpacesAction spacesAction;
-/// How to treat colored nicknames:
-///
-/// * `NCP_ForbidColor` - completely strips down any color from nicknames;
-/// * `NCP_ForceTeamColor` - forces all nicknames to have player's current
-///     team's color;
-/// * `NCP_ForceSingleColor` - allows nickname to be painted with a single
-///     color (sets nickname's color to that of the first character);
-/// * `NCP_AllowAnyColor` - allows nickname to be colored in any way player
-///     wants.
-/// Default is `NCP_ForbidColor`, same as on vanilla.
-var public config NicknameColorPermissions colorPermissions;
-/// Set this to `true` if you wish to replace all whitespace characters with
-/// underscores and `false` to leave them as is.
-/// Default is `true`, same as on vanilla. However there is one difference:
-/// Futility replaces all whitespace characters (including tabulations,
-/// non-breaking spaces, etc.) instead of only ' '.
-var public config bool replaceSpacesWithUnderscores;
-/// Set this to `true` to remove single 'quotation marks' and `false` to
-/// leave them. Default is `false`, same as on vanilla.
-var public config bool removeSingleQuotationMarks;
-/// Set this to `true` to remove dobule 'quotation marks' and `false` to
-/// leave them. Default is `true`, same as on vanilla.
-var public config bool removeDoubleQuotationMarks;
-/// Should we replace empty player nicknames with a random fallback nickname
-/// (defined in `fallbackNickname` array)?
-var public config bool correctEmptyNicknames;
-/// Max allowed nickname length. Negative values disable any length limits.
-///
-/// NOTE #1: `0` resets all nicknames to be empty and,
-/// if `correctEmptyNicknames` is set to `true`, they will be replaced with
-/// one of the fallback nicknames (see `correctEmptyNicknames` and
-/// `fallbackNickname`).
-///
-/// NOTE #2: Because of how color swapping in vanilla Killing Floor works,
-/// every color swap makes text count as being about 4 characters longer.
-/// So if one uses too many colors in the nickname, for drawing functions
-/// it will appear to be longer than it actually is and it *will* mess up
-/// UI. Unless you are using custom HUD it is recommended to keep this value
-/// at default `20` and forbid colored nicknames (by setting
-/// `colorPermissions=NCP_ForbidColor`). Or to allow only one color (by setting
-/// `colorPermissions=NCP_ForceSingleColor` or
-/// `colorPermissions=NCP_ForceTeamColor`) and reducing `maxNicknameLength` to
-/// `16` (20 characters - 4 for color swap).
-/// If you want to increase the limit above that, you can also do your own
-/// research by testing nicknames of various length on screen resolutions you
-/// care about.
-var public config int maxNicknameLength;
-/// Array of fallback nicknames that will be used to replace any empty nicknames
-/// if `correctEmptyNicknames` is set to `true`.
-var public config array<string> fallbackNickname;
 
-protected function HashTable ToData() {
+protected function HashTable ToData()
-    local int i;
+{
+    local int       i;
     local ArrayList fallbackNicknamesData;
     local HashTable data;
-
     data = __().collections.EmptyHashTable();
     data.SetString(P("spacesAction"), string(spacesAction));
     data.SetString(P("colorPermissions"), string(colorPermissions));
-    data.SetBool(P("replaceSpacesWithUnderscores"), replaceSpacesWithUnderscores);
+    data.SetBool(   P("replaceSpacesWithUnderscores"),
-    data.SetBool(P("removeSingleQuotationMarks"), removeSingleQuotationMarks);
+                    replaceSpacesWithUnderscores);
-    data.SetBool(P("removeDoubleQuotationMarks"), removeDoubleQuotationMarks);
+    data.SetBool(   P("removeSingleQuotationMarks"),
+                    removeSingleQuotationMarks);
+    data.SetBool(   P("removeDoubleQuotationMarks"),
+                    removeDoubleQuotationMarks);
     data.SetBool(P("correctEmptyNicknames"), correctEmptyNicknames);
     data.SetInt(P("maxNicknameLength"), maxNicknameLength);
     fallbackNicknamesData = __().collections.EmptyArrayList();
-
+    for (i = 0; i < fallbackNickname.length; i += 1)
-    for (i = 0; i < fallbackNickname.length; i += 1) {
+    {
-        fallbackNicknamesData.AddItem(__().text.FromFormattedString(fallbackNickname[i]));
+        fallbackNicknamesData.AddItem(
+            __().text.FromFormattedString(fallbackNickname[i]));
     }
     data.SetItem(P("fallbackNickname"), fallbackNicknamesData);
     _.memory.Free(fallbackNicknamesData);
     return data;
 }
 
-protected function FromData(HashTable source) {
+protected function FromData(HashTable source)
-    local int i;
+{
-    local Text nextNickName, storedText;
+    local int       i;
+    local Text      nextNickName, storedText;
     local ArrayList fallbackNicknamesData;
-
     if (source == none) {
         return;
     }
@@ -132,20 +86,25 @@ protected function FromData(HashTable source) {
     storedText = source.GetText(P("colorPermissions"));
     colorPermissions = ColorPermissionsFromText(storedText);
     _.memory.Free(storedText);
-    replaceSpacesWithUnderscores = source.GetBool(P("replaceSpacesWithUnderscores"), true);
+    replaceSpacesWithUnderscores =
-    removeSingleQuotationMarks = source.GetBool(P("removeSingleQuotationMarks"), true);
+        source.GetBool(P("replaceSpacesWithUnderscores"), true);
-    removeDoubleQuotationMarks = source.GetBool(P("removeDoubleQuotationMarks"), true);
+    removeSingleQuotationMarks =
+        source.GetBool(P("removeSingleQuotationMarks"), true);
+    removeDoubleQuotationMarks =
+        source.GetBool(P("removeDoubleQuotationMarks"), true);
     correctEmptyNicknames = source.GetBool(P("correctEmptyNicknames"), true);
     maxNicknameLength = source.GetInt(P("correctEmptyNicknames"), 20);
     fallbackNicknamesData = source.GetArrayList(P("fallbackNickname"));
     if (fallbackNickname.length > 0) {
         fallbackNickname.length = 0;
     }
-    for (i = 0; i < fallbackNicknamesData.GetLength(); i += 1) {
+    for (i = 0; i < fallbackNicknamesData.GetLength(); i += 1)
+    {
         nextNickName = fallbackNicknamesData.GetText(i);
         if (nextNickName != none) {
             fallbackNickname[i] = nextNickName.ToFormattedString();
-        } else {
+        }
+        else {
             fallbackNickname[i] = "";
         }
         _.memory.Free(nextNickName);
@@ -153,7 +112,8 @@ protected function FromData(HashTable source) {
     _.memory.Free(fallbackNicknamesData);
 }
 
-private function NicknameSpacesAction SpaceActionFromText(BaseText action) {
+private function NicknameSpacesAction SpaceActionFromText(BaseText action)
+{
     if (action == none) {
         return NSA_DoNothing;
     }
@@ -169,7 +129,9 @@ private function NicknameSpacesAction SpaceActionFromText(BaseText action) {
     return NSA_DoNothing;
 }
 
-private function NicknameColorPermissions ColorPermissionsFromText(BaseText permissions) {
+private function NicknameColorPermissions ColorPermissionsFromText(
+    BaseText permissions)
+{
     if (permissions == none) {
         return NCP_ForbidColor;
     }
@@ -188,14 +150,15 @@ private function NicknameColorPermissions ColorPermissionsFromText(BaseText perm
     return NCP_ForbidColor;
 }
 
-protected function DefaultIt() {
+protected function DefaultIt()
-    spacesAction = NSA_DoNothing;
+{
-    colorPermissions = NCP_ForbidColor;
+    spacesAction        = NSA_DoNothing;
-    replaceSpacesWithUnderscores = true;
+    colorPermissions    = NCP_ForbidColor;
-    removeSingleQuotationMarks = false;
+    replaceSpacesWithUnderscores    = true;
-    removeDoubleQuotationMarks = true;
+    removeSingleQuotationMarks      = false;
-    correctEmptyNicknames = true;
+    removeDoubleQuotationMarks      = true;
-    maxNicknameLength = 20;
+    correctEmptyNicknames           = true;
+    maxNicknameLength               = 20;
     if (fallbackNickname.length > 0) {
         fallbackNickname.length = 0;
     }
@@ -211,15 +174,16 @@ protected function DefaultIt() {
     fallbackNickname[9] = "Bug Meat";
 }
 
-defaultproperties {
+defaultproperties
+{
     configName = "FutilityNicknames"
-    spacesAction = NSA_DoNothing
+    spacesAction                    = NSA_DoNothing
-    colorPermissions = NCP_ForbidColor
+    colorPermissions                = NCP_ForbidColor
-    replaceSpacesWithUnderscores = true
+    replaceSpacesWithUnderscores    = true
-    removeSingleQuotationMarks = false
+    removeSingleQuotationMarks      = false
-    removeDoubleQuotationMarks = true
+    removeDoubleQuotationMarks      = true
-    correctEmptyNicknames = true
+    correctEmptyNicknames           = true
-    maxNicknameLength = 20
+    maxNicknameLength               = 20
     fallbackNickname(0) = "Fresh Meat"
     fallbackNickname(1) = "Rotten Meat"
     fallbackNickname(2) = "Troll Meat"

sources/Features/FutileNickames/FutilityNicknames_Feature.uc

@@ -1,6 +1,9 @@
 /**
- *  Config class for storing map lists.
+ *      This feature allows to configure nickname limitations for the server.
- *      Copyright 2022-2023 Anton Tarasenko
+ *      It allows you to customize vanilla limitations for nickname length and
+ *  color with those of your own design. Enabling this feature overwrites
+ *  default behaviour.
+ *      Copyright 2022 Anton Tarasenko
  *------------------------------------------------------------------------------
  * This file is part of Acedia.
  *
@@ -20,133 +23,224 @@
 class FutilityNicknames_Feature extends Feature
     dependson(FutilityNicknames);
 
-//! This feature's functionality is rather simple, but we will still break up
+/**
-//! what its various components are.
+ *  This feature's functionality is rather simple, but we will still break up
-//!
+ *  what its various components are.
-//!     Fallback nicknames are picked at random from
+ *
-//! the `fallbackNicknames` array. This is done by copying that array into
+ *      Fallback nicknames are picked at random from
-//! `unusedNicknames` and then picking and removing its random elements each
+ *  the `fallbackNicknames` array. This is done by copying that array into
-//! time we need a fallback. Once `unusedNicknames` is empty - it is copied from
+ *  `unusedNicknames` and then picking and removing its random elements each
-//! `fallbackNicknames` once again, letting already used nicknames to be reused.
+ *  time we need a fallback. Once `unusedNicknames` is empty - it is copied from
-//!     `unusedNicknames` contains same references as `fallbackNicknames`,
+ *  `fallbackNicknames` once again, letting already used nicknames to be reused.
-//! so they need to be separately deallocated and should also be forgotten once
+ *      `unusedNicknames` contains same references as `fallbackNicknames`,
-//! `fallbackNicknames` are deallocated`.
+ *  so they need to be separately deallocated and should also be forgotten once
-//!     This is implemented inside `PickNextFallback()` method.
+ *  `fallbackNicknames` are deallocated`.
-//!
+ *      This is implemented inside `PickNextFallback()` method.
-//!     Nickname changes are applied inside `CensorNickname()` method that uses
+ *
-//! several auxiliary methods to perform different stages of "censoring".
+ *      Nickname changes are applied inside `CensorNickname()` method that uses
-//!     Censoring is performed:
+ *  several auxiliary methods to perform different stages of "censoring".
-//!         1. On any player's name change
+ *      Censoring is performed:
-//!             (using `OnPlayerNameChanging()` signal, connected to
+ *          1. On any player's name change
-//!             `HandleNicknameChange()`);
+ *              (using `OnPlayerNameChanging()` signal, connected to
-//!         2. When new player logins (using `OnNewPlayer()` signal,
+ *              `HandleNicknameChange()`);
-//!             conneted to `CensorOriginalNickname()`) to enforce our own
+ *          2. When new player logins (using `OnNewPlayer()` signal,
-//!             handling of player's original nickname.
+ *              conneted to `CensorOriginalNickname()`) to enforce our own
+ *              handling of player's original nickname;
+ *          3. When censoring is re-activated.
+ *              In case all censoring options of this feature are disabled
+ *              (checked by `IsAnyCensoringEnabled()`) - we do not attempt to
+ *              catch any events or do anything at all.
+ *              If settings change mid-execution, this feature might need to
+ *              enable or disable censoring on-the-fly. To accomplish that we
+ *              remember current status inside `censoringNicknames` boolean
+ *              variable and enable/disable events if required by settings.
+ *              So whenever we re-activate censoring we also need to update
+ *              ("censor") current players' nicknames - a third occasion to
+ *              call `CensorNickname()`, implemented inside
+ *              `CensorCurrentPlayersNicknames()`.
+ */
 
+//  How to treat whitespace characters inside players' nicknames.
+//      * `NSA_DoNothing` - does nothing, leaving whitespaces as they are;
+//      * `NSA_Trim` - removes leading and trailing whitespaces for nicknames;
+//      * `NSA_Simplify` - removes leading and trailing whitespaces
+//          for nicknames, also reducing a sequence of whitespaces inside
+//          nickname to a single space, e.g. "my   nick" becomes "my nick".
+//  Default is `NSA_DoNothing`, same as on vanilla.
 var private /*config*/ FutilityNicknames.NicknameSpacesAction spacesAction;
+
+//  How to treat colored nicknames.
+//      * `NCP_ForbidColor` - completely strips down any color from nicknames;
+//      * `NCP_ForceTeamColor` - forces all nicknames to have player's current
+//          team's color;
+//      * `NCP_ForceSingleColor` - allows nickname to be painted with a single
+//          color (sets nickname's color to that of the first character);
+//      * `NCP_AllowAnyColor` - allows nickname to be colored in any way player
+//          wants.
+//  Default is `NCP_ForbidColor`, same as on vanilla.
 var private /*config*/ FutilityNicknames.NicknameColorPermissions colorPermissions;
-var private /*config*/ bool replaceSpacesWithUnderscores;
-var private /*config*/ bool removeSingleQuotationMarks;
-var private /*config*/ bool removeDoubleQuotationMarks;
-var private /*config*/ int maxNicknameLength;
-var private /*config*/ bool correctEmptyNicknames;
-var private /*config*/ array<Text> fallbackNickname;
 
-/// Guaranteed order of applying changes (only chosen ones) is as following:
+//      Set this to `true` if you wish to replace all whitespace characters with
-///
+//  underscores and `false` to leave them as is.
-/// 1. Trim/simplify spaces;
+//      Default is `true`, same as on vanilla. However there is one difference:
-/// 2. Remove single and double quotation marks;
+//  Futility replaces all whitespace characters (including tabulations,
-/// 3. Enforce max limit of nickname's length;
+//  non-breaking spaces, etc.) instead of only ' '.
-/// 4. Replace empty nickname with fallback nickname (no further changes
+var private /*config*/ bool         replaceSpacesWithUnderscores;
-///     will be applied to fallback nickname in that case);
+//  Set this to `true` to remove single 'quotation marks' and `false` to
-/// 5. Enforce color limitation;
+//  leave them. Default is `false`, same as on vanilla.
-/// 6. Replace remaining whitespaces with underscores.
+var private /*config*/ bool         removeSingleQuotationMarks;
-///
+//  Set this to `true` to remove dobule 'quotation marks' and `false` to
-/// NOTE #1: as follows from the instruction described above, no changes will
+//  leave them. Default is `true`, same as on vanilla.
-/// ever be applied to fallback nicknames (unless player's nickname coincides
+var private /*config*/ bool         removeDoubleQuotationMarks;
-/// with one by pure accident).
+
-///
+//  Max allowed nickname length. Negative values disable any length limits.
-/// NOTE #2: whitespaces inside steam nicknames are converted into underscores
+//
-/// before they are passed into the game and this is a change Futility
+//  NOTE #1: `0` resets all nicknames to be empty and,
-/// cannot currently abort. Therefore all changes relevant to whitespaces inside
+//      if `correctEmptyNicknames` is set to `true`, they will be replaced with
-/// nicknames will only be applied to in-game changes.
+//      one of the fallback nicknames
+//      (see `correctEmptyNicknames` and `fallbackNickname`).
+//  NOTE #2: Because of how color swapping in vanilla Killing Floor works,
+//      every color swap makes text count as being about 4 characters longer.
+//      So if one uses too many colors in the nickname, for drawing functions
+//      it will appear to be longer than it actually is and it *will* mess up
+//      UI. Unless you are using custom HUD it is recommended to keep this value
+//      at default `20` and forbid colored nicknames
+//      (by setting `colorPermissions=NCP_ForbidColor`). Or to allow only one
+//      color (by setting `colorPermissions=NCP_ForceSingleColor` or
+//      `colorPermissions=NCP_ForceTeamColor`) and reducing `maxNicknameLength`
+//      to `16` (20 characters - 4 for color swap).
+//          If you want to increase the limit above that, you can also do your
+//      own research by testing nicknames of various length on
+//      screen resolutions you care about.
+var private /*config*/ int          maxNicknameLength;
 
-/// Nicknames from `fallbackNickname` that can still be picked in the current
+//  Should we replace empty player nicknames with a random fallback nickname
-/// rotation.
+//  (defined in `fallbackNickname` array)?
+var private /*config*/ bool         correctEmptyNicknames;
+//  Array of fallback nicknames that will be used to replace any empty nicknames
+//  if `correctEmptyNicknames` is set to `true`.
+var private /*config*/ array<Text>  fallbackNickname;
+
+//  Guaranteed order of applying changes (only chosen ones) is as following:
+//      1. Trim/simplify spaces;
+//      2. Remove single and double quotation marks;
+//      3. Enforce max limit of nickname's length;
+//      4. Replace empty nickname with fallback nickname (no further changes
+//          will be applied to fallback nickname in that case);
+//      5. Enforce color limitation;
+//      6. Replace remaining whitespaces with underscores.
+//
+//  NOTE #1: as follows from the instruction described above, no changes will
+//      ever be applied to fallback nicknames (unless player's nickname
+//      coincides with one by pure accident).
+//  NOTE #2: whitespaces inside steam nicknames are converted into underscores
+//      before they are passed into the game and this is a change Futility
+//      cannot currently abort.
+//      Therefore all changes relevant to whitespaces inside nicknames will only
+//      be applied to in-game changes.
+
+//  Nicknames from `fallbackNickname` that can still be picked in
+//  the current rotation.
 var private array<Text> unusedNicknames;
+//      Are we currently censoring nicknames?
+//      Set to `false` if none of the feature's options require
+//  any action (censoring) and, therefore, we do not listen to any signals.
+var private bool        censoringNicknames;
 
 var private const int CODEPOINT_UNDERSCORE;
 
-protected function OnEnabled() {
+protected function OnDisabled()
-    if (IsAnyCensoringEnabled()) {
+{
-        // Do this before adding event handler to avoid censoring nicknames
-        // second time (censoring nickname will trigger `OnPlayerNameChanging()`
-        // signal)
-        CensorCurrentPlayersNicknames();
-        _.players.OnPlayerNameChanging(self).connect = HandleNicknameChange;
-        _.players.OnNewPlayer(self).connect = CensorOriginalNickname;
-    }
-}
-
-protected function OnDisabled() {
     _.memory.FreeMany(fallbackNickname);
-    _.memory.FreeMany(unusedNicknames);
+    //  Free this `Text` data - it will be refilled with `SwapConfig()`
-    fallbackNickname.length = 0;
+    //  if this feature is ever reenabled
-    unusedNicknames.length  = 0;
+    if (fallbackNickname.length > 0)
-    if (IsAnyCensoringEnabled()) {
+    {
+        _.memory.FreeMany(fallbackNickname);
+        fallbackNickname.length = 0;
+        unusedNicknames.length  = 0;
+    }
+    if (censoringNicknames)
+    {
+        censoringNicknames = false;
         _.players.OnPlayerNameChanging(self).Disconnect();
         _.players.OnNewPlayer(self).Disconnect();
     }
 }
 
-protected function SwapConfig(FeatureConfig config) {
+protected function SwapConfig(FeatureConfig config)
+{
+    local bool              configRequiresCensoring;
     local FutilityNicknames newConfig;
-
     newConfig = FutilityNicknames(config);
     if (newConfig == none) {
         return;
     }
-    replaceSpacesWithUnderscores = newConfig.replaceSpacesWithUnderscores;
+    replaceSpacesWithUnderscores    = newConfig.replaceSpacesWithUnderscores;
-    removeSingleQuotationMarks = newConfig.removeSingleQuotationMarks;
+    removeSingleQuotationMarks      = newConfig.removeSingleQuotationMarks;
-    removeDoubleQuotationMarks = newConfig.removeDoubleQuotationMarks;
+    removeDoubleQuotationMarks      = newConfig.removeDoubleQuotationMarks;
-    correctEmptyNicknames = newConfig.correctEmptyNicknames;
+    correctEmptyNicknames           = newConfig.correctEmptyNicknames;
-    spacesAction = newConfig.spacesAction;
+    spacesAction                    = newConfig.spacesAction;
-    colorPermissions = newConfig.colorPermissions;
+    colorPermissions                = newConfig.colorPermissions;
-    maxNicknameLength = newConfig.maxNicknameLength;
+    maxNicknameLength               = newConfig.maxNicknameLength;
-    SwapFallbackNicknames(newConfig);
+    configRequiresCensoring         = IsAnyCensoringEnabled();
-}
+    //  Enable or disable censoring if `IsAnyCensoringEnabled()`'s response
-
+    //  has changed.
-private function SwapFallbackNicknames(FutilityNicknames newConfig) {
+    if (!censoringNicknames && configRequiresCensoring)
-    local int i;
+    {
-
+        censoringNicknames = true;
-    _.memory.FreeMany(fallbackNickname);
+        //  Do this before adding event handler to
-    fallbackNickname.length = 0;
+        //  avoid censoring nicknames second time
-    for (i = 0; i < newConfig.fallbackNickname.length; i += 1) {
+        CensorCurrentPlayersNicknames();
-        fallbackNickname[i] = _.text.FromFormattedString(newConfig.fallbackNickname[i]);
+        _.players.OnPlayerNameChanging(self).connect = HandleNicknameChange;
+        _.players.OnNewPlayer(self).connect = CensorOriginalNickname;
     }
-    unusedNicknames = fallbackNickname;
+    if (censoringNicknames && !configRequiresCensoring)
+    {
+        censoringNicknames = false;
+        _.players.OnPlayerNameChanging(self).Disconnect();
+        _.players.OnNewPlayer(self).Disconnect();
+    }
+    SwapFallbackNicknames(newConfig);
 }
 
-private function Text PickNextFallback() {
+private function Text PickNextFallback()
-    local int pickedIndex;
+{
-    local Text result;
+    local int   pickedIndex;
-
+    local Text  result;
-    if (fallbackNickname.length <= 0) {
+    if (fallbackNickname.length <= 0)
-        // Just in case this feature is really misconfigured
+    {
+        //  Just in case this feature is really misconfigured
         return P("Fresh Meat").Copy();
     }
     if (unusedNicknames.length <= 0) {
         unusedNicknames = fallbackNickname;
     }
-    // Pick one nickname at random.
+    //  Pick one nickname at random.
-    // `pickedIndex` will belong to [0; unusedNicknames.length - 1] segment.
+    //  `pickedIndex` will belong to [0; unusedNicknames.length - 1] segment.
     pickedIndex = Rand(unusedNicknames.length);
     result = unusedNicknames[pickedIndex].Copy();
     unusedNicknames.Remove(pickedIndex, 1);
     return result;
 }
 
-private function bool IsAnyCensoringEnabled() {
+protected function SwapFallbackNicknames(FutilityNicknames newConfig)
+{
+    local int i;
+    _.memory.FreeMany(fallbackNickname);
+    if (fallbackNickname.length > 0) {
+        fallbackNickname.length = 0;
+    }
+    for (i = 0; i < newConfig.fallbackNickname.length; i += 1)
+    {
+        fallbackNickname[i] =
+            _.text.FromFormattedString(newConfig.fallbackNickname[i]);
+    }
+    unusedNicknames = fallbackNickname;
+}
+
+private function bool IsAnyCensoringEnabled()
+{
     return (    replaceSpacesWithUnderscores
             ||  removeSingleQuotationMarks
             ||  removeDoubleQuotationMarks
@@ -156,38 +250,40 @@ private function bool IsAnyCensoringEnabled() {
             ||  spacesAction != NSA_DoNothing);
 }
 
-// For nickname changes mid-game.
+//  For nickname changes mid-game.
 private function HandleNicknameChange(
-    EPlayer affectedPlayer,
+    EPlayer     affectedPlayer,
-    BaseText oldName,
+    BaseText    oldName,
-    MutableText newName
+    MutableText newName)
-) {
+{
     CensorNickname(newName, affectedPlayer);
 }
 
-// For handling of player's original nicknames.
+//  For handling of player's original nicknames.
-private function CensorOriginalNickname(EPlayer affectedPlayer) {
+private function CensorOriginalNickname(EPlayer affectedPlayer)
+{
     local Text originalNickname;
     if (affectedPlayer == none) {
         return;
     }
     originalNickname = affectedPlayer.GetOriginalName();
-    // This will automatically trigger `OnPlayerNameChanging()` signal and
+    //  This will automatically trigger `OnPlayerNameChanging()` signal and
-    // our `HandleNicknameChange()` handler.
+    //  our `HandleNicknameChange()` handler.
     affectedPlayer.SetName(originalNickname);
     _.memory.Free(originalNickname);
 }
 
-// For handling nicknames of players after censoring is re-activated by
+//  For handling nicknames of players after censoring is re-activated by
-// config change.
+//  config change.
-private function CensorCurrentPlayersNicknames() {
+private function CensorCurrentPlayersNicknames()
-    local int i;
+{
-    local Text nextNickname;
+    local int               i;
-    local MutableText alteredNickname;
+    local Text              nextNickname;
-    local array<EPlayer> currentPlayers;
+    local MutableText       alteredNickname;
-
+    local array<EPlayer>    currentPlayers;
     currentPlayers = _.players.GetAll();
-    for (i = 0; i < currentPlayers.length; i += 1) {
+    for (i = 0; i < currentPlayers.length; i += 1)
+    {
         nextNickname    = currentPlayers[i].GetName();
         alteredNickname = nextNickname.MutableCopy();
         CensorNickname(alteredNickname, currentPlayers[i]);
@@ -199,10 +295,10 @@ private function CensorCurrentPlayersNicknames() {
     }
 }
 
-private function CensorNickname(MutableText nickname, EPlayer affectedPlayer) {
+private function CensorNickname(MutableText nickname, EPlayer affectedPlayer)
-    local Text fallback;
+{
-    local BaseText.Formatting newFormatting;
+    local Text                  fallback;
-
+    local BaseText.Formatting   newFormatting;
     if (nickname == none)       return;
     if (affectedPlayer == none) return;
 
@@ -218,21 +314,25 @@ private function CensorNickname(MutableText nickname, EPlayer affectedPlayer) {
     if (maxNicknameLength >= 0) {
         nickname.Remove(maxNicknameLength);
     }
-    if (correctEmptyNicknames && nickname.IsEmpty()) {
+    if (correctEmptyNicknames && nickname.IsEmpty())
+    {
         fallback = PickNextFallback();
         nickname.Append(fallback);
         _.memory.Free(fallback);
         return;
     }
-    if (colorPermissions != NCP_AllowAnyColor) {
+    if (colorPermissions != NCP_AllowAnyColor)
+    {
         if (colorPermissions == NCP_ForceSingleColor) {
             newFormatting = nickname.GetCharacter(0).formatting;
-        } else if (colorPermissions == NCP_ForceTeamColor) {
+        }
+        else if (colorPermissions == NCP_ForceTeamColor)
+        {
             newFormatting.isColored = true;
             newFormatting.color     = affectedPlayer.GetTeamColor();
         }
-        // `colorPermissions == NCP_ForbidColor`
+        //  `colorPermissions == NCP_ForbidColor`
-        // `newFormatting` is colorless by default
+        //  `newFormatting` is colorless by default
         nickname.ChangeFormatting(newFormatting);
     }
     if (replaceSpacesWithUnderscores) {
@@ -240,18 +340,21 @@ private function CensorNickname(MutableText nickname, EPlayer affectedPlayer) {
     }
 }
 
-// Asusmes `nickname != none`.
+//  Asusmes `nickname != none`.
-private function ReplaceSpaces(MutableText nickname) {
+private function ReplaceSpaces(MutableText nickname)
-    local int i;
+{
-    local MutableText nicknameCopy;
+    local int                   i;
-    local BaseText.Character nextCharacter, underscoreCharacter;
+    local MutableText           nicknameCopy;
-
+    local BaseText.Character    nextCharacter, underscoreCharacter;
     nicknameCopy = nickname.MutableCopy();
     nickname.Clear();
-    underscoreCharacter = _.text.CharacterFromCodePoint(CODEPOINT_UNDERSCORE);
+    underscoreCharacter =
-    for (i = 0; i < nicknameCopy.GetLength(); i += 1) {
+        _.text.CharacterFromCodePoint(CODEPOINT_UNDERSCORE);
+    for (i = 0; i < nicknameCopy.GetLength(); i += 1)
+    {
         nextCharacter = nicknameCopy.GetCharacter(i);
-        if (_.text.IsWhitespace(nextCharacter)) {
+        if (_.text.IsWhitespace(nextCharacter))
+        {
             //  Replace character with underscore, leaving the formatting
             underscoreCharacter.formatting = nextCharacter.formatting;
             nextCharacter = underscoreCharacter;
@@ -261,7 +364,8 @@ private function ReplaceSpaces(MutableText nickname) {
     _.memory.Free(nicknameCopy);
 }
 
-defaultproperties {
+defaultproperties
+{
     configClass = class'FutilityNicknames'
     CODEPOINT_UNDERSCORE = 95 // '_'
 }

sources/Futility.uc

@@ -21,16 +21,20 @@ class Futility extends FeatureConfig
     perobjectconfig
     config(Futility);
 
-protected function HashTable ToData() {
+protected function HashTable ToData()
+{
     return _.collections.EmptyHashTable();
 }
 
-protected function FromData(HashTable source) {
+protected function FromData(HashTable source)
+{
 }
 
-protected function DefaultIt() {
+protected function DefaultIt()
+{
 }
 
-defaultproperties {
+defaultproperties
+{
     configName = "Futility"
 }

sources/Futility_Feature.uc

@@ -36,7 +36,7 @@ protected function OnEnabled()
         return;
     }
     for (i = 0; i < allCommandClasses.length; i += 1) {
-        //commandsFeature.RegisterCommand(allCommandClasses[i]);
+        commandsFeature.RegisterCommand(allCommandClasses[i]);
     }
     _.environment.OnFeatureEnabled(self).connect = RegisterAllCommandClasses;
 }
@@ -52,7 +52,7 @@ protected function OnDisabled()
         return;
     }
     for (i = 0; i < allCommandClasses.length; i += 1) {
-        //ommandsFeature.RegisterCommand(allCommandClasses[i]);
+        commandsFeature.RegisterCommand(allCommandClasses[i]);
     }
 }
 
@@ -65,7 +65,7 @@ private final function RegisterAllCommandClasses(Feature enabledFeature)
         return;
     }
     for (i = 0; i < allCommandClasses.length; i += 1) {
-        //commandsFeature.RegisterCommand(allCommandClasses[i]);
+        commandsFeature.RegisterCommand(allCommandClasses[i]);
     }
 }
 

sources/Tools/PendingConfigsTool.uc

@@ -189,7 +189,7 @@ public function PendingConfigToolResult EditConfig(
     AcediaObject    newValue)
 {
     local HashTable                 pendingData;
-    local MutableJsonPointer        pointer;
+    local JSONPointer               pointer;
     local PendingConfigToolResult   result;
 
     if (pathToValue == none) {
@@ -200,7 +200,7 @@ public function PendingConfigToolResult EditConfig(
         return PCTE_ConfigMissing;
     }
     //  Set new data
-    pointer = _.json.MutablePointer(pathToValue);
+    pointer = _.json.Pointer(pathToValue);
     result = SetItemByJSON(pendingData, pointer, newValue);
     pointer.FreeSelf();
     pendingData.FreeSelf();
@@ -208,9 +208,9 @@ public function PendingConfigToolResult EditConfig(
 }
 
 private function PendingConfigToolResult SetItemByJSON(
-    HashTable           data,
+    HashTable       data,
-    MutableJsonPointer  pointer,
+    JSONPointer     pointer,
-    AcediaObject        jsonValue)
+    AcediaObject    jsonValue)
 {
     local Text                      containerIndex;
     local AcediaObject              container;