Forge
How-to guides

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.

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-irvin3

Skip this step if you host your artifacts locally.

Next

Continue with Your first resource.

On this page