Commands

Island

Registered by SkyblockCommand.

• /is — resolves the caller's island via members().findPlayerIsland(...) and opens the island-main menu with it. If the caller has no island, the command currently does nothing: the creation-menu fallback is a // TODO: Open creation menu in source and is not implemented in this version.

• /is create [name] [blueprint] — both arguments are optional (@Nullable @Optional) despite the <name> <blueprint> syntax hint. If name is omitted or blank, it defaults to the caller's username; if blueprint is omitted, it defaults to BlueprintService#defaultBlueprint() (the blueprint flagged default: true in its file — see Islands). Fails with NAME_ALREADY_TAKEN if the resolved name is already in use. The command does not check whether the caller already owns an island before creating another one. Tab-completes <blueprint> with @islandBlueprints.

• /is delete <island> — resolves <island> by exact name (see Argument resolution) and calls IslandService#delete directly. Neither the command nor the service performs an ownership or permission check — any player who can name (or tab-complete via @islands) an island can request its deletion.

• /is go <island> — resolves the island's host server (or loads it on the network's emptiest island-capable server if it isn't hosted anywhere), then teleports the caller there through the core TeleportationService. Like delete, no ownership check is performed.

• /is reload — works for console senders too (CommandSender, not Player). Re-invokes AstralSkyblock#loadConfiguration(), which reloads config.yml, loader.yml, roles.yml, block-values.yml, messages.yml, settings.yml and permissions.yml. See Configuration.

Invitations

Registered by InvitationCommand. Invitations expire 15 minutes after creation (IslandInvitation.create, hardcoded — not a config value).

• /is invite//is coop — both fail with NO_ISLAND if the caller has no island, and with NO_PERMISSION if the caller's role lacks INVITE_MEMBER/COOP_MEMBER. Both delegate to InvitationService#create, which silently no-ops (no message) if the recipient is already a member (or already coop, for COOP invitations) or already has a non-expired invitation from that island.

• /is accept [player]//is decline [player] — with <player> given, resolves that sender's non-expired invitation specifically and fails with NO_PENDING_INVITATION if none exists. Without an argument, looks at all of the caller's non-expired invitations: zero sends NO_PENDING_INVITATION, exactly one is auto-accepted/declined, and more than one sends MULTIPLE_PENDING_INVITATIONS (the caller must re-run with a sender specified).

• /is cancel <player> — fails with NO_ISLAND if the caller has no island. InvitationService#cancel additionally requires the caller to be the original sender of the pending invitation, otherwise it behaves as if no invitation exists (INVITATION_NOT_FOUND).

All four target-taking subcommands tab-complete <player> with @networkPlayers.

Members

Registered by MemberCommand. Role comparisons use each IslandRole's weight(); the promote/demote ladder is the island's non-owner (MEMBER-kind) roles sorted ascending by weight.

• /is kick — the island owner can never be kicked (MEMBER_HIGHER_ROLE); a non-owner kicker must also outrank the target's role weight.

• /is leave — blocked for the island owner (OWNER_CANNOT_LEAVE); the owner must /is transfer first.

• /is promote//is demote — fail with MEMBER_ALREADY_HIGHEST_ROLE/MEMBER_ALREADY_LOWEST_ROLE at the ends of the ladder; a non-owner sender cannot promote a target to or above their own role weight, and must outrank the target to demote them (MEMBER_HIGHER_ROLE/MEMBER_PROMOTE_HIGHER).

• /is transfer — checked directly against island.owner() rather than an IslandPermission (NOT_ISLAND_OWNER if the caller isn't the owner). <player> must already be a member (MEMBER_NOT_FOUND otherwise). On success the ex-owner is demoted to the island's highest-weight MEMBER-kind role and the target becomes owner.

<player> tab-completes with @islandMembers on all five subcommands (members of the caller's island, excluding the caller).

Co-ops

Registered by CoopCommand. See Members, Co-ops & Invitations for how co-op players differ from full members.

Fails with NO_ISLAND if the caller has no island, NO_PERMISSION if the caller's role lacks UNCOOP_MEMBER, and COOP_NOT_FOUND if <player> isn't currently a co-op of the island. Unlike the member-management subcommands, <player> tab-completes with the generic @players (any online player), not @islandMembers.

Permissions

Neither node is declared in plugin.yml (no permissions: block), so both fall back to Bukkit's default behavior for undeclared permissions (operators only).

Everything else is gated by the island's own role system — an IslandPermission value looked up on the caller's IslandRole (owners always pass; co-op players are checked against the island's COOP-kind role). See Roles, Permissions & Settings for the full IslandPermission list and how roles assign them.

Argument resolution

Two custom ACF context resolvers back the command arguments above:

MinecraftPlayer arguments (used by invite/coop/accept/decline/cancel/kick/promote/demote/transfer/uncoop) resolve through AstralCore's context resolver, not one registered by this plugin.

Tab completion

@networkPlayers and @players are AstralCore-provided completions, not registered by this plugin.