Flyrr's Portkeys

Flyrr's Portkeys

Easily link teleport locations to your items!

by
161 Downloads
datapackfabricforgeneoforgequiltequipmentmagictransportation
Rent Server with this Mod

Screenshots

Crafting a Stone of Teleportation
Teleporting using a Portkey
An Iron Ingot turned into a Portkey
Banner

About this Mod

Have you always dreamed of replicating the concept of Portkeys portrayed in the Harry Potter universe? Or are you just looking for a simple way to teleport between fixed places?
Then this highly configurable pack is just for you!

Crafting

To convert an item into a Portkey, you first need to craft yourself a Stone Of Teleportation.
Items arranged in the grid of a Crafting Table: First Row: Bottle o' Enchanting, Eye of Ender, Bottle o' Enchanting; Second Row: Eye of Ender, Flint, Eye of Ender; Third Row: Bottle o' Enchanting, Eye of Ender, Bottle o' Enchanting;
Once you have done so you simply need to equip the Stone of Teleportation into your off-hand, select any item of your choice in your hotbar and right click. Doing this will convert the selected item into a Portkey linked to your current location. Portkey items keep all their original properties but appear with an enchanted glint and the "Portkey" property in the item description.
An Iron Ingot appearing with the enchantment glint, the Items lore shows the text

If you're an operator, you can give yourself a Stone of Teleportation by running loot give @s loot portkey:stone_of_teleportation)

Usage

Once dropped, Portkey items take 1.5 seconds* before they active. You can tell that a Portkey is active by the enchantment particles surrounding it and also from a quick flash upon initial activation.*
Players picking up activated Portkeys will be teleported close to the location they were first created*, taking other players and mobs close to them with them*.
A player picks up a Portkey and gets teleported
In the current version of this pack, Portkey items never run out of uses. This might be introduced as a setting in future versions of the pack :)
NOTE: PLACING BLOCKS WHICH WERE CONVERTED TO A PORTKEY BEFOREHAND WILL GET RID OF THE PORTKEY PROPERTY. THIS CAN'T BE FIXED AT THIS POINT IN TIME.

* This can be configured in the settings

Settings

Many parts of this pack can be configured by people with op permissions.
Settings of the "Boolean" type can be either 1 (True) or 0 (False), trying to set them to anything besides that might break parts of the pack.
To change a setting, run /scoreboard players set %<setting> portkey.settings <value> in chat or from console, replacing <setting> with the name of the setting (keeping the %!!) and <value> with the value of your choice.
To quickly reset all settings to their default values, run function portkey:_commands/reset_settings

Teleportation Settings
Name Effect Type Default
cooldown* Time Portkeys take to activate Numerical, 20 = 1s 30
exact_teleport † Wether or not to teleport players/entities to the exact position the portkey was created Boolean 0
range Max. distance from the portkey in which additional mobs/players get teleported Numerical, 10 = 1 Block 20
include_players Wether or not to also teleport other players around you Boolean 1
include_entities Wether or not to also teleport entities around you Boolean 1
include_bosses Wether or not to also teleport bosses around you Boolean 0

*) Additional particles are shown before the Portkey activates if this value is higher than 49. See Visual Settings on how to disable these.
†) If false, players and entities will be spread around the original coordinate by a few blocks. If true, players and entitites will match the location and rotation of the original creator as closely as possible. This means that multiple entities can and WILL land on the same block.

Visual Settings
Name Effect Type Default
item_particles Wether or not to show particles around activated Portkey Boolean 1
item_flash Wether or not to show a flash when a Portkey activates Boolean 1
additional_particles Wether or not to show particles shortly before a portkey activates (if cooldown >= 50) Boolean 1

Tools & Commands

These were mainly added for debugging and testing reasons and will probably not be of much use to the average person using this pack. Usage might lead to unexpected behaviour.
/function portkey:_dev/convert -> Converts the held item into a Portkey, using the current coordinates as teleport location
/function portkey:_dev/convert_broken -> Converts the held item into a Broken Portkey, which acts like a regular Portkey but doesn't teleport anybody when picked up
/function portkey:_dev/tp_handheld -> Teleports you to the coordinates linked to the Portkey item you're holding

Contribution

You can help making this pack better by contributing and reporting bugs on GitHub! [Datapack Repository]
Also feel free to add supporte for more languages by contributing to the [Resource Pack] :)

Need a minecraft server?

Available Versions

V1.1 (MOD)release
MC 1.21.9, 1.21.10, 1.21.11fabric, forge, neoforge, quilt
March 19, 2026
V1.1 (DATAPACK)release
MC 1.21.9, 1.21.10, 1.21.11datapack
March 19, 2026
V1.0 (MOD) - DOES NOT WORKrelease
MC 1.21.9, 1.21.10fabric, forge, neoforge, quilt
December 6, 2025
V1.0 (DATAPACK) DOES NOT WORKrelease
MC 1.21.9, 1.21.10datapack
December 6, 2025

How to Install Flyrr's Portkeys on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set datapack Loader

In the panel under "Egg", select the datapack loader and matching Minecraft version (1.21.11).

3

Install Mod

Open the mod browser in the dashboard and search for "Flyrr's Portkeys". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

datapackfabricforgeneoforgequilt

Minecraft Versions

1.21.11, 1.21.10, 1.21.9

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Flyrr's Portkeys server crashes on startup – what to do?

Most common cause: wrong datapack version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.

Is Flyrr's Portkeys compatible with datapack and fabric and forge and neoforge and quilt?

Flyrr's Portkeys officially supports datapack, fabric, forge, neoforge, quilt for Minecraft 1.21.11, 1.21.10, 1.21.9. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Flyrr's Portkeys – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Flyrr's Portkeys consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Flyrr's Portkeys with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
Creative Commons Attribution Non Commercial No Derivatives 4.0 International
Server-side
Required

Supported Versions

1.21.111.21.101.21.9