HuskHomes

HuskHomes 2.10.1 makes a couple of small improvements and fixes bugs.

• Fix the wrong version being reported in-game
• Fixed teleports failing to complete if players are being ridden by passenger entities (#114)
• Updated Pl3xMap integration to support SquareMap. Pl3x has discontinued Pl3xMap and it is now being maintained by a new team under the SquareMap name. (#121)
• Added an option to disable the /back command in config.yml under general options. (#115)
• Separated some permission nodes for teleport request and teleport commands. Old permission nodes should work as normal, but additional permissions have been added.
  • /tp - huskhomes.tp (previously huskhomes.tp)
  • /tphere - huskhomes.tphere (previously huskhomes.tp)
  • /tpa - huskhomes.tpa (previously huskhomes.tprequest)
  • /tpahere - huskhomes.tpahere (previously huskhomes.tprequest)
  • /tpaccept - huskhomes.tpaccept (previously huskhomes.tprequest)
  • /tpdeny - huskhomes.tpdeny (previously huskhomes.tprequest)
• Updated polish (pl) localisation, courtesy of ReferTV
• Update libraries

To update, just drag+drop.

HuskHomes 2.10 adds a number of long standing small feature requests, such as the ability to handle multiple requests from players as well as automatic name completion. It also ensures compatibility with the upcoming Minecraft 1.18 update.

• Added player name auto completion, which can be turned off in config.yml (e.g typing /tpa William will autocomplete to William278 if "William278" is online but "William" is not.) (#105)
• You can now receive multiple teleport requests at once and accept and deny them individually (/tpaccept ; /tpdeny ). (#74)
  • The [Accept] and [Deny] buttons will correctly accept or deny the request for that player.
  • Players can no longer spam send tp requests to a user, only once the last request has expired will their request go through again.
• You can now specify where the teleport warmup countdown message will be displayed; ACTION_BAR, TITLE, SUBTITLE or CHAT through a new option in config.yml (#48)
• Fixed an issue that meant the sound effect for teleporting would get sometimes cut off (#107)
• Added the ability to limit the maximum number of public homes a player may set through the huskhomes.max_public_homes. permission node. (#91)
• Added the ability to have limit-based permission nodes stack (the limit is the sum of the player's limit permission) rather than just take the highest one. (#108)
• Fixed an issue with the Pl3xMap integration that meant multiversed worlds that initialised after world startup wouldn't be able to display HuskHomes markers (#110)
• Updated the Jedis (Redis API) dependency (#98)
• API: Added PlayerPreTeleportEvent which fires before a player teleports and is cancellable

To update, regenerate your messages file or replace the teleport_request_options locale with the latest one from here. The update should also automatically add two new items to your config.yml file as well.

HuskHomes 2.9.1 is a simple hotfix update addressing a few bugs and updating translations.

• Updated the Polish localisation (pl.yml), courtesy of @ReferTV (#101)
• Fixed the Pl3xMap integration failing to initialize (#99)
• Added bStats metrics for cross-server data bridge type (redis/plugin messaging)
• Minor code tweaks and optimizations

No config changes. To update, drag+drop and replace the old jar.

HuskHomes 2.9 adds Redis support and now makes use of Hikari connection pooling for more efficient database querying, among a few other tweaks, optimizations & improvements.

• HuskHomes now uses Hikari connection pooling for establishing a connection to your database
  • Added new connection_pool_options section in the config file letting you control the pool size
• Added support for Redis messaging
  • To enable, change messenger_type to 'redis' and enter your Redis server credentials under redis_credentials
  • This should allow servers running RedisBungee to operate
• Added Traditional Chinese (zh-tw) localisation, courtesy of TonyPak
• Updated the Italian (it) localisation, courtesy of Villag3r
• Updated the Simplified Chinese (zh-cn) localisation, courtesy of SnivyJ_
• Updated the /huskhomes update menu
• Added support for automatically forwarding usage of the /rtp command to HuskBungeeRTP if it detects you have that plugin installed.
• Fixed an issue with some versions of MySQL where it would output a "Value '0000-00-00 00:00:00' can not be represented as java.sql.Timestamp" error; HuskHomes will now try and convert these to null values in your database. Please make sure your version of MySQL is up-to-date (latest v8+)
• Fixed deleting home and warp events not actually cancelling properly

To update from the previous version of HuskHomes, drag and drop your jar file to replace the old one. If you'd like to make use of Redis, switch messenger_type from 'pluginmessage' to 'redis' and enter the credentials under redis_credentials

HuskHomes 2.8.2 fixes an important permission error preventing the use of the /delhome command in many cases and adds some new error locales when editing, deleting or viewing another player's homes.

• Fixed /delhome returning a permission error when deleting your own homes
• Added two new locales that are used when modifying or viewing other player's homes, replacing messages like "You don't have any homes set" / "You don't have a home named X" with "Player hasn't set any homes" / "Player doesn't have a home named X", which should help with clarity.
  • error_no_homes_set_other
  • error_home_invalid_other
• Fixed some languages having some locales missing altogether in their files.
• Fixed console log typo regarding the Pl3xMap integration

HuskHomes 2.8.1 has now been released which fixes a critical bug with the database upgrade system and adds automatic SQLite backups before database upgrades.

⚠️ This release has reported issues with the Migrator and is UNSTABLE. Do NOT download right now.

HuskHomes 2.8 is now available at last and it adds new admin permissions to let staff members view, edit, delete & teleport to other player's
private and public homes for easy moderation, as well as a plethora of other optimizations, fixes & tweaks.

• Admins can now teleport to, edit and delete private homes so long as they have the respective permission node:
  • huskhomes.home.other
  • huskhomes.delhome.other
  • huskhomes.edithome.other
• This is done through /home owner_name.home_name, /edithome owner_name.home_name and /delhome owner_name.home_name respectively (fairly self explanatory)
• Fixed an issue preventing the plugin from correctly disambiguating between similarly named players when using teleport and teleport request commands
• Warps and homes now have timestamps tracking when they were set and can be viewed in the edithome/editwarp menu
• Added support for a new server map plugin, Pl3xMap
• Greatly optimised database handling and performed general plugin cleanup, warning reductions & refactoring.
• HuskHomes now uses its own icons on maps; can be changed by replacing them in the /HuskHomes/marker-icons folder if you are using the map integration.
• Fixed the database upgrade system not working correctly in some circumstances
• Updated it-it (Italian) locale, courtesy of Villag3r
• Bump VaultAPI to 1.7.1
• Fully asynchronised the EssentialsX migrator to allow massive amounts of data to correctly transfer
• API: Renamed two methods to fix inconsistent capitalisation and deprecated the old ones (check the Javadocs!)

To upgrade, simply drag+drop. You must regenerate your messages file for this release as it makes important changes. Or, copy these updated locales from this page into your file:

• edit_home_options
• edit_home_options_make_public
• edit_home_options_make_private
• home_list_item

• Re-added Polish (pl) localisation
• Fixed an important issue where the database upgrader would not work. (this means you can now properly upgrade from 2.6.x and below)
  • The system will try and upgrade your database again
• API: Added a method for updating the player's previous location

HuskHomes 2.7 adds two brand new commands - /tpoffline and /tpignore that let you teleport to where players logged off from and to toggle ignoring incoming teleport requests. It also adds a new Simplified Chinese translation.

Changelog

Additions

• Added /tpoffline that lets you teleport to where a player last logged out on your HuskHomes network of servers. Permission: huskhomes.tpoffline; restricted to OPs by default, aliases: /tpaignore, /ignoretprequests (#63)
• Added /tpignore that lets you toggle between ignoring and listening for incoming teleport requests. It works cross-server and remembers your status between sessions, too. Permission: huskhomes.tpignore (not restricted by default) (#61)
• Added Simplified Chinese (简体中文支持) localisation (zh-tw) courtesy of SnivyJ (@Dragon_AJiaoCat) (#73)
• The database format has been upgraded to accommodate for the new tpoffline and ignore features. When you start the plugin, your database will be upgraded.
• Added the ability to specify target servers based on source worlds for homes to the Essentials migrator (huskhomes migrate essentialsx [world] [target server])
• You can now use unicode and non-alphanumeric characters in home descriptions (can be turned off with a new option in config.yml; allow_unicode_descriptions: true/false under general:.
• Added two new permission nodes; huskhomes.delhome.all and huskhomes.delwarp.all (both true by default) that allow you to fine-tune whether players can use the /delwarp and /delhome commands.
• Added the following new locales to accommodate the new features: teleporting_offline_player, error_no_offline_position, tpignore_toggle_on, tpignore_toggle_off, tpignore_on_reminder, & error_ignoring_teleport_requests.
• Additionally, the two invalid description locales have been removed and split into four locales for more specific error messages: error_edit_home_description_length, error_edit_home_description_characters, error_edit_warp_description_length & error_edit_warp_description_characters.

Changes & Fixes

• Updated and improved the EssentialsX migrator to respect newer Essentials configuration structures and world UUID handling. (#70)
• Fixed the wrong locale being used for spending money to use the /back command (#69)
• Updated the edit_home_options and edit_warp_options locales to fix them sending commands rather than suggesting for editing and renaming.
• Adjusted the inheritance of some permission nodes by default to fix inconsistencies
• Updated the link to the configuration guide in config.yml
• Fixed a typo in various SQL exception console error messages.
• Updated the translation contributors in the about menu.
• Developer API: HuskHomes events are once again cancellable. (#64)

How to update

To update, simply drag + drop the new JAR file into your plugins folder and delete the old version.

You should regenerate your messages file for this update (simply delete the messages-xx-xx.yml file in the HuskHomes subfolder located in your plugins folder). Alternatively, you can update the following locales: edit_home_options & edit_warp_options.

Note for users running HuskHomes on a mySQL database

You may receive a console note when updating HuskHomes on all your servers (Skipped performing the database upgrade...). This is because HuskHomes is checking for a database upgrade that has already been carried out by another instance of the plugin on another server. You can safely ignore this message.

Planned for the next release (Coming soon!)

• The ability for admins to teleport to private (non-public) homes
• Better teleport request handling to allow players to manage multiple requests
• Pl3xM4p support

This is a preview development build and is not for deployment on production servers.

Changelog Work-in-Progress:

• Added /tpoffline that lets you teleport to where a player last logged out on your HuskHomes network of servers. Permission: huskhomes.tpoffline; restricted to OPs by default, aliases: /tpaignore, /ignoretprequests
• Added /tpignore that lets you toggle between ignoring and listening for incoming teleport requests. It works cross-server and remembers your status between sessions, too. Permission: huskhomes.tpignore (not restricted by default)
• The database format has been upgraded to accommodate for the new tpoffline and ignore features.
• Fixed the wrong message being used for /back
• API events can now be cancelled again
• Updated the edit_home_options and edit_warp_options locales to fix them sending commands rather than suggesting for editing and renaming
• Updated and improved the EssentialsX migrator to respect newer Essentials configuration structures and world UUID handling
• Added the ability to specify target servers based on source worlds for homes to the Essentials migrator (huskhomes migrate essentialsx [world] [target server])
• You can now use unicode and non-alphanumeric characters in home descriptions (can be turned off with a new option in config.yml; allow_unicode_descriptions: true/false under general
• Added two new permission nodes; huskhomes.delhome.all and huskhomes.delwarp.all (both true by default) that allow you to fine-tune whether players can use the /delwarp and /delhome commands.
• Updated the link to the configuration guide in config.yml
• Fixed a typo in error messages
• Adjusted the inheritance of some permission nodes by default to fix inconsistencies
• Added the following new locales to accommodate the new features: teleporting_offline_player, error_no_offline_position, tpignore_toggle_on, tpignore_toggle_off, tpignore_on_reminder, & error_ignoring_teleport_requests

This update fixes an issue with /back permissions. To let players use the command, use the huskhomes.back permission - and to let them also use /back to return by death to where they died, use huskhomes.back.death. By the way, HuskHomes also supports Minecraft 1.17.1!

• Fixed /back permissions not working correctly (#60)
• Fixed the wrong number appearing in the maximum homes reached message.
• Updated Italian locale; it-it (#59)

This version of HuskHomes adds BlueMap support and fixes a few small issues.
If you were experiencing issues running HuskHomesGUI previously, please update to the latest version of that which fixes various issues.

• Added support for BlueMap to HuskHomes.
  • To use BlueMap, change map_type in config.yml from "dynmap" to "BlueMap" and make sure it is enabled.
  • Homes and warps will then be displayed as markers on your BlueMap.
  • In the future, additional support will be added to replace the default "i" icon with some better ones.
• Fixed Dynmap failing to initialize properly.
• Updated the it-it (Italian) locale
• A few more plugin metrics are now recorded via bStats.

This release of HuskHomes makes a number of fixes. It is the first version of HuskHomes to completely require Java 16.

• HuskHomes now requires Java 16
• Updated messages file to rearrange the edit home and edit warp menu; now all locales are formatted with MineDown (Fix #43)
  • It is recommended that you regenerate your messages-xx-xx.yml file (delete it and allow the plugin to recreate it)
• Fixed two IllegalArgumentExceptions, one with tab completing /edithome & /editwarp; another with using /back without having a last position when you join the server.
• Various Java-16 related optimizations.
• API: Fixed API & javadoc access via jitpack not functioning correctly.
• API: There is a new method of accessing the API; HuskHomesAPI#getInstance() - the old method, accessed through the main HuskHomes class has been deprecated.

HuskHomes 2.6 updates the plugin to Java 16, ensures support for Minecraft 1.17, re-adds player tab completion cross-server, improves the way menu lists are displayed, adds a command list and fixes bugs. This version introduces some config and message file changes, so I strongly recommend regenerating your config and especially your messages file.

• The plugin now requires Java 16.
• Re-added tab completion for players cross-server (#47)
• Fixed the Decline button on the teleportation request notification not working (#41)
• Fixed warps not being correctly hidden from the warp list (#44)
• Added an option to always teleport players to spawn on login (#28)
• Updated the messages file to format more things properly using MineDown
• /rtp will now limit itself to teleporting you within the world border even if you set the rtp range greater than it (#46)
• Updated config.yml with regard to the dynmap integration; you may need to change some settings if you were using this. This is to make way for BlueMap support in the next version.
• Added a command list (/huskhomes help). This now displays by default too if you just type /huskhomes, you can still view the plugin information with /huskhomes about.
• Fixed /tp erroneously checking if a world that wasn't on the server is null (because it probably is) (#49)
• If the SQL JDBC library is not present it will now be downloaded at runtime. This should fix some occurrences of the library going missing when upgrading to Java 16.

This version of HuskHomes is compatible with Minecraft 1.16.5 and 1.17

This release massively refactors the plugin for significantly improved performance. Please regenerate your language file for this release.

• Massively refactored database options such that they are handled asynchronously (Fixes #1)
• PaperLib is now used for teleport operations for asynchronous smooth performance when teleporting on papermc servers (particularly good for /rtp performance)
• Overhauled in-game text appearance and formatting.
• Removed zh-tw, pl, de-de & ru languages as a result of the above change.
• Optimized teleportation countdown handling such the plugin will no longer run a schedule every second but only when it needs to.
• If a teleport requests expires and you try to accept it, a message will now display to let you know.
• Improved the HuskHomes information menu
• Removed the legacy migrator (from HuskHomes versions 1.X); if you want to update from 1.X then update to HuskHomes 2.4.2 using the migrator and then update to this version.
• API events are no longer cancellable.
• TAB completion cross-server has been removed (this will be re-added soon in an improved form).

Running HuskHomesGUI? You'll need to download the updated version of that as well.

HuskHomes 2.4.1 adds a huskhomes.warp.* option for permission-restricted warps and the option to hide restricted warps in the /warplist, as well as expanding the developer API to allow for other plugins to teleport players.

• Add a warp permission override (huskhome.warp.*) for servers using permission-restricted warps. (#30)
  • Lets you access all warps, even if you don't have specific nodes on servers with permission restricted warps enabled.
• Added an option (true by default) to hide permission restricted warps in the /warplist page. (#27)
• Added two new API options to allow plugins to queue teleports
  • HuskHomesAPI#teleportPlayer(Player, TeleportationPoint, doTeleportationWarmup)
  • HuskHomesAPI#teleportPlayer(Player, targetPlayerName, doTeleportationWarmup)

This should be a drag+drop replacement for the previous version. Thank you as always!

HuskHomes 2.4 adds cross-server /spawn (finally!), permission-restricted warps and functionality to teleport players to warps and public homes via console.

• Added a configuration option to set a /spawn position cross-server (#20)
  • This works by setting a warp at the spawn position. The /spawn command automatically direct you there. The name of the "spawn" warp can be changed in the configuration too.
  • To use, change enabled under spawn_command, bungee_network_spawn to true on all servers you want this enabled (make sure the warp_name matches too between them). Then, type /setspawn to set your cross-server spawn where you want on your network.
  • Players will not respawn at a cross-server spawn position if they die on other servers (as player spawn points are per-server and can be updated by things like beds and respawn anchors)
• Added a configuration option to restrict warps behind permissions. (#25)
  • Players will not be able to teleport to /warp locations unless they have the correct permission if this is enabled.
  • To enable it in the config.yml, set enabled to true under warp_command, permission_restrictions.
  • Then, by default you will need to grant the permission huskhomes.warp.<warp_name> to allow users to use warps. You can also customize the format of the permission using the format config option.
• You can now teleport players to warps and public homes through console. (#26)
  • Usage: /warp <warp> <player> or /phome <owner_name.home_name> <player> in console.
  • This bypasses permission requirements and teleportation warmup; players will teleport instantly.
• (API) Fixed an issue for developers where updating home and warp object's descriptions tried to update their name (to admittedly hilarious results).
• Added three new translatable strings.

This update is designed to be a drag+drop replacement for the previous version of HuskHomes. If you're having issues with finding the new options in the configuration file, I recommend regenerating it (make a copy of config.yml, delete the original then restart the server). Then you can go through and fill in the config again. As a reminder if you need support there's now a support discord (link on the resource page).

By the way, a few people have asked me in the past about tipping me for development, so I setup a "buy me a coffee" page. Thank you for your generosity, it's really appreciated, though don't feel obliged to donate. The link is now on the resource page.

This release fixes a critical issue preventing cross-server teleportation from working.

• Fixed player teleportation state not being set in SQL

It is important that you update; to do so, simply drag+drop the plugin and replace the old jar.

This minor release of HuskHomes expands the HuskHomes API slightly to support a new extension of PlaceholderAPI for HuskHomes.

• Added getMaxSethomes(player) and getFreeSethomes(player) to the HuskHomes API
• Made some optimizations to SQL executions

Also, I made a fork of HomeGUI for Essentials that supports HuskHomes. If you like chest GUIs for viewing homes, you could take a look.

This release should be a simple drag+drop replacement.

• Added Italian (it-it) localisation, courtesy of Villag3r_
• Added ability to delete all your homes and all the server warps. To do this, type /delhome all or /delwarp all respectively. (#23)
• Underwent further refactoring to project code, courtesy of @imDaniX
• TAB completion for players now works cross server. (#13)
  • HuskHomes will now try and keep track of all the players on HuskHomes-enabled servers in the same cluster and add them to the teleport commands TAB completion list.
  • It updates this when a player joins as well as periodically every 60 seconds (configurable) if there's people online
  • Can be disabled if you want (see under bungee settings in config)
• Added an economy option to charge per use of the /back command (#18)
• Added additional strings to language files to let you customize how homes and warps display in the list. (#22)
• Added new strings to set the default home and warp descriptions (#21)
• Fixed a NPE related to the Citizens plugin on the player join event
• Fixed the number of items per page displaying incorrectly in the next page button tooltips. (#19)