Skip to content

Getting started

Riccardo Chimisso edited this page Nov 14, 2025 · 10 revisions

Add as a dependency

Since Server Sided Portals is built on a MultiLoader environment, you can depend on it regardless of whether you use a MultiLoader environment too or not.

Note that you don't need any of the following if you only intend to use this mod through datapacks.

Note: if you're not using a MultiLoader environment, the root build.gradle and the loader-specific build.gradle are the same, and you don't need Server Sided Portals common module.

Add required Maven repositories

In your root build.gradle add the following repositories:

repositories {
  // Crystal Nest repository where Server Sided Portals is hosted.
  exclusiveContent {
    forRepository {
      maven {
        name = "Crystal Nest"
        url = "https://maven.crystalnest.it"
      }
    }
    filter {
      includeGroup "it.crystalnest"
    }
  }
}

Specify Server Sided Portals version

In your gradle.properties add this line:

server_sided_portals_version = 2.2.0

Make sure to point to the latest version for the specific Minecraft version.

Import Server Sided Portals common module

In your common build.gradle add the following dependency:

dependencies {
  implementation "it.crystalnest:server-sided-portals-common:$minecraft_version-$server_sided_portals_version"
}

Import Server Sided Portals loader-specific modules

Fabric

In your fabric build.gradle add the following dependency:

dependencies {
  modImplementation "it.crystalnest:server-sided-portals-fabric:$minecraft_version-$server_sided_portals_version"
}
NeoForge

In your neoforge build.gradle add the following dependency:

dependencies {
  implementation "it.crystalnest:server-sided-portals-neoforge:$minecraft_version-$server_sided_portals_version"
}
The NeoForge module is available since version 1.20.2.
Forge

In your forge build.gradle add the following dependency:

dependencies {
  // Forge deobfuscation strips dependencies, so you need to import Cobweb too. If missing, add the version property and set it to the latest version
  implementation fg.deobf("it.crystalnest:cobweb-forge:$minecraft_version-$cobweb_version")
  implementation fg.deobf("it.crystalnest:server-sided-portals-forge:$minecraft_version-$server_sided_portals_version")
}
The Forge module is unavailable since version 1.21.

Declare Server Sided Portals dependency

Depending on the mod loader, you need to declare Server Sided Portals dependency in different ways.

Fabric

In your fabric.mods.json add the following dependency:

"depends": {
  "server_sided_portals_version": "^${server_sided_portals_version}"
}
NeoForge

In your mods.toml (neoforge.mods.toml since 1.20.5) add the following dependency:

[[dependencies.${mod_id}]]
  modId = "server_sided_portals_version"
  # Change this field to use Forge syntax if on 1.20.2
  type = "required"
  versionRange = "[${server_sided_portals_version},)"
  ordering = "AFTER"
  side = "BOTH"
Forge

In your mods.toml add the following dependency:

[[dependencies.${mod_id}]]
  modId = "server_sided_portals_version"
  mandatory = true
  versionRange = "[${server_sided_portals_version},)"
  ordering = "AFTER"
  side = "BOTH"