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:

Permission:

Commands

GUI Editor Permissions

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