Flyrr's Portkeys

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 "Portkey" in a pastel purple

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?

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!

Compatibility

Minecraft: Java Edition

Platforms

Links