AAMods // Central Registry

America's Army v2.8.5 Server Mutation Development Hub
[DEPLOYMENT UPDATE] A new critical package optimization is available for the ServerSuite Unified Mutator. VIEW CHANGELOG & DOWNLOAD

Technical Documentation Archive

// DOCUMENTATION LOG SHORTCUT NODES:
[ 1. Features ][ 2. Badges ][ 3. Installation ][ 4. Configuration ][ 5. Chat Commands ][ 6. Color Palette ]

ServerSuite Mutator (v2.8.5)

An all-in-one administration sandbox, optimization utility, and automated notification engine designed explicitly for America's Army: Operations (v2.8.5) servers.

This mutator features an iron-clad authorization bypass safety valve, a streamlined administrator chat listener, and dynamic color translations for both server-wide broadcasts and public player text loops!


1. Features

Overview

Master Auth & Safety Valve - Hardlocks SetRequireAuthorization natively to False on launch. This completely stops the server from waiting on the dead master authentication nodes, bypassing broken AGP.dll handshakes to let players connect instantly.
Public Variable Optimization - Refines public variables down to ultra-short configurations (bLeased, bOfficial, bEU) to keep the server ini layout readable for administrators.
Public & Admin Chat Color Transceiver - Unlocks dynamic caret-to-escape color translations for everyone on the server! Regular users can use traditional caret color strings (^1 through ^0) in standard global or team text chat channels, which are parsed instantly into live, bold color lines.
Universal Force Class Shortcut - Introduces the rapid-fire !afc global loadout override command so operators can force universal sandbox configurations (like instant all-sniper s24 environments) straight from the message bar.

2. Badges

Special Administration Visual Badge

The suite automatically hooks into the stock client rendering tables to elevate logged-in administrators on the master scoreboard without requiring any custom local game file downloads.

Gold Star AACM Badge (Group ID: "23") - Server administrators are automatically assigned an hardcoded gold star visual crest next to their name under the scoreboard's Class column. This provides immediate, unmistakable authority in-game without forcing players to download custom texturing assets.

3. Installation

Quick Installation Guide (Pure Server-Side)

Because this mutator runs entirely server-side, players connecting to your server do not need to download this package to join your matches.

1. Drop the Binary File

Place your compiled ServerSuite.u file directly into your server's System/ directory alongside your other game engine files.

2. Boot the Map Server Instance

Add the mutator package wrapper straight to your startup execution command line script parameters.

Linux / Wine .sh Shell Script Boot Example:

#!/bin/bash
cd System || { echo "System directory not found"; exit 1; }

# Boots the server instance safely via Wine with the suite active
wine ./server.exe LAN pipeline.aao?mutator=serversuite.main

4. Configuration

Configuration Guide (ServerSuite.ini)

Upon its very first boot, the mutator automatically generates a pristine configuration matrix layout inside your server's System/ folder named exactly ServerSuite.ini.

(Note: The inherited clutter recording parameters are automatically isolated at the very bottom into a distinct containment block to preserve the clean structure of your public variables).

[ServerSuite.Main]
bLeased=true
bOfficial=true
bForceFirstPersonSpectate=false
bEU=false

[ServerSuite.ServerMessages]
bEnableMessages=true
MessageInterval=60.000000
Message1=^3[SERVER] ^7Welcome to map ^2%map%^7!
Message2=^5[INFO] ^7You are playing on ^6%servername%^7.
Message3=^1[RULES] ^7Please respect other users and play fair!
Message4=^2[TIP] ^7Use carets like ^4^1 or ^4^2 to add awesome colors to chat!

[ServerSuite.Dump]
bDemoRecSounds=True
bDemoRecMuzzleFlash=True

5. Chat Commands

Administrator Chat Command Roster

Logged-in server administrators can type these commands directly into the standard text talk chat bar (Say). The mod intercepts them instantly, runs the action, and completely ghosts the text from showing up on regular players' screens.

Moderation & Player Management Shorthand

Chat Box CommandNative Command MappingFunction Description
!k <name> <reason>admin kick <name> <reason>Kicks matching player and logs your custom text reason.
!b <name> <type>admin ban <name> 0 <type>Permanently bans player. Types: Name, IP, MAC, PBGUID.
!tb <name> <time> <type>admin ban <name> <time> <type>Bans player for time intervals. Suffix examples: 30m, 2h, 7d, 1w.
!ubadmin unbanClears an authentication ban record from history.
!bladmin banlistPrints the active server blacklists into your local console screen.
!st <name/id>admin A_SwitchTeam <name/id>Switches specified player's team at the beginning of the next round.
!spec <name/id>admin Spectate <name/id>Forces you to spectate the specified target player (Leave blank for generic).
!mute <name/id/all>admin Mute <name/id/all>Natively blocks voice/chat channels for specified target or everyone.

Infrastructure & Match Control Shorthand

Chat Box CommandNative Command MappingFunction Description
!afc <weaponclass>admin forceclass * <weaponclass>Instantly forces every single player on the server into the chosen weapon role (e.g., !afc s24).
!map <mapname>admin Switch <mapname>Instantly forces the server to change the active arena over to the chosen map.
!restartadmin RestartMapRestarts the current map match setup immediately.

Messaging & Text Shorthand

Chat Box CommandNative Command MappingFunction Description
!s <text>admin say <text>Broadcasts a standard administrative global chat line to all users.
!cs <text>admin csay <text>Flashes a global center-screen HUD notification text string.
admin commandpostNavigates the active administration screen loop straight to Command Post panels.
!m <text>admin message <text> / Custom OverlayTriggers the game's bold admin alert. If a caret (^) is included, it dynamically shifts to a fully custom, colored pop-up banner!
!w <name> <text>Internal SubsystemPrivately warns a player. Flashes a bold line in chat and slams a stacked, native line-break pop-up onto their center screen!
!w * <text>Internal SubsystemBroadcasts a high-priority, server-wide bold text alert and center screen layout message.

6. Color Palette

Caret Palette Color Shorthand Guide

When configuring automated messages inside ServerSuite.ini, or when any administrator or player types lines inside standard chat queues, drop these caret indices anywhere to apply dynamic text colors and force the engine font into bold mode:

^1 = Red
^2 = Green
^3 = Yellow
^4 = Blue
^5 = Cyan
^6 = Magenta
^7 = White
^8 = Orange
^9 = Grey
^0 = Black