EliteMobs/com.magmaguy.elitemobs.api.mind/EliteMindService

EliteMindService

EliteMobs-owned interface for Lua-authored native mob minds.

Consumers obtain this interface from Bukkit's services manager after com.magmaguy.elitemobs.api.EliteMobsInitializedEvent. All mutations must run on the server thread. Registered Lua source is validated immediately, while each entity receives a fresh executable program and Lua environment when it is bound.

Functions

bodyCapabilities

public abstract EliteMindBodyCapabilities bodyCapabilities()

Returns body features supported by the active native Minecraft adapter.

clearProgram

public abstract boolean clearProgram(EliteEntity eliteEntity)

Stops the program and terminally removes its native actor.

inspect

public abstract Optional<EliteMindSnapshot> inspect(EliteEntity eliteEntity)

Returns the current native runtime state when the actor has a mind binding.

registerLuaModule

public abstract EliteMindModule registerLuaModule(Plugin owner, NamespacedKey key, long revision, String source)

Registers or advances one owner-scoped Lua module before programs reference it.

registerLuaProgram

public abstract EliteMindProgram registerLuaProgram(Plugin owner, NamespacedKey key, long revision, String source)

Registers or advances one owner-scoped Lua program.

registerNaturalSpawnProvider

public abstract void registerNaturalSpawnProvider(Plugin owner, EliteNaturalSpawnProvider provider)

Registers one owner-scoped natural-spawn provider.

setPaused

public abstract EliteMindSnapshot setPaused(EliteEntity eliteEntity, boolean paused)

Idempotently pauses or resumes an actor's native Mind and attached power runtimes.

setProgram

public abstract EliteMindSnapshot setProgram(EliteEntity eliteEntity, NamespacedKey key, EliteMindTransferPolicy transferPolicy)

Replaces the program on an actor already backed by a MagmaCore mind body.

spawn

public abstract EliteEntity spawn(EliteMindSpawnRequest request)

Spawns an EliteMobs actor on MagmaCore's native mind body and binds the requested program.

unregisterOwner

public abstract void unregisterOwner(Plugin owner)

Closes the plugin's module and natural-spawn scopes, removes its programs, and removes actors still running those programs.