Chat Faction Tags

Overview

Chat Faction Tags displays faction and role indicators before player chat messages so it is easy to identify who is speaking at a glance.

Typical output looks like [US, Admin] Hello team or [USSR, GM] Event starts now, with colors based on faction and optional darkening for admin/GM roles.

Use this page as the canonical reference for your shipped settings.json keys and behavior.

Requirements

• Arma Reforger 1.6+
• Mod must be loaded on the server/session so settings replicate to all clients

Configuration

On first run, the mod creates:

Profile/ChatFactionTags/settings.json

Edit this file while the server is stopped, then restart so changes apply.

Default Config

{
  "useFactionColors": true,
  "useAdminColor": true,
  "useGMColor": true,
  "adminColorFactor": 0.5,
  "gmColorFactor": 0.7,
  "adminTag": "Admin",
  "gmTag": "GM",
  "factions": [
    { "key": "US", "tag": "US" },
    { "key": "USSR", "tag": "USSR" },
    { "key": "FIA", "tag": "FIA" }
  ]
}

Settings

useFactionColors

Controls faction-based chat coloring.

• true: applies faction/role color logic
• false: forces message color to white

useAdminColor

Controls admin message color override.

• true: uses darkened faction color for admin messages when available
• false: no admin-specific color override

useGMColor

Controls GM message color override.

• true: uses darkened faction color for GM messages when available
• false: no GM-specific color override

adminTag

Text used for admin role tag.

• Example: "Admin" -> [US, Admin]
• Empty values are auto-corrected to "Admin" on load

gmTag

Text used for GM role tag.

• Example: "GM" -> [USSR, GM]
• Empty values are auto-corrected to "GM" on load

adminColorFactor

Darkening multiplier applied to faction color for admin messages.

• Lower value = darker color
• Clamped to range 0..1

gmColorFactor

Darkening multiplier applied to faction color for GM messages.

• Lower value = darker color
• Clamped to range 0..1

factions

Faction tag overrides used for displayed faction labels.

• Format: array of objects with key and tag
• Example entry: { "key": "USRF", "tag": "RANGERS" }
• Duplicate keys are deduplicated on load (last entry wins)
• Empty keys are ignored
• Empty tags fall back to the faction key

Gameplay notes

• Tags are built from player faction plus detected admin/GM status.
• Role tags are automatic; players do not manually set them in chat.
• Settings are replicated from server to clients for consistent display.
• Designed to improve readability and moderation awareness in active servers.

Troubleshooting

Credits

Special thanks to Ceo_Of_Bacon for the original Chat Message Roles mod this project is based on.

Compatibility

• Arma Reforger 1.6+
• Compatible with any scenario or game mode

Links