HydroHologram

Create floating text displays anywhere in your world!

HydroHologram is a powerful and easy-to-use hologram plugin for Hytale servers that allows you to create, edit, and manage floating text displays throughout your world. Perfect for server information, welcome messages, rules, waypoints, and more!

Just a heads up, color text does not work atm due to Hytale locking there code for color for nameplates. When that get fixed will update the hologram to have color!

Hey everyone here is the list of mod that are currectly conflicting with HydroHologram and can't fix on our end at this stage yet.

- Nothing at this stage

Features

Multi-Line Holograms

Create holograms with unlimited text lines
Each line is independently editable
Create Image holograms (Version 1.0.3+)
Create Gif holograms (Version 1.0.8+)
Use Custom animations for images and gifs

Intuitive GUI Editor

In-game editor interface
Click on any line to edit it directly
Add, update, or remove lines with a single click
Real-time preview of changes
Change location with x,y,z button
Update holograms direction.

Easy Positioning

Create holograms at your current location
Move existing holograms to your position with the "Move Here" button
Precise coordinate display in the editor
Can you entity tool to move them and scale them

Road Map
- Add in a config option in folder so you can change in there too
- Add in lighting to holograms
- And any other request

🖼️ Image Hologram Lines (Only works on 1.0.3 and above)

Basic Format:
image:<name> (Display image at default scale)

With Scale:
image:<name>:<scale> (Display image with custom scale)
Example: image:logo:2.0 (2x size)
Example: image:logo:0.5 (Half size)

With Direction
image:<name>:<direction> (Display image facing a direction)
image:<name>:<scale>:<direction> (Scale + direction)
Example: image:logo:s (Facing south)
Example: image:logo:2.0:sw (2x size, facing southwest)

Available Directions:
n, ne, e, se, s, sw, w, nw

Billboard Mode: (Faces Each Player!)
image:<name>:true (Always faces each player)
image:<name>:true:<distance> (Faces player within distance (blocks))
image:<name>:true:<distance>:<dir> (Billboard with fallback direction to config)
image:<name>:<scale>:true:<distance>:<dir> (Full options)

Example: image:logo:true (Billboard mode)
Example: image:logo:true:20 (Billboard within 20 blocks)
Example: image:logo:1.5:true:20:s (1.5x scale, billboard 20 blocks, faces south when out of range)

Double-Sided Mode: (Version 1.10.0+)
Add :ds or :doublesided anywhere in the line to make the image visible from both front and back!

image:<name>:ds (Double-sided image)
image:<name>:<scale>:ds (Double-sided with scale)
image:<name>:true:ds (Billboard + double-sided)

Example: image:logo:ds (Visible from both sides)
Example: image:logo:2.0:ds (2x size, double-sided)
Example: image:logo:true:ds (Billboard + double-sided)

Animation Tags: (Version 1.10.0+)
Add :anim_<name> anywhere in the line to animate your image!

image:<name>:anim_bounce (Bouncing image)
image:<name>:<scale>:anim_float (Floating image with scale)
image:<name>:ds:anim_spin (Double-sided spinning image)
image:<name>:true:anim_pulse (Billboard pulsing image)

Example: image:logo:anim_bounce (Bouncing logo)
Example: image:logo:2.0:anim_float (2x size floating logo)
Example: image:logo:ds:anim_spin (Double-sided spinning logo)
Example: image:logo:true:anim_pulse (Billboard pulsing logo)

Available Animations:
Floating: :anim_float, :anim_float_slow, :anim_float_fast
Spinning: :anim_spin, :anim_spin_slow, :anim_spin_fast, :anim_tumble
Pulsing: :anim_pulse, :anim_pulse_big, :anim_heartbeat, :anim_breathe
Bouncing: :anim_bounce, :anim_bounce_small
Swaying: :anim_sway, :anim_sway_big
Wobbling: :anim_wobble, :anim_wobble_slow, :anim_wobble_fast
Shaking: :anim_shake, :anim_shake_big
Orbiting: :anim_orbit, :anim_orbit_small, :anim_orbit_fast
Other: :anim_wave, :anim_flip, :anim_flip_full

Use /holo animlist to see all available animations in-game!

---

📝 How to Add Custom Images

1. Place your PNG in: mods/com.hydrohologram_HydroHologram/images/
2. Run: /holo reload to generate the assest zip for the img to load. No Restart Need anymore from 1.0.5 Version and above.
3. Use: /holo edit (name), Make sure you have created a hologram first so you can edit it. (/Holo create (name))

🎬 GIF Hologram Lines (Version 1.0.8+)

Basic Format:
gif:<name> (Display GIF at default scale and speed)

With Scale:
gif:<name>:scale_<value> (Custom scale)
Example: gif:fire:scale_2 (2x size)
Example: gif:fire:scale_0.5 (Half size)

With Speed:
gif:<name>:speed_<value> (Custom animation speed)
Example: gif:fire:speed_2 (2x faster)
Example: gif:fire:speed_0.5 (Half speed / slower)

With Direction:
gif:<name>:dir_<direction> (Facing direction)
Example: gif:fire:dir_s (Facing south)
Example: gif:fire:dir_ne (Facing northeast)

Available Directions:
n, ne, e, se, s, sw, w, nw

Billboard Mode: (Faces Each Player!)
gif:<name>:true (Always faces each player)
gif:<name>:true:blocks_<distance> (Faces player within distance)

