- 作者: 淦 & 星梦XM (优化版)
- 版本: 1.1.3
手持物品提示插件 当玩家手持特定物品时，会在头顶显示彩色浮动提示消息，或在个人信息栏显示文本，并可自动执行预设命令。
- 支持在玩家头顶显示彩色浮动文本，或在信息栏中显示提示消息
- 支持自定义文本颜色，浮动文本支持Y轴位置偏移
- 每个物品可配置多条消息，随机显示
- 支持个人开关，玩家可控制是否显示（0=关闭，1=浮动文本，2=信息栏，3=全部）
- 手持特定物品时自动执行预设命令
- 支持组权限控制，不同玩家组执行不同命令
- 命令支持变量替换：
{player}（玩家名）、{item}（物品ID）、{x}（X坐标）、{y}（Y坐标）
- 手持切换冷却：防止玩家快速滚轮切换武器导致刷屏，切换物品后强制等待指定时间才能触发（默认1.5秒）
- 全局冷却时间可配置（浮动文本、信息栏、命令独立设置）
- 支持物品级自定义冷却时间覆盖全局设置
- 配置文件位置:
TShock/ItemHeldMessages.json
{
"全局设置": {
"启用浮动文本": true,
"启用信息栏文本": true,
"启用自动命令": true,
"手持切换冷却(秒)": 1.5,
"默认浮动文本冷却(秒)": 3.0,
"默认信息栏冷却(秒)": 2.0,
"默认命令冷却(秒)": 5.0,
"默认Y轴偏移(像素)": 50.0,
"冷却提示消息": "该{type}冷却中，请在{seconds:F1}秒后再试！",
"切换冷却提示": "切换过于频繁，请等待{seconds:F1}秒"
},
"物品配置": {
"29": {
"物品名称": "生命水晶",
"浮动消息列表": [
{
"文本": "关住星梦喵，关住星梦谢谢喵！",
"颜色": [0, 100, 255]
},
{
"文本": "生命水晶: 右键使用增加20点生命上限",
"颜色": [0, 200, 100]
}
],
"信息栏消息列表": [
{
"文本": "你将生命水晶贴近了你的耳朵，你听到了微弱的声音",
"颜色": [0, 255, 150]
},
{
"文本": "关住星梦喵，关住星梦谢谢喵！",
"颜色": [0, 255, 150]
}
],
"命令配置": {
"启用": true,
"命令": "/heal 20",
"允许的权限组": ["admin", "vip"],
"描述": "恢复20点生命值"
},
"自定义覆盖设置": {
"Y轴偏移": 60.0,
"浮动文本冷却": 5.0,
"信息栏冷却": 3.0,
"命令冷却": 10.0
}
},
"74": {
"物品名称": "铂金币",
"浮动消息列表": [
{
"文本": "铂金币: 价值连城！",
"颜色": [255, 215, 0]
}
],
"信息栏消息列表": [
{
"文本": "价值可是高达100个金币呢（）",
"颜色": [255, 223, 0]
}
],
"命令配置": {
"启用": true,
"命令": "/give {player} 74 1",
"允许的权限组": ["admin"],
"描述": "复制一个铂金币"
}
}
}
}
颜色使用 RGB 格式，每个值范围 0-255
- 红色: [255, 0, 0]
- 绿色: [0, 255, 0]
- 蓝色: [0, 0, 255]
- 黄色: [255, 255, 0]
- 白色: [255, 255, 255]
建议使用在线工具选择颜色：https://www.rapidtables.org/zh-CN/web/color/RGB_Color.html
| 命令 | 权限 | 描述 |
|---|---|---|
/ihm |
itemheldmsg.use |
显示帮助信息 |
/ihm mode |
itemheldmsg.use |
查看当前显示模式 |
/ihm mode <0-3> |
itemheldmsg.use |
设置显示模式 |
/ihm status |
itemheldmsg.use |
查看插件运行状态和个人设置 |
/ihm check <物品> |
itemheldmsg.use |
查看指定物品的配置信息 |
/ihm reload |
itemheldmsg.admin |
重新加载配置文件 |
| 命令 | 权限 | 描述 |
|---|---|---|
/reload |
itemheldmsg.admin |
标准重载命令，重载所有插件配置 |
- 又一次修复了配置文件生成滚木的问题
- 添加重载错误日志记录
感谢Tshock群群友1763596621的提出
- 修复了配置文件生成的问题
- 新增手持切换冷却机制，防止快速滚轮切枪刷屏
- 新增 切换冷却提示 配置项，支持自定义切换过于频繁时的提示文本
- 新增顺序执行模式：消息可按配置顺序循环显示
- 新增持续触发模式：持续手持时按间隔持续触发
- 支持物品级覆盖全局设置
- 优化冷却提示逻辑（持续模式下不刷屏）
- 新增信息栏文本显示功能（个人聊天栏）
- 支持独立的浮动文本和信息栏冷却时间以及冷却提示功能
- 玩家可使用
/ihm mode自由切换显示模式 - 简化命令系统，统一使用
/ihm命令
- 浮动文本显示系统
- 自动命令执行系统
- 组权限控制功能
- 冷却时间机制
- 确保TShock版本兼容，如有报错请检查配置、插件列表，随后在TShock官方群
816771079中联系星梦，并提交报错截图 - 有改进建议可在插件发布页面
https://github.com/ICU-Club提交Issue
开启你的创意之旅，打造独特的服务器体验！
文档最后更新: 2026年3月11日