A Minecraft server-side mod that adds various teleportation related commands
Java 89.9%
Shell 6.6%
Batchfile 2.1%
Nix 1.3%
Just 0.1%
66 7 0

Clone this repository

https://tangled.org/mrsnowy.dev/TeleportCommands https://tangled.org/did:plc:5fbqdlfpahlht7gu4c6zrdpj/TeleportCommands
git@knot.tangled.mrsnowy.dev:mrsnowy.dev/TeleportCommands git@knot.tangled.mrsnowy.dev:did:plc:5fbqdlfpahlht7gu4c6zrdpj/TeleportCommands

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

Teleport Commands Teleport Commands Logo#

A Minecraft server-side mod that adds various teleportation related commands, like /home /tpa and /back

Here is the Changelog

Currently available commands:#

  • /worldspawn [<Disable Safety>] - Teleports you to the world spawn (in the overworld), if given true it will not do safety checks
  • /back [<Disable Safety>] - Teleports you to the location where you last died, if given true it will not do safety checks

    Homes are player specific locations that only that player can teleport to
  • /sethome <name> - Creates a new home
  • /home [<name>] - Teleports you to the home, if no name is giving it will go to the default home
  • /delhome <name> - Deletes a home
  • /renamehome <name> <newName> - Renames a home
  • /homes - Shows a list of your homes
  • /defaulthome <name> - Sets the default home

    Warps are op managed locations that all players can teleport to
  • /warp <name> - Teleports you to the warp
  • /warps - Shows a list of the available warp
  • /setwarp <name> - Sets a warp. Permission level of 4 required (op)
  • /delwarp <name> - Deletes a warp. Permission level of 4 required (op)
  • /renamewarp <name> <newName> - Renames a warp. Permission level of 4 required (op)

    With tpa you can teleport to other players or make them teleport to you
  • /tpa <player> - Sends a tpa request to another player
  • /tpahere <player> - Sends a tpaHere request to another player
  • /tpaaccept <player> - Accepts the tpa/tpahere request of that player
  • /tpadeny <player> - Denies the tpa/tpaHere request of that player

TODO:#

Planned commands:#

  • /wild - Teleports you to a random location in the Overworld
  • /worldspawn - Teleports you to the worldspawn
  • /spawn <dimension> - Teleports you to your spawn point in a dimension, defaults to your current dimension
  • /previous - Go to the last teleported location

Improvements:#

  • Look into changing the mod into the more safe and sane kotlin (I love java)
  • Add game tests
  • Find the easiest way to backport the mod to older version (help)
  • Create a config to add any delays and disable commands, with commands for operators in game
  • Add a perm system
  • Optimize the translation strings (They are getting out of hand)
  • Potentially setup a better translation system (Maybe I will self-host texterify)
  • Find a way to combine the mod loader specific jars into one
  • Json Storage automatic updater & cleaner
  • Modify /back to check if the location is safe and automatically choose a nearby location that is safe
  • Limit tpa requests for a player
  • Add translation system
  • Improve responses for commands
  • Add Quilt support and NeoForge

Want to help?#

  1. You can create a translation file so other people can use the mod in their native language: translations.md

How to build#

Getting the correct environment#

Nixos#

If you are on nixos you can simply go into the folder of where you cloned the repo, and run nix develop .. This will give you the environment I use (apart from the IDE) :3.

Generic linux#

On any other linux distro, just install the jetbrains jdk, or try openjdk21.

Windows#

On windows probably go to the openjdk website and install the 21 version? Idk goodluck.

Building#

Then on linux just run ./gradlew build. To make it into a single mod jar just run ./gradlew mergeJars.

Or on windows, just do .\gradlew.bat build and .\gradlew.bat mergeJars. Note that this isn't tested for windows, but I think that is how it works.

Getting the jars#

Then you can find your jars in fabric/build/libs/ (for fabric), neoforge/build/libs/ (for neoforge) or merged/build/libs/ (if you made the merged jar file).

If you have any issues just make an issue or contact me on Discord @mrsnowy_

Random notes lol#

Text Colors:

  • Green = When something succeeds and an action will happen
  • Aqua = When something needs attention
  • White = When something is done
  • Red = When something fails