The Best Resource for Minecraft
The Best Resource for Minecraft

InGame Info XML Mod 1.12.2, Wiki

InGame Info XML is a highly customizable HUD mod for Minecraft that allows players to display real-time information such as coordinates, player stats, world data, and technical metrics directly on the screen using XML, JSON, or Text configuration files.

6 sections · 817 words

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).

Custom HUD display showing coordinates and biome

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.

The IGI Taglist GUI showing available variables

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).

HUD showing technical data and armor durability

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:

  1. Minecraft Forge: Ensure the correct version of Forge is installed for 1.12.2 or 1.11.2.
  2. LunatriusCore: This is a mandatory dependency mod. The mod will crash on startup if this library is missing.
  3. Installation: Place both InGameInfoXML.jar and LunatriusCore.jar into the mods folder of your Minecraft directory.
  4. First Run: Upon the first launch, the mod will generate a default InGameInfo.xml file in the config folder. You can edit this file with any text editor to customize your HUD.