Admin Commands

MC 1.21.1MC 1.21.2MC 1.21.4MC 1.21.5MC 1.21.6

Administrative commands provide server staff with tools to manage shares, monitor usage, and maintain the Showcase system.

Create Shares for Other Players

Command Syntax:/admin-showcase [type]

Create shares on behalf of other players using your current context:

Share Types Available:

item - Your held item (default if no type specified)
inventory - Your full inventory
hotbar - Your hotbar only
enderchest - Your ender chest contents
stats - Your player statistics

# Share your held item (default)
/admin-showcase
/admin-showcase item

# Share your inventory
/admin-showcase inventory

# Share your hotbar
/admin-showcase hotbar

# Share your ender chest
/admin-showcase enderchest

# Share your statistics
/admin-showcase stats

Educational Demonstrations:

# Prepare example items in your inventory, then:
/admin-showcase inventory
# Creates a public share of your inventory

# Hold an enchanted item, then:
/admin-showcase item
# Shares the item you're holding

Event Management:

# Hold a prize item, then:
/admin-showcase item
# Creates a public showcase of the prize

# Prepare contest items, then:
/admin-showcase hotbar
# Shows your prepared hotbar layout

Note: Admin shares use your current player state (items you're holding, your inventory, etc.) and create public shares for all players to view.

Required Permission:

Operator level 4 (server operator)
No specific permission nodes required

Admin Share Behavior:

Creates public shares (visible to all players)
Uses standard share duration from config
Bypasses your personal cooldowns
Uses your current player state (inventory, held items, etc.)

Limitations:

Cannot specify custom receivers, duration, or description
Cannot share other players' content directly
Must have the content to share in your own inventory/state

System Management

Configuration Management

Command Syntax:/showcase-manage reload

Reload configuration without server restart:

# Reload all configuration
/showcase-manage reload

What Gets Reloaded:

✅ Share durations and cooldowns
✅ Chat keyword settings
✅ Permission defaults
✅ Performance settings
❌ Database settings (requires restart)
❌ Language files (requires restart)

Required Permission: showcase.manage.reload (default: level 4)

Command Syntax:/showcase-manage list [page]

View all active shares:

# View first page of shares
/showcase-manage list

# View specific page
/showcase-manage list 2

Output Example:

Active Shares (Page 1/2):
[abc123] Steve | ITEM | Diamond Sword | 25m remaining
[def456] Alex | INVENTORY | Full Inventory | 1h 15m remaining
[ghi789] Sarah | STATS | Player Statistics | 45m remaining

Page 1 of 2 | Total: 8 shares

Required Permission: showcase.manage.list (default: level 4)

Cancel Shares

Command Syntax:/showcase-manage cancel <id|player>

Cancel specific shares or all shares by a player:

# Cancel specific share
/showcase-manage cancel abc123

Share ID Sources:

/showcase-manage list command
Share creation notifications (if enabled)
Server logs with debug enabled

Success Message:

Share abc123 cancelled successfully

# Cancel all shares by a player
/showcase-manage cancel Steve

Success Message:

Cancelled 3 shares by Steve

Use Cases:

Player leaving server
Resolving sharing conflicts
Moderation actions

Required Permission: showcase.manage.cancel (default: level 4)

About Information

Command Syntax:/showcase-manage about

Display detailed mod information:

/showcase-manage about

Output Example:

=== Showcase Mod About ===
Mod ID: showcase
Name: Showcase
Author: jiazengp
Version: 2.3.1+mc1.21.6
Source Code: github.com/jiazengp/showcase-fabric
Issues: github.com/jiazengp/showcase-fabric/issues
Homepage (CN): showcase.example.com
License: MIT
===========================

Required Permission: showcase.manage.about (default: none - available to all players)

Permission Management

Administrative Permissions

showcase.manage.reload

Reload configuration files

showcase.manage.list

View all active shares

showcase.manage.cancel

Cancel any player's shares

showcase.manage.about

View mod information (default: available to all)

Permission Setup Examples

# Give moderators basic management permissions
/lp group moderator permission set showcase.manage.list true
/lp group moderator permission set showcase.manage.cancel true

# Give admins full management access
/lp group admin permission set showcase.manage.reload true
/lp group admin permission set showcase.manage.list true
/lp group admin permission set showcase.manage.cancel true

# Admin showcase requires operator level 4 (no specific permission)
/op YourAdminName

Best Practices for Administrators

Regular Maintenance

Daily Checks: Use /showcase-manage list to monitor active shares and system usage.

Daily Tasks:

# Check active shares
/showcase-manage list

# Review system information
/showcase-manage about

Weekly Tasks:

# Reload configuration after updates
/showcase-manage reload

# Backup configuration files
# (Outside of game - backup config/showcase/config.yml)

Monitoring Guidelines

Active Share Management:

Monitor share count trends with /showcase-manage list
Look for unusually long-running shares
Check for abandoned shares from offline players

Configuration Management:

Test config changes with /showcase-manage reload
Monitor server logs for configuration errors
Keep backup copies of working configurations

Security Considerations

Access Control:

Limit management permissions to trusted staff only
Use specific permissions rather than full operator access
Regularly audit permission assignments

Share Moderation:

Monitor shares for inappropriate content
Use /showcase-manage cancel for problematic shares
Check sharing patterns for potential abuse

Troubleshooting

Common Issues

Config reload fails: Check server logs for syntax errors in configuration files.

Solutions:

Verify YAML syntax in config files
Check file permissions
Restart server if reload continues to fail

Cannot cancel shares: Verify you have the correct permission level.

Solutions:

Check permission with /lp user <your-name> permission check showcase.manage.cancel
Verify share ID exists with /showcase-manage list
Ensure player name is spelled correctly

Emergency Procedures

Server Performance Issues:

# 1. Check active share count
/showcase-manage list

# 2. Cancel problematic shares if needed
/showcase-manage cancel ProblematicPlayer

# 3. Reload config with reduced limits
/showcase-manage reload

Admin Commands

Admin Commands

Create Shares for Other Players

System Management

Configuration Management

Cancel Shares

About Information

Permission Management

Administrative Permissions

Permission Setup Examples

Best Practices for Administrators

Regular Maintenance

Monitoring Guidelines

Security Considerations

Troubleshooting

Common Issues

Emergency Procedures

Related Topics

On this page