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