Valhelsia Core Wiki

Valhelsia Core is a foundational library mod developed by the Valhelsia Team. It serves as a centralized repository of shared code, utilities, and frameworks required by all other mods in the Valhelsia suite. By consolidating common logic into a single core mod, the developers ensure better performance, easier maintenance, and consistent behavior across their entire modding ecosystem.

As a library mod, Valhelsia Core does not add traditional gameplay content such as mobs, biomes, or dimensions directly. Instead, it provides the underlying systems that allow mods like Valhelsia Structures, Valhelsia Furniture, and Valhelsia Enchanting to function. It is a strict dependency; without this core library, any mod built upon it will fail to load.

The mod introduces several backend systems that streamline mod development and improve game stability. These features are invisible to the average player but are critical for the functionality of the Valhelsia mod suite.

Registry Framework

Valhelsia Core includes a robust registry management system. This system simplifies the process of registering new blocks, items, entities, and sound events. It ensures that all Valhelsia mods follow a unified internal naming convention, reducing the risk of ID conflicts and improving compatibility with other mods.

Data Generation Utilities

The library provides advanced data generation helpers. These tools allow developers to programmatically create JSON files for recipes, loot tables, block states, and item models. This ensures that all content added by Valhelsia mods is consistent and free of manual formatting errors.

Capability Management

Valhelsia Core handles the registration and management of Forge Capabilities. This allows different mods within the ecosystem to share data seamlessly, such as energy systems, fluid handling, or custom player data, without needing to write redundant code for each individual mod.

Valhelsia Core implements a unified configuration system that allows players and server administrators to tweak the behavior of all Valhelsia-related mods from a centralized logic. The primary configuration file is located in the /config/ folder of the Minecraft installation.

Common Settings

• Debug Logging: Can be toggled to provide detailed logs for troubleshooting mod interactions.
• Feature Toggles: Allows for the global enabling or disabling of specific shared mechanics used across the Valhelsia suite.

One of the most visible features of Valhelsia Core is the management of Creative Mode tabs. Rather than cluttering the creative menu with dozens of individual tabs for every small mod, Valhelsia Core groups related items into organized, themed tabs.

• Valhelsia Blocks: A unified tab for all decorative and functional blocks from mods like Valhelsia Furniture and Valhelsia Structures.
• Valhelsia Items: A centralized location for tools, materials, and consumables added by the team's mods.

This organization makes it significantly easier for players in Creative Mode to find specific assets without searching through the entire item list.

Valhelsia Core provides the logic for several shared mechanics that appear across multiple mods. These include:

• Structure Placement Logic: Provides the mathematical framework for how structures (from Valhelsia Structures) are placed in the world, ensuring they respect biome boundaries and do not overlap excessively.
• Loot Table Functions: Adds custom functions to the Minecraft loot system, allowing for more dynamic and randomized loot in chests found within Valhelsia-generated structures.
• Recipe Conditionals: Enables "conditional recipes" that only activate if other specific mods are installed, allowing for seamless cross-mod integration without requiring manual patches.

Valhelsia Core is required for the following mods to operate. If you are using any of these, ensure that the version of Valhelsia Core matches the version required by the mod loader (Forge/NeoForge).

• Valhelsia Structures: Adds new dungeons, ruins, and buildings to the world.
• Valhelsia Furniture: Adds a wide variety of functional and decorative furniture.
• Valhelsia Enchanting: Overhauls the enchanting system with new mechanics.
• Valhelsia Tweaks: Provides various quality-of-life improvements and small gameplay changes.