xHeadTurns

✨ EXAMPLE ✨

xHeadTurns - Interactive & Customizable Floating Heads

Bring your server to life with xHeadTurns, a powerful and lightweight plugin that allows you to place interactive, rotating heads anywhere in your world. These heads can execute custom commands when clicked, making them perfect for creating unique server menus, interactive NPCs, info points, and much more!

✨ Features In-Game Management: Create, delete, and manage all floating heads with simple and intuitive commands right from the game. No need to restart the server.

Deep Customization: For each head, you can configure:

Custom Textures: Supports player names and Base64 values from sites like minecraft-heads.com!

Rotation Speed: Make them spin fast or slow.

Particle Effects: Add a touch of magic with configurable particles.

Click Cooldown: Prevent spam by setting a cooldown between interactions.

Command Execution: Assign a list of commands to be run from the console when a player clicks a head. Perfect for rewards, teleports, opening other menus, and more.

PlaceholderAPI Support: Use placeholders in your commands to personalize actions for each player (e.g., eco give %player_name% 100).

Multi-Language Support: All plugin messages can be easily translated. English and Spanish are included by default.

Lightweight & Optimized: Designed to be efficient and not cause any lag on your server.

🎮 Commands & Permissions All commands use the xheadturns.* permission structure. The main command is /xht.

/xht help - (none) - Displays the help message.
/xht create <name> - xheadturns.create - Creates a new floating head at your eye level.
/xht delete <name> - xheadturns.delete - Deletes an existing floating head.
/xht reload - xheadturns.reload - Reloads the entire plugin configuration.

⚙️ Configuration The configuration is straightforward Here is an example from the config file

#    ___             __ _
#   / __\___  _ __  / _(_) __ _
#  / /  / _ \| '_ \| |_| |/ _` |  Plugin By
# / /__| (_) | | | |  _| | (_| |  WillfryDev
# \____/\___/|_| |_|_| |_|\__, |
#                         |___/ .yml
# Set the locale for plugin messages.
# Available languages are stored in the 'messages' folder (e.g., en, es).
locale: "es"

# Define all the floating heads here.
# You can create more using '/xhtc <name>'
heads:
  default:
    # Location where the head will be spawned.
    location:
      world: world
      x: 0.5
      y: 75.0
      z: 0.5
    # Texture of the head. Supports PlaceholderAPI.
    # You can use a player name (e.g., "Notch") or a Base64 value from sites like minecraft-heads.com
    texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY-JhMDdkYTI3ZDg1YzA5MTY4ODFlNTUyMmVlNGU5NjhhYmRjOWMyODg4ZTMifX19"
    # Rotating speed in degrees per tick (higher is faster).
    speed: 2.5
    # Cooldown in seconds between clicks for a single player.
    click-cooldown: 1
    # Particle to display around the head.
    # Particle List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
    particle-type: "FLAME"
    # List of commands to be executed when a player right-clicks the head.
    # Supports PlaceholderAPI. Commands are run from the console.
    commands:
      - "say Hello, %player_name%!"
      - "eco give %player_name% 100"
#  __♥__♥_____♥__♥___ Want To
#  _♥_____♥_♥_____♥__ Work As
#  _♥______♥______♥__ A
#  __♥___________♥__ Translator?
#  ___♥_________♥___ Join Our
#  ____♥______♥_____ Discord At
#  ______♥_♥_______ https://discord.gg/
#  ________♥_________ AH5k9YE78b

📥 Installation Make sure your server is running on Paper (or a fork) 1.19+.

Install PlaceholderAPI.

Download the latest version of xHeadTurns.jar.

Place the .jar file into your server's /plugins folder.

Restart your server, and you're ready to

📜Messanges | English

#                                                  
#   /\/\   ___  ___ ___  __ _ _ __   __ _  ___  ___ 
#  /    \ / _ \/ __/ __|/ _` | '_ \ / _` |/ _ \/ __|
# / /\/\ \  __/\__ \__ \ (_| | | | | (_| |  __/\__ \
# \/    \/\___||___/___/\__,_|_| |_|\__, |\___||___/
#                                  |___/ English 
# 📖 Wiki & Support:
# Join our Discord: https://discord.gg/AH5k9YE78b

