Initial setup for easter plugin

.idea/gradle.xml

@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
+  <component name="GradleMigrationSettings" migrationVersion="1" />
   <component name="GradleSettings">
     <option name="linkedExternalProjectsSettings">
       <GradleProjectSettings>

build.gradle.kts

@@ -2,6 +2,7 @@ plugins {
     id("java")
     id("maven-publish")
     id("com.github.ben-manes.versions") version "0.52.0"
+    id("com.github.johnrengelman.shadow") version "8.1.1"
 }
 
 group = "com.alttd.easter"
@@ -29,6 +30,14 @@ tasks {
         archiveFileName.set("${rootProject.name}.jar")
     }
 
+    named<com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar>("shadowJar") {
+        archiveFileName.set("${rootProject.name}.jar")
+        mergeServiceFiles()
+    }
+    build {
+        dependsOn("shadowJar")
+    }
+
     processResources {
         filteringCharset = Charsets.UTF_8.name()
         duplicatesStrategy = DuplicatesStrategy.INCLUDE
@@ -43,6 +52,10 @@ dependencies {
         isChanging = true
     }
 
+    implementation("com.alttd.inventory_gui:InventoryGUI:1.1.5-20260201.231743-1") {
+        isChanging = true
+    }
+
     implementation("org.slf4j:slf4j-api:2.0.17")
 
     compileOnly("org.projectlombok:lombok:1.18.38")

src/main/java/com/alttd/easter/Easter.java

@@ -3,22 +3,39 @@ package com.alttd.easter;
 import com.alttd.easter.commands.Command;
 import com.alttd.easter.config.Config;
 import com.alttd.easter.config.Messages;
+import com.alttd.easter.data.DataManager;
+import com.alttd.easter.glow.GlowManager;
+import com.alttd.easter.listeners.DeathListener;
+import com.alttd.easter.listeners.SpawnListener;
+import com.alttd.easter.npc.RabbitNpcManager;
+import com.alttd.easter.gui.TurnInGuiManager;
 import org.bukkit.plugin.PluginManager;
 import org.bukkit.plugin.java.JavaPlugin;
 
 public final class Easter extends JavaPlugin {
 
+    private DataManager dataManager;
+    private RabbitNpcManager rabbitNpcManager;
+    private GlowManager glowManager;
+    private TurnInGuiManager turnInGuiManager;
+
     @Override
     public void onEnable() {
+        reloadConfigs();
+        this.dataManager = new DataManager(this);
+        this.glowManager = new GlowManager(this);
+        this.turnInGuiManager = new TurnInGuiManager(dataManager);
+        this.rabbitNpcManager = new RabbitNpcManager(this, turnInGuiManager);
         registerCommands();
         registerEvents();
-        reloadConfigs();
         registerSchedulers();
     }
 
     @Override
     public void onDisable() {
-        //TODO save data
+        if (dataManager != null) {
+            dataManager.save();
+        }
     }
 
     private void registerCommands() {
@@ -27,16 +44,19 @@ public final class Easter extends JavaPlugin {
 
     private void registerEvents() {
         PluginManager pluginManager = getServer().getPluginManager();
-
-        //TODO register events
+        pluginManager.registerEvents(new SpawnListener(glowManager), this);
+        pluginManager.registerEvents(new DeathListener(), this);
+        pluginManager.registerEvents(rabbitNpcManager, this);
+        pluginManager.registerEvents(turnInGuiManager, this);
     }
 
     public void reloadConfigs() {
         Config.reload();
         Messages.reload();
+        if (rabbitNpcManager != null) rabbitNpcManager.reload();
     }
 
     private void registerSchedulers() {
-        //TODO register schedulers
+        // No schedulers required currently
     }
 }

src/main/java/com/alttd/easter/commands/Command.java

@@ -34,7 +34,8 @@ public class Command implements CommandExecutor, TabExecutor {
         command.setAliases(List.of("pu"));
 
         subCommands = List.of(
-                new Reload(easter)
+                new Reload(easter),
+                new SetPrize()
         );
     }
 

src/main/java/com/alttd/easter/commands/SubCommand.java

@@ -13,7 +13,7 @@ public abstract class SubCommand {
     public abstract String getName();
 
     public String getPermission() {
-        return "playerutils." + getName();
+        return "easter." + getName();
     }
 
     public abstract List<String> getTabComplete(CommandSender commandSender, String[] args);

src/main/java/com/alttd/easter/commands/subcommands/SetPrize.java

@@ -0,0 +1,44 @@
+package com.alttd.easter.commands.subcommands;
+
+import com.alttd.easter.commands.SubCommand;
+import com.alttd.easter.config.Config;
+import com.alttd.easter.config.Messages;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+
+import java.util.List;
+
+public class SetPrize extends SubCommand {
+
+    @Override
+    public boolean onCommand(CommandSender commandSender, String[] args) {
+        if (!(commandSender instanceof Player player)) {
+            commandSender.sendRichMessage(Messages.GENERIC.PLAYER_ONLY);
+            return true;
+        }
+        ItemStack item = player.getInventory().getItemInMainHand();
+        if (item.getType().isAir()) {
+            player.sendRichMessage(Messages.SETPRIZE.EMPTY_HAND);
+            return true;
+        }
+        Config.PRIZES.addPrize(item.clone());
+        player.sendRichMessage(Messages.SETPRIZE.SUCCESS);
+        return true;
+    }
+
+    @Override
+    public String getName() {
+        return "setprize";
+    }
+
+    @Override
+    public List<String> getTabComplete(CommandSender commandSender, String[] args) {
+        return List.of();
+    }
+
+    @Override
+    public String getHelpMessage() {
+        return Messages.HELP.SET_PRIZE;
+    }
+}

src/main/java/com/alttd/easter/config/Config.java

@@ -1,11 +1,13 @@
 package com.alttd.easter.config;
 
 import lombok.extern.slf4j.Slf4j;
-import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.Location;
+import org.bukkit.World;
+import org.bukkit.inventory.ItemStack;
 
 import java.io.File;
-import java.util.HashMap;
-import java.util.Set;
+import java.util.ArrayList;
+import java.util.List;
 
 @Slf4j public class Config extends AbstractConfig{
 
@@ -26,15 +28,66 @@ import java.util.Set;
         config.readConfig(Config.class, null);
     }
 
-    public static class SETTINGS {
-        private static final String prefix = "settings.";
-        public static boolean DEBUG = false;
-        public static boolean WARNINGS = true;
+    public static class EGGS {
+        private static final String prefix = "eggs.";
+        public static double SPAWN_CHANCE = 0.02; // ~2 per night per player
 
         @SuppressWarnings("unused")
         private static void load() {
-            DEBUG = config.getBoolean(prefix, "debug", DEBUG);
-            WARNINGS = config.getBoolean(prefix, "warnings", WARNINGS);
+            SPAWN_CHANCE = config.getDouble(prefix, "spawn-chance", SPAWN_CHANCE);
+        }
+    }
+
+    public static class RABBIT {
+        private static final String prefix = "rabbit.";
+        public static String WORLD = "world";
+        public static double X = 0, Y = 64, Z = 0;
+        public static float YAW = 0, PITCH = 0;
+        public static double INTERACT_RADIUS = 2.5;
+
+        @SuppressWarnings("unused")
+        private static void load() {
+            WORLD = config.getString(prefix, "world", WORLD);
+            X = config.getDouble(prefix, "x", X);
+            Y = config.getDouble(prefix, "y", Y);
+            Z = config.getDouble(prefix, "z", Z);
+            YAW = (float) config.getDouble(prefix, "yaw", YAW);
+            PITCH = (float) config.getDouble(prefix, "pitch", PITCH);
+            INTERACT_RADIUS = config.getDouble(prefix, "interact-radius", INTERACT_RADIUS);
+        }
+
+        public static Location getLocation(org.bukkit.Server server) {
+            World world = server.getWorld(WORLD);
+            if (world == null) return null;
+            return new Location(world, X, Y, Z, YAW, PITCH);
+        }
+    }
+
+    public static class PRIZES {
+        private static final String prefix = "prizes.";
+        public static List<ItemStack> LIST = new ArrayList<>();
+
+        @SuppressWarnings("unused")
+        private static void load() {
+            List<?> raw = config.yaml.getList(prefix + "list");
+            LIST = new ArrayList<>();
+            if (raw != null) {
+                for (Object o : raw) {
+                    if (o instanceof ItemStack item) LIST.add(item);
+                }
+            }
+            // ensure path exists
+            config.yaml.addDefault(prefix + "list", LIST);
+        }
+
+        public static void addPrize(ItemStack item) {
+            LIST.add(item);
+            config.set(prefix, "list", LIST);
+        }
+
+        public static ItemStack getRandomPrize() {
+            if (LIST.isEmpty()) return null;
+            return LIST.get((int) (Math.random() * LIST.size())).clone();
         }
     }
 }

src/main/java/com/alttd/easter/config/Messages.java

@@ -1,7 +1,6 @@
 package com.alttd.easter.config;
 
 import java.io.File;
-import java.util.List;
 
 public class Messages extends AbstractConfig {
     static Messages config;
@@ -26,12 +25,14 @@ public class Messages extends AbstractConfig {
         public static String HELP_MESSAGE_WRAPPER = "<gold>Easter help:\n<commands></gold>";
         public static String HELP_MESSAGE = "<green>Show this menu: <gold>/pu help</gold></green>";
         public static String RELOAD = "<green>Reload the configs for Easter: <gold>/pu reload</gold></green>";
+        public static String SET_PRIZE = "<green>Add the item in your hand as a prize: <gold>/pu setprize</gold></green>";
 
         @SuppressWarnings("unused")
         private static void load() {
             HELP_MESSAGE_WRAPPER = config.getString(prefix, "help-wrapper", HELP_MESSAGE_WRAPPER);
             HELP_MESSAGE = config.getString(prefix, "help", HELP_MESSAGE);
             RELOAD = config.getString(prefix, "reload", RELOAD);
+            SET_PRIZE = config.getString(prefix, "set-prize", SET_PRIZE);
         }
     }
 
@@ -46,7 +47,7 @@ public class Messages extends AbstractConfig {
         private static void load() {
             NO_PERMISSION = config.getString(prefix, "no-permission", NO_PERMISSION);
             PLAYER_ONLY = config.getString(prefix, "player-only", PLAYER_ONLY);
-            PLAYER_NOT_FOUND = config.getString(prefix, "player-only", PLAYER_NOT_FOUND);
+            PLAYER_NOT_FOUND = config.getString(prefix, "player-not-found", PLAYER_NOT_FOUND);
         }
     }
 
@@ -60,4 +61,38 @@ public class Messages extends AbstractConfig {
             RELOADED = config.getString(prefix, "reloaded", RELOADED);
         }
     }
+
+    public static class RABBIT {
+        private static final String prefix = "rabbit.";
+        public static String LEFT_CLICK_INTRO = "<green>Hi <player>. A bunch of different mobs have stolen my easter eggs! Can you find them and kill them for me? If you bring the eggs back I will reward you!</green>";
+        public static String NO_EGGS = "<yellow>Please come back when you've found some eggs!</yellow>";
+        public static String THANK_YOU = "<green>Thank you for finding my eggs <player>! Keep looking for more!</green>";
+        public static String ONE_EGG = "<green>Thank you for finding my eggs <player>! I have received the <egg1> from you. Please keep looking for more!</green>";
+        public static String MULTI_EGGS = "<green>Thank you for finding my eggs <player>! I have received the <egg1>, <egg2>, and <egg3> from you. Please keep looking for more!</green>";
+        public static String REWARD = "<green>Thank you! You've turned in 4 unique eggs and earned a prize!</green>";
+        public static String DUPLICATE_EGGS = "<yellow>Those are duplicates I already have. Bring me new colors!</yellow>";
+        public static String GUI_TITLE = "<gold>Turn in Eggs</gold>";
+
+        @SuppressWarnings("unused")
+        private static void load() {
+            LEFT_CLICK_INTRO = config.getString(prefix, "left-click-intro", LEFT_CLICK_INTRO);
+            NO_EGGS = config.getString(prefix, "no-eggs", NO_EGGS);
+            THANK_YOU = config.getString(prefix, "thank-you", THANK_YOU);
+            REWARD = config.getString(prefix, "reward", REWARD);
+            DUPLICATE_EGGS = config.getString(prefix, "duplicate-eggs", DUPLICATE_EGGS);
+            GUI_TITLE = config.getString(prefix, "gui-title", GUI_TITLE);
+        }
+    }
+
+    public static class SETPRIZE {
+        private static final String prefix = "setprize.";
+        public static String SUCCESS = "<green>Added the item in your hand as a possible prize.</green>";
+        public static String EMPTY_HAND = "<red>You must hold an item to set it as a prize.</red>";
+
+        @SuppressWarnings("unused")
+        private static void load() {
+            SUCCESS = config.getString(prefix, "success", SUCCESS);
+            EMPTY_HAND = config.getString(prefix, "empty-hand", EMPTY_HAND);
+        }
+    }
 }

src/main/java/com/alttd/easter/data/DataManager.java

@@ -0,0 +1,57 @@
+package com.alttd.easter.data;
+
+import com.alttd.easter.egg.EggType;
+import org.bukkit.configuration.file.YamlConfiguration;
+
+import java.io.File;
+import java.io.IOException;
+import java.util.*;
+import java.util.stream.Collectors;
+
+public class DataManager {
+
+    private final File file;
+    private final YamlConfiguration yaml;
+    private final Map<UUID, Set<EggType>> playerEggs = new HashMap<>();
+
+    public DataManager(org.bukkit.plugin.Plugin plugin) {
+        this.file = new File(plugin.getDataFolder(), "data.yml");
+        this.yaml = new YamlConfiguration();
+        if (file.exists()) {
+            try { yaml.load(file); } catch (Exception ignored) {}
+        }
+        load();
+    }
+
+    private void load() {
+        for (String key : yaml.getKeys(false)) {
+            try {
+                UUID uuid = UUID.fromString(key);
+                List<String> list = yaml.getStringList(key);
+                Set<EggType> types = list.stream().map(s -> {
+                    try { return EggType.valueOf(s); } catch (Exception e) { return null; }
+                }).filter(Objects::nonNull).collect(Collectors.toSet());
+                playerEggs.put(uuid, types);
+            } catch (IllegalArgumentException ignored) {}
+        }
+    }
+
+    public void save() {
+        for (Map.Entry<UUID, Set<EggType>> e : playerEggs.entrySet()) {
+            List<String> list = e.getValue().stream().map(Enum::name).toList();
+            yaml.set(e.getKey().toString(), list);
+        }
+        try { yaml.save(file); } catch (IOException ignored) {}
+    }
+
+    public Set<EggType> getPlayerEggs(UUID uuid) {
+        return playerEggs.computeIfAbsent(uuid, u -> new HashSet<>());
+    }
+
+    public int addEggs(UUID uuid, Collection<EggType> newTypes) {
+        Set<EggType> set = getPlayerEggs(uuid);
+        int before = set.size();
+        set.addAll(newTypes);
+        return set.size() - before; // number of newly added uniques
+    }
+}

src/main/java/com/alttd/easter/egg/EggType.java

@@ -0,0 +1,47 @@
+package com.alttd.easter.egg;
+
+import lombok.Getter;
+import org.bukkit.Material;
+import org.bukkit.enchantments.Enchantment;
+import org.bukkit.entity.EntityType;
+
+public enum EggType {
+    BROWN_HUSK(Material.BROWN_GLAZED_TERRACOTTA, EntityType.HUSK, Enchantment.FIRE_PROTECTION, 2),
+    RED_SPIDER(Material.RED_GLAZED_TERRACOTTA, EntityType.SPIDER, Enchantment.BANE_OF_ARTHROPODS, 2),
+    ORANGE_BLAZE(Material.ORANGE_GLAZED_TERRACOTTA, EntityType.BLAZE, Enchantment.FIRE_ASPECT, 2),
+    YELLOW_PIGLIN(Material.YELLOW_GLAZED_TERRACOTTA, EntityType.PIGLIN, Enchantment.FORTUNE, 2),
+    LIME_CREEPER(Material.LIME_GLAZED_TERRACOTTA, EntityType.CREEPER, Enchantment.BLAST_PROTECTION, 2),
+    GREEN_ZOMBIE(Material.GREEN_GLAZED_TERRACOTTA, EntityType.ZOMBIE, Enchantment.FEATHER_FALLING, 2),
+    LIGHT_BLUE_STRAY(Material.LIGHT_BLUE_GLAZED_TERRACOTTA, EntityType.STRAY, Enchantment.FROST_WALKER, 2),
+    CYAN_GUARDIAN(Material.CYAN_GLAZED_TERRACOTTA, EntityType.GUARDIAN, Enchantment.THORNS, 2),
+    BLUE_WARDEN(Material.BLUE_GLAZED_TERRACOTTA, EntityType.WARDEN, Enchantment.SWIFT_SNEAK, 2),
+    PURPLE_ENDER_DRAGON(Material.PURPLE_GLAZED_TERRACOTTA, EntityType.ENDER_DRAGON, Enchantment.POWER, 2),
+    MAGENTA_ENDERMAN(Material.MAGENTA_GLAZED_TERRACOTTA, EntityType.ENDERMAN, Enchantment.INFINITY, 2),
+    PINK_HOGLIN(Material.PINK_GLAZED_TERRACOTTA, EntityType.HOGLIN, Enchantment.PIERCING, 2),
+    WHITE_SKELETON(Material.WHITE_GLAZED_TERRACOTTA, EntityType.SKELETON, Enchantment.MULTISHOT, 2),
+    LIGHT_GRAY_SILVERFISH(Material.LIGHT_GRAY_GLAZED_TERRACOTTA, EntityType.SILVERFISH, Enchantment.EFFICIENCY, 2),
+    GRAY_WITHER(Material.GRAY_GLAZED_TERRACOTTA, EntityType.WITHER, Enchantment.SMITE, 2),
+    BLACK_WITHER_SKELETON(Material.BLACK_GLAZED_TERRACOTTA, EntityType.WITHER_SKELETON, Enchantment.LOOTING, 2);
+
+    @Getter
+    private final Material material;
+    private final EntityType entityType;
+    @Getter
+    private final Enchantment enchantment;
+    @Getter
+    private final int enchantLevel;
+
+    EggType(Material material, EntityType entityType, Enchantment enchantment, int enchantLevel) {
+        this.material = material;
+        this.entityType = entityType;
+        this.enchantment = enchantment;
+        this.enchantLevel = enchantLevel;
+    }
+
+    public static EggType fromEntityType(EntityType entityType) {
+        for (EggType type : values()) {
+            if (type.entityType == entityType) return type;
+        }
+        return null;
+    }
+}

src/main/java/com/alttd/easter/glow/GlowManager.java

@@ -0,0 +1,52 @@
+package com.alttd.easter.glow;
+
+import com.alttd.easter.egg.EggType;
+import org.bukkit.Bukkit;
+import org.bukkit.ChatColor;
+import org.bukkit.entity.Entity;
+import org.bukkit.scoreboard.Scoreboard;
+import org.bukkit.scoreboard.Team;
+
+public class GlowManager {
+
+    private final Scoreboard scoreboard;
+
+    public GlowManager(org.bukkit.plugin.Plugin plugin) {
+        this.scoreboard = Bukkit.getScoreboardManager().getMainScoreboard();
+    }
+
+    public void applyGlow(Entity entity, EggType type) {
+        String teamName = ("easter_" + type.name()).toLowerCase();
+        Team team = scoreboard.getTeam(teamName);
+        if (team == null) {
+            team = scoreboard.registerNewTeam(teamName);
+            team.setCanSeeFriendlyInvisibles(false);
+            team.setAllowFriendlyFire(true);
+            team.setColor(colorFor(type));
+        }
+        String entry = entity.getUniqueId().toString();
+        if (!team.hasEntry(entry)) team.addEntry(entry);
+    }
+
+    private ChatColor colorFor(EggType type) {
+        switch (type) {
+            case BROWN_HUSK: return ChatColor.DARK_RED; // closest
+            case RED_SPIDER: return ChatColor.RED;
+            case ORANGE_BLAZE: return ChatColor.GOLD;
+            case YELLOW_PIGLIN: return ChatColor.YELLOW;
+            case LIME_CREEPER: return ChatColor.GREEN;
+            case GREEN_ZOMBIE: return ChatColor.DARK_GREEN;
+            case LIGHT_BLUE_STRAY: return ChatColor.AQUA;
+            case CYAN_GUARDIAN: return ChatColor.DARK_AQUA;
+            case BLUE_WARDEN: return ChatColor.BLUE;
+            case PURPLE_ENDER_DRAGON: return ChatColor.DARK_PURPLE;
+            case MAGENTA_ENDERMAN: return ChatColor.LIGHT_PURPLE;
+            case PINK_HOGLIN: return ChatColor.LIGHT_PURPLE;
+            case WHITE_SKELETON: return ChatColor.WHITE;
+            case LIGHT_GRAY_SILVERFISH: return ChatColor.GRAY;
+            case GRAY_WITHER: return ChatColor.DARK_GRAY;
+            case BLACK_WITHER_SKELETON: return ChatColor.BLACK;
+            default: return ChatColor.WHITE;
+        }
+    }
+}

src/main/java/com/alttd/easter/gui/TurnInGuiManager.java

@@ -0,0 +1,114 @@
+package com.alttd.easter.gui;
+
+import com.alttd.easter.config.Messages;
+import com.alttd.easter.data.DataManager;
+import com.alttd.easter.egg.EggType;
+import com.alttd.easter.util.ItemUtils;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.inventory.InventoryClickEvent;
+import org.bukkit.event.inventory.InventoryCloseEvent;
+import org.bukkit.inventory.Inventory;
+import org.bukkit.inventory.ItemStack;
+
+import java.util.*;
+
+public class TurnInGuiManager implements Listener {
+
+    private final DataManager dataManager;
+    private final Map<UUID, Inventory> openInventories = new HashMap<>();
+
+    public TurnInGuiManager(DataManager dataManager) {
+        this.dataManager = dataManager;
+    }
+
+    private String title() {
+        // crude strip of minimessage tags for inventory title
+        String mm = Messages.RABBIT.GUI_TITLE;
+        String plain = mm.replaceAll("<[^>]+>", "");
+        if (plain.isBlank()) plain = "Turn in Eggs";
+        return plain;
+    }
+
+    public void open(Player player) {
+        Inventory inv = Bukkit.createInventory(player, 27, title());
+        openInventories.put(player.getUniqueId(), inv);
+        player.openInventory(inv);
+    }
+
+    @EventHandler
+    public void onClick(InventoryClickEvent event) {
+        if (!(event.getWhoClicked() instanceof Player player)) return;
+        Inventory top = openInventories.get(player.getUniqueId());
+        if (top == null) return;
+        if (!event.getView().getTopInventory().equals(top)) return;
+
+        // If clicking in player inventory with shift-click, prevent moving non-egg items into GUI
+        if (event.isShiftClick() && event.getClickedInventory() != null && event.getClickedInventory().equals(player.getInventory())) {
+            ItemStack stack = event.getCurrentItem();
+            if (stack != null && !stack.getType().isAir() && !ItemUtils.isEggItem(stack)) {
+                event.setCancelled(true);
+                return;
+            }
+        }
+
+        // If placing an item into the GUI (cursor over top inventory), only allow egg items
+        boolean inTop = event.getRawSlot() < top.getSize() && event.getRawSlot() >= 0;
+        if (inTop) {
+            ItemStack cursor = event.getCursor();
+            if (!cursor.getType().isAir() && !ItemUtils.isEggItem(cursor)) {
+                event.setCancelled(true);
+            }
+        }
+    }
+
+    @EventHandler
+    public void onClose(InventoryCloseEvent event) {
+        Player player = (Player) event.getPlayer();
+        Inventory top = openInventories.remove(player.getUniqueId());
+        if (top == null) return;
+        if (!event.getInventory().equals(top)) return;
+        // collect egg items and clear them from the GUI so they don't drop
+        Set<EggType> submitted = new HashSet<>();
+        for (ItemStack item : top.getContents()) {
+            if (ItemUtils.isEggItem(item)) {
+                EggType type = ItemUtils.getEggType(item);
+                if (type != null) submitted.add(type);
+            }
+        }
+        top.clear();
+        if (submitted.isEmpty()) {
+            player.sendRichMessage(Messages.RABBIT.NO_EGGS);
+            return;
+        }
+        int before = dataManager.getPlayerEggs(player.getUniqueId()).size();
+        int added = dataManager.addEggs(player.getUniqueId(), submitted);
+        dataManager.save();
+        // Dialog formatting for submission summary
+        List<String> colors = submitted.stream().map(ItemUtils::colorName).toList();
+        if (colors.size() == 1) {
+            player.sendRichMessage(Messages.RABBIT.ONE_EGG,
+                    net.kyori.adventure.text.minimessage.tag.resolver.Placeholder.parsed("player", player.getName()),
+                    net.kyori.adventure.text.minimessage.tag.resolver.Placeholder.parsed("egg1", colors.getFirst())
+            );
+        } else {
+            String c1 = !colors.isEmpty() ? colors.get(0) : "";
+            String c2 = colors.size() > 1 ? colors.get(1) : "";
+            String c3 = colors.size() > 2 ? colors.get(2) : "";
+            player.sendRichMessage(Messages.RABBIT.MULTI_EGGS,
+                    net.kyori.adventure.text.minimessage.tag.resolver.Placeholder.parsed("player", player.getName()),
+                    net.kyori.adventure.text.minimessage.tag.resolver.Placeholder.parsed("egg1", c1),
+                    net.kyori.adventure.text.minimessage.tag.resolver.Placeholder.parsed("egg2", c2),
+                    net.kyori.adventure.text.minimessage.tag.resolver.Placeholder.parsed("egg3", c3)
+            );
+        }
+        int total = dataManager.getPlayerEggs(player.getUniqueId()).size();
+        if (total % 4 == 0) {
+            var prize = com.alttd.easter.config.Config.PRIZES.getRandomPrize();
+            if (prize != null) player.getInventory().addItem(prize);
+            player.sendRichMessage(Messages.RABBIT.REWARD);
+        }
+    }
+}

src/main/java/com/alttd/easter/listeners/DeathListener.java

@@ -0,0 +1,30 @@
+package com.alttd.easter.listeners;
+
+import com.alttd.easter.egg.EggType;
+import com.alttd.easter.util.ItemUtils;
+import com.alttd.easter.util.Keys;
+import org.bukkit.entity.LivingEntity;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.entity.EntityDeathEvent;
+import org.bukkit.persistence.PersistentDataType;
+
+public class DeathListener implements Listener {
+
+    @EventHandler
+    public void onDeath(EntityDeathEvent event) {
+        LivingEntity entity = event.getEntity();
+        String eggName = entity.getPersistentDataContainer().get(Keys.EGG_ENTITY, PersistentDataType.STRING);
+        if (eggName == null) {
+            return;
+        }
+        EggType type;
+        try {
+            type = EggType.valueOf(eggName);
+        } catch (IllegalArgumentException ex) {
+            return;
+        }
+        // Ensure the egg drops
+        event.getDrops().add(ItemUtils.createEggItem(type));
+    }
+}

src/main/java/com/alttd/easter/listeners/SpawnListener.java

@@ -0,0 +1,46 @@
+package com.alttd.easter.listeners;
+
+import com.alttd.easter.config.Config;
+import com.alttd.easter.egg.EggType;
+import com.alttd.easter.glow.GlowManager;
+import com.alttd.easter.util.ItemUtils;
+import com.alttd.easter.util.Keys;
+import org.bukkit.entity.Creature;
+import org.bukkit.entity.EntityType;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.entity.CreatureSpawnEvent;
+import org.bukkit.inventory.EntityEquipment;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.persistence.PersistentDataType;
+
+import java.util.concurrent.ThreadLocalRandom;
+
+public class SpawnListener implements Listener {
+
+    private final GlowManager glowManager;
+
+    public SpawnListener(GlowManager glowManager) {
+        this.glowManager = glowManager;
+    }
+
+    @EventHandler
+    public void onNaturalSpawn(CreatureSpawnEvent event) {
+        if (event.getSpawnReason() != CreatureSpawnEvent.SpawnReason.NATURAL) return;
+        if (!(event.getEntity() instanceof Creature creature)) return;
+        EntityType type = event.getEntityType();
+        EggType eggType = EggType.fromEntityType(type);
+        if (eggType == null) return;
+        double chance = Config.EGGS.SPAWN_CHANCE;
+        if (ThreadLocalRandom.current().nextDouble() >= chance) return;
+
+        ItemStack eggItem = ItemUtils.createEggItem(eggType);
+        EntityEquipment equipment = creature.getEquipment();
+        equipment.setHelmet(eggItem);
+        equipment.setHelmetDropChance(1.0f);
+        // tag entity so we know it's an egg carrier
+        creature.getPersistentDataContainer().set(Keys.EGG_ENTITY, PersistentDataType.STRING, eggType.name());
+        creature.setGlowing(true);
+        glowManager.applyGlow(creature, eggType);
+    }
+}

src/main/java/com/alttd/easter/npc/RabbitNpcManager.java

@@ -0,0 +1,81 @@
+package com.alttd.easter.npc;
+
+import com.alttd.easter.config.Config;
+import com.alttd.easter.config.Messages;
+import com.alttd.easter.gui.TurnInGuiManager;
+import com.alttd.easter.util.Keys;
+import net.kyori.adventure.text.minimessage.tag.resolver.Placeholder;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.EntityType;
+import org.bukkit.entity.Player;
+import org.bukkit.entity.Rabbit;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.entity.EntityDamageByEntityEvent;
+import org.bukkit.event.player.PlayerInteractAtEntityEvent;
+import org.bukkit.persistence.PersistentDataType;
+import org.bukkit.plugin.Plugin;
+
+import java.util.*;
+
+@SuppressWarnings("ClassCanBeRecord")
+public class RabbitNpcManager implements Listener {
+
+    private final org.bukkit.plugin.Plugin plugin;
+    private final com.alttd.easter.gui.TurnInGuiManager turnInGuiManager;
+
+    public RabbitNpcManager(Plugin plugin, TurnInGuiManager turnInGuiManager) {
+        this.plugin = plugin;
+        this.turnInGuiManager = turnInGuiManager;
+        spawnOrFindRabbit();
+    }
+
+    public void reload() {
+        spawnOrFindRabbit();
+    }
+
+    private void spawnOrFindRabbit() {
+        // Find existing rabbit with tag, else spawn new at config location
+        UUID rabbitId;
+        for (org.bukkit.World world : Bukkit.getWorlds()) {
+            for (org.bukkit.entity.Entity e : world.getEntitiesByClass(Rabbit.class)) {
+                if (e.getPersistentDataContainer().has(Keys.RABBIT_NPC, PersistentDataType.BYTE)) {
+                    rabbitId = e.getUniqueId();
+                    return;
+                }
+            }
+        }
+        var loc = Config.RABBIT.getLocation(plugin.getServer());
+        if (loc == null) return;
+        Rabbit rabbit = (Rabbit) loc.getWorld().spawnEntity(loc, EntityType.RABBIT);
+        rabbit.setCustomNameVisible(true);
+        rabbit.customName(net.kyori.adventure.text.Component.text("Easter Bunny"));
+        rabbit.getPersistentDataContainer().set(Keys.RABBIT_NPC, PersistentDataType.BYTE, (byte)1);
+        rabbitId = rabbit.getUniqueId();
+    }
+
+    @EventHandler
+    public void onInteract(PlayerInteractAtEntityEvent event) {
+        if (!(event.getRightClicked() instanceof Rabbit) && !(event.getRightClicked() instanceof org.bukkit.entity.LivingEntity le && le.getPersistentDataContainer().has(Keys.RABBIT_NPC, PersistentDataType.BYTE))) return;
+        event.setCancelled(true);
+        Player player = event.getPlayer();
+        // Right click -> open GUI
+        openTurnIn(player);
+    }
+
+    @EventHandler
+    public void onLeftClick(EntityDamageByEntityEvent event) {
+        if (!(event.getEntity() instanceof org.bukkit.entity.LivingEntity le)) return;
+        if (!le.getPersistentDataContainer().has(Keys.RABBIT_NPC, PersistentDataType.BYTE)) return;
+        if (!(event.getDamager() instanceof Player player)) return;
+        event.setCancelled(true);
+        player.sendRichMessage(Messages.RABBIT.LEFT_CLICK_INTRO,
+                Placeholder.parsed("player", player.getName())
+        );
+    }
+
+    private void openTurnIn(Player player) {
+        // Delegate to TurnInGuiManager which controls the inventory and submission flow
+        turnInGuiManager.open(player);
+    }
+}

src/main/java/com/alttd/easter/util/ItemUtils.java

@@ -0,0 +1,75 @@
+package com.alttd.easter.util;
+
+import com.alttd.easter.egg.EggType;
+import org.bukkit.ChatColor;
+import org.bukkit.inventory.ItemFlag;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.ItemMeta;
+import org.bukkit.persistence.PersistentDataType;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public final class ItemUtils {
+
+    public static String colorName(EggType type) {
+        return switch (type) {
+            case BROWN_HUSK -> "Brown";
+            case RED_SPIDER -> "Red";
+            case ORANGE_BLAZE -> "Orange";
+            case YELLOW_PIGLIN -> "Yellow";
+            case LIME_CREEPER -> "Lime";
+            case GREEN_ZOMBIE -> "Green";
+            case LIGHT_BLUE_STRAY -> "Light Blue";
+            case CYAN_GUARDIAN -> "Cyan";
+            case BLUE_WARDEN -> "Blue";
+            case PURPLE_ENDER_DRAGON -> "Purple";
+            case MAGENTA_ENDERMAN -> "Magenta";
+            case PINK_HOGLIN -> "Pink";
+            case WHITE_SKELETON -> "White";
+            case LIGHT_GRAY_SILVERFISH -> "Light Grey";
+            case GRAY_WITHER -> "Grey";
+            case BLACK_WITHER_SKELETON -> "Black";
+        };
+    }
+
+    public static ItemStack createEggItem(EggType type) {
+        ItemStack item = new ItemStack(type.getMaterial());
+        ItemMeta meta = item.getItemMeta();
+        meta.addEnchant(type.getEnchantment(), type.getEnchantLevel(), true);
+        meta.addItemFlags(ItemFlag.HIDE_ENCHANTS);
+        meta.setDisplayName(ChatColor.GOLD + "Easter Egg - " + prettify(type.name()));
+        meta.getPersistentDataContainer().set(Keys.EGG_ITEM, PersistentDataType.STRING, type.name());
+        item.setItemMeta(meta);
+        return item;
+    }
+
+    public static boolean isEggItem(ItemStack item) {
+        if (item == null) return false;
+        ItemMeta meta = item.getItemMeta();
+        if (meta == null) return false;
+        return meta.getPersistentDataContainer().has(Keys.EGG_ITEM, PersistentDataType.STRING);
+    }
+
+    public static EggType getEggType(ItemStack item) {
+        if (!isEggItem(item)) return null;
+        String name = item.getItemMeta().getPersistentDataContainer().get(Keys.EGG_ITEM, PersistentDataType.STRING);
+        try {
+            return name == null ? null : EggType.valueOf(name);
+        } catch (IllegalArgumentException ex) {
+            return null;
+        }
+    }
+
+    public static String prettify(String name) {
+        String[] parts = name.toLowerCase().split("_");
+        List<String> out = new ArrayList<>();
+        for (String p : parts) {
+            if (p.isEmpty()) continue;
+            out.add(Character.toUpperCase(p.charAt(0)) + p.substring(1));
+        }
+        return String.join(" ", out);
+    }
+
+    private ItemUtils() {}
+}

src/main/java/com/alttd/easter/util/Keys.java

@@ -0,0 +1,12 @@
+package com.alttd.easter.util;
+
+import com.alttd.easter.Easter;
+import org.bukkit.NamespacedKey;
+
+public final class Keys {
+    public static final NamespacedKey EGG_ITEM = new NamespacedKey(Easter.getPlugin(Easter.class), "egg-item");
+    public static final NamespacedKey EGG_ENTITY = new NamespacedKey(Easter.getPlugin(Easter.class), "egg-entity");
+    public static final NamespacedKey RABBIT_NPC = new NamespacedKey(Easter.getPlugin(Easter.class), "rabbit-npc");
+
+    private Keys() {}
+}

src/main/resources/plugin.yml

@@ -0,0 +1,19 @@
+name: Easter
+main: com.alttd.easter.Easter
+version: ${version}
+description: Altitude's Easter plugin
+api-version: '1.21'
+author: Altitude
+commands:
+  easter:
+    description: Easter main command
+    usage: /<command>
+    aliases: [easter]
+    permission: playerutils.use
+permissions:
+  easter.reload:
+    description: Reload the Easter plugin
+    default: op
+  easter.setprize:
+    description: Set the held item as a prize
+    default: op