Portalgems

The Portalgems mod introduces compact handheld teleporters called "Gems" to Minecraft, allowing instant travel between dimensions. Full customization is available through datapacks.

Configuration and Creation

Creating Custom Gems

To add your own unique Gem, create corresponding crafting recipes:

{
  "type": "minecraft:crafting_shaped",
  "category": "misc",
  "key": {
    "G": {
      "item": "minecraft:gold_ingot"
    },
    "S": {
      "item": "minecraft:yellow_stained_glass_pane"
    }
  },
  "pattern": [
    " G ",
    "GSG",
    " G "
  ],
  "result": {
    "components": {
      "portalgems:destination": {
        "color": "#FFCFFF00",
        "dimension": "minecraft:the_end",
        "position": [
          0,
          80,
          0
        ]
      }
    },
    "count": 1,
    "id": "portalgems:gem"
  }
}

You can use any recipe type, not necessarily grid-based crafting.

Crucial point: the most important part is the results section. This is where teleportation parameters are configured. Within the components/portalgems:destination block, three parameters are available:

• color: color tint of the Gem's center in ARGB format (required parameter)
• dimension: dimension ID for teleportation (required parameter)
• position: exact destination coordinates in the specified dimension (optional parameter)

Important: if destination coordinates are not specified, the Gem will attempt to teleport you in a manner similar to chorus fruit, but between dimensions. This might result in no valid position being found. In such cases, moving in any direction to find a suitable location is recommended.

Configuration (Work in Progress)

The following settings are configurable:

• cooldown: Gem cooldown time in ticks
• twoway: ability to use Gem in its target dimension (e.g., using Nether Gem in the Nether) to return to the Overworld

Known Issues

• Occasional teleportation failure

  • Possible causes:
  • Dimension missing on server
  • Dimension not loaded on server
  • No suitable destination found (see above)

• Teleportation into caves despite starting from high positions

  • Mechanism:
  • System selects random offset relative to current position in target dimension
  • Then checks each Y level below that point until valid location is found
  • Process repeats several times if unsuccessful