Dependency Changes

• Updated zAPI to 2.0.4

General Changes

• Added support for 26.1.2
• Fixed a bug where players with "_" in their name wouldn't see the homes menu

Full Changelog: https://github.com/yL3oft/zHomes/compare/3.0.3...3.0.4

Dependency Changes

• Updated zAPI to 2.0.3
• Updated NBTAPI to 2.15.7
• Updated PlaceholderAPI to 2.12.2

General Changes

• Added support for 26.1.1 and 26.1
• New regex detection system when setting new home, now supports more formats and is more accurate
• Better coding practices and code organization
• New checks for database connection and queries, to ensure better stability and error handling
• Fixed issues related to database connection and queries, improving overall performance and reliability

Config & Language Changes

• New configurations related to sethome regex detection
• Update version from both config & language files to 1.0.2

Full Changelog: https://github.com/yL3oft/zHomes/compare/3.0.2...3.0.3

Dependency Changes

• Updated zAPI to 2.0.2

General Changes

• New purge subcommand to /zhomes to purge data from the database, with alot of filters to choose from, you can read more about it in the wiki.
• Fixed permissions not registering bug in 3.0.1
• New permission to announce version updates to players, can be configured in the config.yml

Language Changes

• Added new messages for the purge subcommand.
• And removed old keys from 3.0.0 that are no longer used.

Full Changelog: https://github.com/yL3oft/zHomes/compare/3.0.1...3.0.2

Dependency Changes

• Updated zAPI to 2.0.1
• Updated to Paper API 1.21.11

General Changes

