Portalgems

A minecraft mod adding simple handheld teleporters (called Gem) to easily switch dimensions. It is fully datapack customizable.

Customization

Adding custom Gems

To add your own gem, create a recipe for it like this:

{
  "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 the recipe types you want, it does not have to be shaped.

Important: the relevant Part is the results. That's where the customizations comes in. Inside the components/portalgems:destination part you see three fields:

color: The desired tint color of the gem in the middle in ARGB (required)
dimension: The dimension id to teleport into (required)
position: The exact position to teleport to in the specified dimension (optional)

Note that if you don't set the position the gem will try to teleport to the other dimension like a chorus fruit would but just interdimensionally. This can lead to it not finding a valid position. In that case try to move a bit in any direction so it can find a valid target position

Config (WIP)

The following is configurable:

cooldown: The cooldown of gems in ticks
twoway: If using any gem in it's dimension (e.g. Using the nether gem in the nether) should teleport you back to the overworld

Known Bugs / Problems

Sometimes not teleporting
- Possible causes:
- Server doesn't have dimension
- Server hasn't loaded the dimension
- No valid target position found (see above)
Teleporting in caves although your start position was much higher
- Possible causes:
- The way we find a target position is by choosing a random offset added to your current position in the target dimension. After choosing that we test every y level below that until we find a valid spot (If the chosen offset didn't work, we repeat it a couple more times)