HuskHomes

HuskHomes 4.2 is now compatible with Fabric (1.19.4) & Sponge (API v8)! Please make sure you download the correct jar file, as Sponge and Fabric are not bundled into the Spigot/Paper "Plugin" jar.

• Add Fabric (Minecraft 1.19.4) server-side mod support (#348)
  • You can now run HuskHomes on Fabric 1.19.4 servers
  • Requires the Fabric API
  • A build for 1.19.2 servers is also being released for those using Cobblemon
  • HuskHomes on Fabric will target the latest release version of Minecraft
  • Also now available on CurseForge
  • Please note global respawning is not currently working on fabric.
• Add Sponge (SpongeAPI v8) server mod support (#354)
  • API v8 targets 1.16.5 primarily. Compatibility for newer versions should work, though since newer versions will target API v9 I may update this in the future.
  • The sponge hook supports the Sponge economy service system
• Added ability to resolve unsafe positions by UUID where the identifier would otherwise be unsafe
  • A UUID is now accepted in place of the home/warp name in all home and warp commands
  • The UUID name will be used and suggested in renaming or description updating commands when the home command contains MineDown-format sensitive characters to avoid conflicts
  • This is mostly useful for international users who have enabled unicode characters in home names (previously, inserting a [ for instance would break the menus)

To update, you should regenerate your locale files. Otherwise, there are no config changes. Please make sure to download the correct file.

HuskHomes 4.1.1 makes a minor improvement to the /edithome privacy command and fixes a few bugs.

• Re-added the ability to toggle a home's privacy without specifying a public/private argument (#344)
• Fixed the TELEPORT_REQUEST_RECEIVED sound effect option being missing from the default config (#343)
• Updated the German (de-de) locales, courtesy of @Ceddix (#341)
• Fixed HuskHomes loading after Essentials on paper servers due to now being a paper plugin (a manual load-before has now been added)
• API: Fixed the API sources not being correctly published in v4.1

To update from v4.1, just drag+drop. If you're updating from earlier versions, you should regenerate your config, locale, spawn & server files

HuskHomes 4.1 adds support for running HuskHomes as a native Paper plugin, adds support for Pl3xMap v2, adds several new API events and makes a number of other quality-of-life improvements and bug fixes.

• Added support for running HuskHomes as a Paper Plugin (1.19.3+ only)
  • Users running on supported versions of Paper will see the plugin show up as a "Paper Plugin" in the /plugins menu
  • On the paper plugin version, disabled commands won't register at all as Paper supports direct runtime command map registering
  • HuskHomes will still run as normal on Spigot servers
• Added a hook for Pl3xMap v2, for users running on Paper servers. This allows you to display homes and warps on your Pl3xMap
• Added a configurable sound effect (default: entity.experience_orb.pickup) when a player receives a teleport request (#333)
• Fixed an issue where Redis messages weren't being dispatched asynchronously
• Fixed an issue where the subnetwork channel ID was using the wrong namespace
• Fixed an issue where PlaceholderAPI was not registered as a softdepend in plugin.yml (#339)
• Fixed the error message displayed when you could not set any more homes because you had reached the limit not being formatted with the correct placeholder replacement (#338)
• Fixed an issue related to performing transactions with RedisEconomy (#340)
• API: Added four new cancellable API events:
  • TeleportBackEvent (extends TeleportEvent) — Fired when a teleport returning a user to their last position is teleported (a new Teleport.Type#BACK has also been added). Includes a convenience method for getting the last position (#180)
  • SendTeleportRequestEvent — When a player sends a teleport request
  • ReceiveTeleportRequestEvent — When a player receives a teleport request
  • ReplyTeleportRequestEvent — When the player who received a teleport request accepts/declines it

To update, you can drag+drop. You should regenerate your config and locale files for this release!

HuskHomes 4.0.5 moves the PlaceholderAPI expansion to within the plugin as a hook. This means you no longer need to download the HuskHomesPlaceholders hook from the PlaceholderAPI eCloud. It also fixes a number of bugs from the previous release.

• Added a hook for PlaceholderAPI, replacing the existing PlaceholderAPI expansion that required a separate eCloud download
  • Please uninstall the existing HuskHomesPlaceholders hook by removing it from your expansions folder and restarting your server
• Fixed the wrong child permissions for the edithome and editwarp commands being registered
• Fixed teleporting other users to homes or warps being set as a default permission for normal users

To update from v4.0.x, just drag+drop. For the full HuskHomes v4.0 changelog, see here -- if you're updating from v3.x, please regenerate all your config files.

HuskHomes 4.0.4 fixes a few more minor bugs present in the previous release!

• Fixed it being possible to set homes and warps with periods in their name
• Fixed it not being possible to teleport to, edit or delete homes with periods in their name
• Fixed permission restricted warps being included in TAB completion lists

To update from v4.0.x, just drag+drop. For the full HuskHomes v4.0 changelog, see here -- if you're updating from v3.x, please regenerate all your config files.

HuskHomes 4.0.3 is a third round of bug fixes for HuskHomes v4.0, to address a few issues in the previous releases.

• Fixed using /tp <user> <coords> and /warp <name> <user> through console on an offline user failing to resolve an online user at teleport construction time causing errors in console
• Worlds will now be resolved by environments as a third failsafe if one could not be resolved by name / uuid
• Added additional error handling for teleporting locally inbound teleports when a world could not be found or the coordinates were illegal
• Added additional error handling to the Redis broker

To update from v4.0.x, just drag+drop. For the full HuskHomes v4.0 changelog, see here -- if you're updating from v3.x, please regenerate all your config files.

HuskHomes 4.0.2 is a hotfix update, fixing a few more bugs present in the initial release.

• Global respawn will now always teleport players to the global spawn if they have no respawn position
• Fixed some commands not working out-of-box or in console due to the wrong permission default being applied
• Fixed the [player] argument being missing from the usage of the /warp command

To update from v4.0.x, just drag+drop. For the full HuskHomes v4.0 changelog, see here -- if you're updating from v3.x, please regenerate all your config files.

HuskHomes 4.0.1 is a hotfix update, addressing a few issues missed in the initial v4.0 release.

• Fixed warp and home list caches not being invalidated when you set, delete or rename a home/warp
• Fixed an ArrayIndexOutOfBoundsException when resolving some public home names
• Fixed an issue where it was not possible to view the home lists of other users using /homelist

To update from v4.0, just drag+drop. For the full HuskHomes v4.0 changelog, see here -- if you're updating from v3.x, please regenerate all your config files.

HuskHomes 4.0 is a new major release bringing with it a large-scale rewrite of HuskHomes' internal plugin logic to address the significant number of bugs and stability in HuskHomes v3.x, and make a selection of user experience improvements.

I would like to apologise for any inconvenience caused issues present in the last major version, which particularly affected users making use of HuskHomes' cross-server functionality. Although this release doesn't contain any significant new features, the nature of the rewrite means that it has introduced breaking API changes, necessitating a major version bump.

Updates are also releasing today for HuskHomesPlaceholders (the PlaceholderAPI expansion) and HuskHomesGUI (the GUI add-on).

New features & improvements

• Added an option to disable commodore brigadier-style TAB completion to better support command and command-namespace hiding plugins.
• The global player list used for TAB completing usernames has been made significantly more accurate
  • It is now restricted to only servers with HuskHomes on and which are in the same cluster.
  • The list is even more accurate when using Redis due to limitations of the plugin message broker
• The server auto-fetching system has been removed due to instability; you must now ensure the server name is set correctly on first-time setup.
• The Global Respawning feature will now teleport users to your global spawn rather than just the local spawn on that server, if you are using the Global Spawn feature.
• Renamed a few plugin permissions (consult the updated docs for more information):
  • huskhomes.bypass.teleport_warmup -> huskhomes.bypass_teleport_warmup
  • huskhomes.bypass.rtp_cooldown -> huskhomes.command.rtp.bypass_cooldown
  • huskhomes.bypass.economy_checks -> huskhomes.bypass_economy_checks
• /phome and /phomelist are now the primary aliases of the public home and public home list commands, instead of /publichome and /publichomelist
• Improved TAB auto-completion for homes, public homes & warps, including automatic filtering for public homes by dot-delimited user prefixes
• Removed the migrator from HuskHomes v2.x; please update to v3.x and then to this release to migrate your data. Sorry for the inconvenience caused.
• You can now customise the name of the public home and warp marker group names displayed on map hooks through the plugin locales
• You can now use the /spawn command to teleport a player to the spawn by name (/spawn <player>); requires the huskhomes.command.spawn.other permission and can be executed through console
• Commands executed through console have been improved; they will now display the same as in-game, with full formatting support
• You can now edit and delete homes and warps (but not their location) through console

Bug fixes

• Fixed the "Message Dispatch after 5 Seconds" error on cross-server setups, caused by extreme thread pool exhaustion.
• Fixed a crash where viewing attempting to view the warp list would crash the server in certain environments
• Fixed a bug where the overwrite_homes_warps feature would fail to overwrite the player's homes if they had reached the maximum number of homes
• Fixed a bug where sounds would fail to play in the previous version
• Fixed a bug where the /setspawn command would fail to write the cached spawn file to disk
• Fixed a bug where attempting to teleport similarly named players cross-server would fail occasionally
• Fixed a bug where players where it would sometimes not be possible to teleport users by name who had number-only usernames
• Fixed a bug where the update checker would incorrectly report that an update was available
• Fixed a bug where economy actions would not be correctly processed as hooks weren't properly being accessed
• Fixed a bug where map markers would not be updated properly when a change was made to a home/public warp on Dynmap/BlueMap
• Fixed issues where cancelling some API events would still display error messages to players

Localisation changes

• Added Turkish (tr-tr) locales, courtesy of @WinTone01 (#310)
• Updated the Traditional Chinese (zh-tw) locales, courtesy of @davgo0103 (#307)
• Updated the Simplified Chinese (zh-cn) locales, courtesy of Wtq_
• Updated the Italian (it-it) locales, courtesy of @iVillager in (#330)

API changes

The API has underwent an overhaul, introducing a wide range of breaking changes. The vast majority of plugins built to work with HuskHomes v3 will not work with v4. Sorry about that. I hope that you find the new API easier to work with.

• Objects are now encapsulated with getter and setter methods where appropriate. For example, you now access information from a Home object with #getX(), #getWorld() etc.
• The selection of API events has changed; there's now a HomeCreateEvent and WarpCreateEvent and the old events fired on save have been replaced with new HomeEditEvent and WarpEditEvents
• API events now provide more methods for setting values to let you affect their outcome
• Creating objects is no longer done with constructors; making Positions is now done with Position.at(x, y, z, world, server); creating Worlds is now done with World.from(name, uuid)
• Methods and objects that require a server ID argument now just take a string (the name of the server).
• The Teleport API has been rewritten again.
• New methods for both creating and editing warps and homes, including some consumer methods for updating metadata tags
• For more information, please consult the updated API docs.

To update to this release from HuskHomes v3.x, you must regenerate your config, server (if you are using cross-server mode) and locale files. No data migration is necessary, as the database schema has not changed.

HuskHomes 3.2.1 is now available to address some outstanding issues present in v3.2, including some critical issues if you are using permission restricted warps.

• Fixed an outstanding issue with permission restricted warps that prevented their use even if the user had the right permission node, courtesy of @Lorias-Aegorin (#280)
• Fixed permission restricted warps not TAB completing correctly, even if the user had the correct permission (#273)
• Fixed a placeholder not being correctly replaced on the free home limit warning (#278)
• Fixed an issue that meant the pagination buttons on the home list menu would paginate through your own home list rather than the target users' homes (#274)
• A number of improvements to the cross-server network messaging system have been made to improve system stability, particularly in cases where plugin message callbacks would fail with a dispatch error (#275)
• Updated the Simplified Chinese (zh-cn) locales, courtesy of @ApliNi (#270)
• Updated the Italian (it-it) locales, courtesy of @iVillager (#274)
• Updated the German (de-de) locales, courtesy of @Ceddix (#269)

To update, just drag+drop. You may wish to regenerate your languages file if you're making use of the mentioned locales that received updates.

HuskHomes v3.2, although light on new features, is heavy on fixing various issues encountered by users in the previous version. Most noticeably, it adds a new config option to let /sethome and /setwarp commands overwrite, fixes issues and introduces new API for bulk-delete commands and makes significant improvements to the performance and API for random teleports.

• Add an option to the plugin config to have homes automatically be relocated instead of the command failing when using /sethome and /setwarp with a home argument that matches the name of an existing respective home or warp. (#168)
• Fixed a variety of issues where random teleport location generation would fail in many cases due to a flawed implementation of needed safe ground detection logic. Random teleport positions no longer cache and the setting for this has been removed.
• Added a message informing players when they execute the /rtp command that the system is finding a position for them.
• Fixed an issue where busy servers sending parallel plugin message requests would conflict with each other causing intermittency with cross-server teleportation features
• Fixed an issue that meant players could access permission restricted warps without the requisite permission node
• Changed the format of the permission restricted warps permission node for consistency (huskhomes.warp.<warp> → huskhomes.command.warp.<warp>)
• Fixed an issue that meant the "Teleportation complete" message would appear twice when teleporting cross-server
• Fixed an issue that meant the wrong locale was displayed when teleporting other users to coordinates
• Fixed the /tp and /tphere commands not working for users vanished by vanish plugins (#255)
• Fixed an issue where if your teleport warmup time was set to 0, it would still treat the teleport as though it were a timed one, showing messages and restricting movement
• Fixed an issue that meant the server could lock up when using /delhome all or /delwarp all (#265)
• Fixed an issue that meant running /delwarp with zero arguments would throw an internal error (#264)
• Fixed an issue where /rtp would sometimes put players inside blocks (#263)
• Added support for RedisEconomy, courtesy of Ermibergo02 (#259)
• Updated the Simplified Chinese (zh-tw) locales, courtesy of ApliNi
• Updated the German (de-de) locales, courtesy of Ceddix
• Updated the Italian (it-it) locales, courtesy of Villag3r
• API (breaking): The Random Teleport API has been reworked. Hooks that work with the API in v3.1 will need to be altered to accommodate the new spec. Providers now need to simply supply an Optional<Position> rather than the previously complex approach.
• API: Added new cancellable events for deleting all homes and deleting all warps. Note that the normal deletion events are not fired when a player chooses to delete all of their homes / warps.

To update from v3.1, regenerate your config.yml and messages.yml files. If you're updating from older versions, you'll need to follow the legacy migration instructions.

⚠️ You must regenerate your config file to upgrade to this version from v3.0.x! Upgrading from v2.11.2? Follow these additional instructions as well.

HuskHomes 3.1 introduces a new developer API for executing teleports, makes a number of stability improvements and fixes a few bugs.

• Rewrote the internal teleportation handling logic for improved stability (see API section for what this means for developers)
• Rewrote logic in a number of places to reduce future #join() calling to fix a few concurrency exceptions in some cases
• Added a couple of new error handling locales for teleportation
• Fixed a problem where the server name and player list could not be updated when a player joined, caused by plugin message dispatch occurring too soon after the user joined
• Fixed a problem where /tpignore would still let you send teleport requests (#238)
• Fixed a number of issues caused by the migration to adventure, including a few that broke compatibility with older versions. Adventure's Bukkit adaption layer is now bundled with HuskHomes.
• Fixed a few issues with the way in which data was read from the config file (Annotaml)
• Tweaked the default Hikari connection pool options
• Updated the Traditional Chinese (zh-tw) locale with a few fixes, courtesy of @davgo0103
• API: New developer API has been introduced for building and executing teleport operations
  • A new entrypoint for getting a TeleportBuilder, which you can convert into an executable Teleport or TimedTeleport, has been added to the API class
  • Old teleport methods that simply accept a Position have been deprecated.
  • Please check the javadocs for more information!

You must regenerate your config file if you're upgrading to this version from v3.0.x! Regenerating your messages file is also recommended. Thank you!

⚠️ Upgrading from v2.11.2? Follow these steps!

HuskHomes 3.0.4 fixes more bugs that cropped up in previous releases, including an issue preventing random teleport cooldowns from working.

• Migrated the locale system to MineDown-adventure and ported the plugin chat system to the adventure platform. The #getLocale method provided by the API has thus changed to return a MineDown-adventure object.
• Fixed a bug where executing the /tpaccept and /tpdecline commands without specifying a player argument and without having any pending requests would cause an exception in console (#228)
• Fixed a problem that meant the server name would not be properly fetched and cached in many cases in cross-server setups (#231)
• Fixed a bug that meant anyone could create public homes regardless of them having the COMMAND_EDIT_HOME_PRIVACY node
• Fixed a bug that meant certain values in the config file couldn't be edited (#220)
• Fixed it not being possible to return by death with /back after you had respawned cross-server via the global respawning feature (#221)
• Fixed an issue that meant viewing the private home list of another user would not update if they set an additional home (#222)
• Fixed the error_edit_home_maximum_public_homes locale not having its' placeholder inserted
• Fixed an issue that meant the return by death via /back prompts when respawning would still appear even if the base permission node for /back was not set (#234)
• Fixed an issue that meant teleportation cancellation prompts would not respect the warmup message display config setting
• Fixed an issue that meant the random teleport cooldown would not apply to users self-executing the command (#224)

This release requires an update for HuskHomesGUI (v2.0.1). Please update the GUI plugin too!

To update from v3.0.x, you should regenerate your messages.yml file (delete messages-xx-xx.yml in your /plugins/HuskHomes/ folder and drag+drop the jar file). If you are upgrading from 2.11.2, you will need to follow these steps.

⚠️ Upgrading from v2.11.2? Follow these steps!

HuskHomes 3.0.3 fixes more bugs and typos present in the previous releases and updates the German (de-de) and Traditional Chinese (zh-tw) locales.

• Added TITLE and SUBTITLE as options for the position of the teleport warmup countdown indicator display
• Fixed an issue where numerical permission-node based limits were not sorted correctly, leading to incorrect totals being calculated on servers with inheriting permission nodes (#213)
• Fixed an issue where usernames that contain two or more adjacent underscores would be treated as MineDown formatting. Simple "markdown"-style formatting for MineDown is no longer supported or escaped (#210)
• Fixed an issue where public homes and warps that had been migrated from HuskHomes v2 would stop displaying on map hooks (#215)
• Fixed a typo in the edit warp menu locales that referred to warps as homes
• Fixed an issue in the incoming teleport request accept/decline button prompts where the click event commands were not prefixed with the plugin namespace (huskhomes:)
• Fixed an issue where the random teleport engine would still cache at least one position even if the number of positions to cache was set to 0
• Newly created tables on MySQL will now enforce a character set and database engine on creation
• Updated the German (de-de) locale, courtesy of @Ceddix
• Updated the Traditional Chinese (zh-tw) locale, courtesy of TonyPak

To update from v3.0.x, you should regenerate your messages.yml file (delete messages-xx-xx.yml in your /plugins/HuskHomes/ folder and drag+drop the jar file). If you are upgrading from 2.11.2, you will need to follow these steps.

⚠️ Upgrading from v2.11.2? Follow these steps!

HuskHomes 3.0.2 fixes a few bugs, updates the Simplified Chinese (zh-cn) locale and makes a small API addition

• Updated the Simplified Chinese (zh-cn) locales, courtesy of @ApliNi
• Re-added bStat metrics collection for certain data points
• Fixed an issue that meant the /back command was using economy action pricing for random teleportation
• Fixed an issue that meant /tpdecline had the wrong command description in most locales
• Fixed an oversight that made it impossible to customise the spacing of home, warp and command lists (#207)
• Fixed an issue that could cause blocking errors that could crash the server in certain edge cases
• Further optimised the random teleport generation system to reduce garbage generation
• API: Added the ability to get whether a player is in a "teleport warmup" state

To update from v3.0, you need to regenerate your messages.yml file (delete messages-xx-xx.yml in your /plugins/HuskHomes/ folder and drag+drop the jar file). If you are upgrading from 2.11.2, you will need to follow these steps.

⚠️ Upgrading from v2.11.2? Follow these steps!

HuskHomes 3.0.1 is a bug fix update to address a few outstanding bugs present in v3.0.

• Updated the Spanish (es-es) locales, courtesy of @Chiquis2005
• Fixed a crash that could occur in exceptional circumstances when modifying or deleting a home or warp
• Fixed excessive memory usage caused by problematic logic when populating the cache of potential random position targets on startup

To update from v3.0, just drag+drop the jar file. If you are upgrading from 2.11.2, you will need to follow these steps.

⚠️ Upgrading from v2.11.2? Follow these steps!

HuskHomes v3.0—the third major version of HuskHomes—is now available. It's a complete rewrite of the plugin which brings about a brand new backend database schema and system, an all-new frontend menu design and chat interface, new features, upgrades to existing ones, a new developer API and many small tweaks and improvements!

New features & changes

• The plugin menus have been redesigned—from list menus, to edit menus, to teleport request prompts. The brand new menus follow the same new design scheme used in HuskSync v2.0.
• The navigation of home, warp, public home and command lists has been improved with new page jumper buttons on page footers
• Commands now have new permission nodes for better consistency.
• Permission nodes for bypassing checks have been changed for better consistency.
• Added a permission node to let you bypass economy checks (#173)
• Added a config option and permission node to let you limit how many homes a user can make public
• Added a config option to disable sound effects altogether
• Added a config option to enable/disable the "return-by-death" feature on the /back command that lets players return to where they died
• Added a config option to determine whether players' last positions, used in the /back command, will be set when the TeleportEvent is fired for players, except by NPCs, for example by other plugins.
• Added a config option to enable/disable strict /tpahere functionality
• Added a config option to let you allow the use of unicode characters in home names and descriptions in aid of international users (#156).
• Added the ability to enable global respawning on cross-server setups (#123). This is an experimental feature that tracks where players died globally and attempts to respawn them at their bed. You will need to set a local /spawn position on each server first, then enable this in the config file. It has some caveats/downsides/inconsistencies and will be improved in the future, but it should help server owners get a step closer to a seamless cross-server experience.
• The plugin now accurately keeps track of online players in cross-server setups, meaning it is no longer possible to send teleport requests to invalid players. TAB completion has been improved as a result.
• The random teleport command now uses a gaussian distribution algorithm to serve random locations with a better distribution. New config options have been added to let you fine-tune this to your liking.
• The teleport command now lets you teleport a player other than yourself (/tp <player> [destination]). A new permission node has been added to restrict this.
• It is now possible to teleport to—but not send teleport requests to—yourself with teleport commands
• A permission node has been added for using the teleport command to teleport to a set of coordinates
• The teleport command now accepts the @s selector for teleporting yourself, reducing friction when using vanilla commands such as the /minecraft:locate command.
• The /tpall and /tpaall commands now inform you of how many players you have teleported/requested to teleport to you.
• Commands are now offered with modern Brigadier rich syntax highlighting for users on Paper servers
• Added a config section to let you disable commands. Commands added to the disabled_commands list will be unable to be used and show an error when you attempt to use them. This is useful for lightweight setups where you would rather not use a permissions plugin.
• You can now view lists of a player's homes, server public homes, warps and commands through console
• You can now randomly teleport a player through console (rtp <player>)
• You can now execute teleports through console (tp <player> [target])
• Warping a player through console now works for any player on the network in cross-server setups, not just online players on the server it was executed from.
• You can now teleport a player to a public home through console (phome <player> <[owner_name].[home_name]>)
• Added a hook with Plan (Player Analytics) that allows you to view some statistics about users' HuskHomes homes on your Plan web panel.
• Dynmap: Updated the appearance of HuskHomes' Marker icons. Markers now also show the icon in the popup information box.
• BlueMap: Updated the appearance of HuskHomes' Marker icons and updated to depend on BlueMap's v2 API, which brings support for newer versions of BlueMap.
• Removed support for SquareMap/Pl3xMap due to poor stability and API inconsistencies following the original v1's discontinuation. Support for the new Pl3xMap v2 by the original author, will be re-added in the future when its' API is more stable.
• Removed the ability to force-teleport a player to the spawn point, for now, due to compatibility issues.
• Removed the config option to handle vanished players for implementation consistency; they are now always handled. Sending a teleport request to a vanished player will act as though they could not be found.
• Removed the config section for configuring how TAB completions on cross-server setups works; the plugin now has new and more accurate tracking and caching of global player lists.
• Removed the need to manually set the name of the server in the config file for users with cross-server setups. HuskHomes will automatically fetch and cache this to a server.yml file when the first user joins.
• Removed the local spawn position section from the config file; this is now saved separately in a spawn.yml file. For global spawn positions on cross-server setups, a warp is still used as before.
• Temporarily removed the collection of a few specific bStats metrics, to be re-added in a future update.
• Fixed an issue that meant the SQLite database could get locked in certain circumstances (#148). HuskHomes's new database system now uses a single connection to SQLite databases and pooling for MySQL connections.
• Fixed an oversight that meant home privacy toggle buttons would appear in the home menu even if a user did not have permission to do so. (#157)
• Updated the Italian (it-it) locales, courtesy of Villag3r1. Locale files need updating for all other languages, though, as over 2/3rds of the locales have changed with the new menu scheme. If you'd like to help translate HuskHomes, please submit a pull request!

Developers

• A new Developer API (v3) has been added. Note that plugins that target HuskHomes v2 API are not compatible with HuskHomes v3.x due to the plugin being a complete top-to-bottom rewrite. The API is available on Jitpack. Please check out the new API docs and Javadocs for more information!
• Added new API events for teleporting and viewing home lists, and renamed and updated old ones
• Added the ability for developers to provide custom Random Teleportation engines to customise the functionality of the /rtp command.
• The plugin is now built with gradle and has a modular, cross-platform design. Contributions welcome!

Add-ons & Placeholders

The following add-ons have been updated to support HuskHomes v3.x. Please download the new versions:

• HuskHomesPlaceholders (the PlaceholderAPI expansion, available on the PlaceholderAPI eCloud) — v2.0+
  • Please note some placeholders have changed and others added. Please check the new list.
• HuskHomesGUI (the GUI add-on plugin) — v2.0+

My other plugins, HuskBungeeRTP and HuskTowns will be updated in due course to make use of this new update. Please sit tight!

If you're updating from HuskHomes v2.x, please follow these steps to upgrade. HuskHomes v3.x has been designed to be as easy to upgrade as possible, so for most people this will amount to just dragging and dropping the plugin and deleting the old messages file.

The plugin documentation has been rewritten for v3.0—please have a read!

HuskHomes v3.0 supports Minecraft 1.16.5 - Minecraft 1.19.x

Thank you!

HuskHomes 2.11.2 fixes a few bugs with previous versions and makes some optimizations for Redis users.

• Fixes and improvements for users running HuskHomes via Redis
  • Fixed an issue where the Redis listener on would terminate unpredictably when trying to add a null set of invites (#130)
  • Fixed an issue where cross-server player list tracking would not accurately add joining players to the global player list
  • Updated the Jedis dependency and now a JedisPool is used to more optimally fetch connections
  • Added an option in the config file to allow for Redis connections to be established over SSL
• Fixed /warp tab completion items not being hidden based on warp permissions even when the setting to hide them from the warplist was enabled (#129)
• Updated HikariCP to 5.0.1 to fix an issue where the database connection pool could be drained in rare circumstances.
• Miscellaneous refactoring

To update, just drag+drop. For Redis users, the new use_ssl config option should appear under redis_credentials in the plugin config.

HuskHomes 2.11.1 fixes an issue for users running HuskHomes' cross-server mode using Redis messaging

• Fixed an issue where the shaded Redis dependency would cause conflicts and ClassLoader exceptions; it will once again be downloaded using Spigot's runtime library maven central downloading function.

To update, just drag+drop.

HuskHomes 2.11 adds the /tpall and /tpaall commands that let you teleport and request to teleport every player to your position on the server.

• Command descriptions are now translatable. That's the ones that appear in /huskhomes help and the regular command list /help menu
• Added /tpall and /tpaall
  • /tpall: Teleport every player immediately to your position. Works for every player on the server. Permission: huskhomes.tpall (operators only by default)
  • /tpaall: Request to teleport every player immediately to your position. Permission: huskhomes.tpaall (operators only by default)
• Redis users: The redis messaging system now uses JedisPools for faster connection retrieval, which will improve performance for servers under heavy load
• Bumped HikariCP to 5.0.1 to fix an issue where the Hikari MySQL connection pool could rarely drain for servers under heavy load, causing database exceptions
• Fixed an IllegalStateException that would occur if players tried to teleport while being ridden by a passenger (#125)

To update, just drag+drop. New locales are available to translate in the language file, so please feel free to update the translations via GitHub if you can!