← Back to home Plugin Reference

Commands List

Every WoSBlock command, its syntax, permission level, and what it does. Arguments in <angle brackets> are required; [square brackets] are optional.

🏝️

Island Management

7 commands
/is create /island create
Player

Creates your personal island with the starter chest containing three NPC spawn eggs (Auctioneer, Thief, Clerk).

/is home /is h /island home
Player

Teleports you to your island's spawn point.

/is visit <player> /island visit
Player

Teleports you to another player's island. Subject to their current visit mode (Friendly, Carnage, Demolition, or FFA).

/is leave
Player

Leaves the island you are currently visiting and returns you to your own island spawn.

/is settings /island settings
Island Owner

Opens the island settings GUI. Cycle through the four visitor modes: Friendly → Carnage → Demolition → FFA.

/is info [player] /island info
Player

Displays island statistics: owner, co-op members, Generator Level, Achievement Level, and total trophies placed. Defaults to your own island.

/is delete
Island Owner

Permanently deletes your island and all its contents. Prompts a confirmation step. This action cannot be undone.

🤝

Co-Op & Trust

6 commands
/is trust <player> /island trust
Island Owner

Grants a player permanent Co-Op builder access: full block placement, interaction, and shared Generator XP. Only the true island owner can use this.

/is untrust <player> /island untrust
Island Owner

Revokes a player's Co-Op trust, removing their builder access immediately. Only the true island owner can use this.

/is members /island members
Player

Lists the true owner and all currently trusted Co-Op members of your island along with their last seen time.

/is kick <player> /island kick
Island Owner

Removes a visitor or Co-Op member from your island and temporarily prevents them from visiting (configurable ban duration).

/is ban <player>
Island Owner

Permanently prevents a player from visiting your island regardless of visit mode. Use /is unban to reverse.

/is unban <player>
Island Owner

Removes a visit ban on a specific player, allowing them to visit again according to the active visit mode.

📍

Waypoints & Navigation

5 commands
/is setwarp <name> /island setwarp
Island Owner

Registers your current position as a named island waypoint. Up to 3 waypoints can be active at once. Right-clicking the Guest Book (Enchanting Table) provides fast-travel access to all registered waypoints.

/is delwarp <name>
Island Owner

Removes a registered waypoint by name.

/is warps
Player

Lists all registered waypoints on your island with their coordinates and names.

/is warp <name>
Player

Teleports you instantly to one of your island's registered waypoints by name.

/is sethome
Island Owner

Moves your island's spawn point to your current location. All future /is home teleports will arrive here.

⛏️

Cobblestone Generator

2 commands
/is gen /island gen
Player

Opens the Generator GUI showing the current island Generator Level, XP progress bar, XP required for the next level, and the full ore probability table for the current level.

/is gen info [level]
Player

Displays the ore probability table for a specific generator level (or your current level if omitted) without opening a GUI.

📋

Quests (The Clerk)

3 commands
/quests /quest /q
Player

Opens your personal quest journal: active quests with progress bars, completed quest history, and available quests from your island's Clerk. Equivalent to clicking the Clerk NPC.

/quests active
Player

Displays a quick summary of your currently active quests and their progress in chat - useful while grinding without opening a GUI.

/quests abandon <quest-id>
Player

Abandons an active quest, freeing one of your three quest slots. Progress is permanently lost and the slot becomes available immediately.

📦

Storage & Automation

2 commands
/is compact [on|off] /island compact
Player

Toggles the personal material compactor. While active, Redstone, Iron, Gold, Lapis, Diamond, Emerald, and Coal are instantly compressed into block form the moment a full stack of 64 is reached in your inventory. Pass on or off to set explicitly.

/is sort
Island Owner / Co-Op

Sorts the inventory of the chest you are currently looking at, if the chest's GUI is not already open. Useful as a shortcut when farming quickly.

🏆

Trophy Hall

3 commands
/is trophies [player] /island trophies
Player

Lists all achievement trophies owned by you (or another player) - both displayed on the island and held in inventory - with their tier, rarity, and value.

/is rank [player] /island rank
Player

Displays the current server leaderboard ranking of your island (or another player's island) based on total trophy value currently placed and displayed.

/leaderboard [page] /lb /top
Player

Displays the full server-wide island leaderboard ranked by total active trophy value. Paginated - each page shows 10 entries.

🔑

Admin Commands

7 commands
/wosblock reload /wos reload
wosblock.admin

Hot-reloads all configuration files (config.yml, generators.yml, quests.yml, loot-tables.yml) without restarting the server. Does not reset active player sessions.

/wosblock version
wosblock.admin

Prints the currently running WoSBlock plugin version, build date, and storage backend in use (Flat-file or MySQL).

/wosblock setlevel <player> <level>
wosblock.admin

Forcibly sets the generator level of a player's island to a specific value. Useful for testing ore probability tables without grinding.

/wosblock addxp <player> <amount>
wosblock.admin

Adds a specific amount of Generator XP to a player's island instance. Dispatched asynchronously; safe to use under heavy load.

/wosblock giveitem <player> <item-id> [amount]
wosblock.admin

Gives a player a custom WoSBlock item (scroll, enchantment book, trophy head, or NPC spawn egg) by its config item ID.

/wosblock clearisland <player>
wosblock.admin

Resets a player's island to the default starter schematic without deleting their data record. Prompts a confirmation step.

/wosblock inspect <player>
wosblock.admin

Prints a full diagnostic summary for a player's island: owner, members, mode, generator level, active quests, and all registered waypoints.

Permission Levels

Player Any player with island access.
Island Owner Only the island's original creator.
Island Owner / Co-Op Owner and all trusted Co-Op members.
wosblock.admin Operators and users with the admin node.