为物品添加各种交互触发功能,创建可交互的道具,适用于地图制作和自定义游戏机制。
右键执行命令组件
组件名称
xdp_rightclick_function
使用方法
/give @s paper[xdp_rightclick_function="命令"]
右键获得钻石
/give @s paper[xdp_rightclick_function="/give @s diamond"]
右键执行函数
/give @s paper[xdp_rightclick_function="/function namespace:test"]
右键传送
/give @s compass[xdp_rightclick_function="/tp @s 0 100 0"]
左键执行命令组件
组件名称
xdp_leftclick_function
使用方法
/give @s sword[xdp_leftclick_function="命令"]
左键攻击时播放音效
/give @s iron_sword[xdp_leftclick_function="/playsound
entity.lightning_bolt.thunder player @s"]
左键时给予效果
/give @s stick[xdp_leftclick_function="/effect give @s strength 10 1"]
丢弃执行命令组件
使用方法
/give @s item[xdp_drop_function="命令"]
丢弃时爆炸
/give @s tnt[xdp_drop_function="/summon creeper ~ ~ ~ {Fuse:0}"]
丢弃时发送消息
/give @s paper[xdp_drop_function="/say 有人丢弃了重要物品!"]
拾取执行命令组件
使用方法
/give @s item[xdp_pickup_function="命令"]
拾取时治疗
/give @s apple[xdp_pickup_function="/effect give @s instant_health 1 1"]
拾取时传送
/give @s ender_pearl[xdp_pickup_function="/tp @s 0 100 0"]
功能特点
- 支持任意有效的 Minecraft 命令
- 以玩家身份执行命令
- 可以组合使用多个组件
- 适用于地图制作和自定义游戏机制
- 省去复杂的计分板检测步骤
通过客户端本地开关,控制各种界面元素的显示状态。
Wiki详情
游戏效果
指令确认弹窗开关
设置开关
/xdp:screen CommandConfirmationScreen <true/false>
查看当前状态
/xdp:screen CommandConfirmationScreen
使用场景:创建可点击的命令文本,当设置为 false 时,点击文本后将直接执行命令,无需确认弹窗。
/tellraw @a
[{"text":"[测试]","color":"green","bold":true,"click_event":{action:run_command,command:"/function
namespace:test"},"hover_event":{action:"show_text",value:{text:"点击"}}}]
HUD元素显示控制
可控制的HUD元素:
| 元素名称 |
说明 |
| Hotbar.HealthBar.FoodBar.ArmorBar.Experience |
快捷栏、生命值、饥饿值、盔甲值、经验条组合 |
| Hotbar |
仅快捷栏物品 |
| Title.Subtitle |
标题和副标题组合 |
| SelectedItemName |
选中物品名称 |
| VehicleHealth |
载具生命值 |
| PotionEffects |
药水效果 |
| ActionBar |
动作栏 |
| Crosshair |
准星 |
| DebugInfo |
调试信息(F3) |
| Chat |
聊天 |
| PlayerList |
玩家列表 |
设置命令
/xdp:screen HudDisplay <元素名称> <targets> <true/false>
查看状态
/xdp:screen HudDisplay <元素名称>
常用示例
隐藏整个底部HUD
/xdp:screen HudDisplay Hotbar.HealthBar.FoodBar.ArmorBar.Experience
<targets> false
单独隐藏快捷栏物品
/xdp:screen HudDisplay Hotbar <targets> false
隐藏准星
/xdp:screen HudDisplay Crosshair <targets> false
隐藏聊天
/xdp:screen HudDisplay Chat <targets> false
权限要求:需要OP权限(权限等级2)
提供权限等级更低的踢出命令,可在命令方块和数据包中使用。
命令格式
/xdp:kick <targets> [<reason>]
权限对比
- 原版 kick 命令:权限等级 3(仅OP可用)
- xdp:kick 命令:权限等级 1(可在命令方块和数据包中使用)
参数说明
- targets - 指定要踢出的玩家(玩家名、目标选择器或UUID)
- reason - 可选,踢出原因(若未指定则使用默认消息)
示例
带原因踢出
/xdp:kick Steve 违反服务器规则
批量踢出
/xdp:kick @a[tag=banned] 已被封禁
完全替换原版死亡消息,支持 JSON 格式的富文本消息。
设置消息
/xdp:config deathmessage set <消息>
重置消息
/xdp:config deathmessage reset
支持格式
纯文本格式
/xdp:config deathmessage set "不幸身亡"
JSON 格式
/xdp:config deathmessage set {"text":"死得很惨","color":"red","bold":true}
效果对比
- 原版消息:XD_ON被杀死了
- 自定义消息:XD_ON不幸身亡
更多示例
简单文本
/xdp:config deathmessage set "不幸身亡"
富文本
/xdp:config deathmessage set {"text":"被彻底消灭了","color":"red","bold":true}
重置为默认
/xdp:config deathmessage reset
自定义成就获得时的提示文本,替换默认的"取得了进度"消息。
设置消息
/xdp:config advancementmessages set <消息>
查看设置
/xdp:config advancementmessages list
重置消息
/xdp:config advancementmessages reset
支持格式
纯文本格式
/xdp:config advancementmessages set "完成了成就"
JSON 格式
/xdp:config advancementmessages set
{"text":"获得了新成就","color":"gold","bold":true}
效果对比
- 原版消息:XD_ON 取得了进度 [获得木头]
- 自定义消息:XD_ON 完成了成就 [获得木头]
更多示例
简单文本
/xdp:config advancementmessages set "达成了里程碑"
富文本
/xdp:config advancementmessages set
{"text":"解锁了新成就","color":"yellow","italic":true}
查看当前设置
/xdp:config advancementmessages list
重置为默认
/xdp:config advancementmessages reset
XDonPlugins的发展路线图和即将到来的重要变化
即将到来的变化
- Minecraft 26.1: 首个非混淆版本支持
- 映射迁移: 计划迁移到 Mojang Mappings
- 更快更新: 非混淆版本将使更新更加迅速
功能开发
此模组将持续开发各种实用功能,会添加更多提升 Minecraft 资源制作和游戏体验的功能。
- 更多自定义物品组件
- 增强的界面控制功能
- 更丰富的命令工具
- 性能优化和稳定性提升