Feat/npc module

common/src/main/java/com/pedrodalben/bigbangessentials/BigBangEssentials.java

@@ -219,6 +219,10 @@ private void registerAllManagers() {
             com.pedrodalben.bigbangessentials.holograms.service.BigBangHologramsManager.class,
             com.pedrodalben.bigbangessentials.holograms.service.BigBangHologramsManager::getInstance);
 
+        registry.registerManager("NpcManager", "npcs",
+            com.pedrodalben.bigbangessentials.npcs.service.NpcManager.class,
+            com.pedrodalben.bigbangessentials.npcs.service.NpcManager::getInstance);
+
         // RankUp Manager
         registry.registerManager("RankupManager", "rankup",
             com.pedrodalben.bigbangessentials.rankup.RankupManager.class);
@@ -240,6 +244,7 @@ private void registerModules() {
         modules.register("rankup", () -> com.pedrodalben.bigbangessentials.config.ConfigManager.isModuleEnabled("rankup"), "economy", "database");
         modules.register("crates", () -> com.pedrodalben.bigbangessentials.config.ConfigManager.isModuleEnabled("crates"), "database");
         modules.register("holograms", () -> com.pedrodalben.bigbangessentials.config.ConfigManager.isModuleEnabled("holograms"));
+        modules.register("npcs", () -> com.pedrodalben.bigbangessentials.config.ConfigManager.isModuleEnabled("npcs"), "holograms");
         modules.register("shop", () -> com.pedrodalben.bigbangessentials.config.ConfigManager.isModuleEnabled("shop"), "economy", "database");
         modules.register("adminshop", () -> com.pedrodalben.bigbangessentials.config.ConfigManager.isModuleEnabled("adminshop"), "economy", "database");
         modules.register("cobblemon", com.pedrodalben.bigbangessentials.pokemarket.PokeMarketManager::isCobblemonPresent);
@@ -439,6 +444,18 @@ public static void onServerStarting(net.minecraft.server.MinecraftServer server)
                 ModuleManager.getInstance().failed("holograms", e);
             }
 
+            if (ModuleManager.getInstance().prepare("npcs")) try {
+                LOGGER.info("⚙ Initializing NPC Module...");
+                com.pedrodalben.bigbangessentials.npcs.service.NpcManager.getInstance().initialize();
+                ManagerRegistry.getInstance().markInitialized("NpcManager");
+                ModuleManager.getInstance().started("npcs", 0);
+                LOGGER.info("✓ NPC Module initialized successfully");
+            } catch (Exception e) {
+                LOGGER.error("✗ NPC Module failed to initialize: {}", e.getMessage(), e);
+                ManagerRegistry.getInstance().markFailed("NpcManager", e.getMessage());
+                ModuleManager.getInstance().failed("npcs", e);
+            }
+
             // Initialize FakePlayerIntegration
             try {
                 LOGGER.info("⚙ Initializing FakePlayer Integration...");
@@ -640,6 +657,10 @@ public static void onPlayerLoggedIn(net.minecraft.server.level.ServerPlayer play
                     }
                 }
             }
+
+            if (ModuleManager.getInstance().isActive("npcs")) {
+                com.pedrodalben.bigbangessentials.npcs.service.NpcManager.getInstance().onPlayerJoin(player);
+            }
         }
 
         public static void onPlayerLoggedOut(net.minecraft.server.level.ServerPlayer player) {
@@ -654,6 +675,10 @@ public static void onPlayerLoggedOut(net.minecraft.server.level.ServerPlayer pla
             } catch (Exception e) {
                 LOGGER.debug("Failed to persist database-backed player state for {}: {}", player.getName().getString(), e.getMessage(), e);
             }
+
+            if (ModuleManager.getInstance().isActive("npcs")) {
+                com.pedrodalben.bigbangessentials.npcs.service.NpcManager.getInstance().onPlayerLeave(player);
+            }
         }
 
         public static void onServerStopping(net.minecraft.server.MinecraftServer server) {
@@ -783,6 +808,13 @@ public static void onServerStopping(net.minecraft.server.MinecraftServer server)
                 LOGGER.error("Failed to shutdown BigBangHolograms", e);
             }
 
