Portalgems: Handheld Teleporters for Minecraft Dimensions

Craft Portalgems to hop between dimensions in Minecraft with handheld teleporters. Fully datapack customizable gems for your next adventure.

Download portalgems for Minecraft 1.21.1

Original name: portalgems

Minecraft: 1.21.1

Loaders: NeoForge

FileVersionLoaderSize
portalgems-0.1.jar1.21.1NeoForge33 КБDownload
portalgems-0.2.jar1.21.1NeoForge33 КБDownload
portalgems-1.0.1.jar1.21.1NeoForge33 КБDownload

Portalgems

Getting between dimensions in Minecraft usually means building a nether portal, hunting down a stronghold, or chewing through a stack of chorus fruit. Portalgems throws all of that out the window by giving you a simple handheld teleporter you can craft, tint, and customize. Whether you are a survival player tired of portal maintenance or a map maker who wants precise travel points, this mod earns its inventory slot.

What Portalgems Actually Does

At its core, Portalgems adds a single item: the Gem. Use one and you are instantly sent to a linked dimension, no portal frame required. Each gem carries a destination inside its data, which means a single item can point to the End, the Nether, or anywhere else you define. The middle of the gem even takes on a custom tint color so you can tell your travel stones apart at a glance.

If a gem has no fixed position set, it behaves like a chorus fruit, except it works across dimensions. That means it searches for a safe landing spot near where you stand, translated into the target world. It is a small detail, but it makes exploration feel fluid rather than scripted.

Supported Versions and Loaders

Portalgems is built for modern Minecraft, with support centered on recent 1.20.x and 1.21.x releases. It runs on the Fabric loader, so you will need Fabric API installed alongside it. Always check the version list on the project page before you download Portalgems, since data component syntax changed between updates and older builds may not match your game version.

Customizing Your Gems With Datapacks

The real depth here is customization. Every gem's destination lives in its recipe result, inside the portalgems:destination component. That means you can create entirely new travel stones with nothing more than a datapack, no Java knowledge required.

The Three Destination Fields

  • color — the ARGB tint applied to the gem's center. Required.
  • dimension — the dimension ID the gem teleports into, such as minecraft:the_end. Required.
  • position — the exact coordinates to land on. Optional; leave it out and the gem picks a spot dynamically.

You can use any recipe type you like, shaped or shapeless. The important part is the result block, not the pattern. A quick example: a shaped recipe using gold ingots and yellow stained glass panes that outputs a gem with a golden tint and a fixed End destination. Swap the color value and dimension ID and you have a brand new travel item in minutes.

If you would rather skip manual file editing, the foxygame.net launcher bundles Portalgems in its add-on catalog, so you can install it in one click and let it handle version matching and updates automatically.

Config Options and Known Quirks

A config file (still marked work in progress) lets you tweak two things. The cooldown setting controls how many ticks pass between gem uses, and twoway decides whether using a gem inside its own dimension sends you back to the Overworld. That second option is handy for quick return trips.

When Teleporting Fails

Occasionally a gem will not fire. The usual suspects are a server missing the target dimension, a dimension that has not loaded yet, or no valid landing position being found. Because the mod picks a random offset from your current coordinates and then scans downward for solid ground, cave landings can happen even when you started high up. Nudging your position a block or two usually fixes a failed search.

How to Install Portalgems for Minecraft

Setup is straightforward. Install Fabric for your game version, drop Fabric API and the Portalgems jar into your mods folder, then launch. If you plan to use custom gems, place your datapack in the world's datapacks folder and run /reload. For multiplayer, remember that the mod must be on the server, and clients need it too.

Portalgems is a compact mod that solves a real annoyance without bloating your game. Craft a few gems, color-code them, and suddenly every dimension is one right-click away. Grab it, experiment with custom destinations, and let your world get a little smaller.