Overview#
ValkyrieLib is a core library mod required for all of ValkyrieofNight's (and Team Kryptic Link's) Minecraft modifications. It does not add extensive content on its own but provides the underlying framework for complex multiblock machines, energy systems, and data-driven mechanics used in its dependent mods.
Key features include:
- Unified Documentation: A single item to access guides for all installed ValkyrieofNight mods.
- Advanced Recipe System: A custom JSON-based system for handling items, fluids, and machine upgrades.
- Shared Components: Common items used across multiple mods for balancing and progression.
Items#
While primarily a library, ValkyrieLib adds several items that are critical for progression in its dependent mods.
Digital Guide
The Digital Guide is the primary documentation tool. It dynamically updates its content based on which ValkyrieofNight mods are currently installed in the instance. By default, it is granted to the player upon their first spawn in a new world.
- Properties: Non-consumable, GUI-based.
- Usage: Right-click to open the interface. It features a searchable index and categorized chapters for machines, items, and mechanics.
Modifier Component
A base crafting ingredient used in the construction of various machine modifiers. It represents the basic circuitry required for machine enhancement.
Speed Modifier
A specific upgrade item used primarily in Simple Generators and Environmental Tech machines.
| Attribute | Value |
|---|---|
| Type | Machine Upgrade |
| Effect | Increases processing speed / RF generation |
| Stack Size | 64 |
Flight Speed Modifier
An advanced modifier crafted using Speed Modifiers, typically used in late-game equipment or environmental controllers to enhance player movement speed while flying.
Mechanics & Recipe System#
ValkyrieLib introduces a specialized datapack convention that allows modpack developers and players to highly customize mod behavior.
Datapack Recipe Types
The mod uses a unique syntax for defining items and fluids within its JSON recipes to ensure compatibility and flexibility.
- Item Type: Defined using the
raw:itemkey."input": { "raw:item": "minecraft:iron_ingot" } - Fluid Type: Defined using the
raw:fluidkey, allowing for precise fluid amounts in machine recipes."input": { "raw:fluid": "minecraft:water", "amount": 1000 }
Overriding Recipes
Players can override or disable any recipe that utilizes the ValkyrieLib system by placing a JSON file with the same name in their world's datapack folder. Setting the result count to 0 or omitting the result entirely will effectively disable the recipe.
Configuration#
Configuration for ValkyrieLib is typically found in the /config folder of the Minecraft directory, usually named valkyrielib-common.toml (for 1.19.2 and 1.20.1).
| Option | Default | Description |
|---|---|---|
spawn_guide |
true |
Whether the Digital Guide is automatically given to new players. |
enable_debug |
false |
Enables advanced logging for recipe loading and data syncing. |
In newer versions, some configuration options may be moved to the server-side config within the world save folder to ensure synchronization between clients and servers in multiplayer environments.
Supported Mods#
ValkyrieLib is a mandatory dependency for the following mods:
- Environmental Tech: A massive multiblock-focused mod for resource mining and energy generation.
- Simple Generators: A collection of single-block power generators that can be upgraded with ValkyrieLib modifiers.
- Simple Chunk Loaders: Efficient chunk loading solutions.
- Environmental Core: Shared assets and mechanics for the Environmental series.