HOME Utilities

WARNING! DATA MIGRATION IS BROKEN IN VERSION 1.3.0! Do not update from version 1.2.3 to 1.3.0 if you already have saved teleportation points! The fix will be available in version 1.3.0!

About the Modification

HOME Utilities is a server-side mod that enhances your server's functionality by adding new commands for managing teleportation points. The mod exclusively adds commands for working with homes (teleportation points).

Available Commands

Here is the complete list of available commands:

• sethome [home_name] — saves the player's current position as a teleportation point with the specified name. If a point with this name already exists, it will be overwritten.
• delhome [home_name] — deletes the specified teleportation point from the player's list.
• home [home_name] — instantly moves the player to the saved teleportation point.
• homes — displays the full list of all teleportation points saved by the player.
• sharehome [home_name] [player_name] — allows sharing your teleportation point with another player. The target player must click on the message to add the point to their list.
• psethome [home_name] — creates a public teleportation point accessible to all players on the server. If a point with this name already exists, it will be overwritten.
• pdelhome [home_name] — deletes a public teleportation point, but only if you are its owner.
• phome [home_name] — teleports the player to a public teleportation point.
• phomes — shows the list of all public teleportation points on the server.
• homelanguage [language] — changes the language that the mod uses for messages for a specific player.
• homeslimit [limit] — by default, players can have up to 10 teleportation points. This command, available only to operators, allows changing this limit.
• phomeslimit [limit] — by default, players can create up to 10 public teleportation points. A command for operators that allows changing this limit.

Translation System

Starting from version 1.2.0, a configuration file "home_translations.json" is automatically created when the server starts, into which you can add translations of the mod's messages. Players can select a language using the /homelanguage command. Here is an example of adding a French translation:

{
  "en": {
    "sethome_success": "Your home has been set!",
    "sethome_limit": "Error : You can only have %d homes.",
    "psethome_success": "Your public home has been set!",
    "psethome_limit": "Error : You can only have %d public homes.",
    "delhome_success": "Your home has been deleted!",
    "delhome_failure": "Error : The home don't exist.",
    "pdelhome_success": "Your public home has been deleted!",
    "pdelhome_failure": "Error : The public home don't exist or you're not the owner.",
    "home_success": "You have been teleported to your home!",
    "home_failure": "Error : The home don't exist.",
    "phome_success": "You have been teleported to the public home!",
    "phome_failure": "Error : The public home don't exist.",
    "homes_success": "Your homes (You can click on them to teleport):",
    "homes_failure": "Error : You don't have any home.",
    "phomes_success": "Public homes (You can click on them to teleport):",
    "phomes_failure": "Error : The server don't have any public home.",
    "sharehome_success": "%s wants to share a home with you! To accept it click on this message.",
    "sharehome_failure": "Error : The home don't exist.",
    "sharehome_yourself": "Error : You can't share with yourself.",
    "accepthome_success": "The home has been transferred! Run /homes to find it.",
    "accepthome_failure": "Error : The home don't exist.",
    "accepthome_empty": "Error : There is no home to accept.",
    "homelanguage_success": "HOME language changed!",
    "homelanguage_failure": "Error : The language provided is invalid.",
    "homeslimit_success": "The new limit of homes has been set!",
    "homeslimit_failure": "Error : Please provide a number that is not negative.",
    "phomeslimit_success": "The new limit of public homes has been set!",
    "phomeslimit_failure": "Error : Please provide a number that is not negative.",
    "version": "1.3"
  },
  "fr": {
    "sethome_success": "Votre home a été défini !",
    "sethome_limit": "Erreur : Vous ne pouvez avoir que %d homes.",
    "psethome_success": "Votre home public a été défini !",
    "psethome_limit": "Erreur : Vous ne pouvez avoir que %d homes publics.",
    "delhome_success": "Votre home a été supprimé !",
    "delhome_failure": "Erreur : Ce home n'existe pas.",
    "pdelhome_success": "Votre home public a été supprimé !",
    "pdelhome_failure": "Erreur : Ce home public n'existe pas ou vous n'en êtes pas le propriétaire.",
    "home_success": "Vous avez été téléporté à votre home !",
    "home_failure": "Erreur : Ce home n'existe pas.",
    "phome_success": "Vous avez été téléporté au home public !",
    "phome_failure": "Erreur : Ce home public n'existe pas.",
    "homes_success": "Vos homes (cliquez pour vous téléporter) :",
    "homes_failure": "Erreur : Vous n'avez aucun home.",
    "phomes_success": "Homes publics (cliquez pour vous téléporter) :",
    "phomes_failure": "Erreur : Le serveur n'a aucun home public.",
    "sharehome_success": "%s souhaite partager un home avec vous ! Cliquez sur ce message pour l'accepter.",
    "sharehome_failure": "Erreur : Ce home n'existe pas.",
    "sharehome_yourself": "Erreur : Vous ne pouvez pas partager avec vous-même.",
    "accepthome_success": "Le home a été transféré ! Utilisez /homes pour le trouver.",
    "accepthome_failure": "Erreur : Ce home n'existe pas.",
    "accepthome_empty": "Erreur : Aucun home à accepter.",
    "homelanguage_success": "Langue du HOME modifiée !",
    "homelanguage_failure": "Erreur : La langue fournie est invalide.",
    "homeslimit_success": "La nouvelle limite de homes a été définie !",
    "homeslimit_failure": "Erreur : Veuillez fournir un nombre positif.",
    "phomeslimit_success": "La nouvelle limite de homes publics a été définie !",
    "phomeslimit_failure": "Erreur : Veuillez fournir un nombre positif.",
    "version": "1.3"
  }
}