- * The default state is {@code false}.
- *
- * @return {@code true} if the NPC is editable, {@code false} otherwise
- */
- public boolean isEditable()
- {
- return getOption(NpcOption.EDITABLE);
- }
-
- /**
- * Sets whether this NPC can be edited through the {@code NpcPlugin}.
- *
- * By default, an NPC is not editable ({@code false}).
- *
- * @param editable {@code true} if the NPC should be editable, {@code false} otherwise
- */
- public void setEditable(boolean editable)
- {
- setOption(NpcOption.EDITABLE, editable);
- }
-
- /**
- * Sets a specific option for this NPC.
- *
- * @param option the {@link NpcOption} to set. Must not be null.
- * @param value the value for the option. If {@code null}, the option will be removed (reverting to default).
- * @param the type of the option's value.
- */
- public void setOption(@NotNull NpcOption option, @Nullable T value)
- {
- if(value == null)
- options.remove(option);
- else
- options.put(option, value);
-
- if(NpcApi.config.autoUpdate())
- {
- viewers.forEach(uuid ->
- {
- Player player = Bukkit.getPlayer(uuid);
- if(player == null)
- return;
-
- option.getPacket(value, this, player).ifPresent(packetWrapper ->
- ((CraftPlayer) player).getHandle().connection.send((Packet) packetWrapper));
- });
- }
- }
-
- /**
- * Gets the value of a specific option for this NPC.
- * If the option has not been explicitly set, its default value will be returned.
- *
- * @param option the {@link NpcOption} to get. Must not be null.
- * @param the type of the option's value.
- * @return the value of the option. Will not be null (guaranteed by NpcOption default values).
- */
- @SuppressWarnings("unchecked")
- public @NotNull T getOption(@NotNull NpcOption option)
- {
- return (T) options.getOrDefault(option, option.getDefaultValue());
- }
-
- /**
- * Plays an animation for this NPC, visible to the specified player.
- *
- * @param player the player who will see the animation. Must not be null.
- * @param animation the {@link AnimatePacket.Animation} to play. Must not be null.
- */
- public void playAnimation(@NotNull Player player, @NotNull AnimatePacket.Animation animation)
- {
- ((CraftPlayer) player).getHandle().connection.send((Packet) AnimatePacket.create(serverPlayer, animation));
- }
-
- /**
- * Reloads the NPC for all current viewers.
- * This typically involves hiding and then re-showing the NPC to apply any changes.
- */
- public void reload()
- {
- final List viewers = new ArrayList<>(this.viewers);
- hideNpcFromAllPlayers();
- TeamManager.clear(getGameProfileName());
- viewers.stream().filter(uuid -> Bukkit.getPlayer(uuid) != null).forEach(uuid -> showNPCToPlayer(Bukkit.getPlayer(uuid)));
- }
-
- /**
- * Gets the current location of the NPC.
- *
- * @return the {@link Location} of the NPC. Will not be null.
- */
- public @NotNull Location getLocation()
- {
- return location;
- }
-
- /**
- * Sets the location of the NPC.
- * This will also update the underlying server player's position.
- *
- * @param location the new {@link Location} for the NPC. Must not be null.
- */
- public void setLocation(@NotNull Location location)
- {
- this.location = location;
- Var.moveEntity(serverPlayer, location.getX(), location.getY(), location.getZ(), location.getYaw(), location.getPitch());
- }
-
- /**
- * Gets the unique identifier (UUID) of this NPC.
- *
- * @return the {@link UUID} of the NPC. Will not be null.
- */
- public @NotNull UUID getUUID()
- {
- return serverPlayer.getUUID();
- }
-
- /**
- * Gets the display name of this NPC.
- *
- * @return the {@link Component} representing the NPC's name. Will not be null.
- */
- public @NotNull Component getName()
- {
- return name;
- }
-
- public @NotNull String getGameProfileName()
- {
- if(Versions.isCurrentVersionSmallerThan(Versions.V1_21_9))
- return (String) Reflections.invokeMethod(serverPlayer.getGameProfile(), "getName").get();
- return serverPlayer.getGameProfile().name();
- }
-
- /**
- * Sets the display name of this NPC.
- * This also updates the name for the underlying server player and its list name.
- *
- * @param name the new {@link Component} name for the NPC. Must not be null.
- */
- public void setName(@NotNull Component name)
- {
- this.name = name;
- serverPlayer.listName = CraftChatMessage.fromJSON(JSONComponentSerializer.json().serialize(name));
-
- viewers.stream().filter(uuid -> Bukkit.getPlayer(uuid) != null).forEach(
- uuid -> ((CraftPlayer) Bukkit.getPlayer(uuid)).getHandle().connection.send(
- ((Packet) SetEntityDataPacket.create(((Display.TextDisplay) nameTag.getDisplay()).getId(),
- (SynchedEntityData) nameTag.applyData(
- isEnabled() ? name : NpcApi.DISABLED_MESSAGE_PROVIDER.apply(Bukkit.getPlayer(uuid))
- .appendNewline().append(name))))));
- }
-
- /**
- * Gets the timestamp when this NPC was created.
- *
- * @return the {@link Instant} of creation. Will not be null.
- */
- public Instant getCreatedAt()
- {
- return createdAt;
- }
-
- /**
- * Makes the NPC visible to all currently online players.
- * This respects the NPC's enabled state and player permissions.
- */
- public void showNpcToAllPlayers()
- {
- Bukkit.getOnlinePlayers().forEach(this::showNPCToPlayer);
- }
-
- /**
- * Makes the NPC visible to a specific player.
- * If the NPC is disabled and the player is not an operator, the NPC will not be shown.
- * This method handles sending all necessary packets to display the NPC correctly.
- *
- * @param player the player to show the NPC to. Must not be null.
- */
- public void showNPCToPlayer(@NotNull Player player)
- {
- if(!getOption(NpcOption.ENABLED) && !player.isOp())
- return;
-
- if(!player.getWorld().getName().equals(serverPlayer.getBukkitEntity().getWorld().getName()))
- {
- hideNpcFromPlayer(player);
- return;
- }
-
- if(!viewers.contains(player.getUniqueId()))
- viewers.add(player.getUniqueId());
-
- List> packets = new ArrayList<>();
-
- Arrays.stream(NpcOption.values()).filter(NpcOption::loadBefore)
- .forEach(npcOption -> npcOption.getPacket(getOption(npcOption), this, player).ifPresent(o -> packets.add((Packet) o)));
-
- packets.add(ClientboundPlayerInfoUpdatePacket.createSinglePlayerInitializing(serverPlayer, true));
- packets.add(serverPlayer.getAddEntityPacket(Var.getServerEntity(serverPlayer, Var.getServerLevel(serverPlayer))));
-
- boolean modified = TeamManager.exists(player, getGameProfileName());
- PlayerTeam wrappedPlayerTeam = (PlayerTeam) TeamManager.create(player, getGameProfileName());
- wrappedPlayerTeam.setNameTagVisibility(Team.Visibility.NEVER);
-
- packets.add((Packet) SetPlayerTeamPacket.createAddOrModifyPacket(wrappedPlayerTeam, !modified));
- packets.add((Packet) SetPlayerTeamPacket.createPlayerPacket(wrappedPlayerTeam, getGameProfileName(),
- ClientboundSetPlayerTeamPacket.Action.ADD));
-
- packets.add(new ClientboundRotateHeadPacket(serverPlayer, (byte) ((location.getYaw() % 360) * 256 / 360)));
- packets.add(new ClientboundMoveEntityPacket.Rot(serverPlayer.getId(), (byte) location.getYaw(), (byte) location.getPitch(),
- serverPlayer.onGround));
-
- if(!getOption(NpcOption.HIDE_NAMETAG))
- {
- packets.add(((Display.TextDisplay) nameTag.getDisplay()).getAddEntityPacket(
- Var.getServerEntity((Display.TextDisplay) nameTag.getDisplay(), Var.getServerLevel(serverPlayer))));
-
- packets.add((Packet) SetEntityDataPacket.create(((Display.TextDisplay) nameTag.getDisplay()).getId(),
- (SynchedEntityData) nameTag.applyData(isEnabled() ? name : NpcApi.DISABLED_MESSAGE_PROVIDER.apply(player)
- .appendNewline().append(name))));
-
- packets.add(new ClientboundSetPassengersPacket(serverPlayer));
- }
-
- Arrays.stream(NpcOption.values()).filter(npcOption -> !npcOption.equals(NpcOption.ENABLED))
- .forEach(npcOption -> npcOption.getPacket(getOption(npcOption), this, player).map(o -> (Packet) o)
- .ifPresent(packets::add));
-
- NpcOption.ENABLED.getPacket(isEnabled(), this, player).map(o -> (Packet) o).ifPresent(packets::add);
-
- ServerGamePacketListenerImpl connection = ((CraftPlayer) player).getHandle().connection;
- packets.forEach(connection::send);
- }
-
- /**
- * Hides the NPC from all currently online players.
- */
- public void hideNpcFromAllPlayers()
- {
- Bukkit.getOnlinePlayers().forEach(this::hideNpcFromPlayer);
- }
-
- /**
- * Hides the NPC from a specific player.
- * This method sends packets to remove the NPC and its associated entities from the player's view.
- *
- * @param player the player to hide the NPC from. Must not be null.
- */
- public void hideNpcFromPlayer(@NotNull Player player)
- {
- ServerGamePacketListenerImpl connection = ((CraftPlayer) player).getHandle().connection;
- connection.send(new ClientboundRemoveEntitiesPacket(serverPlayer.getId(), ((Display.TextDisplay) nameTag.getDisplay()).getId()));
-
- if(TeamManager.exists(player, getGameProfileName()))
- {
- PlayerTeam team = (PlayerTeam) TeamManager.create(player, getGameProfileName());
- connection.send((Packet) SetPlayerTeamPacket.createPlayerPacket(team, getGameProfileName(),
- ClientboundSetPlayerTeamPacket.Action.REMOVE));
- connection.send((Packet) SetPlayerTeamPacket.createRemovePacket(team));
- }
-
- connection.send(new ClientboundPlayerInfoRemovePacket(List.of(getUUID())));
-
- viewers.remove(player.getUniqueId());
- }
-
- /**
- * Deletes the NPC.
- * This hides the NPC from all players, removes it from the NPC manager, and deletes its saved data file.
- */
- public void delete() throws IOException
- {
- if(serverPlayer == null)
- return;
-
- hideNpcFromAllPlayers();
- NpcManager.removeNPC(this);
-
- serverPlayer.remove(Entity.RemovalReason.DISCARDED);
- serverPlayer = null;
-
- npcPath.toFile().getParentFile().mkdirs();
- Files.deleteIfExists(npcPath);
- }
-
- /**
- * Makes the NPC look at a specific player.
- * This calculates the required yaw and pitch and sends update packets to the viewing player.
- *
- * @param viewer the player the NPC should look at. Must not be null.
- */
- public void lookAtPlayer(@NotNull Player viewer)
- {
- Location npcLoc = serverPlayer.getBukkitEntity().getLocation();
- Location playerLoc = viewer.getLocation();
-
- if(npcLoc.getWorld() != playerLoc.getWorld())
- return;
-
- double dx = playerLoc.getX() - npcLoc.getX();
- double dy = ((playerLoc.getY() + viewer.getEyeHeight())) -
- ((npcLoc.getY() + serverPlayer.getBukkitEntity().getEyeHeight() * getOption(NpcOption.SCALE)));
- double dz = playerLoc.getZ() - npcLoc.getZ();
-
- double distanceXZ = Math.sqrt(dx * dx + dz * dz);
- float yaw = (float) Math.toDegrees(Math.atan2(-dx, dz));
- float pitch = (float) Math.toDegrees(-Math.atan2(dy, distanceXZ));
-
- byte yawByte = (byte) (yaw * 256 / 360);
- byte pitchByte = (byte) (pitch * 256 / 360);
-
- ServerGamePacketListenerImpl connection = ((CraftPlayer) viewer).getHandle().connection;
-
- connection.send(new ClientboundRotateHeadPacket(serverPlayer, yawByte));
- connection.send(new ClientboundMoveEntityPacket.Rot(serverPlayer.getId(), yawByte, pitchByte, serverPlayer.onGround()));
- }
-
- /**
- * Moves the NPC along a precomputed {@link de.eisi05.npc.api.pathfinding.Path}, simulating walking, jumping, and gravity.
- * The NPC's position and rotation are updated each tick and sent to the specified player(s).
- *
- * @param path The {@link de.eisi05.npc.api.pathfinding.Path} containing the ordered waypoints the NPC should follow.
- * @param player The player who should see the NPC move. If null, updates all viewers in the `viewers` set.
- * @param walkSpeed The walking speed of the NPC (clamped between 0.1 and 1).
- * @param changeRealLocation If true, the NPC's actual server-side location will be updated; otherwise only packets are sent.
- * @param onEnd A {@link Runnable} to be executed when the NPC reaches the end of the path.
- * @return The {@link BukkitTask} representing the movement task.
- */
- public @NotNull BukkitTask walkTo(@NotNull de.eisi05.npc.api.pathfinding.Path path, @Nullable Player player, double walkSpeed,
- boolean changeRealLocation, @Nullable Consumer onEnd)
- {
- final double speed = Math.max(Math.min(walkSpeed, 1), 0.1);
-
- final double gravity = -0.08;
- final double jumpVelocity = 0.5;
- final double terminal = -0.5;
- final double stepHeight = 0.6;
-
- return new BukkitRunnable()
- {
- final List pathPoints = path.asLocations();
- int index = 0;
- org.bukkit.util.Vector current = location.toVector();
- double yVel = 0.0;
- float previousYaw = location.getYaw();
- org.bukkit.util.Vector previousMovement = location.getDirection();
-
- @Override
- public void run()
- {
- if(index >= pathPoints.size())
- {
- if(!path.getWaypoints().isEmpty())
- {
- Location last = path.getWaypoints().getLast();
-
- org.bukkit.util.Vector lastVector = last.toVector();
- org.bukkit.util.Vector lastMovement = lastVector.clone().subtract(current);
-
- ClientboundRotateHeadPacket rotateHeadPacket = new ClientboundRotateHeadPacket(serverPlayer,
- (byte) (last.getYaw() * 256 / 360));
- ClientboundTeleportEntityPacket teleportEntityPacket = new ClientboundTeleportEntityPacket(serverPlayer.getId(),
- new PositionMoveRotation(new Vec3(lastVector.toVector3f()), new Vec3(lastMovement.toVector3f()), last.getYaw(),
- last.getPitch()), Set.of(), true);
-
- sendNpcMovePackets(player, teleportEntityPacket, rotateHeadPacket);
- }
-
- if(changeRealLocation)
- {
- setLocation(path.getWaypoints().isEmpty() ? pathPoints.getLast() : path.getWaypoints().getLast());
- if(player != null)
- {
- for(UUID uuid : viewers)
- {
- OfflinePlayer offlinePlayer = Bukkit.getOfflinePlayer(uuid);
- if(!offlinePlayer.isOnline() || uuid.equals(player.getUniqueId()))
- continue;
-
- hideNpcFromPlayer(offlinePlayer.getPlayer());
- showNPCToPlayer(offlinePlayer.getPlayer());
- }
- }
- }
-
- if(onEnd != null)
- onEnd.accept(Result.SUCCESS);
-
- cancel();
- return;
- }
-
- org.bukkit.util.Vector target = pathPoints.get(index).toVector();
- org.bukkit.util.Vector toTarget = target.clone().subtract(current);
-
- if(toTarget.lengthSquared() < 0.04 && Math.abs(toTarget.getY()) < 0.2)
- {
- index++;
- return;
- }
-
- org.bukkit.util.Vector horizontal = new org.bukkit.util.Vector(toTarget.getX(), 0, toTarget.getZ());
- org.bukkit.util.Vector horizontalMove =
- (horizontal.lengthSquared() > 1e-6) ? horizontal.clone().normalize().multiply(speed) : new org.bukkit.util.Vector(0, 0, 0);
-
- double nextDist = target.clone().subtract(current.clone().add(horizontalMove)).lengthSquared();
- if(nextDist > toTarget.lengthSquared())
- {
- current = target;
- index++;
- return;
- }
-
- World world = location.getWorld();
- int bx = (int) Math.floor(current.getX());
- int bz = (int) Math.floor(current.getZ());
- int searchStart = (int) Math.floor(current.getY());
- int groundBlockY = Integer.MIN_VALUE;
-
- for(int y = searchStart; y >= searchStart - 3; y--)
- {
- Block block = world.getBlockAt(bx, y - 1, bz);
- if(block.getType().isSolid() && !block.getType().isAir() && !block.isPassable())
- {
- groundBlockY = y - 1;
- break;
- }
- }
- if(groundBlockY == Integer.MIN_VALUE)
- groundBlockY = world.getHighestBlockYAt(bx, bz) - 1;
- double groundY = groundBlockY + 1.0;
- boolean onGround = current.getY() <= groundY + 1e-5;
-
- if(onGround)
- {
- if(toTarget.getY() > 0 && toTarget.getY() <= stepHeight && horizontal.lengthSquared() > 1e-6)
- {
- current = current.clone().add(new org.bukkit.util.Vector(0, Math.min(toTarget.getY(), stepHeight), 0));
- yVel = 0;
- onGround = true;
- }
- else if(toTarget.getY() > 0.5)
- {
- yVel = jumpVelocity;
- onGround = false;
- }
- else
- {
- yVel = 0;
- current = new org.bukkit.util.Vector(current.getX(), groundY, current.getZ());
- }
- }
-
- double yDelta = 0;
- if(!onGround)
- {
- yVel += gravity;
- if(yVel < terminal)
- yVel = terminal;
- yDelta = yVel;
-
- if(current.getY() + yDelta <= groundY)
- {
- yDelta = groundY - current.getY();
- yVel = 0;
- onGround = true;
- }
- }
-
- org.bukkit.util.Vector movement = new org.bukkit.util.Vector(horizontalMove.getX(), yDelta, horizontalMove.getZ());
- current = current.clone().add(movement);
-
- org.bukkit.util.Vector lookDir;
- if(index + 1 < pathPoints.size())
- {
- org.bukkit.util.Vector currentTarget = pathPoints.get(index).toVector().clone();
- org.bukkit.util.Vector nextTarget = pathPoints.get(index + 1).toVector().clone();
-
- lookDir = currentTarget.clone().add(nextTarget).multiply(0.5).subtract(current);
- }
- else
- lookDir = pathPoints.get(index).toVector().clone().subtract(current);
-
- org.bukkit.util.Vector horizontalVec = new org.bukkit.util.Vector(lookDir.getX(), 0, lookDir.getZ());
- if(horizontalVec.lengthSquared() < 1e-6)
- horizontalVec = previousMovement.clone();
-
- float targetYaw = (float) (Math.atan2(horizontalVec.getZ(), horizontalVec.getX()) * 180 / Math.PI - 90);
-
- while(targetYaw > 180)
- targetYaw -= 360;
- while(targetYaw < -180)
- targetYaw += 360;
-
- float diff = targetYaw - previousYaw;
- if(diff > 180)
- diff -= 360;
- if(diff < -180)
- diff += 360;
-
- float maxTurn = 15f;
- diff = Math.max(-maxTurn, Math.min(maxTurn, diff));
-
- float yaw = previousYaw + diff;
- previousYaw = yaw;
-
- previousMovement = horizontalVec.clone();
-
- org.bukkit.util.Vector targetVec = pathPoints.get(Math.min(index + 1, pathPoints.size() - 1)).toVector().clone().subtract(current);
- double horizontalLen = Math.sqrt(targetVec.getX() * targetVec.getX() + targetVec.getZ() * targetVec.getZ());
- float pitch = (float) (-Math.atan2(targetVec.getY(), horizontalLen) * 180 / Math.PI) / 1.5f;
-
- ClientboundRotateHeadPacket rotateHeadPacket = new ClientboundRotateHeadPacket(serverPlayer, (byte) (yaw * 256 / 360));
- ClientboundTeleportEntityPacket teleportEntityPacket = new ClientboundTeleportEntityPacket(serverPlayer.getId(),
- new PositionMoveRotation(new Vec3(current.toVector3f()), new Vec3(movement.toVector3f()), yaw, pitch), Set.of(), onGround);
-
- sendNpcMovePackets(player, teleportEntityPacket, rotateHeadPacket);
- }
-
- @Override
- public synchronized void cancel() throws IllegalStateException
- {
- super.cancel();
- if(onEnd != null)
- onEnd.accept(Result.CANCELLED);
- }
- }.runTaskTimer(NpcApi.plugin, 1L, 1L);
- }
-
- /**
- * Sends NPC movement and rotation packets to a specific player or all viewers.
- *
- * @param player The player to send packets to. If null, packets are sent to all viewers.
- * @param teleportEntityPacket The packet containing the NPC's teleport/move data. Must not be null.
- * @param rotateHeadPacket The packet containing the NPC's head rotation data. Must not be null.
- */
- private void sendNpcMovePackets(@Nullable Player player, @NotNull ClientboundTeleportEntityPacket teleportEntityPacket,
- @NotNull ClientboundRotateHeadPacket rotateHeadPacket)
- {
- if(player != null)
- {
- ServerPlayer serverPlayer1 = ((CraftPlayer) player).getHandle();
- serverPlayer1.connection.send(teleportEntityPacket);
- serverPlayer1.connection.send(rotateHeadPacket);
- }
- else
- {
- for(UUID uuid : viewers)
- {
- OfflinePlayer offlinePlayer = Bukkit.getOfflinePlayer(uuid);
- if(!offlinePlayer.isOnline())
- continue;
-
- ServerPlayer serverPlayer1 = ((CraftPlayer) offlinePlayer.getPlayer()).getHandle();
- serverPlayer1.connection.send(teleportEntityPacket);
- serverPlayer1.connection.send(rotateHeadPacket);
- }
- }
- }
-
- void changeUUID(@NotNull UUID newUUID)
- {
- try
- {
- Files.deleteIfExists(npcPath);
- npcPath = NpcApi.plugin.getDataFolder().toPath().resolve("NPC").resolve(newUUID + ".npc");
- save();
- } catch(Exception e)
- {
- throw new RuntimeException(e);
- }
- }
-
- public CustomNameTag getNameTag()
- {
- return nameTag;
- }
-
- /**
- * A serializable representation of an NPC, used for saving and loading NPC data.
- * This record stores all essential properties of an NPC that need to be persisted.
- *
- * @param world The UUID of the world where the NPC is located.
- * @param x The x-coordinate of the NPC's location.
- * @param y The y-coordinate of the NPC's location.
- * @param z The z-coordinate of the NPC's location.
- * @param yaw The yaw (horizontal rotation) of the NPC.
- * @param pitch The pitch (vertical rotation) of the NPC.
- * @param id The unique identifier (UUID) of the NPC.
- * @param name The serialized representation of the NPC's display name.
- * @param options A map of NPC options, where keys are option paths (strings) and values are serializable option values.
- * @param clickEvent The click action associated with the NPC. Can be null.
- * @param createdAt The timestamp when the NPC was originally created.
- */
- public record SerializedNPC(@NotNull UUID world, double x, double y, double z, float yaw, float pitch, @NotNull UUID id,
- @NotNull String name, @NotNull Map options,
- @Nullable NpcClickAction clickEvent, @NotNull Instant createdAt) implements Serializable
- {
- @Serial
- private static final long serialVersionUID = 1L;
-
- /**
- * Creates a {@link SerializedNPC} instance from an existing {@link NPC} object.
- *
- * @param npc The NPC to serialize. Must not be null.
- * @return A new {@link SerializedNPC} instance representing the given NPC. Will not be null.
- */
- public static @NotNull SerializedNPC serializedNPC(@NotNull NPC npc)
- {
- Map options = new HashMap<>();
- npc.options.forEach((key, value) -> options.put(key.getPath(), Var.unsafeCast(key.serialize(npc.getOption(key)))));
-
- return new SerializedNPC(npc.getLocation().getWorld().getUID(), npc.getLocation().getX(), npc.getLocation().getY(),
- npc.getLocation().getZ(), npc.getLocation().getYaw(), npc.getLocation().getPitch(), npc.getUUID(),
- JSONComponentSerializer.json().serialize(npc.getName()), options, npc.clickEvent, npc.createdAt);
- }
-
- /**
- * Deserializes this {@link SerializedNPC} object back into a fully functional {@link NPC} instance.
- *
- * @param The type of the NpcOption value.
- * @param The serializable type of the NpcOption value.
- * @return A new {@link NPC} instance reconstructed from the serialized data. Will not be null.
- */
- @SuppressWarnings("unchecked")
- public @NotNull NPC deserializedNPC()
- {
- NPC npc = new NPC(new Location(Bukkit.getWorld(world), x, y, z, yaw, pitch), id,
- JSONComponentSerializer.json().deserialize(name)).setClickEvent(
- clickEvent == null ? clickEvent : clickEvent.initialize());
- options.forEach((string, serializable) -> NpcOption.getOption(string)
- .ifPresent(npcOption -> npc.setOption((NpcOption) npcOption, (T) npcOption.deserialize(Var.unsafeCast(serializable)))));
- npc.createdAt = createdAt == null ? Instant.now() : createdAt;
- return npc;
- }
- }
-}
diff --git a/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcConfig.java b/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcConfig.java
deleted file mode 100644
index 2444fca..0000000
--- a/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcConfig.java
+++ /dev/null
@@ -1,150 +0,0 @@
-package de.eisi05.npc.api.objects;
-
-import org.jetbrains.annotations.NotNull;
-
-/**
- * Configuration settings for NPC behavior.
- * This class allows for customizing various aspects of an NPC, such as interaction timers.
- */
-public class NpcConfig
-{
- /**
- * The time in ticks an NPC will look at a player after interaction.
- * The default value is 5 ticks.
- */
- private long lookAtTimer = 5;
-
- /**
- * If true, command validation will be skipped.
- * Useful for allowing proxy commands like BungeeCord.
- */
- private boolean avoidCommandCheck = false;
-
- /**
- * If true, debug mode is enabled.
- * Can be used for logging or diagnostic purposes.
- */
- private boolean debug = false;
-
- /**
- * Time allowed for input, measured in seconds.
- * Default is 60 seconds.
- */
- private int inputTime = 60;
-
- /**
- * If true, NPCs are automatically updated when changed.
- */
- private boolean autoUpdate = false;
-
- /**
- * Sets the duration an NPC will look at a player after an interaction.
- *
- * @param time The time in ticks. For example, 20 ticks = 1 second.
- * @return This {@link NpcConfig} instance for method chaining. Will not be null.
- */
- public @NotNull NpcConfig lookAtTimer(long time)
- {
- lookAtTimer = time;
- return this;
- }
-
- /**
- * Sets whether to skip command validation.
- * Useful for allowing BungeeCord or proxy commands.
- *
- * @param avoidCommandCheck True to skip command checks, false to validate.
- * @return This {@link NpcConfig} instance for method chaining. Never null.
- */
- public @NotNull NpcConfig avoidCommandCheck(boolean avoidCommandCheck)
- {
- this.avoidCommandCheck = avoidCommandCheck;
- return this;
- }
-
- /**
- * Enables or disables debug mode.
- *
- * @param debug True to enable debug mode, false to disable it.
- * @return This {@link NpcConfig} instance for method chaining. Never null.
- */
- public @NotNull NpcConfig debug(boolean debug)
- {
- this.debug = debug;
- return this;
- }
-
- /**
- * Sets the input time limit.
- *
- * @param inputTime The time in seconds.
- * @return This {@link NpcConfig} instance for method chaining. Never null.
- */
- public @NotNull NpcConfig inputTime(int inputTime)
- {
- this.inputTime = inputTime;
- return this;
- }
-
- /**
- * Sets whether automatic updates should be enabled.
- *
- * @param autoUpdate True to enable auto updates, false otherwise.
- * @return This {@link NpcConfig} instance for method chaining. Never null.
- */
- public @NotNull NpcConfig autoUpdate(boolean autoUpdate)
- {
- this.autoUpdate = autoUpdate;
- return this;
- }
-
- /**
- * Gets the configured duration an NPC will look at a player.
- *
- * @return The time in ticks.
- */
- public long lookAtTimer()
- {
- return lookAtTimer;
- }
-
- /**
- * Checks whether command validation is disabled.
- *
- * @return True if validation is skipped; false otherwise.
- */
- public boolean avoidCommandCheck()
- {
- return avoidCommandCheck;
- }
-
- /**
- * Checks whether debug mode is enabled.
- *
- * @return True if debug is enabled; false otherwise.
- */
- public boolean debug()
- {
- return debug;
- }
-
- /**
- * Gets the configured input time limit.
- *
- * @return The time in seconds.
- */
- public int inputTime()
- {
- return inputTime;
- }
-
- /**
- * Checks whether automatic updates are enabled.
- *
- * @return True if auto updates are enabled; false otherwise.
- */
- public boolean autoUpdate()
- {
- return autoUpdate;
- }
-}
diff --git a/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcHolder.java b/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcHolder.java
deleted file mode 100644
index dc25fcd..0000000
--- a/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcHolder.java
+++ /dev/null
@@ -1,62 +0,0 @@
-package de.eisi05.npc.api.objects;
-
-import org.bukkit.inventory.Inventory;
-import org.bukkit.inventory.InventoryHolder;
-import org.jetbrains.annotations.NotNull;
-
-import java.io.IOException;
-
-/**
- * Abstract class representing an entity that can hold NPC-related data
- * and has a concept of unsaved changes.
- * It implements {@link InventoryHolder} but onlay as placeholder.
- */
-public abstract class NpcHolder implements InventoryHolder
-{
- /**
- * Flag indicating whether there are unsaved changes to this holder.
- * Defaults to {@code false}.
- */
- private boolean unsavedChanges = false;
-
- /**
- * Checks if there are any unsaved changes for this NPC holder.
- *
- * @return {@code true} if there are unsaved changes, {@code false} otherwise.
- */
-
- public boolean hasUnsavedChanges()
- {
- return unsavedChanges;
- }
-
- /**
- * Marks that there are unsaved changes to this NPC holder.
- * This should be called whenever a modifiable property of the holder is changed.
- */
- public void markChange()
- {
- unsavedChanges = true;
- }
-
- /**
- * Saves the current state of the NPC holder.
- * This method is intended to persist any changes. After successful execution,
- * the {@code unsavedChanges} flag is reset to {@code false}.
- *
- * @throws IOException if an error occurs during the saving process.
- */
- public void save() throws IOException
- {
- unsavedChanges = false;
- }
-
- /**
- * @throws UnsupportedOperationException always, as this inventory is not used.
- */
- @Override
- public @NotNull Inventory getInventory()
- {
- throw new UnsupportedOperationException("This inventory is not used!");
- }
-}
diff --git a/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcOption.java b/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcOption.java
deleted file mode 100644
index bb1f312..0000000
--- a/src/main/NpcApi-Paper-master/src/main/java/de/eisi05/npc/api/objects/NpcOption.java
+++ /dev/null
@@ -1,591 +0,0 @@
-package de.eisi05.npc.api.objects;
-
-import com.google.common.collect.Multimaps;
-import com.mojang.authlib.GameProfile;
-import com.mojang.authlib.properties.Property;
-import com.mojang.authlib.properties.PropertyMap;
-import com.mojang.datafixers.util.Pair;
-import de.eisi05.npc.api.NpcApi;
-import de.eisi05.npc.api.enums.SkinParts;
-import de.eisi05.npc.api.manager.TeamManager;
-import de.eisi05.npc.api.scheduler.Tasks;
-import de.eisi05.npc.api.utils.*;
-import de.eisi05.npc.api.wrapper.enums.ChatFormat;
-import de.eisi05.npc.api.wrapper.packets.SetEntityDataPacket;
-import de.eisi05.npc.api.wrapper.packets.SetPlayerTeamPacket;
-import net.minecraft.ChatFormatting;
-import net.minecraft.network.Connection;
-import net.minecraft.network.protocol.Packet;
-import net.minecraft.network.protocol.PacketFlow;
-import net.minecraft.network.protocol.game.*;
-import net.minecraft.network.syncher.EntityDataSerializers;
-import net.minecraft.network.syncher.SynchedEntityData;
-import net.minecraft.server.MinecraftServer;
-import net.minecraft.server.level.ClientInformation;
-import net.minecraft.server.level.ServerLevel;
-import net.minecraft.server.level.ServerPlayer;
-import net.minecraft.server.network.CommonListenerCookie;
-import net.minecraft.server.network.ServerGamePacketListenerImpl;
-import net.minecraft.world.entity.Entity;
-import net.minecraft.world.entity.ai.attributes.AttributeInstance;
-import net.minecraft.world.entity.ai.attributes.Attributes;
-import net.minecraft.world.scores.PlayerTeam;
-import org.bukkit.Bukkit;
-import org.bukkit.Location;
-import org.bukkit.craftbukkit.CraftServer;
-import org.bukkit.craftbukkit.CraftWorld;
-import org.bukkit.craftbukkit.entity.CraftPlayer;
-import org.bukkit.craftbukkit.inventory.CraftItemStack;
-import org.bukkit.entity.Player;
-import org.bukkit.entity.Pose;
-import org.bukkit.inventory.EquipmentSlot;
-import org.bukkit.inventory.ItemStack;
-import org.bukkit.scheduler.BukkitRunnable;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.io.Serializable;
-import java.lang.reflect.Field;
-import java.util.*;
-import java.util.function.Function;
-
-/**
- * Represents a configurable option for an NPC.
- * Each option has a path, a default value, serialization/deserialization logic,
- * and a function to generate a network packet for applying the option.
- *
- * @param The type of the option's value in its usable form.
- * @param The type of the option's value in its serialized form.
- */
-public class NpcOption
-{
- /**
- * NPC option to determine if the NPC should use the skin of the viewing player.
- * If true, the NPC's skin will be dynamically set to the skin of the player looking at it.
- */
- public static final NpcOption USE_PLAYER_SKIN = new NpcOption<>("use-player-skin", false,
- aBoolean -> aBoolean, aBoolean -> aBoolean,
- (skin, npc, player) ->
- {
- if(!skin)
- return null;
-
- ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
- ServerPlayer npcServerPlayer = (ServerPlayer) npc.getServerPlayer();
-
- if(!Versions.isCurrentVersionSmallerThan(Versions.V1_21_9))
- {
- var textureProperties = ((PropertyMap) Reflections.getField(serverPlayer.getGameProfile(), "properties")
- .get()).get("textures").iterator();
-
- var npcTextureProperties = ((PropertyMap) Reflections.getField(serverPlayer.getGameProfile(), "properties")
- .get()).get("textures").iterator();
-
- Property property = textureProperties.hasNext() ? textureProperties.next() : null;
- Property npcProperty = npcTextureProperties.hasNext() ? npcTextureProperties.next() : null;
-
- if((property == null && npcProperty == null) || (property != null && npcProperty != null &&
- Reflections.getField(property, "value").get().equals(Reflections.getField(npcProperty, "value").get())))
- return null;
-
- UUID newUUID = UUID.randomUUID();
- GameProfile profile = Reflections.getInstance(GameProfile.class, newUUID, "NPC" + newUUID.toString().substring(0, 13),
- Reflections.getInstance(PropertyMap.class, Multimaps.forMap(property == null ? Map.of() : Map.of("textures", property)))
- .orElseThrow()).orElseThrow();
-
- Location location = npc.getLocation();
- MinecraftServer server = ((CraftServer) Bukkit.getServer()).getServer();
- ServerLevel level = ((CraftWorld) location.getWorld()).getHandle();
- npc.serverPlayer = new ServerPlayer(server, level, profile, ClientInformation.createDefault());
- Var.moveEntity(npc.serverPlayer, location.getX(), location.getY(), location.getZ(), location.getYaw(), location.getPitch());
- npc.serverPlayer.connection = new ServerGamePacketListenerImpl(server, new Connection(PacketFlow.SERVERBOUND), npc.serverPlayer,
- CommonListenerCookie.createInitial(profile, true));
- npc.changeUUID(newUUID);
- return null;
- }
-
- PropertyMap playerProperty = (PropertyMap) Reflections.invokeMethod(serverPlayer.getGameProfile(), "getProperties").get();
- PropertyMap npcProperty = (PropertyMap) Reflections.invokeMethod(serverPlayer.getGameProfile(), "getProperties").get();
-
- var textureProperties = playerProperty.get("textures").iterator();
- npcProperty.removeAll("textures");
-
- if(!textureProperties.hasNext())
- return null;
-
- var textureProperty = textureProperties.next();
- npcProperty.put("textures", textureProperty);
- return null;
- }).loadBefore(!Versions.isCurrentVersionSmallerThan(Versions.V1_21_9));
-
- /**
- * NPC option to set a specific skin using a value and signature.
- * This is ignored if {@link #USE_PLAYER_SKIN} is true.
- */
- public static final NpcOption SKIN = new NpcOption("skin", null,
- skin -> skin, skin -> skin,
- (skin, npc, player) ->
- {
- if(npc.getOption(USE_PLAYER_SKIN))
- return null;
-
- ServerPlayer npcServerPlayer = (ServerPlayer) npc.getServerPlayer();
-
-
- if(!Versions.isCurrentVersionSmallerThan(Versions.V1_21_9))
- {
- var npcTextureProperties = ((PropertyMap) Reflections.getField(npcServerPlayer.getGameProfile(), "properties")
- .get()).get("textures").iterator();
-
- Property npcProperty = npcTextureProperties.hasNext() ? npcTextureProperties.next() : null;
-
- if((skin == null && npcProperty == null) ||
- (npcProperty != null && skin.value().equals(Reflections.getField(npcProperty, "value").get())))
- return null;
-
- UUID newUUID = UUID.randomUUID();
- var textures = new Property("textures", skin.value(), skin.signature());
-
- PropertyMap propertyMap = Reflections.getInstance(PropertyMap.class,
- Multimaps.forMap(skin == null ? Map.of() : Map.of("textures", textures))).orElseThrow();
-
- GameProfile profile = Reflections.getInstance(GameProfile.class, newUUID, "NPC" + newUUID.toString().substring(0, 13),
- propertyMap).orElseThrow();
-
- Location location = npc.getLocation();
- MinecraftServer server = ((CraftServer) Bukkit.getServer()).getServer();
- ServerLevel level = ((CraftWorld) location.getWorld()).getHandle();
- npc.serverPlayer = new ServerPlayer(server, level, profile, ClientInformation.createDefault());
- Var.moveEntity(npc.serverPlayer, location.getX(), location.getY(), location.getZ(), location.getYaw(), location.getPitch());
- npc.serverPlayer.connection = new ServerGamePacketListenerImpl(server, new Connection(PacketFlow.SERVERBOUND), npc.serverPlayer,
- CommonListenerCookie.createInitial(profile, true));
- npc.changeUUID(newUUID);
- return null;
- }
-
- PropertyMap properties = (PropertyMap) Reflections.invokeMethod(npcServerPlayer.getGameProfile(), "getProperties").get();
-
- properties.removeAll("textures");
-
- if(skin == null)
- return null;
-
- var textures = new Property("textures", skin.value(), skin.signature());
-
- properties.put("textures", textures);
- return null;
- }).loadBefore(!Versions.isCurrentVersionSmallerThan(Versions.V1_21_9));
-
- /**
- * NPC option to control whether the NPC is shown in the player tab list.
- * If false, the NPC will be removed from the tab list for the viewing player after a short delay.
- */
- public static final NpcOption SHOW_TAB_LIST = new NpcOption<>("show-tab-list", true,
- aBoolean -> aBoolean, aBoolean -> aBoolean,
- (show, npc, player) ->
- {
- if(show)
- return null;
-
- new BukkitRunnable()
- {
- @Override
- public void run()
- {
- ((CraftPlayer) player).getHandle().connection.send(new ClientboundPlayerInfoRemovePacket(List.of(npc.getUUID())));
- }
- }.runTaskLater(NpcApi.plugin, 50);
- return null;
- });
-
- /**
- * NPC option to set the simulated latency (ping) of the NPC in the tab list.
- */
- public static final NpcOption LATENCY = new NpcOption<>("latency", 0,
- aInteger -> aInteger, aInteger -> aInteger,
- (latency, npc, player) ->
- {
- ServerPlayer npcServerPlayer = (ServerPlayer) npc.getServerPlayer();
-
- CommonListenerCookie commonListenerCookie;
- if(Versions.isCurrentVersionSmallerThan(Versions.V1_21_7))
- commonListenerCookie = Reflections.getInstanceFirstConstructor(CommonListenerCookie.class,
- npcServerPlayer.getGameProfile(), latency, ClientInformation.createDefault(), true).orElseThrow();
- else
- commonListenerCookie = Reflections.getInstanceFirstConstructor(CommonListenerCookie.class,
- npcServerPlayer.getGameProfile(), latency, ClientInformation.createDefault(), true, null,
- new HashSet<>(), Reflections.getInstance("io.papermc.paper.util.KeepAlive").orElseThrow()).orElseThrow();
-
- if(Versions.isCurrentVersionSmallerThan(Versions.V1_21_9))
- npcServerPlayer.connection = new ServerGamePacketListenerImpl(
- (MinecraftServer) Reflections.invokeMethod(npcServerPlayer, "getServer").get(),
- new Connection(PacketFlow.SERVERBOUND), npcServerPlayer, commonListenerCookie);
- else
- npcServerPlayer.connection = new ServerGamePacketListenerImpl(npcServerPlayer.level().getServer(),
- new Connection(PacketFlow.SERVERBOUND), npcServerPlayer, commonListenerCookie);
-
- return new ClientboundPlayerInfoUpdatePacket(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_LATENCY, npcServerPlayer);
- });
-
- /**
- * NPC option to control the visibility of the NPC's nametag.
- */
- public static final NpcOption HIDE_NAMETAG = new NpcOption<>("hide-nametag", false,
- aBoolean -> aBoolean, aBoolean -> aBoolean,
- (hide, npc, player) ->
- {
- if(!hide)
- return null;
-
- return new ClientboundRemoveEntitiesPacket(((Entity) npc.getNameTag().getDisplay()).getId());
- });
-
- /**
- * NPC option to set the pose of the NPC (e.g., standing, sleeping, swimming).
- * For a full list look at {@link Pose}.
- */
- public static final NpcOption POSE = new NpcOption<>("pose", Pose.STANDING,
- pose -> pose, pose -> pose,
- (pose, npc, player) ->
- {
- net.minecraft.world.entity.Pose nmsPose = net.minecraft.world.entity.Pose.values()[pose.ordinal()];
-
- if(nmsPose == null)
- throw new RuntimeException("Pose (" + pose.name() + ") not found");
-
- ServerPlayer npcServerPlayer = (ServerPlayer) npc.getServerPlayer();
-
- npcServerPlayer.setPose(nmsPose);
-
- SynchedEntityData data = npcServerPlayer.getEntityData();
- data.set(EntityDataSerializers.POSE.createAccessor(6), nmsPose);
-
- if(pose == Pose.SPIN_ATTACK)
- data.set(EntityDataSerializers.BYTE.createAccessor(8), (byte) 0x04);
- else
- data.set(EntityDataSerializers.BYTE.createAccessor(8), (byte) 0x01);
-
- return (Packet) SetEntityDataPacket.create(npcServerPlayer.getId(), data);
- });
-
- /**
- * NPC option to set the equipment worn by the NPC (armor, items in hand).
- * The map uses {@link EquipmentSlot} as keys and {@link ItemStack} as values.
- * Serialized form uses item base64 strings.
- */
- public static final NpcOption, HashMap> EQUIPMENT = new NpcOption<>("equipment", Map.of(),
- map ->
- {
- HashMap serializedMap = new HashMap<>();
- map.forEach((slot, item) -> serializedMap.put(slot, ItemSerializer.itemStackToBase64(item)));
- return serializedMap;
- },
- serializedMap ->
- {
- HashMap map = new HashMap<>();
- serializedMap.forEach((slot, string) -> map.put(slot, ItemSerializer.itemStackFromBase64(string)));
- return map;
- },
- (map, npc, player) ->
- {
- if(map.isEmpty())
- return null;
-
- List> list = new ArrayList<>();
-
- map.forEach((slot, item) -> list.add(
- new Pair<>(net.minecraft.world.entity.EquipmentSlot.values()[slot.ordinal()], CraftItemStack.asNMSCopy(item))));
-
- return new ClientboundSetEquipmentPacket(((ServerPlayer) npc.getServerPlayer()).getId(), list);
- });
-
- /**
- * NPC option to control which parts of the NPC's skin are visible (e.g., hat, jacket).
- * For a full list look at {@link SkinParts}.
- */
- public static final NpcOption SKIN_PARTS = new NpcOption<>("skin-parts", SkinParts.values(),
- skinParts -> skinParts, skinParts -> skinParts,
- (skinParts, npc, player) ->
- {
- ServerPlayer npcServerPlayer = (ServerPlayer) npc.getServerPlayer();
- SynchedEntityData data = npcServerPlayer.getEntityData();
- data.set(EntityDataSerializers.BYTE.createAccessor(Versions.isCurrentVersionSmallerThan(Versions.V1_21_9) ? 17 : 16),
- (byte) Arrays.stream(skinParts).mapToInt(SkinParts::getValue).sum());
- return (Packet) SetEntityDataPacket.create(npcServerPlayer.getId(), data);
- });
-
- /**
- * NPC option to make the NPC look at the player if they are within a certain distance.
- * The value is the maximum distance in blocks. A value of 0 or less disables this.
- * The actual looking logic is handled by {@link Tasks}.
- */
- public static final NpcOption LOOK_AT_PLAYER = new NpcOption<>("look-at-player", 0.0,
- distance -> distance, distance -> distance,
- (distance, npc, player) -> null);
-
- /**
- * NPC option to make the NPC glow with a specific color.
- * If null, the glowing effect is removed.
- */
- @SuppressWarnings("unchecked")
- public static final NpcOption GLOWING = new NpcOption<>("glowing", null,
- color -> color, color -> color,
- (color, npc, player) ->
- {
- ServerPlayer npcServerPlayer = (ServerPlayer) npc.getServerPlayer();
-
- if(color == null)
- {
- SynchedEntityData entityData = npcServerPlayer.getEntityData();
- entityData.set(EntityDataSerializers.BYTE.createAccessor(0), (byte) 0);
- return (Packet) SetEntityDataPacket.create(npcServerPlayer.getId(), entityData);
- }
-
- String teamName = npc.getGameProfileName();
- boolean modified = TeamManager.exists(player, teamName);
- PlayerTeam team = (PlayerTeam) TeamManager.create(player, teamName);
-
- team.setColor(ChatFormatting.getByCode(color.getColorCode()));
-
- var teamPacket = SetPlayerTeamPacket.createAddOrModifyPacket(team, !modified);
-
- SynchedEntityData entityData = npcServerPlayer.getEntityData();
- entityData.set(EntityDataSerializers.BYTE.createAccessor(0), (byte) 0x40);
-
- return new ClientboundBundlePacket(List.of((Packet) teamPacket,
- (Packet) SetEntityDataPacket.create(
- npcServerPlayer.getId(), entityData)));
- });
-
- /**
- * NPC option to set the scale (size) of the NPC.
- * A value of 1.0 is normal size. Requires Minecraft 1.20.6 or newer.
- */
- public static final NpcOption SCALE = new NpcOption<>("scale", 1.0,
- scale -> scale, scale -> scale,
- (scale, npc, player) ->
- {
- ServerPlayer npcServerPlayer = (ServerPlayer) npc.getServerPlayer();
-
- AttributeInstance instance = npcServerPlayer.getAttribute(Attributes.SCALE);
- instance.setBaseValue(scale);
-
- return new ClientboundUpdateAttributesPacket(npcServerPlayer.getId(), List.of(instance));
- });
-
- /**
- * NPC option to control the position of the NPC in the TAB list.
- *
- * Only works on versions older than 1.21.2.
- * On 1.21.2 and newer, this option has no effect.
- *
- */
- public static final NpcOption LIST_ORDER = new NpcOption<>("list-order", 0,
- aInt -> aInt, aInt -> aInt,
- (order, npc, player) ->
- {
- if(!Versions.isCurrentVersionSmallerThan(Versions.V1_21_2))
- return null;
-
- ((ServerPlayer) npc.getServerPlayer()).listOrder = order;
-
- return new ClientboundPlayerInfoUpdatePacket(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_LIST_ORDER,
- (ServerPlayer) npc.getServerPlayer());
- }).since(Versions.V1_21_2);
-
- /**
- * NPC option to control if the NPC is enabled (visible and interactable).
- * If false, a "DISABLED" marker may be shown.
- * This is an internal option, typically not directly set by users but controlled by {@link NPC#setEnabled(boolean)}.
- */
- static final NpcOption ENABLED = new NpcOption<>("enabled", false,
- aBoolean -> aBoolean, aBoolean -> aBoolean,
- (enabled, npc, player) -> null);
-
- /**
- * NPC option to control if the NPC is enabled (visible and interactable).
- * If false, a "DISABLED" marker may be shown.
- * This is an internal option, typically not directly set by users but controlled by {@link NPC#setEnabled(boolean)}.
- */
- static final NpcOption EDITABLE = new NpcOption<>("editable", false,
- aBoolean -> aBoolean, aBoolean -> aBoolean,
- (enabled, npc, player) -> null);
-
- private final String path;
- private final T defaultValue;
- private final Function serializer;
- private final Function deserializer;
- private final TriFunction> packet;
- private Versions since = Versions.V1_17;
- private boolean loadBefore = false;
-
- /**
- * Private constructor to create a new NpcOption.
- *
- * @param path The configuration path string. Must not be null.
- * @param defaultValue The default value for the option. Can be null.
- * @param serializer The serialization function. Must not be null.
- * @param deserializer The deserialization function. Must not be null.
- * @param packet The packet generation function. Must not be null.
- */
- private NpcOption(@NotNull String path, @Nullable T defaultValue, @NotNull Function serializer, @NotNull Function deserializer,
- @NotNull TriFunction> packet)
- {
- this.path = path;
- this.defaultValue = defaultValue;
- this.serializer = serializer;
- this.deserializer = deserializer;
- this.packet = packet;
- }
-
- /**
- * Retrieves all declared {@link NpcOption} constants within this class using reflection.
- *
- * @return An array of {@link NpcOption} instances. Will not be null.
- */
- public static @NotNull NpcOption[] values()
- {
- List fields = Arrays.stream(NpcOption.class.getDeclaredFields()).filter(field -> field.getType().equals(NpcOption.class)).toList();
-
- NpcOption[] values = new NpcOption[fields.size()];
-
- for(int i = 0; i < fields.size(); i++)
- {
- try
- {
- values[i] = (NpcOption) fields.get(i).get(null);
- } catch(IllegalAccessException e)
- {
- }
- }
-
- return values;
- }
-
- /**
- * Retrieves an {@link NpcOption} instance by its configuration path.
- *
- * @param path The configuration path string to search for. Must not be null.
- * @return An {@link Optional} containing the found {@link NpcOption}, or an empty Optional if no option matches the path.
- */
- public static @NotNull Optional> getOption(@NotNull String path)
- {
- return Arrays.stream(values()).filter(npcOption -> npcOption.getPath().equals(path)).findFirst();
- }
-
- /**
- * Sets the minimum Minecraft version required for this option.
- * Used for options that are only available in newer versions of the game.
- *
- * @param since The minimum {@link Versions} required. Must not be null.
- * @return This {@link NpcOption} instance for method chaining.
- */
- public @NotNull NpcOption since(@NotNull Versions since)
- {
- this.since = since;
- return this;
- }
-
- public @NotNull NpcOption loadBefore(boolean loadBefore)
- {
- this.loadBefore = loadBefore;
- return this;
- }
-
- public boolean loadBefore()
- {
- return loadBefore;
- }
-
- /**
- * Checks if this NPC option is compatible with the current server version.
- * An option is compatible if the current server version is greater than or equal to
- * the version specified by {@link #since()}.
- *
- * @return {@code true} if the option is compatible, {@code false} otherwise.
- */
- public boolean isCompatible()
- {
- return !Versions.isCurrentVersionSmallerThan(since);
- }
-
- /**
- * Gets the minimum Minecraft version required for this option.
- *
- * @return The {@link Versions} instance.
- */
- public Versions since()
- {
- return since;
- }
-
- /**
- * Gets the default value for this option.
- *
- * @return The default value, which can be null if defined as such.
- */
- public @Nullable T getDefaultValue()
- {
- return defaultValue;
- }
-
- /**
- * Gets the configuration path string for this option.
- *
- * @return The path string. Will not be null.
- */
- public @NotNull String getPath()
- {
- return path;
- }
-
- /**
- * Serializes the given value (of type T) into its serializable form (type S).
- *
- * @param var1 The value to serialize. Can be null.
- * @return The serialized value. Can be null if the input or serializer result is null.
- * @throws RuntimeException if a {@link ClassCastException} occurs during serialization,
- * indicating an incorrect type was passed.
- */
- @SuppressWarnings("unchecked")
- public @Nullable S serialize(@Nullable Object var1)
- {
- try
- {
- return serializer.apply((T) var1);
- } catch(ClassCastException e)
- {
- throw new RuntimeException(path + " -> " + var1);
- }
- }
-
- /**
- * Deserializes the given value (of type S) back into its usable form (type T).
- *
- * @param var1 The serialized value to deserialize. Can be null.
- * @return The deserialized value. Can be null if the input or deserializer result is null.
- */
- public @Nullable T deserialize(@Nullable S var1)
- {
- return deserializer.apply(var1);
- }
-
- /**
- * Generates the network packet(s) needed to apply this option's value to an NPC for a specific player.
- * The method checks for version compatibility before generating the packet.
- *
- * @param object The value of the option to apply. Can be null.
- * @param npc The {@link NPC} to apply the option to. Must not be null.
- * @param player The {@link Player} who will receive the update. Must not be null.
- * @return An {@link Optional} containing the {@link Packet} if one is generated and the option is compatible,
- * otherwise an empty Optional.
- */
- @SuppressWarnings("unchecked")
- public @NotNull Optional