Implemented feature from here: #46

Author: TSERATO

plugins/fancyholograms/fh-api/src/main/java/com/fancyinnovations/fancyholograms/api/data/TextHologramData.java

@@ -21,13 +21,15 @@ public class TextHologramData extends DisplayHologramData {
     public static final boolean DEFAULT_TEXT_SHADOW_STATE = false;
     public static final boolean DEFAULT_SEE_THROUGH = false;
     public static final int DEFAULT_TEXT_UPDATE_INTERVAL = -1;
+    public static final byte DEFAULT_TEXT_OPACITY = (byte) 255;
 
     private List<String> text = new ArrayList<>(DEFAULT_TEXT);
     private Color background = null;
     private TextDisplay.TextAlignment textAlignment = DEFAULT_TEXT_ALIGNMENT;
     private boolean textShadow = DEFAULT_TEXT_SHADOW_STATE;
     private boolean seeThrough = DEFAULT_SEE_THROUGH;
     private int textUpdateInterval = DEFAULT_TEXT_UPDATE_INTERVAL;
+    private byte textOpacity = DEFAULT_TEXT_OPACITY;
 
     /**
      * @param name     Name of hologram
@@ -150,6 +152,19 @@ public TextHologramData setTextUpdateInterval(int textUpdateInterval) {
         return this;
     }
 
+    public byte getTextOpacity() {
+        return textOpacity;
+    }
+
+    public TextHologramData setTextOpacity(byte textOpacity) {
+        if (this.textOpacity != textOpacity) {
+            this.textOpacity = textOpacity;
+            setHasChanges(true);
+        }
+
+        return this;
+    }
+
     @Override
     @ApiStatus.Internal
     public boolean read(ConfigurationSection section, String name) {
@@ -163,6 +178,7 @@ public boolean read(ConfigurationSection section, String name) {
         textShadow = section.getBoolean("text_shadow", DEFAULT_TEXT_SHADOW_STATE);
         seeThrough = section.getBoolean("see_through", DEFAULT_SEE_THROUGH);
         textUpdateInterval = section.getInt("update_text_interval", DEFAULT_TEXT_UPDATE_INTERVAL);
+        textOpacity = (byte) section.getInt("text_opacity", DEFAULT_TEXT_OPACITY);
 
         String textAlignmentStr = section.getString("text_alignment", DEFAULT_TEXT_ALIGNMENT.name().toLowerCase());
         textAlignment = switch (textAlignmentStr.toLowerCase(Locale.ROOT)) {
@@ -197,6 +213,7 @@ public boolean write(ConfigurationSection section, String name) {
         section.set("see_through", seeThrough);
         section.set("text_alignment", textAlignment.name().toLowerCase(Locale.ROOT));
         section.set("update_text_interval", textUpdateInterval);
+        section.set("text_opacity", textOpacity);
 
         final String color;
         if (background == null) {
@@ -223,6 +240,7 @@ public TextHologramData copy(String name) {
                 .setTextShadow(this.hasTextShadow())
                 .setSeeThrough(this.isSeeThrough())
                 .setTextUpdateInterval(this.getTextUpdateInterval())
+                .setTextOpacity(this.getTextOpacity())
                 .setScale(this.getScale())
                 .setShadowRadius(this.getShadowRadius())
                 .setShadowStrength(this.getShadowStrength())

plugins/fancyholograms/fh-api/src/main/java/com/fancyinnovations/fancyholograms/api/events/HologramUpdateEvent.java

@@ -78,6 +78,7 @@ public enum HologramModification {
         BACKGROUND,
         TEXT_SHADOW,
         TEXT_ALIGNMENT,
+        TEXT_OPACITY,
         SEE_THROUGH,
         SHADOW_RADIUS,
         SHADOW_STRENGTH,

plugins/fancyholograms/fh-api/src/main/java/com/fancyinnovations/fancyholograms/api/hologram/HologramType.java

@@ -4,7 +4,7 @@
 import java.util.List;
 
 public enum HologramType {
-    TEXT(Arrays.asList("background", "textshadow", "textalignment", "seethrough", "setline", "removeline", "addline", "insertbefore", "insertafter", "updatetextinterval")),
+    TEXT(Arrays.asList("background", "textshadow", "textalignment", "opacity", "seethrough", "setline", "removeline", "addline", "insertbefore", "insertafter", "updatetextinterval")),
     ITEM(List.of("item")),
     BLOCK(List.of("block"));
 

plugins/fancyholograms/src/main/java/com/fancyinnovations/fancyholograms/commands/HologramCMD.java

@@ -49,6 +49,7 @@ public final class HologramCMD extends Command {
             <%primary_color%>- /hologram edit <hologram> background <color> <dark_gray>- <white>Changes the background of the hologram
             <%primary_color%>- /hologram edit <hologram> textShadow <true|false> <dark_gray>- <white>Enables/disables the text shadow
             <%primary_color%>- /hologram edit <hologram> textAlignment <alignment> <dark_gray>- <white>Sets the text alignment
+            <%primary_color%>- /hologram edit <hologram> opacity <0-100> <dark_gray>- <white>Changes the opacity of the text hologram
             <%primary_color%>- /hologram edit <hologram> seeThrough <true|false> <dark_gray>- <white>Enables/disables whether the text can be seen through blocks
             <%primary_color%>- /hologram edit <hologram> shadowRadius <value> <dark_gray>- <white>Changes the shadow radius of the hologram
             <%primary_color%>- /hologram edit <hologram> shadowStrength <value> <dark_gray>- <white>Changes the shadow strength of the hologram
@@ -376,6 +377,7 @@ private boolean edit(@NotNull final CommandSender player, @NotNull final Hologra
             case "insertafter" -> new InsertAfterCMD().run(player, hologram, args);
             case "textshadow" -> new TextShadowCMD().run(player, hologram, args);
             case "textalignment" -> new TextAlignmentCMD().run(player, hologram, args);
+            case "opacity" -> new OpacityCMD().run(player, hologram, args);
             case "seethrough" -> new SeeThroughCMD().run(player, hologram, args);
 
             // block data

plugins/fancyholograms/src/main/java/com/fancyinnovations/fancyholograms/commands/hologram/OpacityCMD.java

@@ -0,0 +1,80 @@
+package com.fancyinnovations.fancyholograms.commands.hologram;
+
+import com.fancyinnovations.fancyholograms.api.data.TextHologramData;
+import com.fancyinnovations.fancyholograms.api.events.HologramUpdateEvent;
+import com.fancyinnovations.fancyholograms.api.hologram.Hologram;
+import com.fancyinnovations.fancyholograms.commands.HologramCMD;
+import com.fancyinnovations.fancyholograms.commands.Subcommand;
+import com.fancyinnovations.fancyholograms.main.FancyHologramsPlugin;
+import com.fancyinnovations.fancyholograms.util.NumberHelper;
+import de.oliver.fancylib.MessageHelper;
+import org.bukkit.command.CommandSender;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+public class OpacityCMD implements Subcommand {
+
+    @Override
+    public List<String> tabcompletion(@NotNull CommandSender player, @Nullable Hologram hologram, @NotNull String[] args) {
+        return null;
+    }
+
+    @Override
+    public boolean run(@NotNull CommandSender player, @Nullable Hologram hologram, @NotNull String[] args) {
+
+        if (!(player.hasPermission("fancyholograms.hologram.edit.opacity"))) {
+            MessageHelper.error(player, "You don't have the required permission to edit a hologram");
+            return false;
+        }
+
+        if (!(hologram.getData() instanceof TextHologramData textData)) {
+            MessageHelper.error(player, "This command can only be used on text holograms");
+            return false;
+        }
+
+        final var parsedNumber = NumberHelper.parseInt(args[3]);
+
+        if (parsedNumber.isEmpty()) {
+            MessageHelper.error(player, "Invalid opacity value.");
+            return false;
+        }
+
+        final int opacityPercentage = parsedNumber.get();
+
+        if (opacityPercentage < 0 || opacityPercentage > 100) {
+            MessageHelper.error(player, "Invalid opacity value, must be between 0 and 100");
+            return false;
+        }
+
+        // Convert percentage (0-100) to byte value (0-255)
+        final byte opacity = (byte) Math.round(opacityPercentage * 255.0 / 100.0);
+
+        if (opacity == textData.getTextOpacity()) {
+            MessageHelper.warning(player, "This hologram already has opacity set to " + opacityPercentage + "%");
+            return false;
+        }
+
+        final var copied = textData.copy(textData.getName());
+        copied.setTextOpacity(opacity);
+
+        if (!HologramCMD.callModificationEvent(hologram, player, copied, HologramUpdateEvent.HologramModification.TEXT_OPACITY)) {
+            return false;
+        }
+
+        if (opacity == textData.getTextOpacity()) {
+            MessageHelper.warning(player, "This hologram already has opacity set to " + opacityPercentage + "%");
+            return false;
+        }
+
+        textData.setTextOpacity(copied.getTextOpacity());
+
+        if (FancyHologramsPlugin.get().getHologramConfiguration().isSaveOnChangedEnabled()) {
+            FancyHologramsPlugin.get().getStorage().save(hologram.getData());
+        }
+
+        MessageHelper.success(player, "Changed text opacity to " + opacityPercentage + "%");
+        return true;
+    }
+}

plugins/fancyholograms/src/main/java/com/fancyinnovations/fancyholograms/hologram/HologramImpl.java

@@ -151,6 +151,7 @@ private void syncWithData() {
             textDisplay.setStyleFlags((byte) 0);
             textDisplay.setShadow(textData.hasTextShadow());
             textDisplay.setSeeThrough(textData.isSeeThrough());
+            textDisplay.setTextOpacity(textData.getTextOpacity());
 
             switch (textData.getTextAlignment()) {
                 case LEFT -> textDisplay.setAlignLeft(true);