Astral Realms Documentation Help

Commands

Base command: /mobs. The class-level @CommandPermission("mobs.command") on MobsCommand applies to every subcommand below — there is no separate per-subcommand permission node.

Command

Permission

Completion

Description

/mobs summon <blueprint>

mobs.command

@mobBlueprints

Spawn a mob blueprint at the sender's location. Player-only.

/mobs reload

mobs.command

Reload the plugin configuration and blueprints.

/mobs summon <blueprint>

Permission: mobs.command. Player-only — the handler takes a Player, not a CommandSender.

<blueprint> is resolved through MobBlueprintContextResolver, which pops the argument and looks it up with AstralMobs#blueprints().findById(id); an unknown id throws InvalidCommandArgument ("Mob blueprint '<id>' not found."). Tab completion (@mobBlueprints, backed by MobBlueprintCompletionHandler) lists the keys of AstralMobs#blueprints().all() — the ids of every loaded mob blueprint.

On success, MobService#summon spawns the resolved blueprint at the sender's current location (sender.getLocation()).

/mobs summon zombie-knight

/mobs reload

Permission: mobs.command. No arguments; works from console or as a player.

Sends the reloading message, then calls AstralMobs#loadConfiguration(), which re-runs:

  1. messages.yml reload

  2. config.yml reload

  3. BlueprintService#load() — re-scans every YAML file under blueprints/ and rebuilds the id lookup used by /mobs summon and its tab completion

On success the sender gets reloaded, followed by a line showing the count of loaded blueprints. If loadConfiguration() throws, the exception is logged to console via AstralMobs#getSLF4JLogger() and the sender gets reload-failed instead.

/mobs reload > Reloading... > Reloaded successfully. > Loaded 12 mob blueprints.

Reload messages

The three reload messages are plain component values in messages.yml and can be edited freely:

Key

Default

reloading

Reloading...

reloaded

Reloaded successfully.

reload-failed

Reload failed. Check the console for errors.

Permission summary

Node

Grants

mobs.command

Base node for /mobs — required for every subcommand (summon, reload).

Last modified: 25 July 2026