Data Packs Magic

Flyrr's Portkeys

  • 450 views 4 today
  • save_alt 18 downloads
Compatibility
Minecraft 1.21
Changes include
  • Advancements
  • Functions
  • Loot Tables
  • Predicates
  • Recipes
  • 4
  • 3
Required Resource Pack
Flyrr
Lvl 52Grandmaster Wizard
225
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.
Flyrr's Portkeys Minecraft Data Pack
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.
Flyrr's Portkeys Minecraft Data Pack
(If you have operator permissions, 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*.
Flyrr's Portkeys Minecraft Data Pack
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  EffectTypeDefault
cooldown*Time Portkeys take to activateNumerical, 20 = 1 second30 / 1.5 seconds
exact_teleport**Wether or not to teleport players/entities to the exact position the portkey was createdNumerical, 10 = 1 block0 / False
rangeMax. distance from the portkey in which additional mobs/players get teleportedBoolean20 / 2 blocks
include_playersWether or not to also teleport other players around youBoolean1 / True
include_entitiesWether or not to also teleport entities around youBoolean1 / True
include_bossesWether or not to also teleport bosses around youBoolean0 / False

*) 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 entities 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

NameEffectTypeDefault
item_particlesWether or not to show particles around activated PortkeyBoolean1 / True
item_flashWether or not to show a flash when a Portkey activatesBoolean1 / True
additional_particlesWether or not to show particles shortly before a portkey activates (if cooldown >= 50)Boolean1 / True


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 [Resourcepack] :)

Need a minecraft sever?



Click the below image and use my promo code "Flynecraft" to get 25% off of minecraft servers hosted by Bisect Hosting, covering top tier performance and exceptional customer support at any time!


2 Update Logs

Update v1.1 : by Flyrr 03/19/2026 4:53:44 pmMarch 19 @ 8:53 pm UTC

Fixed a bug which caused the pack not to work at all
LOAD MORE LOGS

More like this

  Have something to say?

Welcome