KubeJS ProjectE: Scriptable EMC and Transmutation Control
For modpack developers and server administrators seeking absolute control over game economics, this add-on provides a robust bridge between the scripting power of KubeJS and the alchemical mechanics of ProjectE. Instead of relying on static configuration files or editing source code, users can define complex transmutation rules and energy values using JavaScript. This tool is essential for creating balanced, unique gameplay experiences where standard item values do not fit the intended progression curve.
Core Capabilities and Economic Control
The primary function of this extension is to allow precise manipulation of Energy-Matter Covalence (EMC) values. Developers can set absolute EMC figures that remain fixed regardless of recipe changes, ensuring specific items always hold a defined worth. Alternatively, the system supports setting values before the automatic calculation phase begins. This feature is critical for establishing base materials that drive dynamic recipe trees, allowing the game to recalculate dependent items based on your custom starting points.
Beyond simple value assignment, the add-on enables direct interaction with player data. Scripts can retrieve, add, or overwrite a player's personal EMC balance instantly. This capability opens doors for custom quest rewards, tutorial mechanisms, or specialized currency systems integrated directly into the alchemy workflow. Furthermore, it facilitates world transmutations, allowing players to convert blocks in the game world instantly using the Philosopher's Stone, extending the mod's utility beyond inventory management.
Implementation and Scripting Logic
All server-side logic regarding EMC adjustments resides within the server_scripts directory of your KubeJS instance. A common scenario involves neutralizing the value of abundant resources like cobblestone to prevent infinite farming loops while assigning high value to specific crafting components like sticks. The syntax distinguishes between hard-setting a value and defining a baseline for calculation. Using the pre-calculation method ensures that downstream recipes update automatically, maintaining a living economy rather than a static list.
Interactive elements can be added through event listeners. For instance, right-clicking an item can trigger a script that displays the user's current balance and awards additional EMC. Since EMC numbers can reach astronomical figures, the system handles inputs as both integers and strings to prevent overflow errors. This flexibility allows for seamless integration with custom block interfaces or achievement triggers without compromising performance.
Installation and Version Compatibility
To utilize these features effectively, your environment must include the core KubeJS mod, the ProjectE mod, and this specific add-on. All three components must be placed in the mods folder of your client or server installation. When you search to download KubeJS ProjectE: Scriptable EMC and Transmutation Control, ensure you select the build matching your target game version. This add-on is currently optimized for modern Minecraft versions supporting the Forge and NeoForge loaders, typically ranging from 1.18 through the latest releases.
For those asking how to install this complex stack without manual errors, using a dedicated launcher can streamline the process. These tools automate dependency resolution and file placement, significantly reducing setup time for large modpacks. Upon first launch, KubeJS generates the necessary folder structure. Users should place their custom scripts in the designated directories and reload the environment using the appropriate command or by restarting the world to activate the new economic rules.
Balancing and Best Practices
When designing custom economies, caution is required to avoid circular logic. Assigning excessively high values to base resources while providing cheap conversion recipes can create infinite EMC generators, breaking the game balance. It is advisable to test all transmutation chains in a single-player environment before deploying to a public server. Additionally, while pre-calculation settings are powerful, they may be overridden if the system detects conflicts; in such cases, absolute setting methods provide the necessary finality.
Debugging is simplified by incorporating chat messages that report real-time values to players, confirming that scripts execute as intended. By combining the scriptable flexibility of KubeJS with the deep alchemical systems of ProjectE, creators can craft entirely new gameplay loops. Whether building a hardcore survival experience with stripped-down resources or a magic-focused pack with inflated material costs, this add-on delivers the precision needed for professional-grade modpacks.