Home Manager

Manage player homes with permissions and cooldowns

ManifesteFourni par TinyEssentials

Champs

Champ	Type	Par défaut	Description
artifact	Ref<HomeArtifactDefinition>	—	Linked artifact_home entry that stores the player homes HomeArtifactDefinition (3) Champ Type Par défaut Description artifactId String — Identifier used for the stored artifact data. Generated once; never change it. storageKey String default Optional legacy suffix for migrating existing YAML files autosaveInterval Long 6000 Interval in ticks between automatic saves. Set to 0 to disable.
defaultHomes	Int	1	Default number of homes for players without special permissions
permissionLimits	List<PermissionLimit>	empty	Permission based limits that override the default home amount PermissionLimit (3) Champ Type Par défaut Description permission String — Permission to check limit Int 1 Number of homes allowed when the permission is present teleportCooldownSeconds Long? — Teleport cooldown in seconds applied when the permission is present. Leave empty to use the default cooldown.
teleportCooldownSeconds	Long	30	Cooldown in seconds between home teleports
basePermission	String?	—	Permission required to use home commands
bypassPermission	String	tinyessentials.homes.bypass	Permission qui leve toutes les restrictions : nombre de maisons illimite et aucun delai entre deux teleportations. Laisser vide pour n'accorder de derogation a personne.
homeSavedMessage	String	&aHome {home} saved.	Message shown when a home is savedPlaceholders
teleportMessage	String	&aTeleporting to {home}...	Message shown when teleporting to a homePlaceholders
cooldownMessage	String	&cPlease wait {cooldown}s before teleporting again.	Message shown when teleport is on cooldownPlaceholders
limitMessage	String	&cYou can only have {limit} homes.	Message shown when a player exceeds their home limitPlaceholders
removedMessage	String	&aHome {home} deleted.	Message shown when a home is removedPlaceholders
missingHomeMessage	String	&cHome {home} does not exist.	Message shown when a player attempts to use a missing homePlaceholders
storageUnavailableMessage	String	&cLe stockage des homes est indisponible pour le moment ({artifact}). Veuillez réessayer plus tard.	Message shown when the home storage artifact is unavailablePlaceholders
listHeader	String	&6Your homes ({count}/{limit}):	Header used when listing homesPlaceholders
listEntry	String	&7- {home} &8({world})	Format used for each home entry in the listPlaceholders
homesMenu	HomesMenuConfig	—	Configuration of the homes inventory menu HomesMenuConfig (9) Champ Type Par défaut Description title String &8Vos homes Title displayed on the homes menuPlaceholders size Int 54 Size of the homes menu inventory homeSlots List<Int> — Slots used to render the player homes defaultHomeItem MenuItemConfig — Default item used for homes when no custom icon is defined MenuItemConfig (4) Champ Type Par défaut Description item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemPlaceholders customModelData Int? — Custom model data applied to the item glow Boolean false Whether the item should glow emptyHomeItem MenuItemConfig? — Item displayed when a home slot is available but no home exists yet MenuItemConfig (4) Champ Type Par défaut Description item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemPlaceholders customModelData Int? — Custom model data applied to the item glow Boolean false Whether the item should glow filler MenuItemConfig? — Filler item applied to empty slots MenuItemConfig (4) Champ Type Par défaut Description item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemPlaceholders customModelData Int? — Custom model data applied to the item glow Boolean false Whether the item should glow previousPageButton MenuButtonConfig? — Button that moves to the previous page MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button nextPageButton MenuButtonConfig? — Button that moves to the next page MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button closeButton MenuButtonConfig? — Button that closes the menu MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button
homeEditorMenu	HomeEditorMenuConfig	—	Configuration of the home editor menu HomeEditorMenuConfig (9) Champ Type Par défaut Description title String &8Gestion de {home} Title displayed on the home editor menuPlaceholders size Int 27 Size of the home editor menu filler MenuItemConfig? — Filler item applied to empty slots in the editor MenuItemConfig (4) Champ Type Par défaut Description item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemPlaceholders customModelData Int? — Custom model data applied to the item glow Boolean false Whether the item should glow teleportButton MenuButtonConfig — Button used to teleport to the home MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button renameButton MenuButtonConfig — Button used to rename the home MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button iconFromHandButton MenuButtonConfig — Button that sets the icon using the item in the player's hand MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button resetIconButton MenuButtonConfig — Button that resets the icon to the default configuration MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button deleteButton MenuButtonConfig — Button used to delete the home MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button backButton MenuButtonConfig? — Button returning to the homes list MenuButtonConfig (2) Champ Type Par défaut Description slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button
renamePromptMessage	String	&eEntrez le nouveau nom du home dans le chat. Tapez &ccancel &epour annuler.	Message shown when a player is asked to provide a new home namePlaceholders
renameCancelledMessage	String	&cRenommage annulé.	Message shown when a player cancels the rename flowPlaceholders
renameSuccessMessage	String	&aHome renommé en {home}.	Message shown when a home is successfully renamedPlaceholders
renameConflictMessage	String	&cUn home nommé {home} existe déjà.	Message shown when renaming a home fails because the name already existsPlaceholders
renameInvalidMessage	String	&cLe nom du home est invalide.	Message shown when the provided home name is invalidPlaceholders
iconUpdatedMessage	String	&aIcône mise à jour pour {home}.	Message shown when the home icon has been updatedPlaceholders
iconResetMessage	String	&eIcône réinitialisée pour {home}.	Message shown when the home icon is reset to the defaultPlaceholders
iconMissingItemMessage	String	&cTenez un objet dans votre main principale pour définir l'icône de {home}.	Message shown when the player must hold an item to update the iconPlaceholders
wikiPlaceholder	String	https://wiki.borntocraft.fr/homes	Value returned by the placeholder %tinyessentials_homes_wiki%Placeholders

How to use it

Link an Artifact Home in artifact; it stores the homes. Without it, home commands answer that storage is unavailable.

• defaultHomes is the number of homes every player can have. Each permissionLimits item grants limit homes (the highest matching limit wins) and may lower the teleport cooldown with its own teleportCooldownSeconds (the smallest matching value wins). teleportCooldownSeconds is the default cooldown.
• A player with bypassPermission (default tinyessentials.homes.bypass) has no limit and no cooldown. Empty the field to give the exception to nobody.
• basePermission, when set, is required for all home commands in addition to each command's own permission.
• The menus are configured in homesMenu (title, size, slots, items, page buttons) and homeEditorMenu. Home names accept spaces. {home}, {limit}, {cooldown}, {count} and {world} are replaced in messages.