Hydro Hologram

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)

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 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