Home Manager

Manage player homes with permissions and cooldowns

ManifestBereitgestellt von TinyEssentials

Felder

Feld	Typ	Standard	Beschreibung
artifact	Ref<HomeArtifactDefinition>	—	Linked artifact_home entry that stores the player homes HomeArtifactDefinition (3) Feld Typ Standard Beschreibung 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) Feld Typ Standard Beschreibung 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 savedPlatzhalter
teleportMessage	String	&aTeleporting to {home}...	Message shown when teleporting to a homePlatzhalter
cooldownMessage	String	&cPlease wait {cooldown}s before teleporting again.	Message shown when teleport is on cooldownPlatzhalter
limitMessage	String	&cYou can only have {limit} homes.	Message shown when a player exceeds their home limitPlatzhalter
removedMessage	String	&aHome {home} deleted.	Message shown when a home is removedPlatzhalter
missingHomeMessage	String	&cHome {home} does not exist.	Message shown when a player attempts to use a missing homePlatzhalter
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 unavailablePlatzhalter
listHeader	String	&6Your homes ({count}/{limit}):	Header used when listing homesPlatzhalter
listEntry	String	&7- {home} &8({world})	Format used for each home entry in the listPlatzhalter
homesMenu	HomesMenuConfig	—	Configuration of the homes inventory menu HomesMenuConfig (9) Feld Typ Standard Beschreibung title String &8Vos homes Title displayed on the homes menuPlatzhalter 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) Feld Typ Standard Beschreibung item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemPlatzhalter 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) Feld Typ Standard Beschreibung item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemPlatzhalter 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) Feld Typ Standard Beschreibung item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemPlatzhalter 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) Feld Typ Standard Beschreibung 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) Feld Typ Standard Beschreibung slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button closeButton MenuButtonConfig? — Button that closes the menu MenuButtonConfig (2) Feld Typ Standard Beschreibung 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) Feld Typ Standard Beschreibung title String &8Gestion de {home} Title displayed on the home editor menuPlatzhalter size Int 27 Size of the home editor menu filler MenuItemConfig? — Filler item applied to empty slots in the editor MenuItemConfig (4) Feld Typ Standard Beschreibung item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemPlatzhalter 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) Feld Typ Standard Beschreibung 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) Feld Typ Standard Beschreibung 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) Feld Typ Standard Beschreibung 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) Feld Typ Standard Beschreibung 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) Feld Typ Standard Beschreibung 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) Feld Typ Standard Beschreibung 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 namePlatzhalter
renameCancelledMessage	String	&cRenommage annulé.	Message shown when a player cancels the rename flowPlatzhalter
renameSuccessMessage	String	&aHome renommé en {home}.	Message shown when a home is successfully renamedPlatzhalter
renameConflictMessage	String	&cUn home nommé {home} existe déjà.	Message shown when renaming a home fails because the name already existsPlatzhalter
renameInvalidMessage	String	&cLe nom du home est invalide.	Message shown when the provided home name is invalidPlatzhalter
iconUpdatedMessage	String	&aIcône mise à jour pour {home}.	Message shown when the home icon has been updatedPlatzhalter
iconResetMessage	String	&eIcône réinitialisée pour {home}.	Message shown when the home icon is reset to the defaultPlatzhalter
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 iconPlatzhalter
wikiPlaceholder	String	https://wiki.borntocraft.fr/homes	Value returned by the placeholder %tinyessentials_homes_wiki%Platzhalter

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.