
xHeadTurns
xHeadTurns is a lightweight and powerful plugin that lets you bring your server to life with floating, interactive heads. Place decorative heads anywhere in your world that, when clicked by a player, can execute a list of fully customizable commands.
Tags
Creators
Details
v1.0.5
Compatibility
Changes
Changelog - xHeadTurns
All news, fixes, and improvements for the project.
[v1.0.5] - 2026-02-25
🚀 New Features
- MiniMessage Support: Holograms now support the modern Adventure format.
- Gradients:
<gradient:#a7c7e7:#77dd77>Text</gradient> - Rainbow:
<rainbow>Text</rainbow> - Hex Colors:
<#FF0000>Text
- Gradients:
- Advanced Color System: The background edit command (
/xhte ... background) now accepts:- Names:
RED,BLUE,TRANSPARENT. - RGB:
255,0,010,0,30. - Hexadecimal:
#FF0055.
- Names:
- Automatic Centering: When creating or moving a head, it now automatically snaps to the exact center of the block (
x.5,z.5) facing the player.
🐛 Bug Fixes
- CRITICAL: "Zombie" Fix: Fixed an issue where heads and holograms would duplicate or become immortal upon reload/crash.
- All entities now have
Persistent=false. If the server crashes, Minecraft removes them automatically.
- All entities now have
- Hologram Overlap Fix: Inverted the hologram construction logic.
- Before: Grew downwards, clipping into the head.
- Now: Grows upwards from the base, always respecting the head's space.
- Rotation Fix: Fixed a bug where heads lost their direction (Yaw/Pitch) upon server restart. Now saved correctly in
data.yml. - Command Fix: Resolved
IndexOutOfBoundserror when using short aliases like/xhtcor/xhte. - Detection Fix (Case Sensitivity): The plugin now internally forces names to lowercase. It no longer matters if you type "Head" or "head"; the plugin will find it.
⚡ Technical Changes
- Data Migration: Active heads are no longer saved in
config.yml.- Implemented
data.ymlto handle active entity storage, separating logic configuration from save data.
- Implemented
- Animation Optimization: Animation tasks now run on the main thread (
runTaskTimer) safely to prevent desynchronization with the Bukkit API.
🗑️ Removed
- Removed strict legacy color support in favor of the hybrid system (Legacy + MiniMessage).
- Removed hardcoded messages in Java code; everything now responds to
messages/en.ymlandes.yml.
xPlugins
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:mYSfbxDb:b5uIgm6C"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:mYSfbxDb:b5uIgm6C"
}
