Astral Realms Documentation Help

Commands

AstralStacker registers two ACF commands: /astralstacker (stats/reload) and /stackill (bulk removal).

Command

Permission

Description

/astralstacker stats

stacker.command

Prints total item and entity stack counts, broken down by material/entity type.

/astralstacker reload

stacker.command

Reloads config.yml.

/stackill <radius>

stacker.butcher

Removes every entity stack within radius blocks of the sender.

/astralstacker

Permission: stacker.command (class-level @CommandPermission, applies to every subcommand — there are no additional per-subcommand permissions).

stats

Console or player. Reports, in gold/gray/green/yellow chat lines:

  • Total tracked item stacks (excluding ones already marked for removal), then each present Material with the summed amount across all its stacks.

  • Total tracked entity stacks (same exclusion), then each present EntityType with the summed amount across all its stacks.

reload

Console or player. Calls AstralStacker#loadConfiguration() (re-reads config.yml and refreshes EntityStackService's cached max-merge-distance). Replies with a gray "Reloading…" message, then a green success or a red failure message; a failure is also logged via SLF4J with the stack trace.

/stackill <radius>

Permission: stacker.butcher. Player-only (@Default, no console fallback). radius is an integer number of blocks (tab-completion suggests 1100, but any value works). Removes every entity stack — not item stacks — within radius blocks of the sender's location in the sender's world (EntityStackService#butcherStacks): each matching stack is marked for removal and its underlying entity is removed immediately. There is no confirmation prompt.

Permission summary

Node

Grants

stacker.command

/astralstacker stats and /astralstacker reload.

stacker.butcher

/stackill <radius>.

See also

  • Overview — the services these commands report on and reload.

  • Configuration — what reload re-reads.

  • Mechanics — what a butchered entity stack was doing before removal.

Last modified: 25 July 2026