SimElectricity

A Minecraft mod aiming to bring real world electrical systems into the Minecraft world

Brought to you by the Chinese Institution of Scientific Minecraft Mod (CISM)

Current Supported Version: Minecraft Forge 1.18.1

Legacy versions: Minecraft Forge 1.17.1, 1.16.5(1.16.2 to 1.16.5), 1.15.2, 1.14.4, 1.12.2, 1.11.2, 1.7.10

Addons:

1. BuildCraft Extension: Install BuildCraft facades to SimElectricity cable, already included in the SimElectricity Essential Mod.
2. ThermalExpension Extension: Install ThermalDynamics facades to SimElectricity cable, already included in the SimElectricity Essential Mod.

Setup the Environment

1. Ensure Java (found here) and Git (found here) are properly installed on your system.
2. Create a base directory for the repo (anywhere you like)
3. On Windows, open either 'CMD' or Windows PowerShell, on Linux and MacOS, launch a terminal, then navigate to the directory just created, and type the following commands:
4. git clone https://github.com/RoyalAliceAcademyOfSciences/SimElectricity
5. git submodule init and git submodule update to get LibRikka

• On Windows: use gradlew.bat instead of gradlew

Build and Test

1. Complete the steps in "Setup the Environment" section.
2. In the repo root folder, execute gradlew runData to launch the data generator, generated resource files will be located at "/src/generated"
3. If you just want to try this mod, run gradlew runClient to launch the game, otherwise skip this step.
4. Execute gradlew build to build SimElectricity.
5. Switch to the librikka directory under the repo root: cd librikka
6. Execute gradlew build again to build LibRikka jars
7. Jars files are in SimElectricity/build/libs and SimElectricity\librikka\build\libs

• The suffix of deobfuscated jars is "dev".
• __Obfuscated jars don't have any suffix, these jars are supposed to be used in normal minecraft games, copy them toyour .minecraft\mods directory __

For Developers

For API Usage, Please refer to the SimElectricity Github Wiki Pages and comments in the API source code (package simelectricity.api).

Eclipse

1. Setup the environment first (See section "Setup Environment")
2. In the SimElectricity directory execute gradlew genEclipseRuns to generate the workspace and launch configuration
3. Launch Eclipse, then Import > Existing Gradle Project > Select Folder
4. Go to Debug Configuration (Next to the debug icon), edit MOD_CLASSES in the Environment tab: Replace simelectricity%%<SomePath>\SimElectricity\bin\main;simelectricity%%<SomePath>\SimElectricity\bin\main with simelectricity%%<SomePath>\SimElectricity\bin\main;librikka%%<SomePath>\SimElectricity\librikka\bin\main.

IntelliJ IDEA

1. Setup the environment first (See section "Setup Environment")
2. Execute gradlew genIntellijRuns
3. In IDEA, import build.gradle as a gradle project

Notes

1. Advanced users only: There are two hidden gradlew tasks: energyNetDevJar and energyNetJar, which can generate Jars without the essential mod.
2. Since 1.15.2, Mojang introduces "DataGenerators", they generate json resource files such as blockstates and models. They are invoked separately. Before building or testing this Mod, you have to execute the gradle task "runData". Checkout: https://minecraft.gamepedia.com/Tutorials/Running_the_Data_Generator
3. Since 1.18.1, Minecraft requires Java 17. To specify JRE path, use './gradlew -Dorg.gradle.java.home=/path_to_jdk_directory '.

Special Thanks To:

• LibRikka - A code pack designed to simplify Minecraft Modding
• CSPARSEJ - CSparseJ is a Java port of CSparse, a Concise Sparse matrix package.
• Minecraft Forge - A Minecraft mod container and loader
• LambdaLib - A modding library that aims at making modding fluent and enjoyable.
• Also, inspired by BuildCraft and Immersive Engineering !