CustomScreenMenu 插件文档
一款适用于现代 Minecraft 服务器的高性能、完全可定制的游戏内菜单插件。
原生支持 Folia。
如需报告错误或提出建议,请加入 官方 Discord。
开源版本不提供技术支持。购买或捐赠是鼓励作者持续开发的最佳方式,同时您还能获得该插件的支持与帮助。
核心功能
- 面向未来:在最新的 Minecraft 版本中保持稳定,兼容 Folia。
- 命令驱动:通过单一命令即可打开或关闭任意屏幕。
- 场景就绪:当玩家首次加入时,自动显示个人开始菜单。
- 3-D 物品展示:手持物品的悬停、可旋转模型。
- 可扩展:与 ItemsAdder、betterhud 等无缝集成。
命令
| 命令 | 描述 |
|---|---|
/cursormenu run <name> |
打开指定名称的自定义菜单。 |
/cursormenu stop |
立即关闭当前活动的菜单。 |
/cursormenu items <item_name> |
显示手中物品的 3-D 模型。 |
/cursormenu itemsstop |
结束当前的 3-D 物品预览。 |
/cursormenu reload |
重新加载所有配置文件(编辑后必需)。 |
亮点
- 360° 相机环绕:围绕菜单或物品进行环绕观察。
- 加入触发器:决定菜单是否应在每次登录时自动打开。
- 3-D 模型设置:自定义 model-data、旋转开关、发光开关。
- 文本定位:为屏幕上任何文本提供精确的 X、Y、Z 偏移量及倾斜角度。
- 即时传送:玩家进入菜单的瞬间将其传送至指定位置。
- ……以及更多可配置选项。
PlaceholderAPI 占位符:
%cursormenu_current_menu% – 当前打开的菜单名称
%cursormenu_selected_option% – 当前高亮显示的选项名称
%cursormenu_display_item_id% – 当前显示的物品的 ID
%cursormenu_clicked_option% – 刚刚点击的文本布局组件的键值
%cursormenu_menu_world% – 菜单所在的世界
%cursormenu_button_x% – 选中按钮的 X 坐标
%cursormenu_button_y% – 选中按钮的 Y 坐标
%cursormenu_button_z% – 选中按钮的 Z 坐标
%cursormenu_is_attacking_or_breaking% – 判断玩家当前是否正在攻击和破坏方块,true 表示是,false 表示否
集成
| 插件 | 新增功能 |
|---|---|
| ItemsAdder | 悬浮 3-D 模型、实时附魔与 Lore 显示、自定义物品面板。 |
| betterhud | 将菜单元素直接渲染到玩家 HUD 上,实现无缝视觉效果。 |
演示视频
- Demo 1 – 菜单交互
- [Demo 2 – 用于注册和登录的菜单示例
- Demo 3 – 高级菜单设计
# CustomScreenMenu 插件文档
CustomScreenMenu Plugin Documentation
A high-performance, fully customizable in-game menu plugin for modern Minecraft servers.
Native Folia support included.
For bug reports or suggestions, join the official Discord.
The open-source version doesn't come with tech support. Buying or donating is just a great way to encourage the author to keep developing and also get support and help for the plugin.
Core Features
- Future-proof: Stable on the latest Minecraft releases, compatible with Folia.
- Command-driven: Open or close any screen with a single command.
- Scenario-ready: Auto-display a personal start menu when a player first joins.
- 3-D item showcase: Hovering, rotatable models of held items.
- Extensible: Seamless integration with ItemsAdder, betterhud, and more.
Commands
| Command | Description |
|---|---|
/cursormenu run <name> |
Opens the custom menu with the given name. |
/cursormenu stop |
Instantly closes the active menu. |
/cursormenu items <item_name> |
Displays a 3-D model of the item in your hand. |
/cursormenu itemsstop |
Ends the current 3-D item preview. |
/cursormenu reload |
Reloads all configuration files (required after edits). |
Highlights
- 360° camera orbit around the menu or item.
- Join-trigger: Decide whether the menu should open automatically on every login.
- 3-D model settings: custom model-data, rotation toggle, glow toggle.
- Text placement: precise X, Y, Z offsets and tilt angles for any on-screen text.
- Instant teleport: warp the player the moment they enter the menu.
- …and many more configurable options.
PlaceholderAPI:
%cursormenu_current_menu% – the name of the menu currently open
%cursormenu_selected_option% – the name of the currently highlighted option
%cursormenu_display_item_id% – the ID of the item currently shown
%cursormenu_clicked_option% – the key of the text layout component that was just clicked
%cursormenu_menu_world% – the world in which the menu is located
%cursormenu_button_x% – X coordinate of the selected button
%cursormenu_button_y% – Y coordinate of the selected button
%cursormenu_button_z% – Z coordinate of the selected button
%cursormenu_is_attacking_or_breaking% – Determine whether the player is currently attacking and destroying blocks, with true as yes and false as no
Integrations
| Plugin | Added Capabilities |
|---|---|
| ItemsAdder | Floating 3-D models, live enchants & lore display, custom item panels. |
| betterhud | Render menu elements directly onto the player HUD for a seamless look. |
Demo Videos
- Demo 1 – Menu Interaction
- [Demo 2 – Menu example for registration and login
- Demo 3 – Advanced Menu Design
# CustomScreenMenu Plugin Documentation
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CustomScreenMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
修复:
-
移除了 Folia 声明:删除了
folia-supported: true,插件不再声明对 Folia 的支持。 -
修复重复的区块加载器:移除重复的区块加载器初始化代码,仅保留单一任务。
-
统一命令执行路径:CursorMenuPlugin 和 WASD 命令的执行现在均通过 CommandUtils 路由,确保真正的 OP 不会被错误降级。
-
优化登录验证性能:BCrypt 和 SQLite 操作已移至固定容量的后台线程池(1–2 个线程,队列容量为 64),并将玩家状态更新发布回主线程,以避免阻塞主线程。
-
改进线程池生命周期:认证线程池现在在插件禁用或重载时正确关闭,以防止资源泄漏。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
评论 0
登录后参与评分
还没有评论,来抢沙发吧