+            if (ModuleManager.getInstance().isActive("npcs")) try {
+                LOGGER.info("Shutting down NPC Module...");
+                com.pedrodalben.bigbangessentials.npcs.service.NpcManager.getInstance().shutdown();
+            } catch (Exception e) {
+                LOGGER.error("Failed to shutdown NPC Module", e);
+            }
+
             // Shutdown FakeTpaManager
             try {
                 LOGGER.info("Shutting down Fake TPA Manager...");
@@ -1378,6 +1410,11 @@ private static void registerAllCommands(CommandDispatcher<CommandSourceStack> di
             com.pedrodalben.bigbangessentials.holograms.command.HologramCommand.register(dispatcher);
         }
 
+        if (ModuleManager.getInstance().isActive("npcs")) {
+            registry.registerCommand("npc", "Manage virtual NPCs", "npcs");
+            com.pedrodalben.bigbangessentials.npcs.command.NpcCommand.register(dispatcher);
+        }
+
         // ========== TABLIST MODULE ==========
         if (ModuleManager.getInstance().isActive("tablist")) {
             registry.registerCommand("tablist", "Manage tablist configuration, reload, debug");

common/src/main/java/com/pedrodalben/bigbangessentials/npcs/api/BigBangNpcs.java

@@ -0,0 +1,11 @@
+package com.pedrodalben.bigbangessentials.npcs.api;
+
+import com.pedrodalben.bigbangessentials.npcs.service.NpcManager;
+
+public final class BigBangNpcs {
+    private BigBangNpcs() {}
+
+    public static NpcService getApi() {
+        return NpcManager.getInstance();
+    }
+}

common/src/main/java/com/pedrodalben/bigbangessentials/npcs/api/NpcAction.java

@@ -0,0 +1,46 @@
+package com.pedrodalben.bigbangessentials.npcs.api;
+
+import java.util.Objects;
+
+public final class NpcAction {
+    private final NpcActionType type;
+    private final String command;
+
+    public NpcAction(NpcActionType type, String command) {
+        this.type = type != null ? type : NpcActionType.NONE;
+        this.command = command != null ? command.trim() : "";
+    }
+
+    public static NpcAction none() {
+        return new NpcAction(NpcActionType.NONE, "");
+    }
+
+    public static NpcAction playerCommand(String command) {
+        return new NpcAction(NpcActionType.PLAYER_COMMAND, stripSlash(command));
+    }
+
+    public static NpcAction consoleCommand(String command) {
+        return new NpcAction(NpcActionType.CONSOLE_COMMAND, stripSlash(command));
+    }
+
+    private static String stripSlash(String cmd) {
+        if (cmd == null) return "";
+        String trimmed = cmd.trim();
+        return trimmed.startsWith("/") ? trimmed.substring(1).trim() : trimmed;
+    }
+
+    public NpcActionType type() { return type; }
+    public String command() { return command; }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof NpcAction that)) return false;
+        return type == that.type && command.equals(that.command);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(type, command);
+    }
+}

common/src/main/java/com/pedrodalben/bigbangessentials/npcs/api/NpcActionType.java

@@ -0,0 +1,7 @@
+package com.pedrodalben.bigbangessentials.npcs.api;
+
+public enum NpcActionType {
+    NONE,
+    PLAYER_COMMAND,
+    CONSOLE_COMMAND
+}

common/src/main/java/com/pedrodalben/bigbangessentials/npcs/api/NpcDefinition.java

