Ponder Overrides: Custom Ponder Scenes via KubeJS
When building a modpack around Create, you often rely on Ponder scenes to teach players how your custom machines work. But the default system ties scenes to block IDs, ignoring NBT data. This becomes a problem when a single block type has multiple variants distinguished only by tags. Ponder Overrides: Custom Ponder Scenes via KubeJS solves this by letting you intercept and redirect Ponder scene selection on the client side, ensuring players always see the correct tutorial for the exact item they hold.
Why You Need Ponder Overrides in Your Modpack
Create's Ponder is a brilliant interactive guide, but it was designed for standard blocks. In complex modpacks, you might have a machine that looks identical in the inventory but behaves differently based on NBT—think of tiered factory components or multi-state devices. Without an override, the game shows a generic or wrong scene, confusing players. This addon bridges Create and KubeJS, giving pack developers full control over which Ponder scene loads for any given item or context. It was originally built for packs like Create: Astral, where clear progression through Ponder is essential, but it fits any setup where NBT-driven logic matters.
How the Override System Works
The mod operates through a client-side KubeJS script, typically placed in client_scripts/ponder.js. You listen for the ponder.override event and use its API to make decisions. The key methods are:
- event.getItem() – returns the ItemStack that triggered the Ponder. You can inspect its NBT to differentiate variants.
- event.getTag() – provides an optional context tag, useful when the scene is opened from the Ponder UI rather than an item.
- event.override("namespace:ponder_id") – explicitly sets which scene to display. If you don't call this, the default Create behavior remains.
For example, if you have three versions of a "precision assembler" all sharing one block ID, your script checks the item's NBT and routes the player to the appropriate assembly tutorial. This avoids duplicating blocks just to get the right Ponder scene.
Installation and Compatibility
To download Ponder Overrides: Custom Ponder Scenes via KubeJS, you need a mod loader that supports both Create and KubeJS. The addon is built for Forge and has been tested on Minecraft versions 1.18.2, 1.19.2, and 1.20.1. Always match the mod version to your Create and KubeJS releases. Installation is straightforward: place the JAR in your mods folder alongside its dependencies. Many launchers, such as foxygame, let you add it directly from their mod browser, streamlining the process for stable modpack assemblies. After installing, create or edit your KubeJS client scripts to define overrides—no additional configuration files are needed.
Best Practices for Reliable Overrides
To keep your client scripts maintainable, follow a few guidelines. First, check the most specific NBT conditions early and fall back to defaults later. This prevents unexpected scene mismatches. Second, name your custom Ponder scenes consistently (e.g., mymod:assembler_tier1, mymod:assembler_tier2) so you can quickly update them when mod versions change. Third, test overrides from multiple entry points: the player's inventory, JEI/REI menus, and the dedicated Ponder UI. The getTag() method may return null in some contexts, so always have a fallback plan. Finally, document your override rules for your modpack team—this saves hours when debugging progression issues.
When to Use Ponder Overrides
This addon is not for every pack. If your Create machines all have unique block IDs, the default Ponder system works fine. But if you're pushing the limits with NBT-customized devices, multi-variant blocks, or deep tech trees where a single block evolves through upgrades, Ponder Overrides: Custom Ponder Scenes via KubeJS for Minecraft becomes indispensable. It restores clarity to in-game tutorials without bloating your block registry. The combination of KubeJS scripting and the ponder.override event gives you surgical control, making Ponder a reliable guide from early automation to endgame factories.
By integrating this tool, you ensure that every player interaction with a machine reveals the right mechanics. Download Ponder Overrides: Custom Ponder Scenes via KubeJS today and give your modpack the polished, intuitive guidance it deserves.