Journey (Beta)

A path-finding solution built for Spigot Minecraft (1.17+).

The Journey initiative is best described as an immersive alternative to teleportation in a multi-world server. To get from place-to-place quickly in Minecraft, players are keen to use commands that get them there immediately. However, while an administrator might want to provide some ease of transportation, he or she might also want to deter people from using such anti-vanilla features as teleportation. Journey provides this solution, and more! Simply type a command and a path to a destination will be calculated and displayed to the user.

The path-finding nature of Journey is conducive to more than just helping players move around the world(s). The algorithm for finding these paths may also be sent to other plugins by using the Journey API. Details and usage of this API will be documented at a later date.

Some examples of tools and solutions that could be developed to make use of the Journey API are:

• A "tour guide" plugin that lets a humanoid entity follow the path and lead the player to a destination
• A town plugin to lead players to towns that may be of interest
• A jail plugin to verify whether it is possible for a player to leave a certain containment area

This project was started as a tool for WHIMC at the University of Illinois, which continues to use and support Journey and many other plugins. Their code repos are found on at What-if Hypothetical Implementations in Minecraft (github.com). Go checkout the other stuff their working on!

Disclaimer

This plugin is currently in its Beta phase. Things change all the time so any saved data on anyone's server could be subject to alteration or deletion. This shouldn't matter too much because most of the plugin is stateless by nature anyway. But, to be sure nothing breaks, everyone is encouraged to completed delete the data folder for Journey on their server upon every new update of the plugin.

Commands
Typing "help" after any command will give a comprehensive explanation of the command and its subcommands.

• /journey to (...) - Calculate a path to a previously saved destination
• /journey save (...) - Save a path destination to be used for later
• /journey list (...) - List all path destinations previously saved
• /journey delete (...) - Remove a previously saved path destination
• /journey admin (...) - Admin commands

Example Usage

1. Run /journey save my home
2. Go exploring for a while
3. Run /journey to my home
4. Wait for the calculation to complete
5. Follow the particles!

Another Example

1. Get lost in a cave system
2. Run /journey to surface
3. Wait for the calculation to complete
4. Follow the particles to get back to the surface!

Permissions

• journey.command.admin - Access to admin commands
  • default: false
• journey.command.to.custom.use - Access to all journey commands for personal locations (the "my"-type commands)
  • default: true
• journey.command.to.surface.use - Access to the "journey to surface" command
  • default: true
• journey.command.to.quest.use - Access to the "journey to quest" command
  • default: true
• journey.command.to.public.use - Access to all journey commands for public locations
  • default: true
• journey.command.to.public.edit - Access to edit the path locations for public searches (save and delete)
  • default: false

Give Us Feedback!

We're looking for suggestions and general feedback. Please download the plugin and report suggestions and issues at Issues · pietelite/journey (github.com) and join the discussion at our Discord