How do I install the Hytale Text Holograms skill?

Run npx skillmds@latest add jburlison/hytale-text-holograms in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Hytale Text Holograms skill do?

Creates floating text holograms in Hytale plugins using invisible entities with nameplates. Use when displaying floating text, title holograms, labels above locations, NPC names, or any world-positioned text displays. Triggers - hologram, text hologram, nameplate, floating text, title hologram, Nameplate, world label, entity nameplate, hovering text. It is listed under Coding & Dev Tools on SkillMD.

Is Hytale Text Holograms safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hytale Text Holograms?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hytale Text Holograms free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hytale Text Holograms?

JBurlison (@jburlison) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hytale Text Holograms by jburlison — Agent Skill

Name: Hytale Text Holograms
Author: JBurlison

Hytale Text Holograms Skill

Use this skill when creating floating text displays (holograms) in the world. Holograms are invisible entities with a Nameplate component that displays text above them.

Quick Reference

Concept	Description
Nameplate	Component that displays text above an entity
ProjectileComponent	Used as an invisible entity shell for the hologram
TransformComponent	Positions the hologram in the world
NetworkId	Required for client-side synchronization
UUIDComponent	Gives the entity a unique identity
Holder	Used to stage components before spawning

How It Works

Text holograms work by spawning an invisible entity (using a ProjectileComponent as a shell) and attaching a Nameplate component to display floating text. The entity is invisible but the nameplate renders as floating text in the world.

Required Imports

import com.hypixel.hytale.component.Holder;
import com.hypixel.hytale.math.vector.Transform;
import com.hypixel.hytale.math.vector.Vec3d;
import com.hypixel.hytale.math.vector.Vec4f;
import com.hypixel.hytale.server.core.entity.UUIDComponent;
import com.hypixel.hytale.server.core.entity.entities.ProjectileComponent;
import com.hypixel.hytale.server.core.entity.nameplate.Nameplate;
import com.hypixel.hytale.server.core.modules.entity.component.TransformComponent;
import com.hypixel.hytale.server.core.modules.entity.tracker.NetworkId;
import com.hypixel.hytale.server.core.universe.PlayerRef;
import com.hypixel.hytale.server.core.universe.Universe;
import com.hypixel.hytale.server.core.universe.world.World;
import com.hypixel.hytale.server.core.universe.world.storage.EntityStore;

Step-by-Step Process

1. Get World Reference

All entity operations must run on the world thread. First, obtain the world where the hologram will spawn:

// From a player context
UUID playerUUID = ctx.sender().getUuid();
PlayerRef playerRef = Universe.get().getPlayer(playerUUID);
World world = Universe.get().getWorld(playerRef.getWorldUuid());
Transform playerTransform = playerRef.getTransform();

2. Execute on World Thread

Entity operations must run on the world thread:

world.execute(() -> {
    // All hologram creation code goes here
});

3. Create Entity Holder

Create a holder to stage components before spawning:

Holder<EntityStore> holder = EntityStore.REGISTRY.newHolder();

4. Create Projectile Component (Entity Shell)

The projectile provides a valid entity shell. It won't move or behave like a real projectile:

ProjectileComponent projectileComponent = new ProjectileComponent("Projectile");

5. Add Position and Identity Components

Component	Purpose
`ProjectileComponent`	Provides a valid entity shell
`TransformComponent`	Sets the entity's position and rotation
`UUIDComponent`	Gives the entity a unique identity

holder.putComponent(ProjectileComponent.getComponentType(), projectileComponent);
holder.putComponent(
    TransformComponent.getComponentType(), 
    new TransformComponent(
        playerTransform.getPosition().clone(), 
        playerTransform.getRotation().clone()
    )
);
holder.ensureComponent(UUIDComponent.getComponentType());

6. Initialize the Projectile

Ensure the projectile entity is fully created before proceeding:

if (projectileComponent.getProjectile() == null) {
    projectileComponent.initialize();
    if (projectileComponent.getProjectile() == null) {
        return; // Initialization failed
    }
}

7. Add Network and Nameplate Components

Component	Purpose
`NetworkId`	Allows the entity to be synced to clients
`Nameplate`	The actual hologram text displayed

holder.addComponent(
    NetworkId.getComponentType(),
    new NetworkId(
        world.getEntityStore()
            .getStore()
            .getExternalData()
            .takeNextNetworkId()
    )
);

holder.addComponent(
    Nameplate.getComponentType(),
    new Nameplate("Your Hologram Text Here")
);

8. Spawn the Entity

Insert the hologram entity into the world:

world.getEntityStore()
    .getStore()
    .addEntity(holder, com.hypixel.hytale.component.AddReason.SPAWN);

Complete Example - Hologram Command

package org.example.plugin;

import com.hypixel.hytale.component.Holder;
import com.hypixel.hytale.math.vector.Transform;
import com.hypixel.hytale.server.core.command.system.CommandContext;
import com.hypixel.hytale.server.core.command.system.basecommands.CommandBase;
import com.hypixel.hytale.server.core.entity.UUIDComponent;
import com.hypixel.hytale.server.core.entity.entities.ProjectileComponent;
import com.hypixel.hytale.server.core.entity.nameplate.Nameplate;
import com.hypixel.hytale.server.core.modules.entity.component.TransformComponent;
import com.hypixel.hytale.server.core.modules.entity.tracker.NetworkId;
import com.hypixel.hytale.server.core.universe.PlayerRef;
import com.hypixel.hytale.server.core.universe.Universe;
import com.hypixel.hytale.server.core.universe.world.World;
import com.hypixel.hytale.server.core.universe.world.storage.EntityStore;

