
显示我的物品
在聊天中优雅地展示你持有的物品、物品栏或末影箱——让分享更轻松!
查看大图Show My Item
在聊天中优雅地展示你的主手物品、背包或末影箱 —— 让分享更简单!
浏览文档 »
查看 Modrinth 页面
·
查看 GitHub 页面
·
报告 Bug
·
请求新功能
关于本项目
![]()
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 (>=0.119.4)
- Java 21
(返回顶部)
快速开始
要在你的服务器(或单人游戏中)使用本模组,请按以下步骤操作。
前置条件
- Minecraft 1.21.4 服务器或客户端(单人游戏时)。
- Fabric Loader 0.16.9 或更高版本。
- Fabric API(服务端必需;客户端非必需,但安装了也无妨)。
安装
下载模组
从 Modrinth 或 GitHub Releases 下载最新的 JAR 文件。放置模组
将 JAR 文件放入服务器的mods文件夹。
单人游戏时,也需将其放入客户端的mods文件夹(它将在集成服务器上运行)。启动游戏/服务器
无需额外配置 —— 模组会自动生效,并在config/showmyitem.json创建配置文件。
(返回顶部)
使用方法
占位符
本模组支持以下可直接在聊天中使用的占位符(这些是英文版占位符;中文占位符请参阅中文文档):
| 占位符 | 描述 |
|---|---|
[item] |
主手物品 |
[offhand] |
副手物品 |
[inventory] |
分享你的整个背包(包括盔甲和副手);生成可点击链接 |
[enderchest] |
分享你的末影箱;生成可点击链接 |
[!NOTE] 占位符与服务器语言无关。你可以在任何语言环境中使用这些英文占位符。如果你更喜欢中文,也可以使用中文等价物
[物品]、[副手]、[背包]、[末影箱]。
基本用法
- 确保你正手持物品。
- 输入包含占位符的消息,例如:
Check this out! [item] My inventory: [inventory] My ender chest: [enderchest] - 发送后,占位符将被替换为物品名称或可点击链接。
- 其他玩家可将鼠标悬停在物品名称上查看提示框,或点击
[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。别忘了给项目点个星!再次感谢!
- Fork 本项目
- 创建你的功能分支(
git checkout -b feature/AmazingFeature) - 提交你的更改(
git commit -m 'Add some AmazingFeature') - 推送分支(
git push origin feature/AmazingFeature) - 发起 Pull Request
(返回顶部)
构建
- 运行
./gradlew build构建模组。 - 重映射后的 jar 位于
build/libs/。 - 开发用 jar 位于
build/devlibs/(不用于分发)。
许可证
基于 MIT 许可证分发。详情请参阅 LICENSE。
(返回顶部)
联系方式
项目链接:https://github.com/PhantomPixel-0418/ShowMyItem
(返回顶部)
致谢
本 README 模板灵感来自:
(返回顶部)
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。