• Plugin changed to paper plugin, it will no longer work on spigot or bukkit servers, if you are using spigot or bukkit, please update to paper for better performance and stability.
• Fix folia compatibility for long distance traveling.
• Removed support for Minecraft 1.18 and below. Minimum supported version is now Minecraft 1.19.
• Added MiniPlaceholders support, more info in the wiki
• New parameter for command /homes: type - This parameter allows you to specify the type of homes output to text or menu, usage: /homes -type <text|menu>, if not specified, it will default to the one in config.yml.
• /zhomes parse can now be parsed with MiniPlaceholders, allowing you to use placeholders from both MiniPlaceholders and PlaceholderAPI at the same time, without any issues. Also you can now parse without specifing the player.
• config.yml comments are now translated with the language file (If it's a custom language file, it will fallback to english)
• Changed the way languages are loaded.
• Updated the database to have 1 extra column: NAME, this column is used to store the name of the player, it helps with the offline player getter, allowing you to get the name of the player even if they are offline, and also helps with the performance of the plugin, as it reduces the number of queries to the database when getting the name of the player.
• Auto update is no longer supported, due to the plugin now being a paper plugin.

Language Changes

• Added new 2 options for /homes:
• • home-string - The string that will be used to display the home in the list of homes, it supports placeholders, you can use %home% to display the name of the home and also supports MiniPlaceholders placeholders.
• • others.home-string - The string that will be used to display the home in the list of homes when the player is viewing other player's homes, it supports placeholders, you can use %home% to display the name of the home, and %player% to display the owner of the home and also supports MiniPlaceholders placeholders.
• Since the plugin now accepts MiniMessage, /zhomes nearhomes & /homes default home-strings now have hover & click effects to teleport to the home. And /zhomes nearhomes has a click effect on the player name to filter the search to the player's homes.

Full Changelog: https://github.com/yL3oft/zHomes/compare/3.0.0...3.0.1

ALERT: This is a major release. Please read the changelog carefully before updating. Specially if you are updating from version 2.x.x.

Dependency Changes

• Updated zAPI to 2.0.0

General Changes

• The whole plugin has been migrated to use zAPI 2.0.0 as a base. This includes changes to how commands, events, and configurations are handled.
• Refactored codebase for better readability and maintainability.
• Removed support for Minecraft versions below 1.18.2.
• Migrated from old coloring system (ChatColor) to more modern text components using MiniMessage for better text formatting and color handling.
• New subcommand added to /zhomes: /zhomes parse (player) (string) - Parses a string for a specific player's placeholders with the plugin placeholder system.
• A lot of new features to menus and GUI handling, including better pagination and item management:
• Improved database connections and query handling for better performance.
• Rework on dependency management & automatic download system.
• Rework on how config.yml & languages are handled (This also includes migration to zAPI's new configuration system).
• A lot of new options in config.yml and in languages (I really don't want to list them all here, go check yourself!)
• Improved hook detection and management for better compatibility with other plugins.
• Updated license year to 2026.

What will happen if I update from 2.x.x?

• The plugin is going to migrate colors from ChatColor to MiniMessage format. If you have custom colors in your config or language files, they will be converted automatically, but it's recommended to review them after the update.
• The configuration file (config.yml) and language files have been restructured. It's recommended to back them up before updating, as some settings may have changed or been removed.
• The plugin no longer supports Minecraft versions below 1.18.2. Ensure your server is running a compatible version
• The menu system for homes has been 100% reworked, and because of that the file of the menu is renamed to "homes-menu.yml", that also means that your old menu file will be ignored. Make sure to back it up if you want to reuse some settings.

Full Changelog: https://github.com/yL3oft/zHomes/compare/2.2.3...3.0.0

Dependency Changes

• Updated zAPI to 1.5.2
• Updated NBTAPI to 2.15.5
• Updated PlaceholderAPI to 2.11.7

General Changes

• Update to 1.21.11
• Fix bypass for restricted worlds

Full Changelog: https://github.com/yL3oft/zHomes/compare/2.2.2...2.2.3

General Changes

• Fix thread safery & memory leak
• Quick change in language for restricted-worlds
• Add limit configuration for nearhomes command and improve radius validation
• Minor bug fixes and optimizations

Full Changelog: https://github.com/yL3oft/zHomes/compare/2.2.1...2.2.2

General Changes

• Added new command to lookup nearby homes: /zhomes nearhomes [<radius>]
• Added delay to update messages upon joining (Cuz it was annoying)
• Improved information from /zhomes info command
• Fix converter for older versions
• Added a way to export/import data via /zhomes export and /zhomes import <data>
• Fix events loading more than one time in /zhomes reload
• Added a new section to the config.yml to restrict homes in certain worlds: restricted-worlds
• Added new internal placeholder for /homes: %amount% - Shows the amount of homes the player has

Full Changelog: https://github.com/yL3oft/zHomes/compare/2.2.0...2.2.1

Dependency Changes

• Plugin now uses zAPI 1.5.1

General Changes

• Fixed support for WorldGuard 6.x
• Added a new shorter homes menu example in folder menus/
• Changed a little the default homes menu
• Fixed head items in menus not showing correctly in some versions
• Fixed action bar on older versions

zAPI Changelog: https://github.com/yL3oft/zAPI/compare/1.5.0...1.5.1 Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.9...2.2.0

Dependency Changes

• Plugin now uses NBTAPI 2.15.3
• Plugin now uses zAPI 1.5.0

General Changes

• Added support for 1.21.9 and 1.21.10
• Fixed converter for xhomes
• Added new info subcommand for the main command (/zhomes info) that shows useful information about the plugin

zAPI Changelog: https://github.com/yL3oft/zAPI/compare/1.4.9...1.5.0 NBTAPI Changelog: https://github.com/tr7zw/Item-NBT-API/compare/2.15.2...2.15.3 Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.8...2.1.9

Dependency Changes

• Plugin now uses zAPI 1.4.9

General Changes

• With the update of zAPI, menus are way more configurable now. Since the wiki for it is not done yet, any questions related to it, ask on our discord
• Fixed 1.8 compatibility issues (It was working but with some issues)
• Changed shaded relocations to fix compatibility issues

zAPI Changelog: https://github.com/yL3oft/zAPI/compare/1.4.8...1.4.9 Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.7...2.1.8

Dependency Changes

• Plugin now uses zAPI 1.4.8
• Plugin now uses NBTAPI 2.15.2
• Plugin now uses version 1.21.8-R0.1-SNAPSHOT from spigot api

General Changes

• Fixed support for 1.20.1 or below
• Changed plugin placeholders (Old placeholders still works)
• Fix java 8 full compatibility
• Added A LOT of new placeholders, more on wiki
• Source code cleanup

API Changes

• Moved api from maven central to codemc's repo
• Javadocs are now generated with GitHub workflow

zAPI Changelog: https://github.com/yL3oft/zAPI/compare/1.4.6...1.4.8 NBTAPI Changelog: https://github.com/tr7zw/Item-NBT-API/compare/2.15.1...2.15.2 Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.6...2.1.7

General Changes

• Fixed database convertion on folia
• Added new option to enable safe teleportation or not: teleport-options.enable-safe-teleport (D: True)
• Added new permission to bypass safe teleport: zhomes.bypass.safeteleport, can be changed on config.yml

Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.5...2.1.6

Dependency Changes

• Plugin now uses zAPI 1.4.6

General Changes

• Fixed and optimized safe location finding on teleport, special thanks for coldironzz and Don (deadeye22122) for reporting
• You can now use chances on commands in the items from custom menus: [<chance (ex: 30.0)>] [CON|INV] (command)

zAPI Changelog: https://github.com/yL3oft/zAPI/compare/1.4.4...1.4.6 Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.4...2.1.5

Dependency Changes

• Plugin now uses zAPI 1.4.4

General Changes

• Fixed folia support (Finally!)
• Fixed permission registration
• Code cleanup and optimizations

zAPI Changelog: https://github.com/yL3oft/zAPI/compare/1.4.3...1.4.4 Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.3...2.1.4

Dependency Changes

• Plugin now uses zAPI 1.4.3
• Plugin now uses NBTAPI 2.15.2-SNAPSHOT

General Changes

• Added 1.21.8 support
• Setup github actions for automatic releases

zAPI Changelog: https://github.com/yL3oft/zAPI/compare/1.4.2...1.4.3 NBTAPI Changelog: https://github.com/tr7zw/Item-NBT-API/compare/2.15.1...master Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.2...2.1.3

Dependency Changes

• Plugin now uses zAPI 1.4.2
• Plugin now uses version 1.21.4-R0.1-SNAPSHOT from folia api

General Changes

• Fixed folia support
• Temp remove of 2 worldguard flags: bypass-home-warmup and bypass-home-cost

Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.1...2.1.2

General Changes

• Fixed plugin not working correctly without WorldGuard
• Added GriefPrevention hook (Also GriefPrevention is now a soft-depend of the plugin)
• Fixed permission registration upon startup
• /zhomes version now tells you if you're up-to-date with the plugin or not

Language Changes

• Fixed language reload not working with some of the languages
• Added new section to griefprevention hook: hooks.griefprevention
• New hook message to worldguard flag set-homes at hooks.worldguard.cant-set-homes

Full Changelog: https://github.com/yL3oft/zHomes/compare/2.1.0...2.1.1

Dependency Changes

• Plugin now uses zAPI 1.4.1

General Changes

• New bStats metrics (Player Count)
• You can now update the plugin in-game with /zhomes version update
• Fixed /zhomes version on console
• Added new config option general.announce-update - Toggles the message you get for plugin updates upon joining

Language Changes

• New language section for /zhomes version update: commands.main.version.update
• Added /zhomes version reload to main command usage message

zAPI Changelog: https://github.com/yL3oft/zAPI/compare/1.4.0...1.4.1 Full Changelog: https://github.com/yL3oft/zHomes/compare/2.0.6...2.1.0