Server Launch System Lite

插件

· 作者 Yeetoxic

在一个 Velocity 分配中运行按需 Minecraft 网络,配备托管后端、匹配系统、恢复功能,无需单独的控制平面。

0 本站下载 0 关注 更新于 2 个月前

最新 v0.1.0-rc.2.3 · 26.2 · Velocity

一键开服(送7天)

SLS standalone logo

SLS-LITE

SLS-LITE 是一个 Velocity 插件,用于在一台主机分配资源内运行小型 Minecraft 网络。它启动并监控本地 Java 服务器进程,向 Velocity 注册就绪的后端节点,并在玩家之间进行转移,无需完整的 SLS 基础设施、Docker 或第二台付费游戏服务器。

SLS-LITE 遵循现代 SLS 术语和兼容的配置结构(在单主机环境下适用的部分)。它仍是一个独立、自包含的产品:完整版的 SLS 并非其运行时依赖项或工作模式。

功能特性

  • 动态蓝图注册表及 registry/server 命令目标定位。
  • 复合实例 ID,例如 biome_run.vued73。
  • 按需安装 Paper 和原版以支持确切的 Minecraft 版本。
  • 手动指定自定义 Java 服务器软件。
  • 隔离的本地实例目录及便携式 cow 卷副本。
  • 基于容量的匹配机制、队列、直接传输以及动作栏状态显示。
  • 托管或外部主大厅(Lobbies)。
  • 当无正常后端可用时,捆绑 SLS-Limbo 作为回退方案。
  • 可选的代理端 ViaVersion 集成,用于 SLS-Limbo 协议转换及动态托管后端协议的同步。
  • 持久化托管实例管理、重启/重置、崩溃恢复及临时服务器的空闲清理。
  • 针对 Paper 管理的白名单、操作员、封禁、图标等根文件,提供有界的每文件持久化状态,无需特权挂载或符号链接。
  • 有界的游戏内日志、临时日志文件、生命周期日志、资源准入、转发配置及主机能力检查。
  • 内置管理员认领功能,加上标准的 Velocity 权限系统。
  • 版本化的 Java 扩展 API 1.2,用于能力发现、不可变检查、安全的异步生命周期/管理路由请求、生命周期订阅以及命名空间化的蓝图就绪性/状态贡献。
  • 默认关闭、经源验证的 Paper 后端消息传递,用于玩家绑定的 NPC、菜单、匹配机制及严格白名单内的 SLS 命令集成。

当前确切范围及有意为之的限制请参阅 Compatibility。

当操作员在 Velocity 上安装 ViaVersion 时会被检测到;SLS-LITE 并未捆绑 ViaVersion,也不强制要求使用。仅检测到该插件并不意味着支持未经测试的 Minecraft 客户端版本。有关支持的本地及转换路径,请参阅 Protocol Compatibility。

要求

  • 当前兼容的 Velocity 4.x 服务器。
  • JDK 25 用于构建和运行本发行版所使用的固定 Velocity 生成版本。 SLS-LITE 本身编译为 Java 21 字节码以确保插件兼容性。
  • 从源码构建时需要 Maven 3.9.6 或更高版本。
  • 你启动的 Minecraft 版本所需的任何其他 Java 主版本。
  • 在主机分配范围内创建文件、绑定回环端口以及启动子 Java 进程的权限。
  • 足够的真实主机内存以容纳 Velocity、SLS-Limbo 以及所有活动的后端节点。
  • 仅在使用 Paper 或原版自动安装提供者时才需要出站 HTTPS 连接。

声明的托管内存预算是准入会计用途,而非绕过或探测主机面板限制的手段。SLS-LITE 不会绕过提供商的限制。

安装

  1. 使用 mvn clean verify 构建或获取经过审核的发布工件。
  2. 将 sls-lite-<version>.jar 放入 Velocity 的 plugins/ 目录中。
  3. 启动一次 Velocity 以生成 plugins/sls-lite/ 目录。
  4. 按照标准的 转发与首次连接设置 操作,然后审阅剩余的 config.yml 中的内存、端口、大厅及安全选项。
  5. 在审阅完 Minecraft EULA 后,通过 software.accept_eula: true 按自动软件配置文件接受,或通过 software.auto_accept_eula: true 在全主机范围内接受,写入 config.yml。
  6. 使用可复制的 Blueprint Recipe Book 添加世界和蓝图,然后重启 Velocity 或运行 /sls reload blueprints。

重新加载更改不会影响正在运行的服务器。在为持久化实例选择重启或重置之前,请阅读 Applying Changes Safely。

请参阅 Getting Started 以获取完整的干净安装指南、真实网络与隔离开发路径、首次传输、更新、备份及移除方法。

基本用法

/sls registries
/sls blueprints minigame
/sls join minigame biome_run
/sls list
/sls info

首位操作员可以从 Velocity 控制台发出 /sls admin code,并在游戏中使用 /sls admin claim <code> 进行认领。生产环境代理必须启用在线模式以支持持久的游戏内管理员。

数据模型

plugins/sls-lite/
|-- config.yml
|-- administrators.properties
|-- blueprints/
|-- volumes/
|   |-- worlds/
|   |-- plugins/
|   `-- whitelists/
|-- software-profiles/
|-- software/
|-- runtimes/
|-- instances/
`-- sls-limbo/

蓝图文件夹仅为组织用途。命令使用的动态注册表是蓝图的 blueprint.type。

文档

构建

mvn clean verify

阴影插件被写入 target/sls-lite-<version>.jar;仅编译用的公共扩展契约被写入 target/sls-lite-<version>-api.jar。插件构建过程嵌入了 SLS-LITE 的 AGPL 许可证、第三方通知、SnakeYAML 以及 SLS-Limbo 所使用的固定版本的 NanoLimbo 运行时。

始终使用 clean 开始可分发版本的构建。阴影阶段会重新定位打包的依赖引用,因此对同一个 target/ 目录再次执行 package/install 调用并非标准的发布构建。

仅在 Velocity 上安装的是阴影插件 JAR。它已包含公共 API 类。较小的 -api.jar 是用于扩展项目的 SDK/分类器,不得作为另一个插件安装。

许可

SLS-LITE 采用 GNU Affero 通用公共许可证 v3.0。捆绑的依赖项通知及相应的源代码信息位于 THIRD_PARTY。

社区

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源