Showcase

A server-side mod that allows players to share links in chat to showcase items, inventories, containers, villager trades, and statistics through commands or chat keywords.

2,72k

Quick challenge

How far can you run before the mobs catch you?

Showcase

Showcase Mod

> The current description is for V2. For V1, please click here.

A server-side Minecraft mod that allows players to share links in chat to showcase items, inventories, containers, villager trades, and statistics through commands or chat keywords.

📖 Complete Documentation

✨ Features

- Chat Item Icons: Items, inventories, containers, and villager trades - Chat Item Icons: No client installation required - Chat Item Icons: Auto-unpack containers, view books and maps - Chat Item Icons: Support for 17+ languages - Chat Item Icons: Shares saved until expiration - Chat Item Icons: LuckPerms integration - Chat Item Icons: Customizable trigger words for quick sharing - Chat Item Icons: Player statistics with detailed categorization - Chat Item Icons: PlaceholderAPI integration for other plugins - Chat Item Icons: Customizable item icons in chat messages (Experimental)

About Chat Item Icons (Experimental)

Displays item icons in chat messages for shared items.

Why Resource Pack? As a server-side mod, we use Minecraft's custom font system to render icons.

Setup: 1. Generate resource pack at Setup 2. Host the pack on a web server 3. Enable in `config/showcase/config.yml`: `itemIcons.enabled = true` 4. Add to `server.properties`: ```properties resource-pack=<your-hosted-pack-url> resource-pack-sha1=<pack-sha1-hash> require-resource-pack=true ```

Config Options: ```yaml itemIcons: enabled: false # Enable/disable icons fontNamespace: "iconifycraft" # Resource pack namespace includeInItemNames: true # Show icons in item names ```

⚠Warning: Experimental feature. Current support for displaying blocks, including chests and ender chests, is incomplete.

⌨️ Commands

> 💡 View detailed command reference with examples and permissions

Player Commands

``` /showcase <type> [player] [duration] [description] ``` Types: `item`, `inventory`, `hotbar`, `enderchest`, `container`, `merchant`, `stats`

Duration formats: `30s`, `5m`, `1h`, `1h30m` or raw seconds (e.g. `300`)

Other Commands: - `/showcase cancel <id>` - Cancel your share - `/showcase-view <id>` - View shared content

Admin Commands

``` /admin-showcase <type> <player> [receiver] [duration] [description] /showcase-manage <action> [args] ```

Actions: `reload`, `list [page]`, `cancel <id|player>`

Chat Keywords

Players can type keywords in square brackets to quickly share content:

Default Keywords (configurable in `config.yml`): - `[item]` or `[i]` - Share held item - `[inventory]` or `[inv]` - Share inventory - `[hotbar]` or `[hb]` - Share hotbar - `[ender_chest]` or `[ec]` - Share ender chest - `[stats]` or `[stat]` - Share statistics

Example: `Check out my [item]!` → automatically replaced with clickable share link

🔌 Developer API

> 🔗 Full API Documentation - Integration guides and examples

PlaceholdersAPI Integration

Basic Sharing: ``` %showcase:item% - Share held item %showcase:inventory% - Share inventory %showcase:hotbar% - Share hotbar %showcase:ender_chest% - Share ender chest %showcase:stats% - Share statistics ```

Essential Statistics: ``` %showcase:shares_count% - Number of active shares %showcase:total_views% - Total views received %showcase:can_share_item% - Permission check (true/false) %showcase:has_admin_perms% - Admin check (true/false) ```

📚 View all placeholders

⚙️ Configuration

> ⚙️ Configuration Reference - Complete settings guide

Main configuration file: `config/showcase/config.yml` (YAML format)

Key Settings: - Share cooldowns and permissions - Chat keywords and triggers - Statistics tracking options - Performance optimization - Multi-language support

📖 View example config | 🔐 Permission setup