MLobbySystem
一款专为 Paper 服务器打造的现代化、轻量级大厅系统——在设计之初便兼顾了性能与灵活性。
它针对当前的服务器环境进行了优化,完全支持 Folia 的区域化多线程模型。
✨ 功能特性
- ⚡ Folia 支持 – 专为在 Folia 服务器上安全高效运行而构建
- ? 自定义出生点系统 – 轻松定义和管理你的大厅出生点
- ? 加入管理 – 自定义或隐藏加入/退出消息,支持加入时传送、重生时传送或掉出虚空时传送
- ? 模块化快捷栏物品 – 添加、移除或更换任意数量的快捷栏物品,每个物品都可绑定独立动作:显示链接、打开服务器选择器、切换玩家可见性、执行命令、打开外观菜单或发送富文本可点击聊天消息
- ? 可点击聊天消息 –
show-text 物品动作支持发送多行 MiniMessage 文本,每行均可设置独立的点击行为(打开 URL、执行命令、建议命令、复制到剪贴板),并支持 {player} 占位符
- ? 外观系统 – 帽子、粒子轨迹和小道具(烟花爆发、抓钩、珍珠弓),每项外观均可设置权限限制,并在重启后为每位玩家持久保存
- ?️ 服务器选择器菜单 – 分页式、采用 MiniMessage 样式风格的代理服务器选择器
- ? 大厅保护 – 禁用伤害、饥饿、方块破坏等功能
- ? 自动传送 – 玩家在加入、重生或掉入虚空时自动传送至出生点
- ? 可脚本化 – 每次使用快捷栏物品都会触发一个可取消的
LobbyItemUseEvent 事件,因此其他插件或脚本(例如 Skript)可以对此作出反应或覆盖物品行为
- ?️ 高度可配置 – 简洁的配置结构,便于快速设置和自定义
? 兼容性
- ✅ Paper 1.21.11, 26.1.x, 26.2(插件需要 Java 21+;Paper 自身运行其 26.x 版本构建需要 Java 25)
- ✅ Folia(相同版本范围)– 基于共享的 Paper/Folia API 构建,对应上述版本的 Folia 构建版也已提供
该插件仅针对最旧的支持 API 编译一次,并通过在同一 jar 包上实际启动 Paper 1.21.11、26.1.2 和 26.2 服务器进行验证——无需为每个 Minecraft 版本单独构建。
? 为什么选择 MLobbySystem?
MLobbySystem 专注于现代服务器架构:命令通过 Paper 的 Brigadier 命令 API 注册(支持真正的标签补全,而非遗留的 CommandExecutor);配置加载到类型化的不可变记录类中,而非分散的可变字段;每个菜单都构建在一个小型、可复用的点击处理框架之上,而非一次性使用的 PersistentDataContainer 标签。它避免了过重的同步逻辑,并与 Folia 等下一代平台保持兼容。
? 安装
- 下载最新发行版
- 将
.jar 文件放入你的 /plugins 文件夹
- 重启服务器
- 在生成的配置文件中进行插件配置
⚙️ 配置
所有功能均可通过 config.yml 和 messages.yml 进行配置。每条消息均支持 MiniMessage 格式(渐变、十六进制颜色等)。
快捷栏物品 (hotbar.items) 和外观 (cosmetics.items) 均为自由列表——你可以按需添加任意数量,每个条目由你选择的唯一 ID 作为键。这两个文件均附带注释示例,涵盖了所有可用的动作/类型。
?️ 命令
| 命令 |
权限 |
描述 |
/spawn |
— |
传送到大厅出生点 |
/setspawn |
lobbysystem.set |
将你所在位置设置为大厅出生点 |
/build |
lobbysystem.build |
在大厅中切换建造模式 |
/lobbysystem reload |
lobbysystem.reload |
重载配置而无需重启服务器 |
你没有权限的命令将不会出现在标签补全列表中——这是标准的 Brigadier 权限过滤机制,并非 Bug。
? 支持
如果遇到任何问题或有建议,欢迎提交 Issue 或贡献代码。
MLobbySystem
A modern, lightweight lobby system for Paper servers — built with performance and flexibility in mind.
Designed for current server setups, including full support for Folia's regionized multithreading model.
✨ Features
- ⚡ Folia Support – Built to run safely and efficiently on Folia servers
- ? Custom Spawn System – Define and manage your lobby spawn with ease
- ? Join Management – Custom or silenced join/quit messages, teleport-on-join/respawn/void
- ? Modular Hotbar Items – Add, remove, or reskin as many hotbar items as you want, each with
its own action: show links, open the server selector, toggle player visibility, run a command,
open the cosmetics menu, or send a rich clickable chat message
- ? Clickable Chat Messages – The
show-text item action sends multi-line MiniMessage text with
per-line click behavior (open URL, run command, suggest command, copy to clipboard) and a
{player} placeholder
- ? Cosmetics – Hats, particle trails, and gadgets (firework burst, grappling hook, pearl bow),
each optionally permission-gated and persisted per player across restarts
- ?️ Server Selector Menu – Paginated, MiniMessage-styled proxy server selector
- ? Lobby Protection – Disable damage, hunger, block breaking, and more
- ? Auto Teleport – Send players to spawn automatically on join, respawn, or void fall
- ? Scriptable – Every hotbar item use fires a cancellable
LobbyItemUseEvent, so other plugins
or scripts (e.g. Skript) can react to or override item behavior
- ?️ Highly Configurable – Simple config structure for fast setup and customization
? Compatibility
- ✅ Paper 1.21.11, 26.1.x, 26.2 (Java 21+ for the plugin; Paper itself needs Java 25 to run its 26.x builds)
- ✅ Folia (same version range) - built against the shared Paper/Folia API, Folia builds exist for the
same versions
The plugin is built once against the oldest supported API and verified by booting the same jar against
real Paper 1.21.11, 26.1.2, and 26.2 servers - no separate builds per Minecraft version needed.
? Why MLobbySystem?
MLobbySystem focuses on modern server architecture: commands are registered through Paper's Brigadier
command API (real tab-completion, no legacy CommandExecutor), config is loaded into typed, immutable
records instead of scattered mutable fields, and every menu is built on a small reusable click-handler
framework rather than one-off PersistentDataContainer tags. It avoids outdated sync-heavy logic and stays
compatible with next-generation platforms like Folia.
? Installation
- Download the latest release
- Place the
.jar file into your /plugins folder
- Restart your server
- Configure the plugin in the generated config files
⚙️ Configuration
All features are configurable via config.yml and messages.yml. Every message supports
MiniMessage formatting (gradients, hex colors, etc.).
Hotbar items (hotbar.items) and cosmetics (cosmetics.items) are both free-form lists — add as many
as you want, each keyed by a unique id you choose. Both files ship with commented examples covering
every available action/kind.
?️ Commands
| Command |
Permission |
Description |
/spawn |
— |
Teleport to the lobby spawn |
/setspawn |
lobbysystem.set |
Set the lobby spawn at your position |
/build |
lobbysystem.build |
Toggle build mode in the lobby |
/lobbysystem reload |
lobbysystem.reload |
Reload the config without restarting |
Commands you don't have permission for won't show up in tab-completion at all — this is standard
Brigadier permission-gating, not a bug.
? Support
If you encounter issues or have suggestions, feel free to open an issue or contribute.
评论 0
登录后参与评分
还没有评论,来抢沙发吧