Set up your machine
Install the tools, point IntelliJ IDEA at the installed JDK, and add your repository credentials.
Do this once per machine, before working on any Forge project.
Install the tools
Forge has been tested with IntelliJ IDEA. Gradle is IDE-agnostic, so any IDE should work. If
you use VS Code, define a GRADLE_HOME environment variable pointing at ~/.gradle.
- Install Git.
- Install IntelliJ IDEA Community Edition.
- Point IntelliJ IDEA at your Git installation in its settings.
- Configure the GitHub connection to https://github.com/.
Point IntelliJ IDEA at the installed JDK
Forge runs every Java task on the JDK that installJdk installs for resource.mdVersionMin, so a
build needs no JDK setting on the machine. Install CATIA Magic covers that
task.
IntelliJ IDEA usually selects that JDK as the project SDK after the Gradle sync. When the project SDK
names a different JDK, set it under File → Project Structure → SDKs to the directory installJdk
reports, such as ~/.mbseconsulting-forge/jdk/2026x-refresh1-21.0.10+7. The editor analyses code with
the project SDK; the build ignores it.
The JDK matrix records which JDK each CATIA Magic version needs.
Add your repository credentials
Credentials belong in your user-home Gradle properties, not in a project. Create the file if it does not exist:
- Windows:
C:\Users\<you>\.gradle\gradle.properties - Linux and macOS:
~/.gradle/gradle.properties
com.mbseconsulting.forge.credentials.username=mark-s
com.mbseconsulting.forge.credentials.password=mark0-holly1-dylan2-irvin3Skip this step if you host your artifacts locally.
Next
Continue with Your first resource.