Initial Configuration

MC 1.21.1MC 1.21.2MC 1.21.4MC 1.21.5MC 1.21.6

Configure Showcase for your server's needs with essential settings only.

First Startup

When Showcase starts, it automatically:

Creates config/showcase/config.yml with default settings
Sets up data storage directories
Initializes with safe defaults for all server sizes

First Boot: Look for "Showcase mod loaded successfully" in console.

Essential Settings

Basic Configuration

config/showcase/config.yml

general:
  defaultDuration: 1800        # 30 minutes default
  maxDuration: 7200           # 2 hours maximum
  maxSharesPerPlayer: 5       # Active shares per player

shares:
  item:
    enabled: true
    cooldown: 5               # 5 seconds between item shares
  inventory:
    enabled: true
    cooldown: 30              # 30 seconds for inventory
  hotbar:
    enabled: true
    cooldown: 15
  container:
    enabled: true
    cooldown: 10

chatKeywords:
  enabled: true
  aliases:
    item: ["i"]
    inventory: ["inv"]
    hotbar: ["hb", "hot"]

Server Size Adjustments

Small Server (5-20 players):

general:
  maxSharesPerPlayer: 10      # More generous limits
shares:
  item:
    cooldown: 3               # Shorter cooldowns

Large Server (100+ players):

general:
  maxSharesPerPlayer: 3       # Stricter limits
shares:
  item:
    cooldown: 10              # Longer cooldowns

Permission Setup

With LuckPerms

Give basic permissions to all players:

/lp group default permission set showcase.command.item true
/lp group default permission set showcase.command.hotbar true
/lp group default permission set showcase.chat.item true

Without LuckPerms

Showcase uses Minecraft's operator permissions by default.

Testing Your Setup

Reload config: /showcase-manage reload
Test sharing: Hold an item and run /showcase item
Test keywords: Type Check my [item]! in chat

Keep It Simple: Default settings work well for most servers. Only adjust if you experience issues.

Common Adjustments

Disable unused features:

shares:
  container:
    enabled: false    # If players don't use containers
  stats:
    enabled: false    # If statistics aren't needed

Adjust cooldowns for your server type:

Creative servers: Lower cooldowns (3-5 seconds)
Survival servers: Standard cooldowns (5-15 seconds)
PvP servers: Higher cooldowns (15-30 seconds)

Next Steps

Permissions Setup - Detailed permissions
Commands Reference - Available commands
Troubleshooting - Common issues

Initial Configuration

On this page