BlossomHomes

BlossomHomes

BlossomHomes is a Minecraft Fabric mod in the Blossom-series mods that provides /home command and utilities

Table of contents

- Dependencies - Config - Commands & their permissions - Translation keys

Dependencies

* BlossomLib * fabric-permissions-api / LuckPerms / etc. (Optional)

Config

This mod's config file can be found at `config/BlossomMods/BlossomHomes.json`, after running the server with the mod at least once.

`teleportation`: TeleportationConfig - teleportation settings `standStill`: int - (seconds), how long the player has to stand still before being teleported `cooldown`: int - (seconds), how long the player has to wait after teleporting using this command, before being able to teleport again `defaultHome`: String - name of the default home `startHomes`: int - default max homes `dimensionBlacklist`: String[] - a list of dimension ids (like `minecraft:the_end`) in which a player can't set a home `useBlacklistAsWhitelist`: boolean - invert blacklist to function as a whitelist `fallbackToPlayerSpawnPoint`: boolean - use player spawn point if no default home set

Commands & their permissions

In all commands where `<name>` is optional, if it's not provided, config value `defaultHome` will be used. Do pay attention that only `/homes` subcommand permissions have the `homes` as a plural. This is done to allow the server owners to hide some commands in case of command clutter.

- `/home [<name>]` - teleport self to home named `<name>` Permission: `blossom.home` (default: true) - `/sethome [<name>]` - creates a home named `<name>` Permission: `blossom.home.set` (default: true) - `/sethome <name> <position> <rotation>` - creates a home named `<name>` at `<position>` facing `<rotation>` Permission: `blossom.home.set.pos` (default: false) - `/sethome <name> <position> <rotation> <dimension>` - creates a home named `<name>` in `<dimension>` at `<position>` facing `<rotation>` Permission: `blossom.home.set.dim` (default: false) - `/delhome [<name>]` - delete a home named `<name>` Permission: `blossom.home.remove` (default: true) - `/listhomes` - lists all homes Permission: `blossom.home.list` (default: true) - `/homes` - alias of `/listhomes` Permission: `blossom.homes.list` (default: true) - `list` - alias of `/listhomes` Permission: `blossom.homes.list` (default: true) - `set` - alias of `/sethome` Permission: `blossom.homes.set` (default: true) - `add` - alias of `/sethome` Permission: `blossom.homes.add` (default: false) - `delete` - alias of `/delhome` Permission: `blossom.homes.delete` (default: true) - `remove` - alias of `/delhome` Permission: `blossom.homes.remove` (default: false) - `set-max <new-max> <players>` - set all `<players>`'s max homes to `<new-max>` Permission: `blossom.homes.set-max` (default: OP level 2) - `load-legacy [<overwrite>]` - load legacy FabricHomes player homes, appending them to existing player homes, unless `<overwrite>` is set to `true`, then replace all (found) player homes. Players don't have to be online for their homes to be updated Permission: `blossom.homes.load-legacy` (default: OP level 4)

Permission: `blossom.homes.set.in-blacklist` (default: OP level 2) - allow setting homes in blacklisted dimensions. To set other players' homes, `/execute as <player> run sethome <name>` can be used.

Translation keys

only keys with available arguments are shown, for full list, please see `src/main/resources/data/blossom/lang/en_us.json`

- `blossom.homes.list.empty`: 1 argument - max home count - `blossom.homes.list.header`: 2 arguments - total home count, max home count - `blossom.homes.list.item`: 1 argument - home name - `blossom.homes.list.item.description`: 7 arguments - home name, home dimension key, home x, home y, home z, home yaw, home pitch - `blossom.homes.add`: 1 argument - home name - `blossom.homes.add.failed.max`: 1 argument - max home count - `blossom.homes.add.failed.name`: 1 argument - home name - `blossom.homes.remove`: 1 argument - home name - `blossom.homes.remove.failed`: 1 argument - home name - `blossom.homes.setMax`: 2 arguments - new max, players - `blossom.homes.load-legacy.done`: 2 arguments - home count, player count

`zh_cn` (Chinese, Simplified), `zh_tw` (Chinese, Traditional) - added by @BackWheel, updated by @Pau1am