> **Next 3.0 is now available for testing – featuring multi-run support!
\n> Join our Discord to get early access and share your feedback!**<\/p>\n
# Overview:<\/p>\n
HeadBlocks is a plugin that allows you to keep your players busy while having fun. The goal is simple, you hide a number of heads in your world and your players have to find them to get many rewards.The most common example of use is for Easter or Christmas headhunting!<\/p>\n
    <\/p>\n
<\/p>\n
# Features:
\n– Very easy to use
\n– No head limit
\n– Execute commands when clicking or according to levels
\n– Multiple head and multiple texture (support HeadDatabase)
\n– Customize sounds on click
\n– Send multi-line and centered messages on click
\n– Customize a firework or an explosion at the head with any colors
\n– Send a title fully customizable to the player
\n– Add particles on head already found and not found
\n– Can be used on a lobby, on a single server or even on several servers simultaneously (with Redis)
\n– Storage of player data in SQLite or MySQL
\n– Everything is translatable
\n– API for developers
\n– Contains several placeholders (see below)
\n– Automatic configuration updates
\n– Supports Minecraft 1.16+ colors
\n– Show holograms on heads (support placeholders)
\n– Order or define max click on the heads
\n– Head push back when already obtained
\n– Head spin mode (head will rotate simultaneously or not)
\n– **NEW** Hint system (actionBar or Sound)
\n– **NEW** Per-head rewards (commands, broadcast, message)
\n– **NEW** Hide head when found (using PacketEvents)
\n_Please note, if you are using tiered rewards, make sure it is set up correctly from the start. There is no way to distribute the rewards for the tiers already reached yet!_<\/p>\n
# Wiki:
\nYou can find the wiki here.<\/p>\n
# Configurations:
\n– **config.yml** : _Plugin configuration file_
\n– **language\/** : _Folder with translations (en or fr available)_
\n– **headblocks.db** : _SQLite database for storing player data (excluding MySQL)_
\n– **locations.yml** : _File containing the list of head positions_<\/p>\n
# Commands: # Permissions: If you want to run placeholders, you will need **PlaceHolderAPI**. # Placeholders: # API: \u2615 The entire plugin source code is available on Github.<\/p>\n # Know Issues: # Special thanks: # Final words<\/p>\n Found an issue or have a suggestion? Feel free to use Github issue here or discussion!<\/p>\n The plugin is probably not perfect yet, before reviewing, don’t hesitate to contact me if you need help or have errors!<\/p>\n Made with \u2764\ufe0f<\/p>\n","protected":false},"excerpt":{"rendered":" Hide heads in your world and let your players find them to earn rewards. Perfect for an Easter event.<\/p>\n","protected":false},"featured_media":79910,"template":"","meta":{"_minecraft_slug":"headblocks","_minecraft_project_id":"bpD0tpKu","_minecraft_author":"AerWyn81","_minecraft_license":"MIT","_minecraft_downloads":1517,"_minecraft_follows":17,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"headblocks.zip","_minecraft_size_bytes":34894202,"_minecraft_version_count":16,"_minecraft_updated_at":"2026-05-16T07:12:58.432925Z","_minecraft_date_created":"2024-07-08T04:46:46.655037Z","_minecraft_date_modified":"2026-02-25T23:09:41.383861Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/headblocks","_minecraft_icon_attachment_id":79910,"_minecraft_imported_at":"2026-06-04T14:31:56+00:00","_minecraft_import_hash":"3823b079bbe19aa58bed053fad2dd77e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,866,867,129],"mod_loader":[134],"minecraft_version":[54,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-79909","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-minigame","mod_category-social","mod_category-spigot","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **progress
\n– **give
\n– **remove
\n– **removeall** : _Remove all spawned heads_
\n– **reset
\n– **resetall** : _Resets data for all player_
\n– **list** : _Display in the chat the list of all heads with their locations_
\n– **rename
\n– **stats
\n– **top
\n– **move** : _Move an existing head without loosing player data_
\n– **export** : _Export HeadBlocks database in another database one_
\n– **options** : _Open a GUI with ordering or max click settings_
\n– **reload** : _Reload the plugin configuration_
\n– **version** : _Display the version of the plugin_
\n– **help** : _Display help message_<\/p>\n
\n– **headblocks.use** : _Allows to interact with the heads_
\n– **headblocks.commands.top** : _Top command_
\n– **headblocks.commands.progress** : _Progress command_
\n– **headblocks.commands.progress.other** : _See progress of player_
\n– **headblocks.admin** : _All admin commands (default op)_<\/p>\n
\nIf you want to run holograms, you will need **ProtocolLib**.
\nIf you want to use HeadDatabase heads, you will need **HeadDatabase**. <\/p>\n
\n– **%headblocks_current%** : _player current amount of heads found (raw integer)_
\n– **%headblocks_left%** : _player left amount of heads to found (raw integer)_
\n– **%headblocks_max%** : _total amount of heads placed (raw integer)_
\n– **%headblocks_hasHead_uuid%** : _if player has found the head with uuid defined in \/hb info command (raw boolean)_
\n– **%headblocks_order_previous%** : _if order is specified, display the previous named head found (raw integer or “-” if not calculable)_
\n– **%headblocks_order_current%** : _if order is specified, display the current named head found (raw integer or “-” if not calculable)_
\n– **%headblocks_order_next%** : _if order is specified, display the next named head to found (raw integer or “-” if not calculable)_
\n– **%headblocks_leaderboard_
\n– **HeadClickEvent** : _Event triggered when a head is clicked_
\n– **HeadCreatedEvent** : _Event called when a head is created_
\n– **HeadDeletedEvent** : _Event to trigger when a head is deleted_<\/p>\n
\n– Armorstands may appear over the head. This happens when the DEFAULT config is used for holograms (which is the default) and your ProtocolLib version is out of date. If you can’t upgrade your ProtocolLib version, you can change the hologram type (CMI support, HolographicDisplay or DecentHologram) or simply disable holograms.<\/p>\n
\nMinecraft-heads : large choice of heads textures
\nItem-NBT-API : head-related management
\nConfig-Updater : update config automatically
\nXSound from XSeries : used to play sound
\nStress-test : Just2Craft <\/p>\n