Legions Utils

Legions Utils

Legions Utils is a client-side Fabric mod made for the Legions Minecraft server.

It is separate from Atomics Client, but integrates with Atomics Client when both mods are installed.

---

⚠️ All features are toggleable ⚠️

---

Feature List

• Rating nametags
• Rating tags in the tab list
• Atomics Client nametag rating replacement
• Enemy highlights
• Quip Outlines
• Dynamic highlight opacity
• Spectator team-colored outlines
• Team HUD
• Team Count overlay
• Team Rating Totals overlay
• Custom team ping rows
• Player pings
• Block/location pings
• Self pings
• Last-attacker and last-attacked pings
• Custom ping messages
• Custom ping colors
• Custom ping icons
• Visual ping audience settings
• Pinged player highlights
• Block outlines and distance labels
• Off-screen ping arrows
• Team Fight Detector
• Recent combat target tracking
• Opponent visibility limiting
• Player render optimization
• Adaptive performance options
• Optional teammate culling
• Custom world border visuals
• World border color and opacity settings
• Hide world border glitter particles
• Teammate attack warning
• Atomics Client compatibility
• Atomics Dual Spectate support
• ModMenu support
• Legacy config migration from legions_client.json

---

Main Features

Rating Nametags and Tab List Ratings

Legions Utils shows Legions ratings on player nametags, such as [1.8] or [?].

It can also add missing rating tags directly to the tab list, making player ratings easier to check during matches.

When Atomics Client is installed, Legions Utils can replace Atomics tier text with Legions rating text so nametags do not show duplicate ranking info.

---

Enemy Highlights and Quip Outlines

Legions Utils adds team-based, ping-based, and rating-based player highlights.

Highlights can be used for:

• Pinged players
• Enemy players
• Spectator team colors
• Rating-colored Quip Outlines

Enemy highlights support dynamic opacity, custom min/max opacity settings, and armor-only rendering for cleaner visuals.

Quip Outlines are optional rating-colored outlines with adjustable width. They make player ratings easier to notice without needing to constantly check nametags or the tab list.

---

Team HUD

The Team HUD shows your current scoreboard team on screen.

It is enabled by default, can be moved with the layout editor, and supports the mod’s UI scale setting.

---

Team Count and Team Ratings Overlay

Legions Utils adds a movable team overlay with two display modes.

• Teams Left: shows active teams and player counts
• Team Ratings: shows each team’s player count and combined rating total

The overlay ignores spectator teams, uses team colors when possible, and avoids duplicate team count displays when Atomics Client is installed.

---

Custom Team Pings

Legions Utils includes a configurable team ping system with multiple custom ping rows.

Ping rows can use:

• Keyboard or mouse inputs
• Single press or multi-press triggers
• Player, block, self, last-attacker, or last-attacked targets
• Teammate-only, enemy-only, or all-player targeting
• Custom messages
• Custom colors
• Custom icons
• Visual audience settings

Default controls:

• Press G once to ping the player you are looking at
• Press G twice to ping the block/location you are looking at

Default messages include:

• Focus PlayerName
• PlayerName NEEDS HELP!
• Go to x y z

---

Ping Messages and Visuals

Ping messages stay readable in normal chat, even for players without Legions Utils.

Legions Utils users also receive extra ping data so the correct player, block, color, icon, and label can be shown visually.

Ping visuals can include:

• Player highlights
• Block outlines
• Ping particles
• Distance labels
• Off-screen arrows

Visual pings can be shown to teammates, opponents, or everyone depending on the ping row. Spectators can see all valid visual pings.

---

Off-Screen Ping Arrows

Off-screen arrows point toward active pings or fight markers that are outside your screen.

They can point toward:

• Player pings
• Block/location pings
• Detected fights

Arrows use ping colors and icons when available. They also support distance fading, scale settings, opacity settings, and screen visibility checks so arrows do not appear for targets already on screen.

---

Team Fight Detector

The Team Fight Detector automatically detects active fights when multiple players from multiple teams are grouped together.

Fight markers prioritize the best active fight based on:

• Number of players
• Number of teams
• Cluster tightness
• Distance from you

Fight markers can appear on-screen and through off-screen arrows. Options include spectator-only mode, custom fight color, smoothing, and fade-out time.

---

Recent Target Pings

Custom ping rows can target recent combat interactions.

Supported recent targets:

• Last player who attacked you
• Last player you attacked

This makes it easier to quickly call out someone who hit you or someone you were just fighting.

---

Player Visibility and Adaptive Performance

Legions Utils can reduce clutter in large fights.

It can:

• Keep important players visible
• Limit visible opponents to the nearest players
• Keep pinged players visible while highlighted
• Hide far-away players past a configurable render distance
• Optionally cull teammates
• Use adaptive performance settings during heavier fights

These options help keep fights easier to read and can reduce rendering load in crowded matches.

---

Custom World Border

Legions Utils replaces the old warning-particle system with a cleaner custom world border display.

World border options include:

• Custom border color
• Custom border opacity
• Hide glitter particles
• Smoother border rendering

This makes the world border easier to see without being as distracting.

---

Teammate Attack Warning

Legions Utils can show a warning when you hit someone on your own team.

This helps prevent accidental team hits during messy fights, while avoiding free-for-all style teams where teammate warnings would not make sense.

---

Atomics Client Compatibility

When Atomics Client is installed, Legions Utils appears inside the Atomics-style module screen instead of using a separate config keybind.

Compatibility includes:

• Atomics-style Legions settings section
• Legions rating replacement for Atomics nametag tiers
• Duplicate team count prevention
• Team Rating Totals support
• Atomics Dual Spectate lock support
• Atomics keybind category support

Without Atomics Client, Legions Utils uses its own config menu.

---

Atomics Dual Spectate Support

When Atomics Client is installed, Legions Utils adds extra Dual Spectate controls.

It can:

• Add lock controls to Dual Spectate player fields
• Lock the camera to a selected player
• Help choose a useful second spectate target
• Restore Atomics Dual Spectate settings when unlocked

This makes spectating Legions matches smoother and easier to follow.

---

Config

Legions Utils includes ModMenu support and saves settings to legions_utils.json.

Old legions_client.json configs are migrated automatically when possible.

Main config options include:

• Server IPs
• UI Scale
• Rating Nametags
• Nametags Any Server
• Quip Outlines
• Quip Outline Width
• Enemy Highlights
• Dynamic Highlight Opacity
• Highlight Min/Max Opacity
• Teammate Attack Warning
• Spectator Glow
• Custom World Border
• Team Ping Rows
• Ping Duration
• Recent Target Timeout
• Off-Screen Arrows
• Team Fight Detector
• Team HUD
• Team Count Overlay
• Team Rating Totals
• Adaptive Performance
• Opponent Limiting
• Cull Teammates
• Player Render Optimization

---

Keybinds

Default controls:

• Open Legions Utils: O when Atomics Client is not installed
• Player ping: G
• Block/location ping: double press G

Ping inputs can be changed in the Team Ping Rows menu.

---

Requirements

• Minecraft 1.21.11
• Fabric Loader 0.18.1+
• Fabric API
• Java 21+

---

Notes

Legions Utils is fully client-side. It does not add server-side mechanics, automation, or gameplay-changing abilities.

Most features only run on configured Legions server addresses. By default, the allowed server list matches servers containing legions.

---

Related

Atomics Client