@@ -0,0 +1,105 @@
+package com.pedrodalben.bigbangessentials.npcs.api;
+
+import java.util.Objects;
+import java.util.regex.Pattern;
+
+public final class NpcDefinition {
+    private static final Pattern VALID_ID = Pattern.compile("^[a-z0-9_-]{1,64}$");
+
+    private final String id;
+    private final boolean enabled;
+    private final String displayName;
+    private final NpcLocation location;
+    private final NpcSkin skin;
+    private final NpcAction action;
+    private final NpcHologramConfig hologram;
+    private final NpcLookSettings lookSettings;
+    private final double viewDistance;
+    private final double despawnDistance;
+    private final NpcInteractionConfig interaction;
+
+    public NpcDefinition(String id, boolean enabled, String displayName, NpcLocation location,
+                         NpcSkin skin, NpcAction action, NpcHologramConfig hologram,
+                         NpcLookSettings lookSettings, double viewDistance, double despawnDistance,
+                         NpcInteractionConfig interaction) {
+        this.id = normalizeId(id);
+        this.enabled = enabled;
+        this.displayName = displayName != null ? displayName : id;
+        this.location = Objects.requireNonNull(location, "location");
+        this.skin = Objects.requireNonNull(skin, "skin");
+        this.action = action != null ? action : NpcAction.none();
+        this.hologram = hologram != null ? hologram : NpcHologramConfig.disabled();
+        this.lookSettings = lookSettings != null ? lookSettings : NpcLookSettings.disabled();
+        this.viewDistance = Math.max(1.0, viewDistance);
+        this.despawnDistance = Math.max(viewDistance, despawnDistance);
+        this.interaction = interaction != null ? interaction : NpcInteractionConfig.defaults();
+    }
+
+    public static String normalizeId(String id) {
+        if (id == null) throw new IllegalArgumentException("NPC id cannot be null");
+        String normalized = id.trim().toLowerCase();
+        if (!VALID_ID.matcher(normalized).matches()) {
+            throw new IllegalArgumentException("Invalid NPC id: '" + id + "'. Must match [a-z0-9_-]{1,64}");
+        }
+        return normalized;
+    }
+
+    public String id() { return id; }
+    public boolean enabled() { return enabled; }
+    public String displayName() { return displayName; }
+    public NpcLocation location() { return location; }
+    public NpcSkin skin() { return skin; }
+    public NpcAction action() { return action; }
+    public NpcHologramConfig hologram() { return hologram; }
+    public NpcLookSettings lookSettings() { return lookSettings; }
+    public double viewDistance() { return viewDistance; }
+    public double despawnDistance() { return despawnDistance; }
+    public NpcInteractionConfig interaction() { return interaction; }
+
+    public NpcDefinition withEnabled(boolean enabled) {
+        return new NpcDefinition(id, enabled, displayName, location, skin, action, hologram,
+            lookSettings, viewDistance, despawnDistance, interaction);
+    }
+
+    public NpcDefinition withLocation(NpcLocation newLocation) {
+        return new NpcDefinition(id, enabled, displayName, newLocation, skin, action, hologram,
+            lookSettings, viewDistance, despawnDistance, interaction);
+    }
+
+    public NpcDefinition withSkin(NpcSkin newSkin) {
+        return new NpcDefinition(id, enabled, displayName, location, newSkin, action, hologram,
+            lookSettings, viewDistance, despawnDistance, interaction);
+    }
+
+    public NpcDefinition withAction(NpcAction newAction) {
+        return new NpcDefinition(id, enabled, displayName, location, skin, newAction, hologram,
+            lookSettings, viewDistance, despawnDistance, interaction);
+    }
+
+    public NpcDefinition withDisplayName(String newDisplayName) {
+        return new NpcDefinition(id, enabled, newDisplayName, location, skin, action, hologram,
+            lookSettings, viewDistance, despawnDistance, interaction);
+    }
+
+    public NpcDefinition withHologram(NpcHologramConfig newHologram) {
+        return new NpcDefinition(id, enabled, displayName, location, skin, action, newHologram,
+            lookSettings, viewDistance, despawnDistance, interaction);
+    }
+
+    public NpcDefinition withLookSettings(NpcLookSettings newLook) {
+        return new NpcDefinition(id, enabled, displayName, location, skin, action, hologram,
+            newLook, viewDistance, despawnDistance, interaction);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof NpcDefinition that)) return false;
+        return id.equals(that.id);
+    }
+
+    @Override
+    public int hashCode() {
+        return id.hashCode();
+    }
+}

common/src/main/java/com/pedrodalben/bigbangessentials/npcs/api/NpcHologramConfig.java

