update description.txt

add short alias for mutator

.editorconfig

@@ -0,0 +1,33 @@
+root = true
+
+# Global
+[*]
+indent_style = unset
+indent_size = 4
+tab_width = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = unset
+
+# Unreal Engine 3 / Source
+[*.uc]
+indent_style = tab
+
+[*.{uci,upkg}]
+
+# Unreal Engine 3 / i18n
+[*.{chn,cht,cze,dan,deu,dut,esl,esn,fra,frc,hun,int,ita,jpn,kor,pol,por,ptb,rus,tur,ukr}]
+charset = utf-16le
+
+# Other
+[*.md]
+indent_style = space
+trim_trailing_whitespace = false
+
+[*.yml]
+indent_style = space
+indent_size = 2
+
+[*.{txt,cfg,conf}]
+indent_style = tab

.github/workflows/mega-linter.yml

@@ -0,0 +1,114 @@
+---
+name: MegaLinter
+
+permissions: read-all
+
+on:
+  push:
+  pull_request:
+    branches:
+      - master
+
+env:
+  APPLY_FIXES: none
+  APPLY_FIXES_EVENT: pull_request
+  APPLY_FIXES_MODE: commit
+  FILTER_REGEX_EXCLUDE: (mega-linter.yml)
+  DISABLE: SPELL
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  megalinter:
+    name: MegaLinter
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11
+        with:
+          token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - name: MegaLinter
+        uses: oxsecurity/megalinter@7e042c726c68415475b05a65a686c612120a1232
+        id: ml
+        env:
+          VALIDATE_ALL_CODEBASE: true
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Archive production artifacts
+        uses: actions/upload-artifact@c7d193f32edcb7bfad88892161225aeda64e9392
+        if: success() || failure()
+        with:
+          name: MegaLinter reports
+          path: |
+            megalinter-reports
+            mega-linter.log
+
+      - name: Set APPLY_FIXES_IF var
+        run: |
+          printf 'APPLY_FIXES_IF=%s\n' "${{
+            steps.ml.outputs.has_updated_sources == 1 &&
+            (
+              env.APPLY_FIXES_EVENT == 'all' ||
+              env.APPLY_FIXES_EVENT == github.event_name
+            ) &&
+            (
+              github.event_name == 'push' ||
+              github.event.pull_request.head.repo.full_name == github.repository
+            )
+          }}" >> "${GITHUB_ENV}"
+
+      - name: Set APPLY_FIXES_IF_* vars
+        run: |
+          printf 'APPLY_FIXES_IF_PR=%s\n' "${{
+            env.APPLY_FIXES_IF == 'true' &&
+            env.APPLY_FIXES_MODE == 'pull_request'
+          }}" >> "${GITHUB_ENV}"
+          printf 'APPLY_FIXES_IF_COMMIT=%s\n' "${{
+            env.APPLY_FIXES_IF == 'true' &&
+            env.APPLY_FIXES_MODE == 'commit' &&
+            (!contains(fromJSON('["refs/heads/main", "refs/heads/master"]'), github.ref))
+          }}" >> "${GITHUB_ENV}"
+
+      - name: Create Pull Request with applied fixes
+        uses: peter-evans/create-pull-request@153407881ec5c347639a548ade7d8ad1d6740e38
+        id: cpr
+        if: env.APPLY_FIXES_IF_PR == 'true'
+        with:
+          token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}
+          commit-message: "[MegaLinter] Apply linters automatic fixes"
+          title: "[MegaLinter] Apply linters automatic fixes"
+          labels: bot
+
+      - name: Create PR output
+        if: env.APPLY_FIXES_IF_PR == 'true'
+        run: |
+          echo "PR Number - ${{ steps.cpr.outputs.pull-request-number }}"
+          echo "PR URL - ${{ steps.cpr.outputs.pull-request-url }}"
+
+      - name: Prepare commit
+        if: env.APPLY_FIXES_IF_COMMIT == 'true'
+        run: sudo chown -Rc $UID .git/
+
+      - name: Commit and push applied linter fixes
+        uses: stefanzweifel/git-auto-commit-action@8756aa072ef5b4a080af5dc8fef36c5d586e521d
+        if: env.APPLY_FIXES_IF_COMMIT == 'true'
+        with:
+          branch: >-
+            ${{
+              github.event.pull_request.head.ref ||
+              github.head_ref ||
+              github.ref
+            }}
+          commit_message: "[MegaLinter] Apply linters fixes"
+          commit_user_name: "github-actions"
+          commit_user_email: "github-actions[bot]@users.noreply.github.com"

.gitignore

@@ -0,0 +1,2 @@
+*.psd
+/ignore

AAL/Classes/AAL.uc

