Package net.citizensnpcs.api.ai.tree

Class Decorator

java.lang.Object

net.citizensnpcs.api.ai.tree.BehaviorGoalAdapter

net.citizensnpcs.api.ai.tree.Decorator

All Implemented Interfaces:

Goal, Behavior

public class Decorator
extends BehaviorGoalAdapter

A decorator is a wrapper over a Behavior, which can add functionality such as filtering BehaviorStatuses, conditions, timer loops and more without knowing the internals of the behavior it wraps. Note that there are often simpler alternatives to a full-blown decorator, which has to be generic for many different scenarios.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Decorator.Builder

Method Summary

Modifier and Type	Method	Description
void	reset()	Resets the goal and any resources or state it is holding.
BehaviorStatus	run()	Runs the behavior for one 'tick', optionally changing the state that it is in.
boolean	shouldExecute()	Returns whether the behavior is ready to run.
static Decorator.Builder	wrapping(Behavior toWrap)

Methods inherited from class net.citizensnpcs.api.ai.tree.BehaviorGoalAdapter

create, run, shouldExecute

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

reset

public void reset()

Description copied from interface: Goal

Resets the goal and any resources or state it is holding.

run

public BehaviorStatus run()

Description copied from interface: Behavior

Runs the behavior for one 'tick', optionally changing the state that it is in.

Returns:

The new state

shouldExecute

public boolean shouldExecute()

Description copied from interface: Behavior

Returns whether the behavior is ready to run. Note this is called once when deciding whether to start execution of a leaf node. The actual execution status is determined by the return value of Behavior.run() which is repeatedly called by the executing node.

wrapping

public static Decorator.Builder wrapping(Behavior toWrap)