AFKTextFX

A BepInEx mod for Mage Arena that lets players customize text.

🔧 Features

• Customization:
  Create a custom rank using a GUI window, toggled with F1. Type your desired settings in the input fields and click Apply to change them.
  You can set your Lobby Name Color, Player Name Color, Rank, and Chat Message Color.

• Persistent Settings:
  All settings (lobby name color, player name color, rank, and chat message color) are saved and reloaded when the game restarts.

• Profanity Filter:
  Custom ranks containing banned words will be automatically blocked and replaced.

🧩 Installation

Requires Mage Arena and BepInEx 5.4.21.

Install Path:

MageArena/
└── BepInEx/
    └── plugins/
        ├── AFKTextFX.dll

Config

You can edit the configs under this path but they are also editable in game with the F1 Key Press.

MageArena/
└── BepInEx/
    └── config/
        ├── AFKTextFX.cfg

If you want to change the F1 UI Key to some other key, then you will have to directly modify the AFKTextFX.cfg file UIToggleKey = F1 setting.

📋 Notes

• Press F1 in-game to toggle the customization UI. You can customize the UI key in BepInEx/config/AFKTextFX.cfg.
• Hex colors must be in RRGGBB format. Invalid entries will be ignored.
• Banned words are filtered from ranks before applying.
• If your color input is invalid, a fallback/default color is used.
• To apply colors to your rank, use Unity Rich Text formatting. For example:

  <color=#FFFFFF><b>lvl 9999 Holy Mage</b></color>
  

  Learn more about supported tags here:
  👉 Unity Rich Text Documentation

Known Issues

• If your player name is multi-line, then the player name colors will not be applied properly

Changelog

[1.4.1] - 2025-08-21

Changed

• Updated mod to work with Mage Arena V0.7.8

[1.4.0] - 2025-08-07

Changed

• Added configuration setting to allow users to set the AFKTextFX UI KeyCode to something other than F1

[1.3.12] - 2025-08-06

Changed

• Fixed bug where rainbow chat messages were not applied

[1.3.11] - 2025-08-06

Changed

• Fixed lvl stat being obtained from steam being set incorrectly
• Fixed bug where player name is not rainbow if default color is selected

[1.3.10] - 2025-08-06

Changed

• Added filter improvements
• Fixed reset button

[1.3.9] - 2025-08-06

Changed

• Added filter improvements

[1.3.8] - 2025-08-06

Changed

• Added peak filtering

Notes

• Why did nobody tell me filters were this hard?

[1.3.7] - 2025-08-06

Changed

• Added insanely better filtering

[1.3.6] - 2025-08-06

Changed

• Added crazy better filtering

[1.3.5] - 2025-08-06

Changed

• Added even better filtering

[1.3.4] - 2025-08-06

Changed

• Added better filtering

[1.3.3] - 2025-08-05

Changed

• Fixed alignment issue with player name color when joining teams

[1.3.2] - 2025-08-05

Changed

• Fixed reset button not applying the default lobby name color properly
• Made the GUI window slightly wider

[1.3.1] - 2025-08-05

Changed

• Updated the README with small fix

[1.3.0] - 2025-08-05

Changed

• Updated the README to reflect that Player Name customization is no longer available and Lobby Name customization is no longer available.
• Available options are now Lobby Name Color, Player Name Color, Rank, & Chat Message Color

[1.2.1] - 2025-08-04

Changed

• Updated the README to reflect that Player Name customization is temporarily disabled.
• Disabled Player Name setting to avoid confusion in the customization section.

Notes

• The setting is still visible in the GUI but not currently editable.