Understanding the Judgment API for Minecraft
Minecraft modding has evolved into a sprawling ecosystem of creativity, where tools and APIs empower players and pack makers to shape their own experiences. Among these, the Judgment API stands out as a specialized instrument for those who love the mystical depths of Thaumcraft and the precision of MineTweaker scripting. If you have ever wanted to gate research behind specific in-game discoveries, this API delivers exactly that power in a clean, standalone package.
What Is the Judgment API?
At its core, the Judgment API replicates the research trigger system originally designed for the Forgotten Relics addon. It provides a framework where certain knowledge remains hidden until a player scans particular items with a thaumometer. The twist is that the API ships with an initially empty list of forgotten knowledge, handing you the reins to populate it with your own custom entries. This means you can craft unique progression paths, secret discoveries, and personalized challenges without being tied to the content of another mod.
The API functions independently, so you do not need Forgotten Relics installed to use its mechanics. However, it also coexists peacefully alongside that addon, maintaining two completely separate lists of forgotten research that never intersect. This dual compatibility opens up fascinating possibilities for modpack designers who want layered mystery systems.
Key Mechanics and Research Triggers
The heart of the Judgment API lies in its revelation system. When a player scans the required items, the Justice Handler unlocks the corresponding research and delivers a notification. By default, this notification mirrors the one found in Forgotten Relics, but you have full freedom to customize it. The system checks against a configurable probability and frequency, ensuring that revelations feel organic rather than guaranteed on every scan.
Here is how the core mechanics break down:
- Scan-based unlocking: Research becomes available only after specific items are scanned with a thaumometer.
- Separate knowledge lists: Judgment API and Forgotten Relics maintain entirely independent forgotten research pools.
- Configurable revelation rates: Adjust how often and how likely new knowledge appears through the config file.
- Custom notifications: Edit the unlock message via .lang files or MineTweaker's localization methods.
MineTweaker Integration and Scripting
For those comfortable with MineTweaker scripts, the Judgment API slots in with minimal friction. The only notable difference from Forgotten Relics scripting is the method declaration. Instead of calling mods.forgottenrelics, you use mods.judgmentapi in your scripts. This small syntax change keeps the two systems cleanly separated while preserving identical functionality in every other aspect.
To retrieve the list of forgotten knowledge researches managed exclusively by the API, you can use the command /minetweaker forgottenKnowledgeAPI. This command gives you a clear overview of what the API handles, making debugging and planning far easier when you are juggling multiple custom research trees.
Configuration and Customization Options
The Judgment API includes its own config file where you can fine-tune the frequency and probability of revelations. This level of control lets you decide whether forgotten knowledge appears frequently as a gentle nudge or rarely as a momentous event. The notification that players receive upon unlocking new research is initially identical to the Forgotten Relics version, but you can modify it by editing the .lang file or using game.setLocalization() in MineTweaker to localize the judgementapi.unlock_notification string. This flexibility ensures the API fits seamlessly into any modpack's narrative tone.
Using Judgment API Alongside Forgotten Relics
One of the most intriguing aspects of the Judgment API is its ability to run concurrently with Forgotten Relics. If you want two distinct sets of forgotten knowledge that operate under separate rules and never cross-contaminate, this combination is ideal. The API's research list remains walled off from the addon's list, and each responds only to its own triggers. This design philosophy gives modpack creators a dual-layered mystery system, where players might uncover secrets from one source while remaining oblivious to the other until they explore further.
When building a modpack that leverages both systems, many creators find that using a modern launcher streamlines the entire process. The foxygame.net launcher, for instance, offers a convenient way to install mods directly from its menu, making it simple to add the Judgment API and its dependencies without manual file hunting. Its flexible interface keeps your mod list organized and up to date, which is especially helpful when you are experimenting with custom MineTweaker scripts and multiple research trees.
Why the Judgment API Matters for Modpack Design
The creator of the Judgment API once reflected that years ago, when first exploring MineTweaker and ModTweaker, the inability to lock research behind specific item scans felt like a glaring omission. The idea was deceptively simple: create a research node and make it accessible only after a player has examined certain objects with a thaumometer. Yet the tools of the time did not support this cleanly. The Judgment API finally corrects that limitation, offering a dedicated system that respects both player discovery and pack maker intent.
This API is not just a technical tool; it is an invitation to craft richer narratives. You can hide forbidden knowledge behind rare artifacts, gate powerful abilities behind exploration milestones, or weave entire story arcs that unfold only when players demonstrate curiosity. The empty starting list of forgotten knowledge is a blank canvas, and the configurable revelation rates let you pace the experience precisely.
Getting Started with Judgment API
Integrating the Judgment API into your modpack follows a straightforward path. First, ensure you have the required dependencies, including MineTweaker and Thaumcraft. Then, drop the API into your mods folder and begin scripting your custom research triggers using the mods.judgmentapi method. Test your triggers in a creative world, adjusting the config file until the revelation frequency feels right. Finally, customize the unlock notification to match your pack's theme, whether that means ominous whispers or scholarly announcements.
The API is completely free to use in any modpack, and its lightweight nature means it adds negligible overhead while unlocking enormous creative potential. Whether you are building a small private pack for friends or a large public release, the Judgment API provides a reliable foundation for scan-based research gating.
Final Thoughts
The Judgment API fills a niche that long-time Thaumcraft enthusiasts and modpack makers have desired for years. By decoupling the research trigger system from Forgotten Relics and offering it as a standalone tool, it empowers creators to design their own forgotten knowledge without compromise. The clean MineTweaker integration, separate research lists, and configurable revelation mechanics make it both powerful and approachable. If you have ever wanted to reward player curiosity with hidden discoveries, this API is the key to unlocking that experience in your Minecraft world.