@@ -1,156 +1,187 @@
-class AAL extends Info
-	config(AAL);
-
-const LatestVersion = 1;
-
-const CfgAdminList = class'AdminList';
-
-var private config int         Version;
-var private config E_LogLevel  LogLevel;
-
-var private OnlineSubsystem    OS;
-var private Array<UniqueNetId> AdminUIDList;
-
-public simulated function bool SafeDestroy()
-{
-	`Log_Trace();
-	
-	return (bPendingDelete || bDeleteMe || Destroy());
-}
-
-public event PreBeginPlay()
-{
-	`Log_Trace();
-	
-	if (WorldInfo.NetMode == NM_Client)
-	{
-		`Log_Fatal("Wrong NetMode:" @ WorldInfo.NetMode);
-		SafeDestroy();
-		return;
-	}
-	
-	Super.PreBeginPlay();
-	
-	PreInit();
-}
-
-public event PostBeginPlay()
-{
-	`Log_Trace();
-	
-	if (bPendingDelete || bDeleteMe) return;
-	
-	Super.PostBeginPlay();
-	
-	PostInit();
-}
-
-private function PreInit()
-{
-	`Log_Trace();
-	
-	if (Version == `NO_CONFIG)
-	{
-		LogLevel = LL_Info;
-		SaveConfig();
-	}
-	
-	CfgAdminList.static.InitConfig(Version, LatestVersion, LogLevel);
-	
-	switch (Version)
-	{
-		case `NO_CONFIG:
-			`Log_Info("Config created");
-			
-		case MaxInt:
-			`Log_Info("Config updated to version" @ LatestVersion);
-			break;
-			
-		case LatestVersion:
-			`Log_Info("Config is up-to-date");
-			break;
-			
-		default:
-			`Log_Warn("The config version is higher than the current version (are you using an old mutator?)");
-			`Log_Warn("Config version is" @ Version @ "but current version is" @ LatestVersion);
-			`Log_Warn("The config version will be changed to" @ LatestVersion);
-			break;
-	}
-	
-	if (LatestVersion != Version)
-	{
-		Version = LatestVersion;
-		SaveConfig();
-	}
-
-	if (LogLevel == LL_WrongLevel)
-	{
-		LogLevel = LL_Info;
-		
-		`Log_Warn("Wrong 'LogLevel', return to default value");
-		
-		SaveConfig();
-	}
-	`Log_Base("LogLevel:" @ LogLevel);
-	
-	OS = class'GameEngine'.static.GetOnlineSubsystem();
-	if (OS != None)
-	{
-		AdminUIDList = CfgAdminList.static.Load(OS, LogLevel);
-	}
-	else
-	{
-		`Log_Fatal("Can't get online subsystem!");
-		SafeDestroy();
-	}
-}
-
-private function PostInit()
-{
-	`Log_Trace();
-}
-
-public function NotifyLogin(Controller C)
-{
-	local PlayerController PC;
-	local PlayerReplicationInfo PRI;
-	local String UniqueID;
-	local String SteamID;
-	local String Profile;
-	
-	`Log_Trace();
-	
-	if (C == None || C.PlayerReplicationInfo == None) return;
-	
-	PRI = C.PlayerReplicationInfo;
-	
-	if (AdminUIDList.Find('Uid', PRI.UniqueId.Uid) != INDEX_NONE)
-	{
-		PRI.bAdmin = true;
-		
-		UniqueID = OS.UniqueNetIdToString(PRI.UniqueId);
-		
-		PC = PlayerController(C);
-		if (PC != None && !PC.bIsEosPlayer)
-		{
-			SteamID = OS.UniqueNetIdToInt64(PRI.UniqueId);
-			Profile = "https://steamcommunity.com/profiles/" $ SteamID;
-			
-			`Log_Info("Admin login:" @ PRI.PlayerName @ "(" $ UniqueID $ "," @ SteamID $ "," @ Profile $ ")");
-		}
-		else
-		{
-			`Log_Info("Admin login:" @ PRI.PlayerName @ "(" $ UniqueID $ ")");
-		}
-	}
-}
-
-public function NotifyLogout(Controller C)
-{
-	`Log_Trace();
-}
-
-defaultproperties
-{
-
+class AAL extends Info
+	config(AAL);
+
+const LatestVersion = 2;
+
+const ProfileURL = "https://steamcommunity.com/profiles/";
+
+const CfgAdminList = class'AdminList';
+
+var private config int         Version;
+var private config E_LogLevel  LogLevel;
+var private config bool        bAutoEnableCheats;
+
+var private OnlineSubsystem    OS;
+var private Array<UniqueNetId> AdminUIDList;
+var private Array<UniqueNetId> AdminUIDListActive;
+
+public simulated function bool SafeDestroy()
+{
+	`Log_Trace();
+
+	return (bPendingDelete || bDeleteMe || Destroy());
+}
+
+public event PreBeginPlay()
+{
+	`Log_Trace();
+
+	if (WorldInfo.NetMode == NM_Client)
+	{
+		`Log_Fatal("Wrong NetMode:" @ WorldInfo.NetMode);
+		SafeDestroy();
+		return;
+	}
+
+	Super.PreBeginPlay();
+
+	PreInit();
+}
+
+public event PostBeginPlay()
+{
+	`Log_Trace();
+
+	if (bPendingDelete || bDeleteMe) return;
+
+	Super.PostBeginPlay();
+
+	PostInit();
+}
+
+private function PreInit()
+{
+	`Log_Trace();
+
+	if (Version == `NO_CONFIG)
+	{
+		LogLevel = LL_Info;
+		SaveConfig();
+	}
+
+	CfgAdminList.static.InitConfig(Version, LatestVersion, LogLevel);
+
+	switch (Version)
+	{
+		case `NO_CONFIG:
+			`Log_Info("Config created");
+
+		case 1:
+			bAutoEnableCheats = false;
+
+		case MaxInt:
+			`Log_Info("Config updated to version" @ LatestVersion);
+			break;
+
+		case LatestVersion:
+			`Log_Info("Config is up-to-date");
+			break;
+
+		default:
+			`Log_Warn("The config version is higher than the current version (are you using an old mutator?)");
+			`Log_Warn("Config version is" @ Version @ "but current version is" @ LatestVersion);
+			`Log_Warn("The config version will be changed to" @ LatestVersion);
+			break;
+	}
+
+	if (LatestVersion != Version)
+	{
+		Version = LatestVersion;
+		SaveConfig();
+	}
+
+	if (LogLevel == LL_WrongLevel)
+	{
+		LogLevel = LL_Info;
+
+		`Log_Warn("Wrong 'LogLevel', return to default value");
+
+		SaveConfig();
+	}
+	`Log_Base("LogLevel:" @ LogLevel);
+
+	OS = class'GameEngine'.static.GetOnlineSubsystem();
+	if (OS != None)
+	{
+		AdminUIDList = CfgAdminList.static.Load(OS, LogLevel);
+	}
+	else
+	{
+		`Log_Fatal("Can't get online subsystem!");
+		SafeDestroy();
+	}
+}
+
+private function PostInit()
+{
+	`Log_Trace();
+}
+
+public function NotifyLogin(Controller C)
+{
+	local PlayerController PC;
+	local PlayerReplicationInfo PRI;
+	local String UniqueID;
+	local String SteamID;
+
+	`Log_Trace();
+
+	if (C == None || C.PlayerReplicationInfo == None) return;
+
+	PRI = C.PlayerReplicationInfo;
+
+	if (AdminUIDList.Find('Uid', PRI.UniqueId.Uid) != INDEX_NONE)
+	{
+		PRI.bAdmin = true;
+	}
+
+	if (PRI.bAdmin)
+	{
+		AdminUIDListActive.AddItem(PRI.UniqueId);
+
+		UniqueID = OS.UniqueNetIdToString(PRI.UniqueId);
+
+		PC = PlayerController(C);
+
+		if (PC != None && bAutoEnableCheats)
+		{
+			PC.AddCheats(true);
+		}
+
+		if (PC != None && !PC.bIsEosPlayer)
+		{
+			SteamID = OS.UniqueNetIdToInt64(PRI.UniqueId);
+			`Log_Info("Admin login:" @ PRI.PlayerName @ "(" $ UniqueID $ "," @ SteamID $ "," @ ProfileURL $ SteamID $ ")");
+		}
+		else
+		{
+			`Log_Info("Admin login:" @ PRI.PlayerName @ "(" $ UniqueID $ ")");
+		}
+	}
+}
+
+public function NotifyLogout(Controller C)
+{
+	local PlayerReplicationInfo PRI;
+	local String UniqueID;
+	local String SteamID;
+
+	`Log_Trace();
+
+	if (C == None || C.PlayerReplicationInfo == None) return;
+
+	PRI = C.PlayerReplicationInfo;
+
+	if (PRI.bAdmin || AdminUIDListActive.Find('Uid', PRI.UniqueId.Uid) != INDEX_NONE)
+	{
+		AdminUIDListActive.RemoveItem(PRI.UniqueId);
+		UniqueID = OS.UniqueNetIdToString(PRI.UniqueId);
+		SteamID = OS.UniqueNetIdToInt64(PRI.UniqueId);
+		`Log_Info("Admin logout:" @ PRI.PlayerName @ "(" $ UniqueID $ "," @ SteamID $ "," @ ProfileURL $ SteamID $ ")");
+	}
+}
+
+defaultproperties
+{
+
 }

AAL/Classes/AAL.upkg

@@ -1,4 +1,4 @@
-[Flags]
-AllowDownload=False
-ClientOptional=False
-ServerSideOnly=True
+[Flags]
+AllowDownload=False
+ClientOptional=False
+ServerSideOnly=True

AAL/Classes/AALMut.uc

@@ -1,60 +1 @@
-class AALMut extends KFMutator;
-
-var private AAL AAL;
-
-public simulated function bool SafeDestroy()
-{
-	return (bPendingDelete || bDeleteMe || Destroy());
-}
-
-public event PreBeginPlay()
-{
-	Super.PreBeginPlay();
-	
-	if (WorldInfo.NetMode == NM_Client) return;
-	
-	foreach WorldInfo.DynamicActors(class'AAL', AAL)
-	{
-		break;
-	}
-	
-	if (AAL == None)
-	{
-		AAL = WorldInfo.Spawn(class'AAL');
-	}
-	
-	if (AAL == None)
-	{
-		`Log_Base("FATAL: Can't Spawn 'AAL'");
-		SafeDestroy();
-	}
-}
-
-public function AddMutator(Mutator Mut)
-{
-	if (Mut == Self) return;
-	
-	if (Mut.Class == Class)
-		Mut.Destroy();
-	else
-		Super.AddMutator(Mut);
-}
-
-public function NotifyLogin(Controller C)
-{
-	Super.NotifyLogin(C);
-	
-	AAL.NotifyLogin(C);
-}
-
-public function NotifyLogout(Controller C)
-{
-	Super.NotifyLogout(C);
-	
-	AAL.NotifyLogout(C);
-}
-
-DefaultProperties
-{
-
-}
+class AALMut extends Mut; // backward compatibility

AAL/Classes/AdminList.uc

@@ -1,84 +1,84 @@
-class AdminList extends Object
-	config(AAL)
-	abstract;
-
-var private config Array<String> AdminId;
-
-public static function InitConfig(int Version, int LatestVersion, E_LogLevel LogLevel)
-{
-	`Log_TraceStatic();
-	
-	switch (Version)
-	{
-		case `NO_CONFIG:
-			ApplyDefault(LogLevel);
-			
-		default: break;
-	}
-	
-	if (LatestVersion != Version)
-	{
-		StaticSaveConfig();
-	}
-}
-
-public static function Array<UniqueNetId> Load(OnlineSubsystem OS, E_LogLevel LogLevel)
-{
-	local Array<UniqueNetId> UIDs;
-	local UniqueNetId UID;
-	local String ID;
-	
-	`Log_TraceStatic();
-	
-	foreach default.AdminId(ID)
-	{
-		if (AnyToUID(OS, ID, UID, LogLevel))
-		{
-			UIDs.AddItem(UID);
-			`Log_Debug("Loaded:" @ ID);
-		}
-		else
-		{
-			`Log_Warn("Can't load AdminId:" @ ID);
-		}
-	}
-	
-	if (default.AdminId.Length == UIDs.Length)
-	{
-		`Log_Info("Loaded" @ UIDs.Length @ "entries");
-	}
-	else
-	{
-		`Log_Info("Loaded" @ UIDs.Length @ "of" @ default.AdminId.Length @ "entries");
-	}
-	
-	return UIDs;
-}
-
-private static function ApplyDefault(E_LogLevel LogLevel)
-{
-	`Log_TraceStatic();
-	
-	default.AdminId.Length = 0;
-	default.AdminId.AddItem("76561190000000000");
-	default.AdminId.AddItem("0x0000000000000000");
-}
-
-private static function bool IsUID(String ID, E_LogLevel LogLevel)
-{
-	`Log_TraceStatic();
-	
-	return (Locs(Left(ID, 2)) ~= "0x");
-}
-
-private static function bool AnyToUID(OnlineSubsystem OS, String ID, out UniqueNetId UID, E_LogLevel LogLevel)
-{
-	`Log_TraceStatic();
-	
-	return IsUID(ID, LogLevel) ? OS.StringToUniqueNetId(ID, UID) : OS.Int64ToUniqueNetId(ID, UID);
-}
-
-defaultproperties
-{
-
-}
+class AdminList extends Object
+	config(AAL)
+	abstract;
+
+var private config Array<String> AdminId;
+
+public static function InitConfig(int Version, int LatestVersion, E_LogLevel LogLevel)
+{
+	`Log_TraceStatic();
+
+	switch (Version)
+	{
+		case `NO_CONFIG:
+			ApplyDefault(LogLevel);
+
+		default: break;
+	}
+
+	if (LatestVersion != Version)
+	{
+		StaticSaveConfig();
+	}
+}
+
+public static function Array<UniqueNetId> Load(OnlineSubsystem OS, E_LogLevel LogLevel)
+{
+	local Array<UniqueNetId> UIDs;
+	local UniqueNetId UID;
+	local String ID;
+
+	`Log_TraceStatic();
+
+	foreach default.AdminId(ID)
+	{
+		if (AnyToUID(OS, ID, UID, LogLevel))
+		{
+			UIDs.AddItem(UID);
+			`Log_Debug("Loaded:" @ ID);
+		}
+		else
+		{
+			`Log_Warn("Can't load AdminId:" @ ID);
+		}
+	}
+
+	if (default.AdminId.Length == UIDs.Length)
+	{
+		`Log_Info("Loaded" @ UIDs.Length @ "entries");
+	}
+	else
+	{
+		`Log_Info("Loaded" @ UIDs.Length @ "of" @ default.AdminId.Length @ "entries");
+	}
+
+	return UIDs;
+}
+
+private static function ApplyDefault(E_LogLevel LogLevel)
+{
+	`Log_TraceStatic();
+
+	default.AdminId.Length = 0;
+	default.AdminId.AddItem("76561190000000000");
+	default.AdminId.AddItem("0x0000000000000000");
+}
+
+private static function bool IsUID(String ID, E_LogLevel LogLevel)
+{
+	`Log_TraceStatic();
+
+	return (Left(ID, 2) ~= "0x");
+}
+
+private static function bool AnyToUID(OnlineSubsystem OS, String ID, out UniqueNetId UID, E_LogLevel LogLevel)
+{
+	`Log_TraceStatic();
+
+	return IsUID(ID, LogLevel) ? OS.StringToUniqueNetId(ID, UID) : OS.Int64ToUniqueNetId(ID, UID);
+}
+
+defaultproperties
+{
+
+}

