The Best Resource for Minecraft
The Best Resource for Minecraft

LunatriusCore Wiki

LunatriusCore is a vital library mod for Minecraft that provides shared code, utility classes, and essential GUI components required to run and stabilize all mods developed by Lunatrius.

5 sections · 647 words
← Back to LunatriusCore (1.12.2, 1.11.2) - Keep Your Modpack Stable

Overview#

LunatriusCore is a foundational library mod designed to provide a shared framework for a suite of popular utility mods. While it does not add direct gameplay content such as blocks or items on its own, it is an absolute requirement for the stability and functionality of several major mods, including Schematica and InGame Info XML. By centralizing common code, it reduces the overall footprint of individual mods and ensures that updates to core mechanics—such as configuration handling or rendering—are applied consistently across the entire ecosystem.

Key Functions

  • Shared Logic: Provides universal math and position utilities used for complex rendering in mods like Schematica.
  • GUI Components: Includes standardized numeric fields, screen wrappers, and geometry tessellators that ensure a consistent user interface across all supported mods.
  • Stability: Prevents common crashes by managing Inter-Mod Communication (IMC) and providing a robust configuration GUI that replaces the standard Forge test config.

Integrated Mods#

LunatriusCore serves as the engine for several high-profile mods. Below are the primary mods that require this core to function:

Schematica

Allows players to display a ghost image of a schematic file inside the world. This is used for rebuilding structures or exporting parts of a world into a .schematic file.

  • Features: Ghost rendering, printer mode (automatic block placement), and schematic manipulation (rotate/flip).
  • Visuals: Transparent blue-print style overlays.

InGame Info XML

A highly customizable HUD mod that displays real-time information on the screen without opening the F3 menu.

  • Customization: Uses XML, JSON, or plain text formats to define what data is shown.
  • Variables: Can display coordinates, biome, light levels, tool durability, potion effects, and more.

Monster Spawn Highlighter

Visualizes exactly where hostile mobs can spawn by placing color-coded markers on the ground.

  • Red X: Mobs can spawn here at any time.
  • Yellow X: Mobs can only spawn here at night.

Stackie

Optimizes server and client performance by automatically stacking items and experience orbs on the ground.

  • Stack Limits: Can stack items up to 127 or more (configurable).
  • Lag Reduction: Significantly reduces entity count in high-drop areas like mob farms.

DynIMC

A utility for modpack creators that allows sending custom Inter-Mod Communication messages to other mods via a simple configuration file.

Mechanics and Shared Code#

As a library, LunatriusCore introduces several technical mechanics that improve the modding environment:

Mechanic Description
MBlockPos An optimized version of the standard BlockPos class, including getAllInBox utilities for faster area scanning.
Geometry Tessellator A specialized rendering tool used to draw the lines and boxes seen in Schematica and Monster Spawn Highlighter.
Numeric Field Control An improved GUI input field that allows for precise numerical configuration within the in-game menus.
Version Checker An internal system that notifies players of updates for any Lunatrius mod upon joining a world.

Commands

While LunatriusCore itself does not add gameplay commands, it enables the command structures for its dependent mods. Common commands enabled by this core include:

  • /schematica - Accesses schematic management.
  • /igi - Controls the InGame Info HUD (e.g., /igi reload, /igi taglist).

Configuration#

The configuration for LunatriusCore is found in the config/lunatriuscore.cfg file. These settings affect the core behavior and the update notification system.

Option Default Description
checkForUpdates true Set to false to disable the update notification message when starting the game.
silenceStackTrace false If enabled, the mod will suppress full stack traces in the console for minor errors to keep logs clean.

To configure the mod in-game, navigate to the Mods button on the main menu, select LunatriusCore, and click Config.

Installation Guide#

To ensure your modpack remains stable, follow these installation steps:

  1. Install Forge: Ensure you have the correct version of Minecraft Forge installed for 1.12.2 or 1.11.2.
  2. Download Core: Place the LunatriusCore JAR file into your .minecraft/mods folder.
  3. Add Dependent Mods: Place any mods that require the core (like Schematica or Stackie) into the same mods folder.
  4. Launch: Start the game. If the core is missing, the game will display a warning screen and prevent loading to avoid a crash.
← Back to LunatriusCore (1.12.2, 1.11.2) - Keep Your Modpack Stable