prefix: "&8[&6xHeadTurns&8] &r"
no-permission: "{prefix}&cYou do not have permission to execute this command."
player-only: "{prefix}&cThis command can only be executed by a player."
unknown-command: "{prefix}&cUnknown command. Use /xht help for a list of commands."
reload-success: "{prefix}&aConfiguration reloaded successfully."
create-usage: "{prefix}&cUsage: /xhtc <name>"
create-success: "{prefix}&aFloating head '{name}' created successfully."
create-fail-exists: "{prefix}&cError: A head with that name already exists."
delete-usage: "{prefix}&cUsage: /xhtd <name>"
delete-success: "{prefix}&aFloating head '{name}' has been deleted."
head-not-found: "{prefix}&cError: No floating head found with that name."
on-cooldown: "{prefix}&cYou must wait {time} second(s) to click again."
help-message:
  - "&6&m-----------------------------------------"
  - "&e/xht help &7- Shows this help message."
  - "&e/xhtr &7- Reloads the configuration."
  - "&e/xhtc <name> &7- Creates a new floating head."
  - "&e/xhtd <name> &7- Deletes a floating head."
  - "&6&m-----------------------------------------"

📜Messanges | Spanish

#                               _
#   /\/\   ___ _ __  ___  __ _ (_) ___  ___
#  /    \ / _ \ '_ \/ __|/ _` || |/ _ \/ __|
# / /\/\ \  __/ | | \__ \ (_| || |  __/\__ \
# \/    \/\___|_| |_|___/\__,_|/ |\___||___/
#                  Español
# 📖 Wiki & Support:
# Join our Discord: https://discord.gg/AH5k9YE78b


prefix: "&8[&6xHeadTurns&8] &r"
no-permission: "{prefix}&cNo tienes permiso para ejecutar este comando."
player-only: "{prefix}&cEste comando solo puede ser ejecutado por un jugador."
unknown-command: "{prefix}&cComando desconocido. Usa /xht help para ver la lista de comandos."
reload-success: "{prefix}&aLa configuración se ha recargado correctamente."
create-usage: "{prefix}&cUso: /xhtc <nombre>"
create-success: "{prefix}&aCabeza flotante '{name}' creada correctamente."
create-fail-exists: "{prefix}&cError: Ya existe una cabeza con ese nombre."
delete-usage: "{prefix}&cUso: /xhtd <nombre>"
delete-success: "{prefix}&aLa cabeza flotante '{name}' ha sido eliminada."
head-not-found: "{prefix}&cError: No se encontró ninguna cabeza flotante con ese nombre."
on-cooldown: "{prefix}&cDebes esperar {time} segundo(s) para volver a hacer clic."
help-message:
  - "&6&m-----------------------------------------"
  - "&e/xht help &7- Muestra este mensaje de ayuda."
  - "&e/xhtr &7- Recarga la configuración."
  - "&e/xhtc <nombre> &7- Crea una nueva cabeza flotante."
  - "&e/xhtd <nombre> &7- Elimina una cabeza flotante."
  - "&6&m-----------------------------------------"

✨ ¡New server! - Join play.minefania.lol

🔥 Partner 10% discount on your purchases on Website

     _          _ 
    / \   _ __ (_)
   / _ \ | '_ \| |
  / ___ \| |_) | |
 /_/   \_\ .__/|_|
         |_|      ⬇️

Set<String> todasLasCabezas = api.getHeadNames();
System.out.println("Cabezas de xHeadTurns: " + todasLasCabezas);

// Ejemplo de cómo hacer caer un rayo sobre una cabeza llamada "default"
api.getHeadEntity("default").ifPresent(armorStand -> {
    armorStand.getWorld().strikeLightning(armorStand.getLocation());
});