MagmaCore/com.magmaguy.easyminecraftgoals/NMSAdapter

NMSAdapter

public abstract class NMSAdapter

Constructors

public void NMSAdapter()

Functions

public Optional<TransientMovementOverride> beginFlee(LivingEntity livingEntity, Location threatLocation, double speedModifier)

Temporarily makes a pathfinding entity flee from a threat while leaving its permanent goals, combat target, and AI flags untouched.

bukkitCustomEntityBuilder

public BukkitCustomEntity.Builder bukkitCustomEntityBuilder()

canReach

public boolean canReach(LivingEntity livingEntity, Location location)

createBukkitCustomEntity

public BukkitCustomEntity createBukkitCustomEntity(Entity entity, CustomEntityDefinition definition)

Creates a custom Bedrock presentation bound to an existing Bukkit entity.

createFakeCustomEntity

public FakeCustomEntity createFakeCustomEntity(Location location, CustomEntityDefinition definition)

Creates a packet-only custom visual entity.

createFakeItem

public FakeItem createFakeItem(Location location, FakeItemSettings settings)

Creates a FakeItem that displays an item visually without being pickable.

createFakeText

public abstract FakeText createFakeText(Location location, FakeTextSettings settings)

Creates a FakeText that automatically uses TextDisplay for Java Edition players and ArmorStand for Bedrock Edition players.

createMindHost

public MindHost createMindHost(MindFailureListener failureListener)

Creates the version-specific native Mind host.

public MindHost createMindHost(NamespacedKey hostIdentity, MindFailureListener failureListener)

Creates a native Mind host with a stable owner identity persisted on every carrier.

public MindHost createMindHost(NamespacedKey hostIdentity, MindFailureListener failureListener, MindActionSink actionSink)

Creates a native Mind host with a synchronous semantic action sink.

createPacketArmorStandEntity

public abstract PacketModelEntity createPacketArmorStandEntity(Location location)

createPacketBundle

public abstract AbstractPacketBundle createPacketBundle()

createPacketDisplayEntity

public abstract PacketModelEntity createPacketDisplayEntity(Location location)

createPacketEntity

public PacketEntityInterface createPacketEntity(EntityType entityType, Location location)

Creates a generic packet entity of the specified type.

createPacketInteractionEntity

public PacketInteractionEntity createPacketInteractionEntity(Location location, float width, float height)

Creates a packet-only Interaction entity for detecting player clicks.

createPacketTextArmorStandEntity

public abstract PacketTextEntity createPacketTextArmorStandEntity(Location location)

createPathfindingHandle

public final Optional<PathfindingHandle> createPathfindingHandle(LivingEntity livingEntity)

Creates one reusable, interruptible navigation handle for an existing mob.

protected Optional<PathfindingHandle> createPathfindingHandle(LivingEntity livingEntity, int priority)

Implemented by adapters that can install native goals on the supplied entity.

damageWithoutCooldown

public abstract void damageWithoutCooldown(LivingEntity target, double amount, Entity source)

Delivers a living attacker or owned arrow hit through native damage and Bukkit events, bypassing only this invocation's hit cooldown.

doNotMove

public abstract void doNotMove(LivingEntity livingEntity)

fakeCustomEntityBuilder

public FakeCustomEntity.Builder fakeCustomEntityBuilder()

fakeItemBuilder

public FakeItem.Builder fakeItemBuilder()

Creates a builder for FakeItem with customizable options.

fakeTextBuilder

public FakeText.Builder fakeTextBuilder()

Creates a builder for FakeText with customizable styling options.

forcedMove

public abstract boolean forcedMove(LivingEntity livingEntity, double speedModifier, Location location)

getBodyRotation

public abstract float getBodyRotation(Entity entity)

getConsumptionSeconds

public float getConsumptionSeconds(ItemStack item)

Effective native consumption duration, including material defaults; -1 for non-consumables.

getDamageCooldownTicks

public int getDamageCooldownTicks(LivingEntity entity)

Returns the remaining native hit cooldown, independently of other invulnerability timers.

getDamageIndicatorParticleCap

public int getDamageIndicatorParticleCap()

grantOrdinaryAmmunition

public RangedAmmunition grantOrdinaryAmmunition(Plugin plugin, Predicate<Player> eligible)

Grants ordinary bow/crossbow ammunition while retaining the native item-use and projectile paths.

hideScoreboardNumbers

public boolean hideScoreboardNumbers(Objective objective)

Hides the numeric score column for a sidebar objective while keeping score values available for ordering.

initializePacketInteractionListener

public void initializePacketInteractionListener(Plugin plugin)

Initializes the packet interaction listener for detecting clicks on packet-only entities.

isMindBody

public boolean isMindBody(Entity entity)

Returns whether an entity is any MagmaCore native mind carrier.

isPositionEntityTicking

public boolean isPositionEntityTicking(Location location)

Checks the entity-ticking chunk level without loading the destination chunk.

move

public abstract boolean move(LivingEntity livingEntity, double speedModifier, Location targetLocation)

Simply makes an entity move to a point.

removeFreeWill

public boolean removeFreeWill(LivingEntity livingEntity)

Removes vanilla goals and brain behaviors from a mob without disabling its pathfinding AI.

setBlockInNativeDataPalette

public abstract void setBlockInNativeDataPalette(World world, int x, int y, int z, BlockData blockData, boolean applyPhysics)

setCustomHitbox

public abstract boolean setCustomHitbox(Entity entity, float width, float height, boolean fixed)

Sets a custom hitbox size for an entity

setDamageCooldownTicks

public void setDamageCooldownTicks(LivingEntity entity, int ticks)

Changes only the native hit cooldown; the previous hit amount and other immunity remain unchanged.

setDamageIndicatorParticleCap

public void setDamageIndicatorParticleCap(int max)

Sets the maximum number of DAMAGE_INDICATOR particles that outbound ClientboundLevelParticlesPacket packets may carry.

setPassengerOffset

public boolean setPassengerOffset(Entity entity, double offsetX, double offsetY, double offsetZ)

Sets a custom passenger riding offset for an entity, overriding where passengers sit.

shutdownMindHost

public void shutdownMindHost()

Stops all native mind sessions while retaining their rehydration markers.

shutdownPacketInteractionListener

public void shutdownPacketInteractionListener()

Shuts down the packet interaction listener.

supportsFakeItems

public boolean supportsFakeItems()

Checks if FakeItem is supported on this server version.

universalMove

public abstract void universalMove(LivingEntity livingEntity, double speedModifier, Location location)

Pathfinding method which will move an entity to a point with a complete disregard for any pathfinding.

wanderBackToPoint

@Nullable()

public @Nullable() AbstractWanderBackToPoint wanderBackToPoint(@NonNull() @NonNull() LivingEntity livingEntity, @NonNull() @NonNull() Location blockLocation, double maximumDistanceFromPoint, int maxDurationTicks)

Makes a mob wander back to a point when it reaches a certain distance from that point, acting as a leash.

public abstract AbstractWanderBackToPoint wanderBackToPoint(LivingEntity livingEntity, Location blockLocation, double maximumDistanceFromPoint, int maxDurationTicks, OverridableWanderPriority overridableWanderPriority)

withConsumptionSeconds

public ItemStack withConsumptionSeconds(ItemStack item, float seconds)

Returns a copy with only consumption duration changed, preserving native effects and animation.