HuskHomes 4.9.4

HuskHomes 4.4.5 updates the plugin locales and fixes an issue where the MariaDB driver could not be correctly located.

• Added Russian (ru-ru) locales, courtesy of @mindryder (#469)
• Updated the Chinese (zh-cn) locales, courtesy of @klxf (#468)
• Fixed the MariaDB driver not being correctly located during database initialization when the database type was set to MARIADB.

To update from 4.4.x, just drag+drop.

HuskHomes 4.4.4 adds support for H2 as a flatfile database type and makes a few optimizations/fixes.

• Added support for H2 as a new flatfile database type
• Optimized database queries through the creation of table indexes on MariaDB and SQLite
• The MariaDB JDBC driver is now bundled on Fabric/Sponge and downloaded at runtime on Spigot/Paper
• fabric: Updated adventure-platform-fabric and re-enabled teleportation sound effects
• Fixed an issue where the server could hang on shutdown if Redis was being used (#463)

To update from 4.4.x, just drag+drop.

HuskHomes 4.4.3 is a hotfix to address a Fabric crash issue on that was present in the previous release.

• fabric: Fixed a crash that occurred when trying to load the mod

To update from 4.4.x, just drag+drop.

HuskHomes 4.4.2 fixes a number of bugs that were present in the previous release, especially if you were using Fabric. Please also note this build no longer supports RedisEconomy due to instability.

• Fixed an issue where "respawning" by going the end exit portal would perform a cross-server teleport for global spawns, causing players to get stuck when returning to the server they exited
• Fixed an issue where players could suffocate when using /rtp, courtesy of @USA-RedDragon (#445)
• Fixed users not being able to have multiple cooldowns due to a wrong UNIQUE constraint
• Removed the RedisEconomy hook due to instability (#447)
• Updated the German (de-de) locales, courtesy of @Ceddix (#452)
• fabric: Fixed the scheduled executor causing lag on the main thread (#450)
• fabric: Fixed Redis not working due to a missing dependency
• fabric: Fixed networking issues when a player attempted to teleport between dimensions (#457)
• fabric: Fixed certain hooks not properly registering (#453)

To update from 4.4.1, just drag+drop.

HuskHomes 4.4.1 is a hotfix release to fix an issue with MySQL on the previous release. Please not Purpur 1.19.4 is not compatible with HuskHomes 4.4+ as that version does not properly implement the new Paper Plugin format.

• Fixed a critical issue with the MySQL database schema and user lookup logic
• Fixed an issue where startup would fail if a hook failed to initialize
• Fixed an issue where the plugin would fail to load if both Essentials and Plan are installed on Paper
• Updated the Simplified Chinese (zh-cn) locales, courtesy of @ApliNi (#438)

To update, just drag+drop; there are no config changes.

HuskHomes 4.4 brings support to Minecraft 1.20.1 on Fabric, adds the ability to define cooldowns for performing certain actions, adds two new supported languages, enhanced permission support for /back, and several significant bug fixes.

• Fabric: Updated to support Minecraft 1.20.1 (#423)
• Added the ability to define cooldowns for action (#437)
  • Cooldowns can be defined for all existing economy actions, including random teleport, home, warp, back, etc.
  • The permission to bypass /rtp cooldowns has also been changed to huskhomes.bypass_cooldowns, and now works to bypass all defined cooldowns.
  • The old option for setting a /rtp cooldown has been removed in favor of a newly added section of the config file
  • Adds a new database table to ensure these can be tracked cross-server too.
  • The amount of cooldown time you have remaining is now more accurate
  • Click here for the relevant documentation and a table of supported actions
• Added comments throughout the default config file
• Added a new huskhomes.command.back.previous permission for using the /back command to return to your previous teleport position, courtesy of @Akiranya (#422)
• Added Japanese (ja-jp) locales, courtesy of @NamiUni (#426)
• Added Turkish (tr-tr) locales, courtesy of @WinTone01 (#429)
• Fixed issues where the EssentialsX importer would fail to import user data, and updated the hook to use newer Essentials API.
  • HuskHomes now requires the latest version of Essentials to import from
• Fixed an issue where creating a home via the API could fail for offline users due to their user data not being cached
• Fixed a missing [ in the zh-cn (Simplified Chinese) locales
• Fixed a rare ConcurrentModificationException that could occur when sending/receiving a teleport request
• Fixed some database logic being wrongly executed on the main thread when players disconnected from the server
• Fixed the teleport button not showing up in HomeEditor, courtesy of @NamiUni (#427)
• Fixed an issue where teleport warmup tasks would fail to cancel correctly (#433)

To update, you should regenerate your config.yml and locale files (the former of which now has new comments to help you use it easier).
Enjoy!

HuskHomes 4.3.2 fixes a few bugs present in the previous release and updates the plugin locales.

• Fixed how accepting a cross-server teleport request would not use exact username lookup when responding to the requestee, which caused some teleport requests to fail when similarly named users were online (#399)
• Fixed an issue where using /sethome when having set the maximum number of homes would not let you overwrite an existing home when the overwrite_homes_warps config option was enabled (#293)
• Fixed an issue where the "teleportation complete" message could appear repeatedly after completing a timed teleport (#405)
• Fixed an issue where map icons wouldn't re-register when Pl3xMap was reloaded. Please make sure you update to the latest Pl3xMap for this release. (#409)
• Fixed an issue where cross-server teleports would not properly catch invalid world exceptions when finishing a teleport (#402)
• Fixed an issue where it was not possible to update the local spawn position after setting it the first time (#400)
• Fixed an issue where running a random teleport operation in a void world would cause an exception due to the safety resolver returning an illegal y-coordinate. (#401)
• HuskHomes on Sponge servers will now properly terminate database and Redis connections on shutdown
• Updated the German (de-de) locales, courtesy of @Ceddix (#404)
• Updated the Italian (it-it) locales, courtesy of @iVillager (#406)

To update from v4.3.1, just drag+drop; there are no config changes.

HuskHomes 4.3.1 adds several new economy actions and slightly improves the global respawning feature for Paper servers.

• Added several new economy actions which you can set prices for performing:
  • home_teleport - When a player teleports to one of their homes with /home
  • public_home_teleport - When a player teleports to a public home with /phome
  • warp_teleport - When a player teleports to a warp with /warp
  • spawn_teleport - When a player teleports to spawn with /spawn
  • send_teleport_request - When a player sends a teleport request with /tpa
  • accept_teleport_request - When a player accepts a teleport request with /tpaccept
• On Paper servers utilising the global respawning feature, the plugin will now listen for the PlayerSetSpawnEvent for more accurate handling of when a player's spawn position is updated
• Added bStats metrics for HuskHomes on Sponge
• Fixed a typo with the update checker referencing the wrong plugin name

To update from v4.3, just drag+drop. If you'd like to make use of the new economy actions, you can add them to the costs section of the config.yml file, mapping them to a price (check the docs for more information). If you're upgrading from earlier versions, be sure to regenerate your config and messages files.

HuskHomes 4.3 adds support for Folia, adds the ability to /rtp into other worlds, adds an importer from EssentialsX, updates the Pl3xMap hook, and fixes a significant number of bugs.

• Added support for running HuskHomes on Folia servers (#376)
• Added the ability to import data from EssentialsX (#390)
  • To do this, use the new /huskhomes import command. Check the docs for more details.
  • This requires the huskhomes.command.huskhomes.import permission.
• Added a config option to make home and warp names case-insensitive (this is off by default)
  • Useful to avoid confusion to prevent users making homes and warps with matching names by case (e.g. example vs ExAmPle)
  • Also useful on Bedrock edition where you can't TAB complete stuff easily
• Added the ability to random teleport to another world (#387)
  • To do this, use /rtp [player] [world].
  • This requires the huskhomes.command.rtp.world permission when used to teleport to a world other than your current one.
  • TAB completion has been added to the /rtp command
• Updated the Pl3xMap hook to use the latest API (#382)
  • You can now also use the Pl3xMap hook on Fabric servers, since Pl3xMap supports fabric.
  • You may need to update your version of Pl3xMap to continue using it with this release.
• Updated the German (de-de) locales, courtesy of @Ceddix (#396)
• Fixed some command aliases not registering correctly on Paper, Fabric or Sponge (but not Spigot) servers: /tpyes, /tpdeny and /tpno will now register correctly.
• Fixed the local username closest-match resolution system overriding global exact matches when similarly named players were connected to the network (#392)
• Fixed some instances where teleportation would silently fail due to illegal target coordinates, particularly on timed teleports
• Fixed a circular dependency issue when launching the plugin with Plan and Essentials installed (#378)
• Fixed the random teleport engine being able to provide positions outside of the world border (#395)
• Fixed some erroneous formatting in the about menu
  • Fixed erroneous trailing commas on credit lists
  • Fixed credit descriptions not being properly displayed on hover

To update, you should regenerate (create a backup, delete and fill in again after updating) your config.yml and messages-xx-xx.yml files. Enjoy!

HuskHomes 4.2.1 fixes a few bugs present in v4.2, including some important fixes related to cross-server mode on fabric.

• Updated the Traditional Chinese (zh-tw) locales, courtesy of @davgo0103 (#360)
• Fixed cross-server plugin messaging causing a client disconnect on proxied Fabric servers
• Fixed an issue where vanished players would be included in the TAB completion list of players
• Fixed an issue where sending a teleport request to a vanished user would still act as though the request was successfully sent
• API: Added a new method: setUserLastPosition(), courtesy of @AlessioDP (#368)

To update from v4.2, just drag+drop. There are no config changes in this release. To update from earlier v3.x-v4.x releases, please regenerate all of your configuration files.

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 3.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.