¶ Description
Warping Wonders allows for a more immersive player teleportation utilizing already existing items. Using a compass which is linked to a lodestone players can teleport back to the lodestone. A clock teleports players back to their spawnpoint (bed, respawn anchor) and the recovery compass can bring players back to their last death location. The latter two always get consumed when using them. In addition to that Portal Horns can be crafted which function as a TPA replacement. The latest addition to the data pack is a Waypoint Hub system which lets players set up a network of points of interest where they can teleport to. All teleport actions function across all dimensions. Ridden Entites (Camel, Strider, Donkey, Mule, Horse, Llama and Horses) as well as leashed Entities (including Boats) can be teleported alongside players if enabled.
¶ Download
The data pack is currently published only on Modrinth. All required assets are included in the data pack and can also be used as a resource pack. An automatically converted mod version is also available. You can download it here: Warping Wonders on Modrinth
When using the mod version in singleplayer worlds, the data pack does not need to be loaded as a resource pack. However, when using the mod version on a server, you must either include the assets from the data pack in your server’s resource pack or instruct players to install the mod locally.
¶ Features
¶ Clock
If enabled in the Configuration Menu, players can teleport to their respawn point (usually a Bed or Respawn Anchor) by right-clicking with the Clock they are holding. Depending on the settings in the Configuration Menu, teleporting may either cost Experience Levels or have a chance to break the Clock.
¶ Compass
If enabled in the Configuration Menu, players can teleport to linked Lodestones by right-clicking with the Compass they are holding. Players can also craft new Compass variants, allowing them to better differentiate between them. Depending on the settings in the Configuration Menu, teleporting may either cost Experience Levels or have a chance to break the Compass.
¶ Recovery Compass
If enabled in the Configuration Menu, players can teleport to their last death location by right-clicking with the Recovery Compass they are holding. Players can also craft new Recovery Compass variants, allowing them to better differentiate between them. Depending on the settings in the Configuration Menu, teleporting may either cost Experience Levels or have a chance to break the Recovery Compass.
¶ Portal Horn
Players can craft a Portal Horn by combining two Iron Ingots and an Ender Pearl in a Crafting Table. The item can also be obtained as a trade from Master Cartographers. Using the Portal Horn opens a menu that allows players to invite another player to teleport to them. The invited player will receive a chat message where they can choose whether to accept the request. Depending on the settings in the Configuration Menu, teleporting may either cost Experience Levels or have a chance to break the Portal Horn.
¶ Waypoint Hub
Waypoint Hubs can be crafted and placed to create fixed teleport locations that link to other Waypoint Hubs. Several variants are available, each crafted with a different base block so they can blend seamlessly into a wide range of builds.
For more detailed information about Waypoint Hubs and their features, visit this page: Waypoint Hub.
¶ Administration
The settings of the data pack can be configured in-game through the Configuration Menu. This menu can be opened using the /function warping_wonders command or through the option provided in the Nice Admin Tools data pack. Among the settings for each key feature of the data pack, there is also an option to restore the default settings that the data pack originally came with.
The player who opens the menu is automatically added as an administrator, granting them permission to view, modify, and teleport to all Waypoints, regardless of normal access restrictions. Players can also be manually added or removed as Waypoint administrators using the command /tag <playername> add/remove wawo.admin.
For PaperMC users, it is recommended to set the
paper.maxChatCommandInputSizeproperty to a value between 512 and 1024. More information can be found in the PaperMC Docs.
¶ Item Teleport Settings
The following aspects of the teleportation methods (Clock, Compass, Recovery Compass & Portal Horn) described above can be customized:
- Active: Enables or disables the feature
- Exp Level Cost: Sets the number of Experience Levels required to use the Item teleportation
- Chance of Item Breaking: Determines the percentage chance for the used Item to break after teleporting
- Teleport Leashed Mobs: Determines whether leashed mobs are teleported alongside the player when using Item teleportation
¶ Waypoint Hub Settings
The following aspects of Waypoint Hubs described above can be customized:
- Active: Enables or disables the feature.
- Exp Level Cost: Sets the number of Experience Levels required to teleport using a Waypoint Hub.
- Teleport Leashed Mobs: Determines whether leashed mobs are teleported alongside the player.
- Min Distance Between Waypoint Hubs: Sets the minimum distance (in blocks) required between placed Waypoint Hubs.
- Max Waypoint Hubs per Player: Sets the maximum number of Waypoint Hubs a player can own at the same time.