AAL/Classes/Mut.uc

@@ -0,0 +1,60 @@
+class Mut extends KFMutator;
+
+var private AAL AAL;
+
+public simulated function bool SafeDestroy()
+{
+	return (bPendingDelete || bDeleteMe || Destroy());
+}
+
+public event PreBeginPlay()
+{
+	Super.PreBeginPlay();
+
+	if (WorldInfo.NetMode == NM_Client) return;
+
+	foreach WorldInfo.DynamicActors(class'AAL', AAL)
+	{
+		break;
+	}
+
+	if (AAL == None)
+	{
+		AAL = WorldInfo.Spawn(class'AAL');
+	}
+
+	if (AAL == None)
+	{
+		`Log_Base("FATAL: Can't Spawn 'AAL'");
+		SafeDestroy();
+	}
+}
+
+public function AddMutator(Mutator M)
+{
+	if (M == Self) return;
+
+	if (M.Class == Class)
+		Mut(M).SafeDestroy();
+	else
+		Super.AddMutator(M);
+}
+
+public function NotifyLogin(Controller C)
+{
+	AAL.NotifyLogin(C);
+
+	Super.NotifyLogin(C);
+}
+
+public function NotifyLogout(Controller C)
+{
+	AAL.NotifyLogout(C);
+
+	Super.NotifyLogout(C);
+}
+
+defaultproperties
+{
+
+}

AAL/Classes/_Logger.uc

@@ -1,20 +1,20 @@
-class _Logger extends Object
-	abstract;
-
-enum E_LogLevel
-{
-	LL_WrongLevel,
-	LL_None,
-	LL_Fatal,
-	LL_Error,
-	LL_Warning,
-	LL_Info,
-	LL_Debug,
-	LL_Trace,
-	LL_All
-};
-
-defaultproperties
-{
-	
-}
+class _Logger extends Object
+	abstract;
+
+enum E_LogLevel
+{
+	LL_WrongLevel,
+	LL_None,
+	LL_Fatal,
+	LL_Error,
+	LL_Warning,
+	LL_Info,
+	LL_Debug,
+	LL_Trace,
+	LL_All
+};
+
+defaultproperties
+{
+
+}

AAL/Constants.uci

@@ -1,2 +1,2 @@
-// Constants
-`define NO_CONFIG 0
+// Constants
+`define NO_CONFIG 0

AAL/Globals.uci

@@ -1,3 +1,3 @@
-// Imports
-`include(Logger.uci)
-`include(Constants.uci)
+// Imports
+`include(Logger.uci)
+`include(Constants.uci)

AAL/Logger.uci

@@ -1,15 +1,15 @@
-// Logger
-`define Log_Tag 'AAL'
-
-`define LocationStatic        "`{ClassName}::" $ GetFuncName()
-
-`define Log_Base(msg, cond)  `log(`msg `if(`cond), `cond`{endif},            `Log_Tag)
-
-`define Log_Fatal(msg)       `log("FATAL:" @ `msg, (LogLevel >= LL_Fatal),   `Log_Tag)
-`define Log_Error(msg)       `log("ERROR:" @ `msg, (LogLevel >= LL_Error),   `Log_Tag)
-`define Log_Warn(msg)        `log("WARN:"  @ `msg, (LogLevel >= LL_Warning), `Log_Tag)
-`define Log_Info(msg)        `log("INFO:"  @ `msg, (LogLevel >= LL_Info),    `Log_Tag)
-`define Log_Debug(msg)       `log("DEBUG:" @ `msg, (LogLevel >= LL_Debug),   `Log_Tag)
-
-`define Log_Trace(msg)       `log("TRACE:" @ `Location       `if(`msg) @ `msg`{endif}, (LogLevel >= LL_Trace), `Log_Tag)
-`define Log_TraceStatic(msg) `log("TRACE:" @ `LocationStatic `if(`msg) @ `msg`{endif}, (LogLevel >= LL_Trace), `Log_Tag)
+// Logger
+`define Log_Tag 'AAL'
+
+`define LocationStatic        "`{ClassName}::" $ GetFuncName()
+
+`define Log_Base(msg, cond)  `log(`msg `if(`cond), `cond`{endif},            `Log_Tag)
+
+`define Log_Fatal(msg)       `log("FATAL:" @ `msg, (LogLevel >= LL_Fatal),   `Log_Tag)
+`define Log_Error(msg)       `log("ERROR:" @ `msg, (LogLevel >= LL_Error),   `Log_Tag)
+`define Log_Warn(msg)        `log("WARN:"  @ `msg, (LogLevel >= LL_Warning), `Log_Tag)
+`define Log_Info(msg)        `log("INFO:"  @ `msg, (LogLevel >= LL_Info),    `Log_Tag)
+`define Log_Debug(msg)       `log("DEBUG:" @ `msg, (LogLevel >= LL_Debug),   `Log_Tag)
+
+`define Log_Trace(msg)       `log("TRACE:" @ `Location       `if(`msg) @ `msg`{endif}, (LogLevel >= LL_Trace), `Log_Tag)
+`define Log_TraceStatic(msg) `log("TRACE:" @ `LocationStatic `if(`msg) @ `msg`{endif}, (LogLevel >= LL_Trace), `Log_Tag)

PublicationContent/description.txt

@@ -1,43 +1,68 @@
-[img]https://img.shields.io/static/v1?logo=GitHub&labelColor=gray&color=blue&logoColor=white&label=&message=Open Source[/img] [img]https://img.shields.io/github/license/GenZmeY/KF2-AdminAutoLogin[/img] [img]https://img.shields.io/steam/favorites/2848836389[/img] [img]https://img.shields.io/steam/update-date/2848836389[/img] [url=https://steamcommunity.com/sharedfiles/filedetails/changelog/2848836389][img]https://img.shields.io/github/v/tag/GenZmeY/KF2-AdminAutoLogin[/img][/url]
+[img]https://img.shields.io/static/v1?logo=GitHub&labelColor=gray&color=blue&logoColor=white&label=&message=Open Source[/img] [img]https://img.shields.io/github/license/GenZmeY/KF2-AdminAutoLogin[/img] [img]https://img.shields.io/steam/downloads/2848836389[/img] [img]https://img.shields.io/steam/favorites/2848836389[/img] [img]https://img.shields.io/steam/update-date/2848836389[/img] [url=https://steamcommunity.com/sharedfiles/filedetails/changelog/2848836389][img]https://img.shields.io/github/v/tag/GenZmeY/KF2-AdminAutoLogin[/img][/url]
 
-[h1]Description[/h1]
+[h1]📋 Description[/h1]
 Small server-side mutator that allows specified players to automatically login as an admin.
 
-[h1]Whitelisted?[/h1]
-No. This mod is not whitelisted and will de-rank your server. Any XP gained will not be saved.
+[h1]❌ Whitelisted?[/h1]
+No. This mod is not whitelisted and will de-rank your server. Any XP earned will not be saved.
 
-[h1]Usage (server)[/h1]
-[b]Note:[/b] [i]If you don't understand what is written here, read the article [url=https://wiki.killingfloor2.com/index.php?title=Dedicated_Server_(Killing_Floor_2)][u]Dedicated Server (KF2 wiki)[/u][/url] before following these instructions.[/i]
+But I hope that it will be whitelisted - I submitted whitelist request here:
+https://forums.tripwireinteractive.com/index.php?threads/whitelisting-mods-and-mutators.120340/post-2353666
+
+[h1]🖥️ Usage (server)[/h1]
+[b]Note:[/b] [i]If this is unclear, first read: [url=https://wiki.killingfloor2.com/index.php?title=Dedicated_Server_(Killing_Floor_2)][u]Dedicated Server Guide (KF2 wiki)[/u][/url][/i]
 [olist]
-[*]Open your [b]PCServer-KFEngine.ini[/b] / [b]LinuxServer-KFEngine.ini[/b];
-[*]Find the [b][IpDrv.TcpNetDriver][/b] section and make sure that there is a line (add if not):
-[b]DownloadManagers=OnlineSubsystemSteamworks.SteamWorkshopDownload[/b]
-❗️ If there are several [b]DownloadManagers=[/b] then the line above should be the first ❗️
+[*]Open [b]PCServer-KFEngine.ini[/b] / [b]LinuxServer-KFEngine.ini[/b].
+[*]Find [b][IpDrv.TcpNetDriver][/b] section and ensure line exists (add if missing):
+[code]DownloadManagers=OnlineSubsystemSteamworks.SteamWorkshopDownload[/code]
+(If there are several [b]DownloadManagers[/b] then the line above should be the first)
 [*]Add the following string to the [b][OnlineSubsystemSteamworks.KFWorkshopSteamworks][/b] section (create one if it doesn't exist):
-[b]ServerSubscribedWorkshopItems=2848836389[/b]
-[*]Start the server and wait until the mutator is downloading;
-[*]Add mutator to server start parameters: [b]?Mutator=AAL.AALMut[/b] and restart the server.
+[code]ServerSubscribedWorkshopItems=2848836389[/code]
+[*]Start server and wait for mutator download.
+[*]When the download is complete, stop the server.
+[*]Create a file [b](*)[/b]: [code]<kf2-server>\KFGame\Config\KFAAL.ini[/code]
+with content:
+[code][AAL.AAL]
+Version=0[/code]
+[*]Add mutator to server start parameters: [code]?Mutator=AAL.Mut[/code] and start the server (this will generate the default KFAAL.ini content).
+[*]Stop the server and configure the mutator (see [b]⚙️ Setup (KFAAL.ini)[/b] below).
+[*]Start the server.
 [/olist]
 
-[h1]Setup (KFAAL.ini)[/h1]
-Config will be created at the first start.
+[h1]🐞 (*) Buggy config initialization[/h1]
+This mutator (like many others) relies on UnrealScript's default values (0 for int type) to detect first-time use and generate a config.
+However, the game contains a bug that initializes unset values to random data, which can lead to incorrect settings or missing configs.
+
+As a workaround, I recommend explicitly setting [b]Version=0[/b] in the config during the first initialization.
+
+Unfortunately, I can't fix this issue because it's a game engine problem (not the mutator's fault).
+
+[h1]⚙️ Setup (KFAAL.ini)[/h1]
 [list]
-[*]Use [b]AdminId[/b] to set the list of admins. You can use UniqueID or SteamID;
+[*]Use [b]AdminId[/b] to set the list of admins, you can use UniqueID or SteamID. The default config contains example UniqueID and SteamID entries - replace them with the values ​​you need or delete them, but don’t leave it as is.
+[*]Set [b]bAutoEnableCheats=True[/b] to automatically enable cheats for admins.
 [/list]
 
-[h1]Getting ID[/h1]
+[h1]🔎 Getting IDs[/h1]
 You can view the Steam ID and UniqueID in WebAdmin on the PLAYERS tab:
 [img]https://raw.githubusercontent.com/GenZmeY/KF2-AdminAutoLogin/master/PublicationContent/ID1.png[/img]
 
-But don't try to use the SteamID from here for EGS players - it won't work. SteamID is for Steam players only.
-UniqueID is suitable for all platforms.
+But don't try to use the SteamID from here for EGS players - it won't work. SteamID is for Steam players only. UniqueID is suitable for all platforms.
 
 SteamID can also be obtained from the player's profile, look at the URL:
 [img]https://raw.githubusercontent.com/GenZmeY/KF2-AdminAutoLogin/master/PublicationContent/ID2.png[/img]
 
 If a player uses a nickname in a link to their profile, then add this to the profile url: [b]?xml=1[/b]
-SteamID will be at the beginning:
 [img]https://raw.githubusercontent.com/GenZmeY/KF2-AdminAutoLogin/master/PublicationContent/ID3.png[/img]
 
-[h1]Sources[/h1]
-[url=https://github.com/GenZmeY/KF2-AdminAutoLogin]https://github.com/GenZmeY/KF2-AdminAutoLogin[/url] [b](GNU GPLv3)[/b]
+[h1]🌍 Credits[/h1]
+[list]
+[*]The cat on the cover is Meawbin (original character by [url=https://x.com/horrormove]Cotton Valent[/url]).
+[/list]
+
+[h1]☑️ Status: Completed[/h1]
+✔️ The mutator works with the current version of the game (v1150) and I have implemented everything I planned.
+⛔️ Development has stopped: I no longer have the time or motivation to maintain this mod. No further updates or bug fixes are planned.
+
+[h1]📜 Sources[/h1]
+https://github.com/GenZmeY/KF2-AdminAutoLogin [b](GNU GPLv3)[/b]

README.md

@@ -1,18 +1,19 @@
 # Admin Auto Login
 
 [![Steam Workshop](https://img.shields.io/static/v1?message=workshop&logo=steam&labelColor=gray&color=blue&logoColor=white&label=steam%20)](https://steamcommunity.com/sharedfiles/filedetails/?id=2848836389)
+[![Steam Downloads](https://img.shields.io/steam/downloads/2848836389)](https://steamcommunity.com/sharedfiles/filedetails/?id=2848836389)
 [![Steam Favorites](https://img.shields.io/steam/favorites/2848836389)](https://steamcommunity.com/sharedfiles/filedetails/?id=2848836389)
-[![Steam Update Date](https://img.shields.io/steam/update-date/2848836389)](https://steamcommunity.com/sharedfiles/filedetails/?id=2848836389)
+[![MegaLinter](https://github.com/GenZmeY/KF2-AdminAutoLogin/actions/workflows/mega-linter.yml/badge.svg?branch=master)](https://github.com/GenZmeY/KF2-AdminAutoLogin/actions/workflows/mega-linter.yml)
 [![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/GenZmeY/KF2-AdminAutoLogin)](https://github.com/GenZmeY/KF2-AdminAutoLogin/tags)
 [![GitHub](https://img.shields.io/github/license/GenZmeY/KF2-AdminAutoLogin)](LICENSE)
 
-# Description
+## Description
 Small server-side mutator that allows specified players to automatically login as an admin.
 
-# Usage & Setup
+## Usage & Setup
 [See steam workshop page](https://steamcommunity.com/sharedfiles/filedetails/?id=2848836389)
 
-# Build
+## Build
 **Note:** If you want to build/test/brew/publish a mutator without git-bash and/or scripts, follow [these instructions](https://tripwireinteractive.atlassian.net/wiki/spaces/KF2SW/pages/26247172/KF2+Code+Modding+How-to) instead of what is described here.
 1. Install [Killing Floor 2](https://store.steampowered.com/app/232090/Killing_Floor_2/), Killing Floor 2 - SDK and [git for windows](https://git-scm.com/download/win);
 2. open git-bash and go to any folder where you want to store sources:  
@@ -26,9 +27,9 @@ Small server-side mutator that allows specified players to automatically login a
 5. The compiled files will be here:  
 `C:\Users\<USERNAME>\Documents\My Games\KillingFloor2\KFGame\Unpublished\BrewedPC\Script\`
 
-# Bug reports
+## Bug reports
 If you find a bug, go to the [issue page](https://github.com/GenZmeY/KF2-AdminAutoLogin/issues) and check if there is a description of your bug. If not, create a new issue.  
 Describe what the bug looks like and how reproduce it.  
 
-# License
-[GNU GPLv3](LICENSE)  
+## License
+[![license](https://www.gnu.org/graphics/gplv3-with-text-136x68.png)](LICENSE)

builder.cfg

@@ -7,15 +7,24 @@ StripSource="True"
 
 # Mutators to be compiled
 # Specify them with a space as a separator,
-# Mutators will be compiled in the specified order 
+# Mutators will be compiled in the specified order
 PackageBuildOrder="AAL"
 
 
+### Brew parameters ###
+
+# Packages you want to brew using @peelz's patched KFEditor.
+# Useful for cases where regular brew doesn't put *.upk inside the package.
+# Specify them with a space as a separator,
+# The order doesn't matter
+PackagePeelzBrew=""
+
+
 ### Steam Workshop upload parameters ###
 
 # Mutators that will be uploaded to the workshop
 # Specify them with a space as a separator,
-# The order doesn't matter 
+# The order doesn't matter
 PackageUpload="AAL"
 
 
@@ -30,7 +39,7 @@ Map="KF-Nuked"
 # Endless:        KFGameContent.KFGameInfo_Endless
 # Objective:      KFGameContent.KFGameInfo_Objective
 # Versus:         KFGameContent.KFGameInfo_VersusSurvival
-Game="AAL.restore KFEditor.ini from backup"
+Game="KFGameContent.KFGameInfo_Survival"
 
 # Difficulty:
 # Normal:         0

tools

@@ -1 +1 @@
-Subproject commit 2f173aad7a6f4578574764801136a0d86e830653
+Subproject commit fb458ac61f7e6c6426b8dff366dd5e7499e0d95f