显示我的物品

显示我的物品

在聊天中优雅地展示你持有的物品、物品栏或末影箱——让分享更轻松!

管理

Logo

Show My Item

在聊天中优雅地展示你的主手物品、背包或末影箱 —— 让分享更简单!
浏览文档 »

查看 Modrinth 页面 · 查看 GitHub 页面 · 报告 Bug · 请求新功能

目录
  1. 关于本项目
  2. 快速开始
  3. 使用方法
  4. 配置
  5. 路线图
  6. 贡献
  7. 许可证
  8. 联系方式
  9. 致谢

关于本项目

Show My Item 截图

Show My Item 是一个面向服务器的轻量级 Minecraft Fabric 模组。它允许玩家使用 [item]、[inventory] 或 [enderchest] 等简单占位符在聊天中分享自己的主手物品、整个背包或末影箱。其他玩家可以将鼠标悬停在物品名称上查看完整提示框,或点击链接查看共享物品栏的只读容器视图。

它解决了什么问题?

  • 无需再手动输入复杂的物品名称,或让朋友猜测你手里拿的是什么。
  • 无需复杂指令即可即时分享你的背包或末影箱。
  • 悬停查看详情,点击查看完整物品栏 —— 交流变得直观且可视化。
  • 纯粹用于分享和展示,不包含作弊或破坏游戏平衡的元素。

为什么选择它?

  • 简单:自然语言占位符,同时支持英文和中文。
  • 强大:支持主手、副手、背包(包括盔甲和副手)以及末影箱。
  • 可配置:类 Carpet 的聊天菜单,可随时调整过期时间、最大快照数和语言。
  • 轻量:仅需服务端安装;客户端无需安装该模组。
  • 兼容:基于 Fabric API 构建,兼容大多数模组。

当然,没有模组能满足所有人。如果你有任何建议,欢迎提交 Issue 或 Pull Request。

(返回顶部)

技术栈

(返回顶部)

快速开始

要在你的服务器(或单人游戏中)使用本模组,请按以下步骤操作。

前置条件

  • Minecraft 1.21.4 服务器或客户端(单人游戏时)。
  • Fabric Loader 0.16.9 或更高版本。
  • Fabric API(服务端必需;客户端非必需,但安装了也无妨)。

安装

  1. 下载模组
    从 Modrinth 或 GitHub Releases 下载最新的 JAR 文件。

  2. 放置模组
    将 JAR 文件放入服务器的 mods 文件夹。
    单人游戏时,也需将其放入客户端的 mods 文件夹(它将在集成服务器上运行)。

  3. 启动游戏/服务器
    无需额外配置 —— 模组会自动生效,并在 config/showmyitem.json 创建配置文件。

(返回顶部)

使用方法

占位符

本模组支持以下可直接在聊天中使用的占位符(这些是英文版占位符;中文占位符请参阅中文文档):

占位符 描述
[item] 主手物品
[offhand] 副手物品
[inventory] 分享你的整个背包(包括盔甲和副手);生成可点击链接
[enderchest] 分享你的末影箱;生成可点击链接

[!NOTE] 占位符与服务器语言无关。你可以在任何语言环境中使用这些英文占位符。如果你更喜欢中文,也可以使用中文等价物 [物品]、[副手]、[背包]、[末影箱]。

基本用法

  1. 确保你正手持物品。
  2. 输入包含占位符的消息,例如:
    Check this out! [item]
    My inventory: [inventory]
    My ender chest: [enderchest]
    
  3. 发送后,占位符将被替换为物品名称或可点击链接。
  4. 其他玩家可将鼠标悬停在物品名称上查看提示框,或点击 [Player's Inventory] / [Player's Ender Chest] 打开只读视图。

交互细节

  • 悬停:将鼠标悬停在物品名称上会显示其完整提示框(附魔、耐久度、自定义名称等)。
  • 点击背包/末影箱链接:打开一个安全、只读的容器,显示目标玩家的主背包、盔甲、副手或末影箱。物品无法移动或取出,防止物品复制漏洞。
  • 权限:只有快照创建者或 OP 才能打开链接;其他玩家会收到错误消息。

(返回顶部)

配置

本模组提供了一个类 Carpet 的聊天菜单,可通过 /showmyitem 命令访问。

命令

命令 描述 权限
/showmyitem 显示所有设置和版本信息 所有人
/showmyitem category <category> 显示某个分类下的设置 所有人
/showmyitem find <query> 模糊搜索设置 所有人
/showmyitem viewinv <snapshotID> 查看背包快照 创建者或 OP
/showmyitem viewender <snapshotID> 查看末影箱快照 创建者或 OP
/showmyitem set <key> <value> 修改配置项 OP(等级 2)
/showmyitem reloadconfig 从文件重新加载配置 OP(等级 2)

配置选项

配置文件位于 config/showmyitem.json。你可以直接编辑它,或在游戏内通过菜单/命令修改数值:

  • snapshotExpiryMs:快照过期时间,单位毫秒(默认 300000 = 5 分钟)。
  • maxSnapshots:同时存储的最大快照数量(默认 100)。
  • defaultLanguage:服务器默认语言,可选 en_us 或 zh_cn。

编辑后,使用 /showmyitem reloadconfig 应用更改,无需重启。

(返回顶部)

路线图

  • 主手物品展示([item])
  • 副手物品展示([offhand])
  • 背包分享,含盔甲和副手([背包] / [inventory])
  • 末影箱分享([末影箱] / [enderchest])
  • 仅服务端架构
  • 多语言支持(英文 / 中文),自动识别占位符
  • 类 Carpet 的可点击设置配置菜单
  • 配置热重载
  • 安全的只读容器,防止物品复制
  • 分享更多信息:生命值、饥饿值等
  • 分享准星对应的方块/实体
  • 更多语言支持

查看 open issues 获取完整的功能请求和已知问题列表。

(返回顶部)

贡献

贡献正是让开源社区如此精彩、充满学习、启发与创造的原因。我们非常感谢你的任何贡献。

如果你有让它变得更好的建议,请 Fork 仓库并创建 Pull Request。你也可以直接提交带有 "enhancement" 标签的 Issue。别忘了给项目点个星!再次感谢!

  1. Fork 本项目
  2. 创建你的功能分支(git checkout -b feature/AmazingFeature)
  3. 提交你的更改(git commit -m 'Add some AmazingFeature')
  4. 推送分支(git push origin feature/AmazingFeature)
  5. 发起 Pull Request

(返回顶部)

构建

  • 运行 ./gradlew build 构建模组。
  • 重映射后的 jar 位于 build/libs/。
  • 开发用 jar 位于 build/devlibs/(不用于分发)。

许可证

基于 MIT 许可证分发。详情请参阅 LICENSE。

(返回顶部)

联系方式

项目链接:https://github.com/PhantomPixel-0418/ShowMyItem

(返回顶部)

致谢

本 README 模板灵感来自:

(返回顶部)