IGI-Addon-ProjectE (Cleanroom Edition)

简体中文 | English

🇺🇸 English

⚠️ CRITICAL RUNTIME REQUIREMENTS This mod utilizes modern Java features and DOES NOT support standard Forge 1.12.2 (Java 8). Please ensure your client meets the following environment specifications:

Core Environment: Cleanroom MC (The modern rewrite platform for 1.12.2)
Java Version: Java 21 or higher
Required Mod Dependencies: InGame Info XML & ProjectE

💡 Description

IGI-Addon-ProjectE is a client-side add-on mod specifically developed for InGame Info XML (IGI) running on the modern Cleanroom 1.12.2 stack.

It bridges the data between IGI and ProjectE (Equivalent Exchange), seamlessly injecting advanced EMC diagnostics directly onto your screen HUD with near-zero performance overhead.

✨ Features

Real-time Global Balance: View your personal Transmutation Tablet EMC balance anywhere on your screen without opening any GUI or learning terminal.
Smart Standard Notation Formatting: Automatically shortens astronomically large EMC numbers into clean, human-readable notation like K, M, B, and T (e.g., 1,250,000 becomes 1.25M).
True EMC/s Delta Tracker: Implements a precise 1000ms rolling window algorithm to compute the true change rate of your EMC per second. This completely solves data/HUD de-sync issues, providing smooth updates for positive, negative, or stagnant rates.
Held Item Detection: Instantly fetches and displays the base individual EMC value of whatever item you are currently holding in your main hand—perfect for analyzing automation lines.

🏷️ Custom Tags List

Once installed, use the following custom tokens in your IGI text layout via the standard {tagname} placeholder syntax:

Tag Name	Registry ID	Output Example	Description
`{peplayeremc}`	`peplayeremc`	`1254300`	Raw numeric balance of player's Transmutation Tablet EMC.
`{peplayeremcfmt}`	`peplayeremcfmt`	`1.25M`	Formatted/shortened balance of player's Transmutation Tablet EMC.
`{peemcdelta}`	`peemcdelta`	`+5000/s` or `-200/s`	Raw numeric EMC fluctuation rate per second.
`{peemcdeltafmt}`	`peemcdeltafmt`	`+1.50M/s` or `0/s`	Formatted/shortened EMC fluctuation rate per second.
`{peitememc}`	`peitememc`	`64`	The single-unit EMC value of the item held in your main hand.

⚙️ Example Configuration (`InGameInfo.xml`)

Below is an implementation example matching your InGameInfo.xml configuration (where formatting codes like $e, $b, and $a represent IGI colors):

<?xml version="1.0" encoding="UTF-8"?>
<config>
    <lines at="topleft">
        <line>
            <str>Day {day}, {mctime} (</str>
            <if>
                <var>daytime</var>
                <str>$eDay</str>
                <str>$8Night</str>
            </if>
            <str> time$f)</str>
        </line>

        <line>
            <str>Transmutation Tablet EMC (Formatted): $e{peplayeremcfmt}</str>
        </line>
        <line>
            <str>Transmutation Tablet EMC (Raw): $6{peplayeremc}</str>
        </line>

        <line>
            <str>EMC Delta Rate (Formatted): $b{peemcdeltafmt}</str>
        </line>
        <line>
            <str>EMC Delta Rate (Raw): $3{peemcdelta}</str>
        </line>

        <line>
            <str>Main Hand Item EMC: $a{peitememc}</str>
        </line>
    </lines>
</config>

🇨🇳 简体中文

⚠️ 重要运行环境要求 本模组利用了现代开发特性，不支持传统的 Forge 1.12.2 (Java 8) 环境。请确保你的客户端满足以下条件：

核心环境：Cleanroom MC (基于 1.12.2 的现代化重构架构)
Java 版本：Java 21 或更高版本
依赖模组：InGame Info XML & ProjectE

💡 模组简介

IGI-Addon-ProjectE 是一个专为 Cleanroom 1.12.2 环境打造的 InGame Info XML (IGI) 实时屏幕 HUD 扩展插件。

它打通了 IGI 与 ProjectE (等价交换) 的数据接口，让你无需频繁打开转化桌或检测终端，就能直接在主屏幕上以极低的性能开销、极其精准的速率监控各项 EMC 数据流。

✨ 核心特性

实时全局余额显示：在屏幕任意位置直观查看个人当前的 EMC 总蓄积量。
智能单位换算（计数法）：自动将天文数字般的 EMC 缩写为更易读的 K、M、B、T（例如 1,250,000 自动显示为 1.25M）。
True EMC/s 瞬时速率追踪：核心采用每秒固定滚动窗口算法 (1000ms Rolling Window)，完美解决 HUD 刷新率与数据同步不同步的痛点。精准展现每秒 EMC 的真实增长或消耗速率（支持正负数、零变动平滑平滑显示，绝不闪烁）。
手持物品检测：实时获取并显示你当前主手上拿着的物品的单体 EMC 价值，方便量化生产线。

🏷️ 标签列表 (Tags)

成功安装本模组后，你可以在 IGI 的配置文件中直接通过 {标签名} 的方式调用以下新增加的标签：

标签名称	对应代码名称	输出示例	说明
`{peplayeremc}`	`peplayeremc`	`1254300`	显示玩家个人转化桌内的 EMC 原始数字
`{peplayeremcfmt}`	`peplayeremcfmt`	`1.25M`	个人 EMC 总量（带单位格式化简写）
`{peemcdelta}`	`peemcdelta`	`+5000/s` 或 `-200/s`	EMC 实时每秒变动速率（原始数字）
`{peemcdeltafmt}`	`peemcdeltafmt`	`+1.50M/s` 或 `0/s`	EMC 实时每秒变动速率（带单位格式化简写）
`{peitememc}`	`peitememc`	`64`	玩家当前主手所持物品的单体 EMC 值

⚙️ 配置文件配置示例 (`InGameInfo.xml`)

你可以直接将以下配置整合进你的 InGameInfo.xml 全局配置文件中（其中 $e、$6 等为 IGI 特有的文本颜色样式代码）：

<?xml version="1.0" encoding="UTF-8"?>
<config>
    <lines at="topleft">
        <line>
            <str>Day {day}, {mctime} (</str>
            <if>
                <var>daytime</var>
                <str>$eDay</str>
                <str>$8Night</str>
            </if>
            <str> time$f)</str>
        </line>

        <line>
            <str>转化桌EMC (简写): $e{peplayeremcfmt}</str>
        </line>
        <line>
            <str>转化桌EMC (数值): $6{peplayeremc}</str>
        </line>

        <line>
            <str>EMC实时变化 (简写): $b{peemcdeltafmt}</str>
        </line>
        <line>
            <str>EMC实时变化 (数值): $3{peemcdelta}</str>
        </line>

        <line>
            <str>手上物品EMC: $a{peitememc}</str>
        </line>
    </lines>
</config>

InGame Info XML Addon - ProjectE