Host your Minecraft server on BisectHosting - get 25% off your first month with code MODRINTH.


Supported by Paper Supported by Spigot

Patreon Official Website Join Our Discord

Built with Gradle Built with Java

About LobbyHeads

LobbyHeads is a Minecraft server hub plugin, designed to adorn your hub spaces with decorative heads. Designed to be highly configurable, it allows designated players to replace these decorative heads with their own, displaying a holographic nickname and skin for personalized flare. This adds an extra layer of cosmetic reward for patrons and special rank holders.

Built to be compatible and extensively tested with Minecraft versions 1.17.1 through 1.20.2, LobbyHeads should function seamlessly with other Minecraft versions too. Always ensure your server is using Java 17 or later for the smoothest experience.

If you find any bugs, issues or inconsistencies, kindly report them here.

Plugin Preview

How head work? (You can use this example for premium ranks on your server!)


How to set up heads? (/heads add comand)


Permission Assignments

LobbyHeads offers two permissions for administrators to assign:

Permission Description
lobbyheads.replace Allows the user to replace decorative heads whenever they want.
lobbyheads.admin Grants the user permission to add or remove decorative heads.
lobbyheads.receiveupdates Grants the user permission to receive updates about new versions of the plugin.

Usage Guidelines

Follow the steps below to use LobbyHeads:

  1. Acquire a player head via game mode and place.
  2. Looking at placed head, type /heads add to place the player head.
  3. If you wish to remove a head, stand in front of it and type /heads remove.
  4. Well done! You have successfully interacted with LobbyHeads.

For developers

Build Process

Use the command ./gradlew shadowJar to build the project.

The output file LobbyHeads-<version>.jar will be located in the build/libs directory.


We wholeheartedly welcome your contributions to LobbyHeads! Please refer to our contribution guidelines for detailed procedures on how you can contribute, and our code of conduct to ensure a harmonious and welcoming community.

Issue Reporting

Experiencing an issue with the plugin? Report it under our Issues tab. Be sure to provide maximum information, such as your Minecraft version, plugin version, and relevant error messages or logs for an efficient diagnosis.

External resources

Project members




Technical information

Project ID