Flyrr's Portkeys
Mod and data packEasily link teleport locations to your items!
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?
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!
