Home Manager

Manage player homes with permissions and cooldowns

МанифестПредоставлено: TinyEssentials

Поля

Поле	Тип	По умолчанию	Описание
artifact	Ref<HomeArtifactDefinition>	—	Linked artifact_home entry that stores the player homes HomeArtifactDefinition (3) Поле Тип По умолчанию Описание 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) Поле Тип По умолчанию Описание 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 savedПлейсхолдеры
teleportMessage	String	&aTeleporting to {home}...	Message shown when teleporting to a homeПлейсхолдеры
cooldownMessage	String	&cPlease wait {cooldown}s before teleporting again.	Message shown when teleport is on cooldownПлейсхолдеры
limitMessage	String	&cYou can only have {limit} homes.	Message shown when a player exceeds their home limitПлейсхолдеры
removedMessage	String	&aHome {home} deleted.	Message shown when a home is removedПлейсхолдеры
missingHomeMessage	String	&cHome {home} does not exist.	Message shown when a player attempts to use a missing homeПлейсхолдеры
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 unavailableПлейсхолдеры
listHeader	String	&6Your homes ({count}/{limit}):	Header used when listing homesПлейсхолдеры
listEntry	String	&7- {home} &8({world})	Format used for each home entry in the listПлейсхолдеры
homesMenu	HomesMenuConfig	—	Configuration of the homes inventory menu HomesMenuConfig (9) Поле Тип По умолчанию Описание title String &8Vos homes Title displayed on the homes menuПлейсхолдеры 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) Поле Тип По умолчанию Описание item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemПлейсхолдеры 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) Поле Тип По умолчанию Описание item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemПлейсхолдеры 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) Поле Тип По умолчанию Описание item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemПлейсхолдеры 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) Поле Тип По умолчанию Описание 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) Поле Тип По умолчанию Описание slot Int 0 Slot used by the button item MenuItemConfig — Item displayed for the button closeButton MenuButtonConfig? — Button that closes the menu MenuButtonConfig (2) Поле Тип По умолчанию Описание 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) Поле Тип По умолчанию Описание title String &8Gestion de {home} Title displayed on the home editor menuПлейсхолдеры size Int 27 Size of the home editor menu filler MenuItemConfig? — Filler item applied to empty slots in the editor MenuItemConfig (4) Поле Тип По умолчанию Описание item Var<Item> — Item template used for menu entries (supports Typewriter custom or serialized items) lore List<String> — Lore displayed on the itemПлейсхолдеры 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) Поле Тип По умолчанию Описание 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) Поле Тип По умолчанию Описание 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) Поле Тип По умолчанию Описание 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) Поле Тип По умолчанию Описание 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) Поле Тип По умолчанию Описание 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) Поле Тип По умолчанию Описание 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 nameПлейсхолдеры
renameCancelledMessage	String	&cRenommage annulé.	Message shown when a player cancels the rename flowПлейсхолдеры
renameSuccessMessage	String	&aHome renommé en {home}.	Message shown when a home is successfully renamedПлейсхолдеры
renameConflictMessage	String	&cUn home nommé {home} existe déjà.	Message shown when renaming a home fails because the name already existsПлейсхолдеры
renameInvalidMessage	String	&cLe nom du home est invalide.	Message shown when the provided home name is invalidПлейсхолдеры
iconUpdatedMessage	String	&aIcône mise à jour pour {home}.	Message shown when the home icon has been updatedПлейсхолдеры
iconResetMessage	String	&eIcône réinitialisée pour {home}.	Message shown when the home icon is reset to the defaultПлейсхолдеры
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 iconПлейсхолдеры
wikiPlaceholder	String	https://wiki.borntocraft.fr/homes	Value returned by the placeholder %tinyessentials_homes_wiki%Плейсхолдеры

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.