Fast Travel icon

Fast Travel -----

Fast Travel requiring the player to visit the destination first!



Description

Fast Travel adds the same mechanic that a lot of video games have to Minecraft. A simple hub and warp system that requires the player to visit the warp before being allowed to use fast travel.

Features
  • Hubs that can connect to any warp allowing you to have dedicated hubs for specific warps (even warps that already have a hub)
  • Prices per hub-warp connection (customizable)
  • Price increments per use (per player) (customizable)
  • Hub and Warp icon customizability
  • The ability to enable two-way connections per hub-warp connection
  • Warp Descriptions
  • Option for exact pricing (name, NBT tag, etc)
  • Multi-world capable
[​IMG]
[​IMG]

Basic Setup

Hub Creation
To begin, stand in the location (including pitch and yaw) you want your hub to be and type:

/travel hub create <HubName> <Radius>

<HubName> will be the name of the hub displayed. You can use color codes for this as well. (Hub and warp names stripped of color must be unique. i.g. &cTest and &6Test is not allowed)
<Radius> Refers to the radius from the block you are standing that players are allowed to activate the hub.

Warp Creation
Similar to the hub, stand in the location you want your warp to be, hold the item you want the warp to cost (hold nothing to make it free), and type:

/travel warp create <WarpName>

Connect Hub and Warp
Finally, you simply need to connect the hub and warp by typing:

/travel connect <WarpName> <HubName>

Done
You're set! Simply crouch at the hub and you will be prompted with a menu that includes your new warp! You can add more warps to this menu by repeating the same warp process.

Custom Hub/Warp Icon
You can also customize what icon appears in the menus for each state instead of having green and red glass panes!
Simply hold the item you want to act as an icon and type:

/travel <warp/hub> icon <WarpName/HubName> <true/false>

<warp/hub> depends on if you're changing the hub or warp icon
<WarpName/HubName> refers to the name of the warp or hub you're changing
<true/false> depends on if you are setting the enabled or disabled state of the icon

Here is an example of customized icons:
Enabled:
[​IMG]
Disabled:
[​IMG]

There are a couple of other quick customizations you can do:

Descriptions
You can give a warp a description by adding the description to the end of the command when creating the warp. Like this:

/travel warp create <WarpName> <Description>

The description will look like this:
[​IMG]
(/travel warp create Teleporter to Coral Reef)

Exact Pricing
If you need the prices to be exact and compare names, NBT tags, or anything else, set the "exactPrice" option in the config to true.

This is what it looks like if I set the price to a gold nugget named "Coin" (Though, you should also have an NBT tag to prevent players from just renaming items. Prevent tax fraud!!!!)
[​IMG]

Commands

Here is a list of all commands (All commands must have admin permissions or "fasttravel.admin"):

/travel -The base command

Warp
/travel warp create <WarpName>
Creates a new warp. Price is set to the item in your main hand (Hold nothing to make it free)

/travel warp create <WarpName> <Description>
Same as above, but adds <Description> to the warp icon in menu

/travel warp delete <WarpName>
Deletes the warp (Color or formatting is not necessary)

/travel warp icon <WarpName> <true/false>
Sets the enabled/disabled icon for this warp (See "Custom Hub/Warp Icon" for more info)

/travel warp list
Lists all the warps

Hub

/travel hub create <HubName> <Radius>
Creates a new hub. Radius the distance required to activate the hub by crouching

/travel hub delete <HubName>
Deletes the hub (Color or formatting is not necessary)

/travel hub icon <HubName> <true/false>
Sets the enabled/disabled icon for this hub (See "Custom Hub/Warp Icon" for more info) (Only applicable if the connection is two-way)

/travel hub list
Lists all the hubs

Other
/travel connect <WarpName> <HubName>
Connects the warp and hub

/travel disconnect <WarpName> <HubName>
Disconnects the warp and hub

/travel teleport <WarpName>
Teleports you to the warp

/travel return <WarpName> <true/false>
Sets whether the connection will be two-ways (Price still applies. Crouch at the warp to activate warp menu)

/travel permit <Username> <WarpName>
Toggles a player's status at a specific warp. (If it toggles off, they must visit the warp again)

Configs

