Showcase

Showcase

一个服务端模组，允许玩家在聊天中分享链接，通过命令或聊天关键词展示物品、背包、容器、村民交易和统计数据。

管理

Showcase预览查看大图

Showcase Mod

当前描述适用于 V2。如需 V1，请点击此处。

一个服务端 Minecraft 模组，允许玩家在聊天中分享链接，通过命令或聊天关键词展示物品、背包、容器、村民交易和统计数据。

📖 完整文档

✨ 功能特性

  • 全面分享：物品、背包、容器和村民交易
  • 仅服务端：无需客户端安装
  • 交互式预览：自动解包容器，查看书本和地图
  • 多语言：支持 17 种以上语言
  • 持久化存储：分享保存至过期
  • 权限系统：集成 LuckPerms
  • 可配置聊天关键词：自定义触发词以实现快速分享
  • 统计追踪：玩家统计数据，带有详细分类
  • 开发者占位符：为其他插件提供 PlaceholderAPI 集成
  • 聊天物品图标：聊天消息中可自定义物品图标（实验性）
关于聊天物品图标（实验性）

在聊天消息中显示分享物品的物品图标。

为什么需要资源包？ 作为服务端模组，我们使用 Minecraft 的自定义字体系统来渲染图标。

设置步骤：

  1. 在 IconifyCraft 生成资源包
  2. 将资源包托管在 Web 服务器上
  3. 在 config/showcase/config.yml 中启用：itemIcons.enabled = true
  4. 添加到 server.properties：
    resource-pack=<your-hosted-pack-url>
resource-pack-sha1=<pack-sha1-hash>
require-resource-pack=true

配置选项：

itemIcons:
  enabled: false                    # 启用/禁用图标
  fontNamespace: "iconifycraft"     # 资源包命名空间
  includeInItemNames: true          # 在物品名称中显示图标

⚠警告：实验性功能。当前对显示方块（包括箱子和末影箱）的支持尚不完整。

⌨️ 命令

💡 查看详细命令参考，包含示例和权限说明

玩家命令

/showcase <type> [player] [duration] [description]

类型：item、inventory、hotbar、enderchest、container、merchant、stats

时长格式：30s、5m、1h、1h30m 或原始秒数（例如 300）

其他命令：

  • /showcase cancel <id> - 取消你的分享
  • /showcase-view <id> - 查看分享内容

管理员命令

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

操作：reload、list [page]、cancel <id|player>

聊天关键词

玩家可以在方括号中输入关键词以快速分享内容：

默认关键词（可在 config.yml 中配置）：

  • [item] 或 [i] - 分享手持物品
  • [inventory] 或 [inv] - 分享背包
  • [hotbar] 或 [hb] - 分享快捷栏
  • [ender_chest] 或 [ec] - 分享末影箱
  • [stats] 或 [stat] - 分享统计数据

示例：Check out my [item]! → 自动替换为可点击的分享链接

🔌 开发者 API

🔗 完整 API 文档 - 集成指南和示例

PlaceholderAPI 集成

基本分享：

%showcase:item%        - 分享手持物品
%showcase:inventory%   - 分享背包
%showcase:hotbar%      - 分享快捷栏
%showcase:ender_chest% - 分享末影箱
%showcase:stats%       - 分享统计数据

常用统计：

%showcase:shares_count% - 活跃分享数量
%showcase:total_views%  - 收到的总查看次数
%showcase:can_share_item% - 权限检查（true/false）
%showcase:has_admin_perms% - 管理员检查（true/false）

📚 查看所有占位符

⚙️ 配置

⚙️ 配置参考 - 完整设置指南

主配置文件：config/showcase/config.yml（YAML 格式）

关键设置：

  • 分享冷却和权限
  • 聊天关键词和触发器
  • 统计追踪选项
  • 性能优化
  • 多语言支持

📖 查看配置示例 | 🔐 权限设置

📚 文档与资源

📝 许可证

MIT