Commands & Permissions

Complete reference for all SteadfastVillagers commands and permissions.

Player Commands

/sv, /steadfastvillagers

steadfastvillagers.use

Main plugin command for players. Shows plugin information and version.

/sv
/steadfastvillagers
/sfvillagers
/svillagers
/villagerblocks
/vb

Admin Commands

/svadmin

steadfastvillagers.admin

Admin command for server management.

/svadmin <subcommand> [arguments]

/svadmin inspect

steadfastvillagers.admin

View detailed information about a villager block.

/svadmin inspect           # Inspect block you're looking at
/svadmin inspect <id>      # Inspect by database ID

Output includes:

  • Block ID and location
  • Owner UUID and name
  • Profession and villager type
  • Current level and XP
  • Trade count and active trade
  • Discount percentage
  • Buffer contents summary
  • Display entity UUIDs

/svadmin list

steadfastvillagers.admin

List all villager blocks on the server.

/svadmin list              # List all blocks
/svadmin list <player>     # Filter by owner
/svadmin list <world>      # Filter by world

Output: Table showing ID, location, owner, and profession for each block.

/svadmin repair

steadfastvillagers.admin

Respawn display entities for a villager block.

/svadmin repair            # Repair block you're looking at
/svadmin repair <id>       # Repair by database ID

Use when: The villager head display entity is missing but the block still functions.

/svadmin repair-corrupted

steadfastvillagers.admin

Find and remove blocks with corrupted data.

/svadmin repair-corrupted

Use when: Database entries exist but have invalid/corrupted trade data. Prompts for confirmation before deletion.

/svadmin restock

steadfastvillagers.admin

Force immediate restock of all trades on a block.

/svadmin restock           # Restock block you're looking at
/svadmin restock <id>      # Restock by database ID

Note: Only affects VANILLA lock-mode blocks. INFINITE mode blocks don't have stock limits.

/svadmin clearbuffers

steadfastvillagers.admin

Clear items from input and/or output buffers.

/svadmin clearbuffers                    # Clear both buffers (looking at block)
/svadmin clearbuffers <id>               # Clear both buffers by ID
/svadmin clearbuffers <id> input         # Clear only input buffer
/svadmin clearbuffers <id> output        # Clear only output buffer
/svadmin clearbuffers <id> all           # Clear both buffers
Warning: Items are permanently deleted. Consider using /svadmin export first.

/svadmin export

steadfastvillagers.admin

Export block data to a JSON file for backup or debugging.

/svadmin export            # Export block you're looking at
/svadmin export <id>       # Export by database ID

Output: Creates plugins/SteadfastVillagers/exports/block_<id>_<timestamp>.json

Exported data includes:

  • Block metadata (location, owner, profession)
  • All trade data with ingredients and results
  • Buffer contents (serialized items)
  • XP and discount values

/svadmin transfer

steadfastvillagers.admin

Transfer ownership of a villager block to another player.

/svadmin transfer <player>           # Transfer block you're looking at
/svadmin transfer <player> <id>      # Transfer by database ID

Effects:

  • New owner can unconvert the block
  • New owner has full GUI access
  • GriefPrevention permissions still apply separately

/svadmin delete

steadfastvillagers.admin

Permanently delete a villager block from the database.

/svadmin delete            # Delete block you're looking at (requires confirm)
/svadmin delete <id>       # Delete by database ID (requires confirm)
/svadmin delete <id> confirm   # Skip confirmation
Warning: This is permanent. The villager is lost. Use /svadmin export first if needed.

/svadmin cleanup

steadfastvillagers.admin

Remove orphaned database entries (blocks that no longer exist in the world).

/svadmin cleanup           # Scan for orphaned entries (requires confirm)
/svadmin cleanup confirm   # Execute cleanup

Use when: After world resets, corruption, or manual world edits that removed blocks without updating the database.

/svadmin stats

steadfastvillagers.admin

Show server-wide statistics.

/svadmin stats

Output:

  • Total villager blocks on server
  • Blocks by profession
  • Blocks by world
  • Total trades completed
  • Total XP generated

/svadmin testvillager

steadfastvillagers.admin

Spawn a test villager with max-level trades for testing.

/svadmin testvillager <profession>

Example:

/svadmin testvillager librarian
/svadmin testvillager farmer

Spawns a Master-level villager with all trades unlocked at your location.

Permissions

Permission Nodes

Permission Default Description
steadfastvillagers.convert true Convert villagers to blocks
steadfastvillagers.use true Use villager blocks (open GUI, trade)
steadfastvillagers.admin op Access admin commands
steadfastvillagers.bypass op Bypass GriefPrevention claim checks

LuckPerms Examples

Grant conversion ability to a rank:

/lp group member permission set steadfastvillagers.convert true

Deny conversion (economy balance):

/lp group default permission set steadfastvillagers.convert false

Grant admin to staff:

/lp group admin permission set steadfastvillagers.admin true

Permission Inheritance

steadfastvillagers.admin
  +-- steadfastvillagers.bypass
  +-- steadfastvillagers.convert
  +-- steadfastvillagers.use

Granting admin does NOT automatically grant other permissions. Set them explicitly.

GUI Actions

These actions don't have commands but are available in the villager block GUI:

Trade Selection

Click any trade item to set it as the active trade for automation.

Input Buffer

  • Left-click: Open input buffer inventory
  • Shift+left-click: Take all items from input

Output Buffer

  • Left-click: Open output buffer inventory
  • Shift+left-click: Take all items from output

XP Collection

  • Left-click with empty hand: Collect XP as orbs
  • Left-click holding Mending item: Apply XP to repair item

Workstation Slot

Place the correct workstation block here to enable trade restocking (VANILLA mode).

Unconvert Button

Returns the block to a living villager. Owner only.

Stats Button

View trading statistics, discount info, and block details.

Console Commands

All /svadmin commands can be run from console:

svadmin list
svadmin stats
svadmin cleanup confirm
svadmin delete 42 confirm
Note: Commands that require "looking at a block" need an explicit ID when run from console.