# Samū's Commands (ModID: `rfx-cmd`) A small mod for Minecraft 1.20.x that adds several small little gameplay features. The mod is made for Fabric and requires the Fabric API. The mod has both client and server features, but operates in such a way that clients don't need to have the mod if the server has it, and vice versa. The mod mostly adds some commands and is most useful on the server, but the client adds some neat little features as well (especially if the server has the mod too). # Server Features All commands and gamerules listed here are automatically shared with all clients, so all players have access to this whether they have the mod or not. ## Homes The mod adds the well known `/home` and `/sethome` commands. You have a main home which you can use by calling the base commands with no extra name. You can add more homes under names by calling the commands with a specific name. - `/home` (alias `/h`) teleports where you last called `/sethome` - `/sethome` (alias `/sh`) sets your home to the current location - `/delhome` deletes your home - `/gethome` (alias `/gh`) gets your home's coordinates, or just whether you have the home when the gamerule `reducedDebugInfo` is set to `true` - `/homes` lists your homes, and coordinates if gamerules allow - `/clearhomes` removes all your named homes, except your main one - `/clearhomes true` removes all your homes, including your main one Homes can be controlled by gamerules: - `/gamerule allowHomeTp true|false` (default `true`) enables or disables all home commands. When `false`, only operators have access to home commands. This gamerule is also not effective to players with cheats enabled in singleplayer worlds. - `/gamerule maxHomes ` (default `0`) sets the maximum amount of homes a player can have, whether that is a named home or a main home. The value `0` disables the limit. If a player has more homes, they must first remove homes before they can set more homes. If a player has exactly this amount of homes, they can only overwrite existing homes. This command only affects `/sethome`, players that have more homes than this gamerule allows can still teleport to any of those. Admins and players with cheats enabled can make more homes. Homes work from any distance and through different dimensions. A home set in the Nether allows players in the Overworld to teleport to that home in the Nether instantly. A useful feature: home names can be clicked in the chat and it will suggest either a `/home` or `/sethome` command based on whether the home existed when it was printed or not. ## Spawn teleportation The mod adds a simple command to let players teleport to the world spawn point in the Overworld. - `/spawn` (alias `/s`) This behaviour can be enabled or disabled with a gamerule: - `/gamerule allowSpawnTp true|false` (default `true`) enables or disables the `/spawn` command. ## Teleportation Requests The mod adds the well known `/tpa` system, to send teleportation requests to players. It is controlled using a set of commands: - `/tpa ` sends a teleportation request to ``. If they accept it, you will be teleported to them. - `/tpc ` sends a teleportation call to ``. If they accept it, they will be teleported to you. - `/tpaccept` accepts the last received teleportation request - `/tpaccept ` accepts a teleportation request from `` - `/tpaccept *` accepts all teleportation requests and calls, use wisely since this may cause quite some chaos if you received a lot of requests and calls - `/tpdeny` denies the last received teleportation request - `/tpdeny ` denies a teleportation request from `` - `/tpdeny *` denies all teleportation requests You can control who can send you requests using a blacklist and a whitelist. The whitelist is by default disabled but can be enabled. If the whitelist is enabled, nobody can send you a request unless they're whitelisted. Blacklisted players can never send you a request even if they're whitelisted. If the whitelist is disabled, everyone except those in your blacklist can request. - `/tpblacklist add ` (alias `/tpbl add `) adds a player to your TP blacklist - `/tpblacklist remove ` (alias `/tpbl remove `) removes a player from your TP blacklist - `/tpwhitelist add ` (alias `/tpwl add `) adds a player to your TP whitelist - `/tpwhitelist remove ` (alias `/tpwl remove `) removes a player from your TP whitelist - `/tpwhitelist enable` (alias `/tpwl enable`) enables your whitelist, blocking everyone unless they're whitelisted - `/tpwhitelist disable` (alias `/tpwl disable`) disables your whitelist, blocking nobody unless they're blacklisted - `/tpwhitelist toggle` (alias `/tpwl toggle`) toggles your whitelist, enabling it if it is disabled and disabling it if it is enabled Teleportation requests can be controlled with several gamerules: - `/gamerule allowTpa true|false` (default `true`) enables or disables all teleportation request commands for everyone, even admins and players with cheats (they have the regular `/tp` command after all, and players could not accept otherwise). - `/gamerule tpaRequestTimeout 1..3600` (default `300`) defines, in seconds, the amount of time before a teleportation request expires. A request must be accepted within this timeframe, otherwise it will be denied silently (with no message to source or target). - `/gamerule tpaRequestSameTeam true|false` (default `false`) sets whether teleportation requests may only be sent to players in the same team. This also considers players that are not in a team to be in a single "not in a team"-team so they can still send requests to eachother. If disabled, everyone can send requests to everyone. - `/gamerule tpaMode tpa|tpc|both` (default `both`) sets in which direction players may teleport eachother. If set to `tpa`, players may only teleport themselves to others (i.e. they can use `/tpa`). If set to `tpc`, players may only teleport others to themselves (i.e. they can use `/tpc`). If set to `both`, players may do both (i.e. they can use `/tpa` and `/tpc`). ## Personal Notes Players can write small notes for themselves, which are stored per world (on the server's side). Notes are stored a bunch of lines which the player may edit, move, remove and add to freely. - `/notes add ` (alias `/note `) adds a new note with the given text - `/notes edit ` edits the note at line `` and replaces the text with the given text - `/notes remove all` removes all notes - `/notes remove ` removes one specific note - `/notes remove ` removes a range of notes - `/notes move ` moves a note from one line to another - `/notes last` (alias `/note`) shows the note at the last line number - `/notes last ` shows the notes at the last `` line numbers - `/notes get all` (alias `/notes`) lists all notes - `/notes get ` lists one specific note - `/notes get ` lists a range of notes Notes allow the interpolation of some simple data points such as your coordinates or your dimension, if the gamerule `reducedDebugInfo` is set to `false`. Each of these insert the specific information at the location where they were put in the note. They are meant to make it easier to insert some information from the debug screen in your notes. - `{xyz}` (alias `{pos}`, `{coords}`) inserts your coordinates in the world - `{xz}` inserts your X and Z coordinates in the world - `{x}` inserts your X coordinate in the world - `{y}` inserts your Y coordinate in the world - `{z}` inserts your Z coordinate in the world - `{dimension}` (alias `{dim}`) inserts the dimension ID of the dimension you're in Since notes are stored on the server side in the player data, a gamerule exists to limit the amount of notes per player in order to limit memory usage per player. Notes have a hardcoded length limit of 1024 characters, but the amount of notes per player is configurable. - `/gamerule maxNotes 1..4096` (default `1024`) sets the maximum amount of notes a player can have. Changing it will not immediately remove notes from players. A useful feature: note lines printed in chat can be clicked upon to copy a note line to the clipboard. ## Points of interests In addition to the home commands, the mod provides points of interests, which are like homes shared across all players. Unless configured otherwise, only admins can set these. All players can teleport to them by default. All commands targeting a single POI can have an optional name as argument to set a named POI. The main POI has no name and must be referred to by not providing the name. - `/poi` teleports to a POI set by `/setpoi` - `/setpoi` sets a POI to the current location - `/delpoi` deletes a POI - `/getpoi` gets a POI's coordinates, or just whether the POI exists when the gamerule `reducedDebugInfo` is set to `true` - `/pois` lists all POIs, and their coordinates if gamerules allow - `/clearpois` removes all named POIs, it keeps the main one - `/clearpois true` removes all POIs, including the main one Points of interest can be controlled by gamerules: - `/gamerule allowPoi true|false` (default `true`) enables or disables all POI commands. When `false`, only operators have access to POI commands. This gamerule is also not effective to players with cheats enabled in singleplayer worlds. - `/gamerule allCanSetPoi true|false` (default `false`) enables or disables POI modification commands. When `false`, only operators can change, add and remove POIs. When `true`, all players can edit POIs. - `/gamerule hidePoiInfo true|false` (default `false`) enables or disables POI querying commands. When `false`, only operators have access to the POI query commands (`/pois`, `/getpoi`). This does not disable the `/poi` teleportation command. POIs, like homes, work from any distance and through different dimensions. A POI set in the Nether allows players in the Overworld to teleport to that POI in the Nether instantly. ## Last death The mod has a feature to teleport players to where they last died. This can be done in two ways: - Using `/death` - By clicking with a recovery compass (which requires players to obtain such a compass) A gamerule can control this ability: - `/gamerule deathTp off|command|compass|both` (default `compass`) sets how the player can teleport to where they last died. - When `off`, the feature is disabled. - When `command`, the feature is accessible through commands only, and players don't need a recovery compass. - When `compass`, the feature is accessible through the recovery compass only. - When `both`, the feature is accessible through both the command and the recovery compass, so players don't necessarily need a recovery compass but they can still use it. For operators, this gamerule has no effect: they can use the command and the recovery compass limitlessly. ## Pets and Leashed Mobs Now you have your fancy teleport commands, but you have a cat or dog and it will stay behind at the place you teleported from. Oh no! But fear no more, because pets can teleport with you, and so can leashed mobs. By default, leashed mobs can teleport through dimensions, and pets only in the same dimension. This can be configured with game rules: - `/gamerule teleportPets off|dimension|interdimensional` (default `dimension`) sets how pets teleport with the player. - `/gamerule teleportLeashedMobs off|dimension|interdimensional` (default `interdimensional`) sets how leashed mobs teleport with the player. Both gamerules follow the same principles: - `off` disables the feature entirely. - `dimension` allows teleporting the animals only through the same dimension, not to different dimensions. - `interdimensional` allows teleporting the animals to other dimensions. # Client Features Currently, not much client features exist. ## Home Keys You can bind keys to set and teleport to your main home. # Planned Features - A home manager: a visual interface showing your homes where you can manage them. - Lodestone teleportation: allows players to click with a lode compass to teleport to the lodestone it's associated with. # License Copyright (C) 2023 Runefox This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see .

Samū's Commands

External resources

Featured versions

Project members

Technical information