HeadBlocks

HeadBlocks v3.5.0

What's New

New Features

- Hide more than heads. The heads list now accepts blocks (block:LANTERN), items (item:DIAMOND:1001), item frames (frame:FILLED_MAP), floating texts (text:&6Find me!) and mobs without AI (mob:CAT). Options go between brackets, e.g. mob:ZOMBIE[head=DIAMOND_HELMET,baby=true]. See the [documentation](https://aerwyn81.gitbook.io/headblocks/configuration-conf… - Contents of other plugins, when installed: custom items and furniture from Nexo, ItemsAdder and Oraxen, mobs from MythicMobs, 3D models from ModelEngine and BetterModel, and NPCs from Citizens, FancyNpcs and ZNPCsPlus. - Rendering modes. A new rendering section (mode, scale, glow) in config.yml, overridable per hunt: heads and blocks are placed as real blocks (BLOCK) or as floating, scalable display entities (DISPLAY) that spin smoothly. - /hb hunt rendering <hunt> <block|display> converts the heads already placed in a hunt, keeping their content, position and player progress. /hb hunt info shows the rendering of the hunt. - Catalog. /hb give opens a menu to take the items: filter by type, pick the hunt the items are linked to, shift + click to take a stack. /hb give <player> opens it for that player, and can be run from the console.

Improvements

- Heads rendered as entities are hidden natively for players who found them with hideFoundHeads: no PacketEvents needed, and no invisible collision left behind. - Entities are never saved in the world: they are spawned when their chunk loads and respawned if something removes them, so uninstalling the plugin leaves nothing behind. - Placed block heads are protected: they don't burn, melt, decay, pop off when their support is removed or get pulled by a sticky piston, and clicking one only claims it (a chest doesn't open, a lever doesn't toggle). - Item frames are placed on the face you click, including floors and ceilings. - /hb move also moves heads rendered as entities. - A head moved to another hunt takes the rendering of its new hunt. - Holograms are raised above tall contents such as mobs. - Spin settings of a hunt are now applied to its heads. - Faster head lookups on servers with many heads.

Breaking Changes

- /hb give <player> <number|*> [hunt] is replaced by the catalog: the head number, * and hunt arguments no longer exist. Scripts or commands giving heads by number must be updated. --- Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [Spigot discussion](https://www.spigotmc.org/threads/headblocks-christmas-eve…

HeadBlocks v3.4.0

What's New

New Features

- Hunt requirements. A Requirements menu in /hb hunt create to stack the conditions to claim a head: area, previous hunt, permission, playtime and PlaceholderAPI, combined with ALL or ANY. See the [documentation](https://github.com/AerWyn81/HeadBlocks/blob/master/docs/c… - /hb give <player> <number> [hunt] links the given head to a hunt. It is always placed in that hunt, whatever the hunt selected with /hb hunt select. - /hb hunt create without a name creates a hunt named with the lowest free number (1, 2, ...).

Improvements

- The bounded zone became the area requirement, with every option it had. Existing hunt files are migrated on load. - The headblocks.zone.bypass permission is now headblocks.area.bypass. The old node keeps working. - Hunt files no longer keep the keys of a behavior or a requirement that was removed. - Player movement checks are skipped when no active hunt has an area to enforce.

Bug Fixes

- Fixed heads being placed in a deleted hunt when it was still selected. The selection now falls back to the default hunt. - Fixed a possible error when refreshing HeadBlocks menus while the player had no inventory open. --- Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [Spigot discussion](https://www.spigotmc.org/threads/headblocks-christmas-eve…

HeadBlocks v3.4.0

What's New

New Features

- Hunt requirements. A Requirements menu in /hb hunt create to stack the conditions to claim a head: area, previous hunt, permission, playtime and PlaceholderAPI, combined with ALL or ANY. See the [documentation](https://github.com/AerWyn81/HeadBlocks/blob/master/docs/c… - /hb give <player> <number> [hunt] links the given head to a hunt. It is always placed in that hunt, whatever the hunt selected with /hb hunt select. - /hb hunt create without a name creates a hunt named with the lowest free number (1, 2, ...).

Improvements

- The bounded zone became the area requirement, with every option it had. Existing hunt files are migrated on load. - The headblocks.zone.bypass permission is now headblocks.area.bypass. The old node keeps working. - Hunt files no longer keep the keys of a behavior or a requirement that was removed. - Player movement checks are skipped when no active hunt has an area to enforce.

Bug Fixes

- Fixed heads being placed in a deleted hunt when it was still selected. The selection now falls back to the default hunt. - Fixed a possible error when refreshing HeadBlocks menus while the player had no inventory open. --- Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [Spigot discussion](https://www.spigotmc.org/threads/headblocks-christmas-eve…

HeadBlocks v3.2.0

What's New

New Features

- Added Folia support. - The plugin now ships as two jars. Paper, Purpur and Folia servers use HeadBlocks-<version>.jar; Spigot servers use HeadBlocks-<version>-spigot.jar (SpigotMC).

Improvements

- Added support for Minecraft 26.2. - Headblocks paper jar is now a native Paper plugin (paper-plugin.yml), which gives it an isolated classloader and an explicit dependency declaration. The Spigot jar is unchanged.

Bug Fixes

- Fixed a per-head reward loading error after /hb reload. - Fixed hunt files not being rewritten when heads were removed in bulk, which made removed heads reappear after a restart. Hunt files are now written atomically. - Fixed a head rotation task leaking on every /hb move, which made moved heads spin twice as fast. - Fixed heads in an unloaded world scheduling a rotation task that errored on every tick. - Fixed holograms failing to spawn on 1.20.5 and later, which flooded the console with NoSuchMethodError once per head. - Fixed particle names being rejected on 1.20.5 and later, where Minecraft renamed them (REDSTONE became DUST, and so on). Both spellings are now accepted on every supported version, and an unknown name no longer spams the console. --- Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [Spigot discussion](https://www.spigotmc.org/threads/headblocks-christmas-eve…

HeadBlocks v3.2.0

What's New

New Features

- Added Folia support. - The plugin now ships as two jars. Paper, Purpur and Folia servers use HeadBlocks-<version>.jar; Spigot servers use HeadBlocks-<version>-spigot.jar (SpigotMC).

Improvements

- Added support for Minecraft 26.2. - Headblocks paper jar is now a native Paper plugin (paper-plugin.yml), which gives it an isolated classloader and an explicit dependency declaration. The Spigot jar is unchanged.

Bug Fixes

- Fixed a per-head reward loading error after /hb reload. - Fixed hunt files not being rewritten when heads were removed in bulk, which made removed heads reappear after a restart. Hunt files are now written atomically. - Fixed a head rotation task leaking on every /hb move, which made moved heads spin twice as fast. - Fixed heads in an unloaded world scheduling a rotation task that errored on every tick. - Fixed holograms failing to spawn on 1.20.5 and later, which flooded the console with NoSuchMethodError once per head. - Fixed particle names being rejected on 1.20.5 and later, where Minecraft renamed them (REDSTONE became DUST, and so on). Both spellings are now accepted on every supported version, and an unknown name no longer spams the console. --- Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [Spigot discussion](https://www.spigotmc.org/threads/headblocks-christmas-eve…

HeadBlocks v3.1.0

What's New

New Features

- Zone behavior: confine players to a cuboid or WorldGuard region while playing a hunt. New headblocks.zone.bypass permission and GUI config. - Timed time limit: countdown to finish a timed run, teleport back to start on timeout, with optional progress reset. - Apply rewards to whole hunt: copy a head's rewards to every head of the hunt. - Hidden leaderboard players: exclude specific players from /hb top. - New placeholder %headblocks_hunt_<huntId>_finishers% to display the number of players who completed a hunt.

Improvements

- Timed start plates are protected from breaking and removed when the hunt is deleted. - Head placement/assignment refuses or skips heads outside a hunt's zone. - /hb reset and /hb resetAll can now be run from the console (only --head with no value still requires a player, since it targets the looked-at block).

Bug Fixes

--- Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [Spigot discussion](https://www.spigotmc.org/threads/headblocks-christmas-eve…

HeadBlocks v3.0.1

What's New

Headline: HeadBlocks now ships a complete multi-hunt system. A server is no longer limited to a single global head collection — you can create, configure and run as many independent hunts as you want, each with its own heads, behavior, rewards and progression. Most of the features below build directly on top of this new foundation.

New Features

- Multi-hunt system: create, rename, delete, list and switch between multiple hunts. Each hunt owns its own heads, rewards, holograms, hints, order configuration and player progression. - Hunt behaviors (cumulative — a hunt can combine several, e.g. Ordered + Timed): - Free — classic, head-by-head exploration - Ordered — heads must be found in a specific sequence - Timed — time-limited challenge with countdown, leaderboard, and an optional repeatable mode (new /hb leave command to abandon a running run) - Scheduled — hunt opens/closes automatically with three sub-modes: - Range — open between two dates (MM/dd/yyyy HH:mm) - Recurring — periodic recurrence with a configurable unit (day/week/month/year) - Slots — one or several recurring time-of-day windows - `/hb hunt schedule` command: full CLI to configure scheduled mode, dates, recurrences and slots. - Hunt sub-menu in `/hb options`: opening Hints / Order / Rewards now first prompts for the target hunt. - Multi-hunt Redis sync: hunt creation, state and configuration are now propagated across servers in addition to player progression — full multi-server multi-hunt support. - HeadDB support: [HeadDB](https://www.spigotmc.org/resources/headdb.114941/) joins HeadDatabase as a supported head provider, configurable in config.yml. - Minecraft 1.21.11 / 26.1 support: tested and added to the supported platform versions. - Colored console output: log messages now use ANSI color codes for better readability.

Improvements

- `/hb stats` and `/hb list` revamped to surface per-hunt breakdowns and clearer information. - Per-hunt storage of head locations: heads are now persisted directly inside hunts/<id>.yml instead of the global locations.yml. Legacy data is automatically migrated on startup. - Performance with large head counts: hologram handling and head lookups have been significantly optimized for servers with many heads. - No more hard dependency on XSeries: only the modules actually used (XSound) are shaded, slashing the bundled code size by ~3 500 lines. - Improved GUI flow for selecting a hunt when configuring Timed / Scheduled behavior. - New & updated placeholders for Timed and Scheduled hunts (state, remaining time, next opening, repeatability, etc.). - Documentation moved to GitBook with a full v3.0 multi-hunt section. - Dependencies updated (Jedis, Gradle wrapper, …).

Stabilization & Code Quality

A large part of this release was spent making the new multi-hunt foundation solid: - Massive test coverage: thousands of new unit and integration tests across commands, services, storages, behaviors, hooks and events. - Refactor from static singletons to dependency injection: a new ServiceRegistry wires services explicitly, making the codebase testable and removing hidden coupling. - Reliability fixes: try-with-resources on streams, ThreadLocalRandom instead of shared Random, deduplicated event/database code, safer SQLite/MySQL handling. - Static analysis: Qodana and SonarQube/SonarCloud integration with a long list of resolved findings. - Removed click-counter feature and its leftover GUI/DB columns (was unused and a source of bugs).

Bug Fixes

- Fixed /hb removeall leaving stale references in hunts. - Fixed /hb reset and /hb resetall on ordered/timed hunts. - Fixed head moves not being persisted correctly. - Fixed Redis hunt transfer issue across servers. - Fixed heads being loaded twice on startup. - Fixed several edge cases in ordered hunt progression. --- Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [Spigot discussion](https://www.spigotmc.org/threads/headblocks-christmas-eve…

HeadBlocks v2.8.6

What's New

New Features

- Added /hb debug resync commands for database/locations synchronization - resync database: removes heads from database not present in locations.yml - resync locations: restores head blocks in the world from locations.yml - Supports --force flag to override safety checks - Multi-server detection with safety warnings - Replaced default database connection handler by HikariCP connection pooling for MySQL and SQLite - Added configurable pool settings (maxConnections, minIdleConnections, connectionTimeout, idleTimeout, maxLifetime)

Improvements

- The /hb removeall command now runs asynchronously to avoid server freezes on large head counts - Enhanced head visibility handling logic and optimized caching by introducing chunk-based tracking - Updated to Minecraft 1.21.11

Bug Fixes

- Fixed command parsing in RewardService to skip blank commands and added safety checks for empty command lists - Fixed deprecated Particle enum usage for 1.21+ compatibility --- Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [**Spigot discussion **](https://www.spigotmc.org/threads/headblocks-christmas-eve…

HeadBlocks v2.8.2

Thank you for using HeadBlocks If you find a bug or have a question, don't hesitate to : - open an issue in [Github](https://github.com/AerWyn81/HeadBlocks/issues) - or in the [Discord](https://discord.gg/f3d848XsQt) - or in the [discussion](https://www.spigotmc.org/threads/headblocks-christmas-eve…

What's New

New Features

- Hide Found Heads: Added an option to visually hide heads already discovered by players (requires PacketEvents) - Rewards Interface: New GUI to manage and view configured rewards for each head - Per-Head Reset: Ability to reset a player's progress for a specific head via /reset and /resetall commands

Improvements

- Cache Optimization: Complete overhaul of the caching system for Redis and Memory, including player, leaderboard, and heads caches - Redis Performance: Replaced lists with sets for storing player heads, simplifying operations and improving performance - Hologram Management: Overhauled hologram system with placeholder support. Removed support for CMI/FancyHolograms & DecentHolograms, replaced by "Advanced hologram" type - Asynchronous Particles: Optimized particle spawning using Bukkit scheduler to reduce server load

Bug Fixes

- Error Handling: Fixed error spam on startup when there's an issue loading the database.

Technical

- Dependency Removal: Removed unnecessary dependencies to simplify plugin compilation. - Dependency Management: Centralized dependency versions using Gradle catalog (libs.versions.toml) - Project Structure: Simplified Gradle structure by removing unnecessary core module - Console logging: Improved logging in console using native server logger.

- Added hint system in /hb options, added mechanics to define a Sound or an ActionBarMessage (with direction!) on each head to help your players to find heads more easily (can be configured in config.yml, inactive by default) - Added protection against explosions (can be turn on/off in config.yml) - Fixed center message when PlaceholderAPI plugin is active - Improved performance with GetHeads() and PreparedStatement If you find a bug, don't hesitate to report it at Github or in the discord! Thanks to use my plugin!

- Added compatibility with 1.21.6 and 1.21.7 - Added %headblocks_leaderboard_position% placeholder to get the number of player position in highscore - Fixed exception when loading a HeadDatabase head which does not exist If you find a bug, don't hesitate to report it at Github or in the discord! Thanks to use my plugin!

- Added compatibility with 1.21.5, - Updated sound compatibility with latest MC releases, - Added random on TieredRewards, - Fixed SQL export command that generated an incorrect SQL query when inserting the player table. If you find a bug, don't hesitate to report it at Github, in the discord! Thanks to use my plugin!

- Added compatibility with 1.21.4 - Fixed no texture on head with HeadDatabase when loading plugin. If you find a bug, don't hesitate to report it at Github, in the discord! Thanks to use my plugin!

- Added compatibility with 1.21.2/3/4 - Fixed some sql requests not handled correctly with MySQL or MariaDB (update/rename existing columns) - Improved concurrency system when retrieving heads from database - Now correctly count the player heads when login - Fixed an Illegal state exception with hologram task when not started - Fixed teleport in stats command - Added name when not empty for list, remove and stats commands If you find a bug, don't hesitate to report it at Github, in the discord! Thanks to use my plugin!

- Use Java 17 instead of Java 21 to compile the plugin If you find a bug, don't hesitate to report it at Github or in the discord! Thanks to use my plugin!

Database migration in this version! An additional column (serverId) has been added to the hb_heads table. Remember to make a backup of the hb_ tables!

- Fixed an issue where the minecraft version check was incorrect for versions 1.20.5- and 1.20.5+. The texture could not be correctly applied - Fixed /hb move command where the head loses its texture Head statistics are now based on the database rather than locally. If you have several servers, the heads will now be counted - Fixed issue where texture was not saved in database - Fixed /hb migrate command which did not correctly generate the sql script - Added debug command to force apply a texture on a steve head - Added debug command to give heads manually (be carefull) - Added possibility to set a prefix for HeadBlocks table - Fixed MariaDB type for database (Driver not found). Now using MySQL - Added silent purge for database when heads not existing anymore on the server based on serverId. If your server is connected to a remote database, a new file is generated in HeadBlocks folder. Don't touch it! If you find a bug, don't hesitate to report it at Github or in the discord! Thanks to use my plugin!

- Fixed issue introduce in the previous update, TieredRewards counting is now working. If you find a bug, don't hesitate to report it at Github, in the discord! Thanks to use my plugin!

- Removal of the external library to manage holograms by default (type DEFAULT in config). HeadBlocks default hologram now use Minecraft native TextDisplay. ProtocolLib is not required anymore. - Attempt to optimize the internal taks for hologram/particles. Feel free to report me issue with the new system! - Fixed issue with reward and full inventory - Rework of reload command to be more comprehensive - [WIP] Data loaded from the database when a player logs in and when a head is clicked is now asynchronous. Feel free to report me issue with the new system! If you find a bug, don't hesitate to report it at Github, in the discord! Thanks to use my plugin!

Fixed critical issue with tieredRewards If you find a bug, don't hesitate to report it at Github or in the discord! Thanks to use my plugin!

- Added head push back configurable when head already found is clicked (configurable) - Added head spin mode. - Updated FancyHolograms. - Added support for 1.21.1. If you find a bug, don't hesitate to report it at [Github](https://github.com/AerWyn81/HeadBlocks/issues), in the [discord](https://discord.gg/f3d848XsQt)! Thanks to use my plugin!

- Fixed an error on plugin starting with version checking. - Fixed exception with default hologram system. - Added support for [FancyHolograms](https://github.com/FancyMcPlugins/FancyHolograms). If you find a bug, don't hesitate to report it at [Github](https://github.com/AerWyn81/HeadBlocks/issues), in the [discord](https://discord.gg/f3d848XsQt) or in the discussion! Thanks to use my plugin!

- Fixed an issue with the player head cache that didn't add to the cache if the player never had a head. If you find a bug, don't hesitate to report it at [Github](https://github.com/AerWyn81/HeadBlocks/issues), in the [Discord](https://discord.gg/f3d848XsQt)! Thanks to use my plugin!