import javax.annotation.Nonnull;
import java.util.UUID;

public class TitleHologramCommand extends CommandBase {

    public TitleHologramCommand() {
        super("TitleHologram", "Create a title hologram.");
    }

    @Override
    protected void executeSync(@Nonnull CommandContext ctx) {
        UUID playerUUID = ctx.sender().getUuid();
        PlayerRef playerRef = Universe.get().getPlayer(playerUUID);
        World world = Universe.get().getWorld(playerRef.getWorldUuid());
        Transform playerTransform = playerRef.getTransform();

        world.execute(() -> {
            Holder<EntityStore> holder = EntityStore.REGISTRY.newHolder();
            ProjectileComponent projectileComponent = new ProjectileComponent("Projectile");

            holder.putComponent(ProjectileComponent.getComponentType(), projectileComponent);
            holder.putComponent(
                TransformComponent.getComponentType(), 
                new TransformComponent(
                    playerTransform.getPosition().clone(), 
                    playerTransform.getRotation().clone()
                )
            );
            holder.ensureComponent(UUIDComponent.getComponentType());

            if (projectileComponent.getProjectile() == null) {
                projectileComponent.initialize();
                if (projectileComponent.getProjectile() == null) {
                    return;
                }
            }

            holder.addComponent(
                NetworkId.getComponentType(),
                new NetworkId(
                    world.getEntityStore()
                        .getStore()
                        .getExternalData()
                        .takeNextNetworkId()
                )
            );
            
            holder.addComponent(
                Nameplate.getComponentType(),
                new Nameplate("Testing Holograms")
            );

            world.getEntityStore()
                .getStore()
                .addEntity(holder, com.hypixel.hytale.component.AddReason.SPAWN);
        });
    }
}

Spawning at Custom Position

To spawn a hologram at a specific position instead of the player's location:

Vec3d position = new Vec3d(100.0, 65.0, 200.0);
Vec4f rotation = new Vec4f(0, 0, 0, 1); // Identity quaternion

holder.putComponent(
    TransformComponent.getComponentType(), 
    new TransformComponent(position, rotation)
);

Utility Method Example

Create a reusable utility method for spawning holograms:

public static void spawnHologram(World world, Vec3d position, String text) {
    world.execute(() -> {
        Holder<EntityStore> holder = EntityStore.REGISTRY.newHolder();
        ProjectileComponent projectileComponent = new ProjectileComponent("Projectile");

        holder.putComponent(ProjectileComponent.getComponentType(), projectileComponent);
        holder.putComponent(
            TransformComponent.getComponentType(), 
            new TransformComponent(position.clone(), new Vec4f(0, 0, 0, 1))
        );
        holder.ensureComponent(UUIDComponent.getComponentType());

        if (projectileComponent.getProjectile() == null) {
            projectileComponent.initialize();
            if (projectileComponent.getProjectile() == null) {
                return;
            }
        }

        holder.addComponent(
            NetworkId.getComponentType(),
            new NetworkId(
                world.getEntityStore()
                    .getStore()
                    .getExternalData()
                    .takeNextNetworkId()
            )
        );
        
        holder.addComponent(
            Nameplate.getComponentType(),
            new Nameplate(text)
        );

        world.getEntityStore()
            .getStore()
            .addEntity(holder, com.hypixel.hytale.component.AddReason.SPAWN);
    });
}

Key Points

World Thread Required: All entity operations must run inside world.execute(() -> { ... })
ProjectileComponent: Used as an invisible shell - it won't move or behave like a projectile
NetworkId Required: Without this, the hologram won't sync to clients
UUIDComponent Required: Provides unique entity identity
Initialize Projectile: Must call projectileComponent.initialize() before spawning
Nameplate Text: The text passed to new Nameplate(text) will be displayed as floating text

Troubleshooting

Issue	Solution
Hologram not visible	Ensure `NetworkId` component is added
Entity not spawning	Check that `projectileComponent.initialize()` succeeded
Wrong position	Verify `TransformComponent` has correct coordinates
Crashes on spawn	Ensure code runs inside `world.execute()`

Credits

Thanks to Al3xWarrior and Quito on Discord for initially discovering this feature, and Elie for the initial code snippet.

Reference

Source: Hytale Modding - Text Hologram Guide

Hytale Text Holograms

File contents

Hytale Text Holograms Skill

Quick Reference

How It Works

Required Imports

Step-by-Step Process

1. Get World Reference

2. Execute on World Thread

3. Create Entity Holder

4. Create Projectile Component (Entity Shell)

5. Add Position and Identity Components

6. Initialize the Projectile

7. Add Network and Nameplate Components

8. Spawn the Entity

Complete Example - Hologram Command

Spawning at Custom Position

Utility Method Example

Key Points

Troubleshooting

Credits

Reference

Frequently asked questions

Hytale Text Holograms

File contents

Hytale Text Holograms Skill

Quick Reference

How It Works

Required Imports

Step-by-Step Process

1. Get World Reference

2. Execute on World Thread

3. Create Entity Holder

4. Create Projectile Component (Entity Shell)

5. Add Position and Identity Components

6. Initialize the Projectile

7. Add Network and Nameplate Components

8. Spawn the Entity

Complete Example - Hologram Command

Spawning at Custom Position

Utility Method Example

Key Points

Troubleshooting

Credits

Reference

Related skills

Frequently asked questions

How do I install the Hytale Text Holograms skill?

What does the Hytale Text Holograms skill do?

Is Hytale Text Holograms safe to use?

Which AI agents work with Hytale Text Holograms?

Is Hytale Text Holograms free to use?

Who published Hytale Text Holograms?