- 版权类型
- 二次开发
- 插件中文名称
- 自定义玩家屏幕菜单
- 插件英文名称
- CustomScreenMenu
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 多语言
- 前置组件
- ProtocolLib
PlaceholderAPI
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
CustomScreenMenu 插件
注意本版本是spigot上面的开源免费版本一款支持高版本 Minecraft 使用的自定义玩家屏幕交互插件，可通过指令快速调用，适用于特殊场景下的屏幕点击交互（如玩家首次进入游戏时的专属起始菜单界面）。
（PS:如需兼容其他端和插件或有建议功能可添加作者qq：3357153117，开源将不会获得作者的支持和帮助）
开源地址：https://github.com/JSGDJD/CustomScreenMenu
点击链接加入群聊【熊式插件】
- 支持高版本 Minecraft 稳定运行
- 指令化操作，灵活控制屏幕交互流程
- 特殊场景适配（如玩家进入游戏时的起始菜单）
- 集成物品 3D 模型展示功能
- 可与其他插件联动扩展（如 ItemsAdder、betterhud）
- 文字样式旋转，上下移动，左右移动，多样化发展
/cursormenu stop 立即停止当前运行的屏幕菜单
/cursormenu items [item_name] 展示指定物品的 3D 模型
/cursormenu itemsstop 停止当前物品的 3D 模型展示
/cursormenu reload 重载插件配置文件（修改配置后需执行）
/cursormenu run [name] player 为指定玩家启动指定名称的屏幕菜单界面
%cursormenu_current_menu% – 当前打开的菜单名称
%cursormenu_selected_option% – 当前高亮的选项名称
%cursormenu_display_item_id% – 当前展示物品的 ID
%cursormenu_clicked_option% – 刚刚点击的文字布局组件键名
%cursormenu_is_attacking_or_breaking% – 检测当前玩家破坏或攻击的变量，true为是，false为否
%cursormenu_menu_world% – 菜单所在世界
%cursormenu_button_x% – 所选按钮的 X 坐标
%cursormenu_button_y% – 所选按钮的 Y 坐标
%cursormenu_button_z% – 所选按钮的 Z 坐标
结合 ItemsAdder 插件（自定义物品）与 betterhud 插件（HUD 界面优化），可实现：
- 物品的 3D 模型悬浮展示
- 更丰富的交互式物品信息面板设计
以下为插件实现效果视频介绍：
视频（视频菜单）
视频（3D模型展示）
视频（视频菜单2）
代码：
version: 1.2.9 # 不要修改
Debug: false
# 是否开启南瓜头
use-pumpkin-overlay: false
# 是否设置自定义的玩家结束菜单的朝向
exit-camera:
yaw: 0.0
pitch: 0.0
# 摄像机视角方块检测配置
camera-block-check:
enabled: true
radius: 1 # 以玩家为中心的检测半径（方块）
messages:
prefix: '&f[&eCustomScreenMenu&f] '
command_blocked: '&c固定视角下无法使用命令!'
sound:
name: music.menu
volume: 1
pitch: 1
# 循环音效
loop:
# 是否开启
enabled: true
# 每隔多少秒播放一次
duration: 30
# 加入游戏就执行菜单
join-run:
enabled: true
# 延迟多少秒执行
delay: 1
# 执行的菜单
menu: Inicio
commands:
- '[op] independenteffect open fullscreen #000000 20 20 20 jsgdjd'
cursor-item:
material: ARROW
custom-model-data: 0
scale: 0.5
# 最大3个X轴 已经为屏幕横向可容纳最大
max-x: 2
# 最大1.5个Y轴 已经为屏幕纵向可容纳最大
max-y: 3
x: 0.0 # X轴偏移
y: 0.0 # Y轴偏移
z-offset: 0.0 # 光标Z轴偏移量
menu:
Inicio:
# 打开整个 test 菜单所需的权限，不写则任何人可开
permission: cursormenu.menu.test
# 按钮所在的位置
camera-position:
# 与文字组件的距离
distance: 1.5
world: world
x: -275
y: 78
z: -51
yaw: 270 # 水平旋转角度 (0-360)
pitch: 0.0 # 垂直旋转角度 (-90到90)
layout:
# 文字组件1
layout1:
permission: cursormenu.button.test.layout1
name: Empezar
# 文字组件的x轴
x: 0
# 文字组件的y轴
y: 2
# 文字组件的z轴
z: 2.0
tilt:
x: 0.0 # 上下倾斜（俯仰）
y: 0.0 # 左右倾斜（偏航）
z: 0.0 # 前后倾斜（翻滚）
# 点击的执行命令
command:
- '[op] independenteffect open fullscreen #000000 20 20 20 jsgdjd'
- '[op] tw cinematic start 1_3 jsgdjd'
command-delay: 6 # 命令执行延迟（ticks）
next-menu:
enabled: false
menu: lobby
# 点击后是否结束菜单
stop-menu:
enabled: true
teleport:
enabled: false # 是否启用传送功能（默认 false）
back-original: false # 是否传回进入菜单前的原位置（true：原位置；false：自定义坐标）
world: world # 目标世界名（当 back-original 为 false 时生效）
x: 654.0 # 目标 X 坐标
y: 64.0 # 目标 Y 坐标
z: 0.0 # 目标 Z 坐标
test:
# 打开整个 test 菜单所需的权限，不写则任何人可开
permission: cursormenu.menu.test
# 按钮所在的位置
camera-position:
# 与文字组件的距离
distance: 1.5
world: world
x: 0
y: 2
z: 0
yaw: 0.0 # 水平旋转角度 (0-360)
pitch: 0.0 # 垂直旋转角度 (-90到90)
layout:
# 文字组件1
layout1:
permission: cursormenu.button.test.layout1
name: 开始游戏
# 文字组件的x轴
x: 0
# 文字组件的y轴
y: 0
# 文字组件的z轴
z: 0.0
tilt:
x: 0.0 # 上下倾斜（俯仰）
y: 0.0 # 左右倾斜（偏航）
z: 0.0 # 前后倾斜（翻滚）
# 点击的执行命令
command:
- '[player] say test'
- '[op] give %player% stone 1'
next-menu:
enabled: false
menu: lobby
# 点击后是否结束菜单
stop-menu:
enabled: false
teleport:
enabled: false # 是否启用传送功能（默认 false）
back-original: false # 是否传回进入菜单前的原位置（true：原位置；false：自定义坐标）
world: world # 目标世界名（当 back-original 为 false 时生效）
x: 0.0 # 目标 X 坐标
y: 64.0 # 目标 Y 坐标
z: 0.0 # 目标 Z 坐标
command-delay: 20
# 文字组件2
layout2:
name: 选项设置
x: 0
y: -1
z: 0.0
tilt:
x: 0.0 # 上下倾斜（俯仰）
y: 0.0 # 左右倾斜（偏航）
z: 0.0 # 前后倾斜（翻滚）
command:
- '[player] say test'
- '[op] give %player% stone 1'
next-menu:
enabled: false
menu: lobby
# 点击后是否结束菜单
stop-menu:
enabled: false
teleport:
enabled: false # 是否启用传送功能（默认 false）
back-original: false # 是否传回进入菜单前的原位置（true：原位置；false：自定义坐标）
world: world # 目标世界名（当 back-original 为 false 时生效）
x: 0.0 # 目标 X 坐标
y: 64.0 # 目标 Y 坐标
z: 0.0 # 目标 Z 坐标
lobby:
camera-position:
distance: 2
world: world
x: 0
y: 100
z: 0
yaw: 0.0 # 水平旋转角度 (0-360)
pitch: 0.0 # 垂直旋转角度 (-90到90)
layout:
layout1:
name: Start
x: 0
y: 0
z: 0
tilt:
x: 0.0 # 上下倾斜（俯仰）
y: 0.0 # 左右倾斜（偏航）
z: 0.0 # 前后倾斜（翻滚）
command:
- '[player] say test'
- '[op] give %player% stone 1'
next-menu:
enabled: false
menu: lobby
# 点击后是否结束菜单
stop-menu:
enabled: false
teleport:
enabled: false # 是否启用传送功能（默认 false）
back-original: false # 是否传回进入菜单前的原位置（true：原位置；false：自定义坐标）
world: world # 目标世界名（当 back-original 为 false 时生效）
x: 0.0 # 目标 X 坐标
y: 64.0 # 目标 Y 坐标
z: 0.0 # 目标 Z 坐标
layout2:
name: Options
x: 0
y: -1
z: 0
tilt:
x: 0.0 # 上下倾斜（俯仰）
y: 0.0 # 左右倾斜（偏航）
z: 0.0 # 前后倾斜（翻滚）
command:
- '[player] say test'
- '[op] give %player% stone 1'
next-menu:
enabled: false
menu: lobby
# 点击后是否结束菜单
stop-menu:
enabled: false
teleport:
enabled: false # 是否启用传送功能（默认 false）
back-original: false # 是否传回进入菜单前的原位置（true：原位置；false：自定义坐标）
world: world # 目标世界名（当 back-original 为 false 时生效）
x: 0.0 # 目标 X 坐标
y: 64.0 # 目标 Y 坐标
z: 0.0 # 目标 Z 坐标测试视频：