@@ -0,0 +1,46 @@
+package com.pedrodalben.bigbangessentials.npcs.api;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+public final class NpcHologramConfig {
+    private final boolean enabled;
+    private final List<String> lines;
+    private final double offsetY;
+    private final double viewDistance;
+    private final boolean shadow;
+    private final boolean seeThrough;
+
+    public NpcHologramConfig(boolean enabled, List<String> lines, double offsetY, double viewDistance, boolean shadow, boolean seeThrough) {
+        this.enabled = enabled;
+        this.lines = Collections.unmodifiableList(new ArrayList<>(lines != null ? lines : List.of()));
+        this.offsetY = Math.max(0.0, offsetY);
+        this.viewDistance = Math.max(1.0, viewDistance);
+        this.shadow = shadow;
+        this.seeThrough = seeThrough;
+    }
+
+    public static NpcHologramConfig defaults(String displayName) {
+        return new NpcHologramConfig(true, List.of(displayName), 2.25, 32.0, true, false);
+    }
+
+    public static NpcHologramConfig disabled() {
+        return new NpcHologramConfig(false, List.of(), 2.25, 32.0, true, false);
+    }
+
+    public boolean enabled() { return enabled; }
+    public List<String> lines() { return lines; }
+    public double offsetY() { return offsetY; }
+    public double viewDistance() { return viewDistance; }
+    public boolean shadow() { return shadow; }
+    public boolean seeThrough() { return seeThrough; }
+
+    public NpcHologramConfig withEnabled(boolean enabled) {
+        return new NpcHologramConfig(enabled, lines, offsetY, viewDistance, shadow, seeThrough);
+    }
+
+    public NpcHologramConfig withLines(List<String> lines) {
+        return new NpcHologramConfig(enabled, lines, offsetY, viewDistance, shadow, seeThrough);
+    }
+}

common/src/main/java/com/pedrodalben/bigbangessentials/npcs/api/NpcInteractionConfig.java

@@ -0,0 +1,22 @@
+package com.pedrodalben.bigbangessentials.npcs.api;
+
+public final class NpcInteractionConfig {
+    private final double distance;
+    private final long cooldownMillis;
+    private final String permission;
+
+    public NpcInteractionConfig(double distance, long cooldownMillis, String permission) {
+        this.distance = Math.max(0.5, distance);
+        this.cooldownMillis = Math.max(0, cooldownMillis);
+        this.permission = permission != null ? permission.trim() : "";
+    }
+
+    public static NpcInteractionConfig defaults() {
+        return new NpcInteractionConfig(4.5, 750, "");
+    }
+
+    public double distance() { return distance; }
+    public long cooldownMillis() { return cooldownMillis; }
+    public String permission() { return permission; }
+    public boolean hasPermission() { return !permission.isEmpty(); }
+}

common/src/main/java/com/pedrodalben/bigbangessentials/npcs/api/NpcLocation.java

@@ -0,0 +1,47 @@
+package com.pedrodalben.bigbangessentials.npcs.api;
+
+import net.minecraft.resources.ResourceLocation;
+import java.util.Objects;
+
+public final class NpcLocation {
+    private final ResourceLocation dimension;
+    private final double x;
+    private final double y;
+    private final double z;
+    private final float yaw;
+    private final float pitch;
+
+    public NpcLocation(ResourceLocation dimension, double x, double y, double z, float yaw, float pitch) {
+        this.dimension = Objects.requireNonNull(dimension, "dimension");
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        this.yaw = yaw;
+        this.pitch = pitch;
+    }
+
+    public ResourceLocation dimension() { return dimension; }
+    public double x() { return x; }
+    public double y() { return y; }
+    public double z() { return z; }
+    public float yaw() { return yaw; }
+    public float pitch() { return pitch; }
+
+    public NpcLocation withYawPitch(float yaw, float pitch) {
+        return new NpcLocation(dimension, x, y, z, yaw, pitch);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof NpcLocation that)) return false;
+        return Double.compare(that.x, x) == 0 && Double.compare(that.y, y) == 0
+            && Double.compare(that.z, z) == 0 && Float.compare(that.yaw, yaw) == 0
+            && Float.compare(that.pitch, pitch) == 0 && dimension.equals(that.dimension);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(dimension, x, y, z, yaw, pitch);
+    }
+}