Code (Text):
# The distance the player has to approach in order to unlock a warp (and to activate the warp menu if the connection is two-way)
warpRadius: 5
# The price increase modifier
priceIncrease: 1.1
# Compares the exact price (name, nbt tags, etc), otherwise just material is compared
exactPrice: false

Code (Text):
Text:
  travelCommand: '/travel (connect/disconnect/warp/hub/permit/teleport/return)'
  connectCommand: '/travel connect (list/<WarpName>) <HubName>'
  connectSuccess: 'Successfully connected the warp <WarpName>&f to the hub <HubName>'
  connectUnsuccess: 'Could not connect warp <WarpName>&f to the hub <HubName>&f (<Error>)'
  connectionList: 'Here is a list of warps connected to <HubName>'
  disconnectCommand: '/travel disconnect <WarpName>&f <HubName>'
  disconnectSuccess: 'Successfully disconnected the warp <WarpName>&f from the hub <HubName>'
  disconnectUnsuccess: 'Could not disconnect warp <WarpName> from the hub <HubName>&f (<Error>)'
  returnCommand: '/travel return <WarpName> <true/false>'
  returnSuccess: 'Successfully set return permission for warp <WarpName>&f to <Value>'
  returnUnsuccess: 'Could not set return permission for warp <WarpName>&f (<Error>)'
  warpCommand: '/travel warp (create/delete/list/icon) <WarpName>'
  warpIconCommand: '/travel warp icon <WarpName> <true/false>'
  warpCreateSuccess: 'Successfully created warp <WarpName>&f with price of <Price>'
  warpCreateUnsuccess: 'Could not create warp <WarpName>&f (<Error>)'
  warpDeleteSuccess: 'Successfully deleted warp <WarpName>'
  warpDeleteUnsuccess: 'Could not delete warp <WarpName>&f (<Error>)'
  iconSuccess: 'Successfully changed the <Value> icon'
  iconUnsuccess: 'Could not change the icon (<Error>)'
  warpList: 'Here is a list of warps:'
  hubCommand: '/travel hub (create/delete/list/icon) <HubName> <Radius>'
  hubIconCommand: '/travel hub icon <HubName> <true/false>'
  hubCreateSuccess: 'Successfully created hub <HubName>'
  hubCreateUnsuccess: 'Could not create hub <HubName>&f (<Error>)'
  hubDeleteSuccess: 'Successfully deleted hub <HubName>'
  hubDeleteUnsuccess: 'Could not delete hub <HubName>&f (<Error>)'
  hubList: 'Here is a list of hubs:'
  permitCommand: '/travel permit <Username> <WarpName>'
  permitSuccess: 'Successfully changed permission for <Username> to warp to <WarpName>&f to <Value>'
  permitUnsuccess: 'Could not change permission for <Username> to warp to <WarpName>&f (<Error>)'
  teleportCommand: '/travel teleport <WarpName>'
  warpUnsuccess: 'Could not warp to <WarpName>&f (<Error>)'
  warpNotFound: '&cWarp <WarpName>&c has not been created&f'
  warpExists: '&cWarp <WarpName>&c has already been created&f'
  hubNotFound: '&cHub <HubName>&c has not been created&f'
  hubExists: '&cHub <HubName>&c has already been created&f'
  alreadyConnected: '&cConnection already made&f'
  notConnected: '&cNo connection exists&f'
  playerNotFound: '&cCould not find player <Username>&f'
  invalidRadius: '&c<Radius> is an invalid radius&f'
  free: 'Free'
  price: 'x<Amount> <Type>'
  hubs: 'Hubs'
  warps: 'Warps'
  noPermission: '&cYou do not have permission for that!'
  # Forward slash used as newline
  unlockNeeded: '&cYou need to visit this destination /&cin order to unlock this warp!'
  unlocked: '&6You unlocked the <WarpName>&6 warp!'
  missingCost: '(Missing x<Amount>)'

Contact

I'm currently a full-time student so I don't have much time for plugin development, but if you have a game-breaking bug I'd appreciate it if you report it on my Discord server :D
Resource Information
Author:
----------
Total Downloads: 308
First Release: Jul 1, 2022
Last Update: Mar 7, 2023
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings