Overview#
Wumple Util Library is a specialized backend framework and dependency mod developed by Stormwind99. Designed for Minecraft versions 1.12.2 and 1.14.4, this library serves as the technical backbone for a wide array of gameplay-enhancing mods. It does not add any visible content to the game when installed alone; instead, it provides a collection of optimized classes and functions that reduce code duplication and improve performance across the developer's entire mod suite.
By centralizing complex logic—such as map manipulation, NBT handling, and custom GUI rendering—Wumple Util Library ensures that all dependent mods operate with a consistent and stable foundation. It is a mandatory requirement for players looking to use mods like Food Funk, Mega Map, or Web Slinger.
Core Technical Features#
The library includes several advanced systems that allow other mods to interact with Minecraft's engine more efficiently. Below are the primary technical components included in the library:
MatchingConfig System
This system allows mods to be highly configurable. It enables users to define specific items, blocks, or entities in configuration files using standardized strings or tags. This is used extensively in mods that need to identify specific objects, such as defining which containers can preserve food or which mobs should receive new AI tasks.
The IThing Adapter
IThing is a unique interface provided by the library that creates a unified wrapper for ItemStack, Entity, and TileEntity instances. This allows developers to write code that can interact with any of these three types through a single set of functions, greatly simplifying complex interactions between items and the world.
BaseChest Framework
A specialized class derived from the vanilla Minecraft chest. It provides a pre-built template for creating new types of storage blocks with custom inventories, rendering, and logic without having to rewrite the base chest code from scratch.
BlockRepair Library
Derived from Corosus' CoroUtil, this feature provides the logic necessary for blocks to "heal" or revert to their original state over time. This is often used in environmental mods where world damage needs to be temporary.
Dependent Mods Ecosystem#
Wumple Util Library is the prerequisite for the following mods. Each of these mods utilizes the library's functions to provide their unique gameplay features:
| Mod Name | Primary Function | Library Usage |
|---|---|---|
| Food Funk | Adds food spoilage and preservation mechanics. | Uses MatchingConfig for rot timers and IThing for item handling. |
| Mega Map | Allows for extreme map zoom scales (1:32 and higher). | Utilizes the Map Manipulation Library for coordinate scaling. |
| Web Slinger | Gives spiders the ability to shoot webbing at players. | Uses the AI Task library and custom entity networking. |
| Canny Composter | Expands the list of items that can be composted. | Uses MatchingConfig to allow user-defined compostables. |
| Pantography | Allows copying map data between different scales. | Relies on the library's NBT and Map data handlers. |
| Daring Debug | Displays advanced TileEntity and Tag info in the F3 screen. | Uses the library's proxy and capability listener classes. |
| Flourishing Foliage | Causes tree leaves to regrow if the trunk is left intact. | Uses the BlockRepair logic for environmental regrowth. |
Items, Blocks, and Mobs#
As a Library Mod, Wumple Util does not add any standalone items, blocks, or mobs to the Creative Menu or the game world. Its purpose is to provide the "logic" that other mods use to create those elements.
- Items: The library provides the
IThinginterface to handle ItemStacks but adds no items of its own. - Blocks: The library provides the
BaseChestclass for creating blocks but adds no blocks of its own. - Mobs: The library provides AI tasks (like the
AIWebbingAttackused by spiders) but does not register new entities.
If you are looking for new content, ensure you have installed the specific Stormwind mods that depend on this library.
Mechanics and Logic#
The library functions through several background mechanics that improve the modded experience:
- Map Manipulation: It contains specialized math for translating world coordinates into map pixels, which is essential for any mod that alters the way Minecraft's built-in Map items function.
- Proxy Handling: It includes Client/Server proxy base classes (derived from Choonster's TestMod3) that ensure mod code runs correctly on both single-player worlds and dedicated servers without crashing.
- Capability Listeners: It provides a framework for "Capabilities" (Forge's system for attaching data to objects). This allows mods to attach new data—like a "freshness" value for food—to existing vanilla items without modifying the vanilla code directly.
Configuration#
While Wumple Util Library has its own configuration file, it is primarily used for internal debugging or global toggles for the library's sub-systems. Most configuration will be done within the individual mods that require this library.
In version 1.14.4, the library leverages the Forge Config system to allow for real-time updates to MatchingConfig lists, meaning players can often change which items are affected by dependent mods without needing to restart the entire game.