Example: gif:fire:true (Billboard mode)
Example: gif:fire:true:blocks_20 (Billboard within 20 blocks)

Combined Parameters:
Parameters can be combined in any order!
gif:<name>:scale_1.5:speed_2:dir_sw (Scale + speed + direction)
gif:<name>:true:blocks_30:scale_2 (Billboard + distance + scale)

Example: gif:fire:scale_2:speed_0.5 (2x size, half speed)
Example: gif:fire:true:blocks_20:scale_1.5 (Billboard, 20 blocks, 1.5x size)

Double-Sided Mode: (Version 1.10.0+)
Add :ds or :doublesided anywhere in the line to make the GIF visible from both front and back!

gif:<name>:ds (Double-sided GIF)
gif:<name>:scale_2:ds (Double-sided with scale)
gif:<name>:true:ds (Billboard + double-sided)

Example: gif:fire:ds (Visible from both sides)
Example: gif:fire:scale_2:ds (2x size, double-sided)
Example: gif:fire:true:ds (Billboard + double-sided)
Example: gif:fire:scale_2:speed_0.5:ds (2x size, half speed, double-sided)

Animation Tags: (Version 1.10.0+)
Add :anim_<name> anywhere in the line to add movement animations to your GIF!

gif:<name>:anim_float (Floating GIF)
gif:<name>:scale_2:anim_wobble (Wobbling GIF with scale)
gif:<name>:ds:anim_bounce (Double-sided bouncing GIF)
gif:<name>:true:anim_pulse (Billboard pulsing GIF)

Example: gif:fire:anim_float (Floating fire GIF)
Example: gif:fire:scale_2:anim_wobble (2x size wobbling fire)
Example: gif:fire:ds:anim_bounce (Double-sided bouncing fire)
Example: gif:fire:true:anim_spin (Billboard spinning fire)

Use /holo animlist to see all available animations in-game!

---

📝 How to Add Custom GIFs

1. Place your GIF in: mods/com.hydrohologram_HydroHologram/gifs/
2. Run: /holo reload to extract frames and generate the asset zip for the GIF to load. No Restart Needed anymore from 1.0.5 Version and above.
3. Use: /holo edit (name), Make sure you have created a hologram first so you can edit it. (/holo create (name))

Commands:

Command	Description
`/holo create <name>`	Create a new hologram at your location
`/holo delete <name>`	Delete an existing hologram
`/holo edit <name>`	Open the GUI editor for a hologram
`/holo list`	List all holograms on the server
`/holo moveto <name>`	Teleport to a hologram's location
`/holo movehere <name>`	Move a hologram to your current position
`/holo addline <name> <text>`	Add a line of text to a hologram
`/holo setline <name> <line#> <text>`	Set a specific line's text
`/holo removeline <name> <line#>`	Remove a specific line
`/holo info <name>`	View detailed information about a hologram
/holo animlist	Show you all avaiable animation you can use in image and gif
/holo entityreload	Reload entity for all player client wise. This is the only way to fix see entity shrink after holo reload

Permission:

Permission	Description
`hydrohologram.admin`	Wildcard - grants ALL permissions
`hydrohologram.create`	Create holograms
`hydrohologram.delete`	Delete holograms and remove lines
`hydrohologram.edit`	Edit holograms (add/update lines, change direction, animation list)
`hydrohologram.list`	View holograms
`hydrohologram.move`	Move/teleport holograms
`hydrohologram.reload`	Reload plugin/ Entity reload
`hydrohologram.cleanup`	Cleanup orphaned entities

Commands

Command	Permission Required
`/holo create <name>`	`hydrohologram.create`
`/holo delete <name>`	`hydrohologram.delete`
`/holo edit <name>`	`hydrohologram.edit`
`/holo list`	`hydrohologram.list`
`/holo info <name>`	`hydrohologram.list`
`/holo moveto <name>`	`hydrohologram.move`
`/holo movehere <name>`	`hydrohologram.move`
`/holo addline <name> <text>`	`hydrohologram.edit`
`/holo setline <name> <#> <text>`	`hydrohologram.edit`
`/holo removeline <name> <#>`	`hydrohologram.edit`
`/holo reload`	`hydrohologram.reload`
`/holo cleanup`	`hydrohologram.cleanup`
/holo animlist	`hydrohologram.edit`
/holo entityreload	`hydrohologram.reload`

GUI Editor Permissions

GUI Action	Permission Required
Add Line (ADD button)	`hydrohologram.edit`
Update Line (click line to edit)	`hydrohologram.edit`
Remove Line (X button)	`hydrohologram.delete`
Change Direction (N/S/E/W buttons)	`hydrohologram.edit`
Move Here button	`hydrohologram.move`
Position controls (+/- buttons)	`hydrohologram.move`
Set Position (SET button)	`hydrohologram.move`
Delete Hologram (DELETE button)	`hydrohologram.delete`

Notes

OPs bypass all permissions - Players with *, hytale.op, or hytale.operator have access to everything
Admin is wildcard - hydrohologram.admin grants access to ALL commands and GUI actions
GUI respects permissions - Buttons will show an error message and refresh properly if permission denied
Avaiable from Version (1.0.8+)

Make sure to visit us in discord for any support:
Discord

If you want to also help fund this project just click the link below. Thank you to anyone who does:
ko-fi.com

Thank you all for download and supporting this. As im still new to creating mods for hytale :)

Contrubiter to the mod:
- wiflow Curseforge Mod Page for Wilflow

Hydro Hologram