Overview#
InGame Info XML (IGI) is a comprehensive utility mod designed to replace or enhance the standard F3 debug screen. It provides a fully customizable Head-Up Display (HUD) that can show a vast array of information, from basic player coordinates and health to complex technical data like FPS, memory usage, and entity counts. Unlike static HUD mods, InGame Info XML uses a logic-based configuration system, allowing users to create dynamic displays that change based on in-game conditions (e.g., changing text color when health is low or displaying a warning when in a slime chunk).

The mod is built on the LunatriusCore library and supports three primary configuration formats: XML (default), JSON, and a simplified Text format. It is widely used in expert modpacks to provide essential data without cluttering the screen with the full debug menu.
Commands#
The mod includes several administrative and utility commands to manage the HUD in real-time without restarting the game.
| Command | Description |
|---|---|
/igi reload |
Reloads the currently active configuration file. Essential for testing changes. |
/igi load <filename> |
Loads a specific configuration file from the config folder. The extension (.xml,.json,.txt) determines the format. |
/igi save <filename> |
Saves the current HUD configuration to a file. |
/igi enable |
Enables the HUD overlay. |
/igi disable |
Disables the HUD overlay. |
/igi taglist |
Opens a GUI displaying every available tag, its current value, and a brief description. |
/igi config |
Opens the configuration GUI to adjust global settings like scaling and offsets. |

HUD Alignment and Positioning#
The HUD is organized into nine anchor points on the screen. Each anchor can contain multiple lines of information, which are rendered relative to that position.
- topleft: Top-left corner of the screen.
- topcenter: Top-center, often used for compasses or day counters.
- topright: Top-right corner, common for potion effects.
- middleleft: Middle of the left edge.
- middlecenter: Dead center of the screen (rarely used for text).
- middleright: Middle of the right edge.
- bottomleft: Bottom-left corner, above the chat.
- bottomcenter: Bottom-center, above the hotbar.
- bottomright: Bottom-right corner.
Users can further refine these positions using X and Y offsets in the InGameInfoXML.cfg file or the /igi config menu to prevent overlapping with other modded UI elements.
Configuration Tags and Variables#
The power of the mod lies in its extensive list of tags. These tags act as variables that the mod replaces with live data.
Player Information
| Tag | Description |
|---|---|
{playername} |
The current player's username. |
{health} |
Current health points. |
{maxhealth} |
Maximum health points. |
{xp} |
Current experience points. |
{level} |
Current experience level. |
{foodlevel} |
Current hunger level. |
{saturation} |
Current hunger saturation. |
{air} |
Remaining air while underwater. |
{armor} |
Current armor value. |
{durability} |
Durability of the currently held item. |
World and Environment
| Tag | Description |
|---|---|
{day} |
Number of days passed in the world. |
{mctime} |
Current in-game time (24h or 12h format). |
{biome} |
The name of the current biome. |
{light} |
Total light level at the player's feet. |
{lightnosun} |
Light level excluding sunlight (useful for mob spawn checking). |
{difficulty} |
Current world difficulty. |
{slime} |
Displays 'True' if the player is in a slime chunk. |
{temperature} |
The temperature value of the current biome. |
{raining} |
Boolean indicating if it is currently raining. |
Technical and System
| Tag | Description |
|---|---|
{fps} |
Current frames per second. |
{mem} |
Used memory in MB. |
{memmax} |
Total allocated memory in MB. |
{entities} |
Total number of loaded entities. |
{entitieshostile} |
Number of hostile mobs nearby. |
{ping} |
Current server latency (multiplayer only). |

Logic and Operations#
InGame Info XML supports logic tags that allow for conditional formatting. This is primarily done in the XML format using specific tags:
<if>: Executes a block of code only if a condition is met.<equal>/<greater>/<less>: Comparison operators used within<if>tags.<op>: Mathematical operations (addition, subtraction, etc.).<str>: Defines a static string of text.<var>: Calls one of the variables listed in the Tags section.<num>: Defines a numerical value for comparisons.<icon>: Displays an item or block icon (e.g.,<icon>minecraft:iron_sword</icon>).
Example Logic (XML):
<if>
<greater>
<var>health</var>
<num>10</num>
</greater>
<str>{green}{health}</str>
<str>{red}{health} - WARNING!</str>
</if>
This example displays the player's health in green if it is above 10, and in red with a warning message if it is 10 or lower.
Installation and Requirements#
To function correctly, InGame Info XML requires specific environment setups:
- Minecraft Forge: Ensure the correct version of Forge is installed for 1.12.2 or 1.11.2.
- LunatriusCore: This is a mandatory dependency mod. The mod will crash on startup if this library is missing.
- Installation: Place both
InGameInfoXML.jarandLunatriusCore.jarinto themodsfolder of your Minecraft directory. - First Run: Upon the first launch, the mod will generate a default
InGameInfo.xmlfile in theconfigfolder. You can edit this file with any text editor to customize your HUD.