Skip to content

Pretorer/AmethystTravelling

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Amethysttravelling

A Minecraft datapack for building fast travel points. It utilizes amethysts and makes them a consistently needed resource for fast travel.
See Amethysttravelling on planetminecraft.

Features:

  • fast travel between distant places and dimensions
    • can display the name of the destination after travelling
    • allows traveling while riding an entity
    • allows to carry nearby npcs (also mobs)
  • different tiers of fast travel points
    • affects speed and available dimensions
  • detects the items in both hands
  • advancements as in-game manual
  • designed to be multiplayer friendly
  • no necessary resource pack

Usage:

Building

To build a fast travel point, a 3x3 platform must be constructed from amethyst blocks. The "catalyst" block in the center determines the time it takes for the fast travel point to channel. In addition, not all fast travel points can be kept permanently active in all dimensions. For this the right "catalyst" must be chosen. To activate the platform of a fast travel point, you must stand in the middle of the platform.

Different 3x3 platforms out of amethyst blocks with different blocks in the center.
Image: Different tiers of fast travel points.

Block Default channelization time (in s) Dimensions
Copper 10 Overworld
Iron 6 Overworld
Gold 3 Overworld
Emerald 2 Overworld
Diamond 1.5 Overworld, Nether, Custom
Netherite 1 Overworld, Nether, End, Custom

Connecting

To connect two fast travel points, the first one must be marked first. To do this, stand in the middle of an activated unconnected platform and hold an amethyst shard in your hand. Now you can go to the second activated unconnected platform and do the same as you did with the first.

Travelling

To travel, stand in the center of an activated connected fast travel point and hold an amethyst shard in your hand. Now the fast travel point starts to channel. NPCs can be taken along by standing on the platform. However, these also consume an amethyst shard. After traveling, the platform must be re-entered or the amethyst shard must be taken in hand again.

Players traveling with fast travel points.
Image: A player who travels using amethyst shards.

Renaming

When a fast travel point is renamed with a name tag, its name is shown when a player travels to it.

Renaming of a fast travel point.
Image: Display the name of a renamed fast travel point after traveling.

Destruction

If a block of the platform of an activated fast travel point is removed, the fast travel point is destroyed. A possibly connected platform will now also no longer work.

Datapack installation:

Install this datapack like any other datapack by placing it in the world's datapack folder and entering the command /reload. Alternatively: when a new world is created, open the datapacks menu and drag this datapack into the Minecraft window.

Datapack removal:

The command /function amethysttravelling:remove removes all entities, scoreboards and unloads all permanently loaded chunks created by this datapack. To reinstall this datapack, use the command /datapack enable "file/AmethystTravelling.zip".

Configuration:

Particle count

You can adjust the amount of particles that are displayed when travelling via Minecraft's graphics options. Since it is still a lot of particles if you use the reduced amount or have the choice to use only the necessary particles, there is an option in the datapack to adjust the amount per player. To use the reduced amount of particles use the command /trigger AT.moreParticles set 0. The default setting is the high amount, which shows an increasing cloud of particles. To re-enable this, use the command /trigger AT.moreParticles or /trigger AT.moreParticles set <value> with a value greater than zero.

Channeling time

Channeling time can be adjusted for different tiers of fast travel points. For example, a netherite fast travel point that lets you travel into the end can be slower than an emerald fast travel point, if desired. Use /scoreboard objectives setdisplay sidebar AT.config to see all channeling times in ticks (20 ticks are one second). To hide the scoreboard use /scoreboard objectives setdisplay sidebar. To update a specific channelization time of a tier shown in the scoreboard, use /scoreboard players set <tier> AT.config <ticks> and update all existing fast travel points with the command /function amethysttravelling:platform/update_existing_platforms.

Materials

You can easily change the materials for the outer ring of the platform by changing the json file "AmethystTravelling/data/amethysttravelling/tags/blocks/magical_block.json" and the item you use for the travel in "AmethystTravelling/data/amethysttravelling/tags/items/magical_item.json". If you want to add a new block for a custom tier of a fast travel point, edit "AmethystTravelling/data/amethysttravelling/tags/blocks/condenser.json", the fast travel point is not known by default and you will get the lowest tier and 10 seconds of channeling time. If you want to change this, it can be helpful to modifiy "AmethystTravelling/data/amethysttravelling/functions/platform/get_type.mcfunction".