
Flyrr's Portkeys
Easily link teleport locations to your items!
Screenshots




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.
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.
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*.
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
How to Install Flyrr's Portkeys on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set datapack Loader
In the panel under "Egg", select the datapack loader and matching Minecraft version (1.21.11).
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
Minecraft Versions
1.21.11, 1.21.10, 1.21.9
Server-side
✓ RequiredRecommended 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.
Similar Mods
Rent Modded Server
Install Flyrr's Portkeys with just one click on your server.
Details
- License
- Creative Commons Attribution Non Commercial No Derivatives 4.0 International
- Server-side
- Required