展示聊天

展示聊天

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

Showcase Mod

当前描述针对 V2 版本。如需 V1 版本，请点击此处。

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

📖 完整文档

✨ 功能

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

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

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

设置步骤：

  1. 在 IconifyCraft 生成资源包
  2. 将资源包托管到网页服务器
  3. 在 config/showcase/config.yml 中启用：itemIcons.enabled = true
  4. 添加到 server.properties：
   resource-pack=<你的托管资源包 URL>
   resource-pack-sha1=<资源包 SHA1 哈希>
   require-resource-pack=true

配置选项：

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

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

⌨️ 命令

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

玩家命令

/showcase <类型> [玩家] [持续时间] [描述]

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

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

其他命令：

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

管理员命令

/admin-showcase <类型> <玩家> [接收者] [持续时间] [描述]
/showcase-manage <操作> [参数]

操作：reload、list [页码]、cancel <id|玩家>

聊天关键词

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

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

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

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

🔌 开发者 API

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

PlaceholdersAPI 集成

基础分享：

%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