RoleDebugFlags

Package: com.hypixel.hytale.server.npc.role

public enum RoleDebugFlags implements Supplier<String>

35 debug flags controlling NPC trace logging, movement validation, steering visualization, and nameplate display overlays. Each constant carries a human-readable description string accessible via get(). Supports named presets for convenient bulk flag activation.

Enum Constants

Name	Description
TraceFail	Trace failed instructions
TraceSuccess	Trace matched instructions
TraceSensorFailures	Trace failing sensors
Flock	Trace flock events
FlockDamage	Trace flock damage events
MotionControllerSteer	Trace steering activity of motion controllers
Collisions	Trace collision information of motion controllers
BlockCollisions	Trace collisions down to block level
ProbeBlockCollisions	Trace collisions down to block level when probing
MotionControllerMove	Trace movement activity of motion controllers
ValidatePositions	Validate computed movement positions are not intersecting blocks
SteeringRole	Debug blended steering behaviour from role like avoidance/separation
DisplayState	Set display name to contents of state
DisplayFlock	Set display name to flock state
DisplayTime	Set display name to day time
DisplayTarget	Set display name to locked target type
DisplayAnim	Display animation state
DisplayLightLevel	Display light levels
DisplayCustom	Display custom debug information (generated by debug components)
DisplayHP	Display NPC HP as numerical values
DisplayStamina	Display NPC Stamina as numerical values
Overlaps	Log overlapping blocks when validating position
Pathfinder	Display pathfinder status
DisplaySpeed	Display speed of entity
DisplayFreeSlots	Display free inventory slots
DisplayInternalId	Display the internal server ID for this entity
DisplayName	Display the role name for this entity
ValidateMath	Validate (some) math computations in movement
VisAvoidance	Visualize avoidance vectors
VisSeparation	Visualize separation vector
VisAiming	Visualize aiming
VisMarkedTargets	Visualize arrows to marked targets
VisSensorRanges	Visualize entity sensor detection ranges
VisLeashPosition	Visualize NPC leash position
VisFlock	Visualize flock member connections
BeaconMessages	Enable debugging of beacon message sending and receiving

Presets

Name	Flags
none	Empty set
all	All flags
move	MotionControllerMove, Collisions
steer	MotionControllerMove, MotionControllerSteer, Collisions
valid	steer + ValidatePositions
block	steer + BlockCollisions
visDist	VisAvoidance, VisSeparation
visSensorInfo	VisMarkedTargets, VisSensorRanges
display	All Display* flags
default	All flags except ValidatePositions

Static Methods

Modifier	Return Type	Signature
@Nonnull public static	EnumSet<RoleDebugFlags>	getFlags(@Nonnull String[] args)
@Nonnull public static	StringBuilder	getListOfFlags(@Nonnull EnumSet<RoleDebugFlags> flags, @Nonnull StringBuilder stringBuilder)
public static	StringBuilder	getListOfAllFlags(@Nonnull StringBuilder stringBuilder)
public static	StringBuilder	getListOfAllPresets(@Nonnull StringBuilder stringBuilder)
@Nonnull public static	EnumSet<RoleDebugFlags>	getPreset(String arg)
public static	boolean	havePreset(String name)