Action & Java Doc Cleanup

java/noppes/npcs/api/handler/IActionManager.java

@@ -0,0 +1,87 @@
+package noppes.npcs.api.handler;
+
+import noppes.npcs.api.handler.data.IAction;
+import java.util.Queue;
+import java.util.function.Consumer;
+
+/**
+ * Interface for managing and scheduling actions.
+ * Provides methods to create, start, stop, and queue actions.
+ */
+public interface IActionManager {
+    /**
+     * Creates a new IAction instance with the specified parameters.
+     *
+     * @param name            the name of the action.
+     * @param maxDuration     the maximum duration (in ticks) for the action.
+     * @param startAfterTicks the delay in ticks before the action starts.
+     * @param action          the consumer defining the action's behavior.
+     * @return a new IAction instance.
+     */
+    IAction createAction(String name, int maxDuration, int startAfterTicks, Consumer<IAction> action);
+
+    /**
+     * Starts the action manager, enabling the processing of scheduled actions.
+     */
+    void start();
+
+    /**
+     * Stops the action manager, halting the processing of scheduled actions.
+     */
+    void stop();
+
+    /**
+     * Schedules an action by adding it to the action queue.
+     *
+     * @param action the action to be scheduled.
+     */
+    void addScheduledAction(IAction action);
+
+    /**
+     * Creates and schedules an action with the given parameters.
+     *
+     * @param name            the name of the action.
+     * @param maxDuration     the maximum duration (in ticks) for the action.
+     * @param startAfterTicks the delay in ticks before the action starts.
+     * @param action          the consumer defining the action's behavior.
+     */
+    void addScheduledAction(String name, int maxDuration, int startAfterTicks, Consumer<IAction> action);
+
+    /**
+     * Inserts an action into the action queue at the specified index.
+     *
+     * @param index  the position in the queue where the action should be added.
+     * @param action the action to insert.
+     */
+    void addScheduledActionAt(int index, IAction action);
+
+    /**
+     * Schedules an action to be executed immediately after the specified action.
+     *
+     * @param after      the action after which the new action should run.
+     * @param toSchedule the action to schedule.
+     */
+    void scheduleActionAfter(IAction after, IAction toSchedule);
+
+    /**
+     * Retrieves the index of the specified action in the action queue.
+     *
+     * @param action the action whose index is to be determined.
+     * @return the index of the action in the queue, or -1 if not found.
+     */
+    int getActionIndex(IAction action);
+
+    /**
+     * Gets the current action (the one at the head of the queue).
+     *
+     * @return the current action, or null if the queue is empty.
+     */
+    IAction getCurrentAction();
+
+    /**
+     * Returns the queue of scheduled actions.
+     *
+     * @return the action queue.
+     */
+    Queue<IAction> getActionQueue();
+}