HeadDatabase

HeadDB 6.0.0 Changelog

Last updated: March 11, 2026 Release status: In progress

CI/CD Updates (March 11, 2026)

• Added Maven distributionManagement to headdb-api/pom.xml for:
  • nexus-releases (https://nexus.bitworksmc.com/repository/maven-releases/)
  • nexus-snapshots (https://nexus.bitworksmc.com/repository/maven-snapshots/)
• Replaced the old build upload pipeline with .github/workflows/publish.yml to deploy headdb-api on master pushes and manual runs.
• Added .github/workflows/release.yml to build on v* tags (or manual tag input) and create GitHub Releases using changelog/<version>.md when available.

Additional Updates (March 11, 2026)

• Made the Discord join message clickable in chat (open_url) from:
  • Main menu info item
  • Heads GUI info item
  • Favorites GUI info item
  • Local Heads GUI info item
  • Custom Categories GUI info item
• Updated main menu control slots:
  • More Categories moved to slot 47
  • Search moved to slot 48
  • Local Heads moved to slot 50
  • Favorites moved to slot 51

Pending Commit Summary

refactor: migrate HeadDB to com.bitworksmc with legacy API support

Pending Commit Description

• Moved plugin source packages from com.github.thesilentpro.headdb.* to com.bitworksmc.headdb.*.
• Updated plugin main class references and build metadata to the new package namespace.
• Switched Maven project coordinates for this project to com.bitworksmc.
• Introduced new API namespace under com.bitworksmc.headdb.api.*.
• Kept legacy API namespace (com.github.thesilentpro.headdb.api.*) for migration and marked it as deprecated.
• Added a runtime adapter to register both legacy and modern HeadAPI services in Bukkit.
• Updated documentation and release notes to reflect the migration and compatibility path.

Highlights

• Full v6 rewrite foundation was introduced.
• Added/expanded config system work (config manager, sound config, head customization, item factory relocation).
• Added Folia 1.21.11 support and related compatibility fixes.
• Head database source moved to a configurable URL option.
• Menu pagination issues were fixed.
• Vault economy integration was modernized to work with VaultUnlocked API expectations, with safer fallback behavior.
• Project namespace migration started from com.github.thesilentpro to com.bitworksmc.

Breaking Changes (6.0.0)

• Primary plugin code package moved to com.bitworksmc.headdb.*.
• Bukkit plugin main class changed to com.bitworksmc.headdb.core.HeadDB.
• Maven project group changed to com.bitworksmc.
• Primary API namespace is now com.bitworksmc.headdb.api.*.

Compatibility Notes

• Legacy API package com.github.thesilentpro.headdb.api.* is still present for migration and marked @Deprecated(forRemoval = true, since = "6.0.0").
• HeadDB now registers both API service interfaces in Bukkit ServicesManager:
  • com.bitworksmc.headdb.api.HeadAPI (new)
  • com.github.thesilentpro.headdb.api.HeadAPI (legacy adapter)

Migration Guide

1. Update imports from com.github.thesilentpro.headdb.* to com.bitworksmc.headdb.*.
2. Update dependency coordinates to com.bitworksmc:*.
3. Move service lookups to com.bitworksmc.headdb.api.HeadAPI.
4. Keep legacy imports only temporarily while migrating; they are deprecated for removal.

Commit History Included In 6.0.0 Line

• cd526e7 v6 rewrite
• d072e51 Update jitpack.yml
• 97e0d7e Update README.md
• 9df1f6d Added sounds.yml Added head customization Added config manager Added (and relocated) item creation to item factories
• a15cbe7 Merge remote-tracking branch 'origin/master'
• 84e316d feat: add Folia 1.21.11 support and fix head name rendering
• 3f1c4df Update HDBCommandSearch.java
• 8b2ff96 Merge pull request #1 from EarthPol/folia
• 127cc75 Migrate head database json to a config option url
• 9091ba2 Update heads.json
• a8c0de6 Fix pagination on menu
• 3f81e57 Migrate to Bitworks - Fix Vault

Working Tree Updates Tracked For 6.0.0 (Pending Commit)

• Added new API namespace interfaces:
  • com.bitworksmc.headdb.api.HeadAPI
  • com.bitworksmc.headdb.api.HeadDatabase
  • com.bitworksmc.headdb.api.model.Head
• Added legacy runtime adapter:
  • com.bitworksmc.headdb.core.api.LegacyHeadAPIAdapter
• Updated docs and build metadata to point to com.bitworksmc coordinates and package paths.
• Updated plugin metadata and shade main class references to the new namespace.