
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 不会绕过提供商的限制。
安装
- 使用
mvn clean verify 构建或获取经过审核的发布工件。
- 将
sls-lite-<version>.jar 放入 Velocity 的 plugins/ 目录中。
- 启动一次 Velocity 以生成
plugins/sls-lite/ 目录。
- 按照标准的 转发与首次连接设置 操作,然后审阅剩余的
config.yml 中的内存、端口、大厅及安全选项。
- 在审阅完 Minecraft EULA 后,通过
software.accept_eula: true 按自动软件配置文件接受,或通过 software.auto_accept_eula: true 在全主机范围内接受,写入 config.yml。
- 使用可复制的 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。
社区

SLS-LITE
SLS-LITE is a Velocity plugin for running a small Minecraft network inside one
hosting allocation. It launches and supervises local Java server processes,
registers ready backends with Velocity, and moves players between them without
requiring full SLS infrastructure, Docker, or a second purchased game server.
SLS-LITE follows modern SLS terminology and compatible configuration shapes
where they make sense on one host. It remains a separate, self-contained
product: full SLS is not a runtime dependency or operating mode.
Features
- Dynamic blueprint registries and
registry/server command targeting.
- Composite instance IDs such as
biome_run.vued73.
- On-demand Paper and vanilla installation for exact Minecraft versions.
- Manual custom Java server software.
- Isolated local instance directories and portable
cow volume copies.
- Capacity-aware matchmaking, queues, direct transfers, and action-bar status.
- Managed or external primary lobbies.
- Bundled SLS-Limbo fallback when no normal backend is safe.
- Optional proxy-installed ViaVersion integration for SLS-Limbo translation and
dynamic managed-backend protocol synchronization.
- Persistent managed instances, restart/reset, crash reconciliation, and idle
cleanup for ephemeral servers.
- Bounded per-file persistent state for Paper-managed whitelist, operator, ban,
icon, and similar root files without privileged mounts or symbolic links.
- Bounded in-game logs, temporary log files, lifecycle logging, resource
admission, forwarding configuration, and host capability checks.
- Built-in administrator claiming plus standard Velocity permissions.
- Versioned Java extension API 1.2 for capability discovery, immutable
inspection, safe asynchronous lifecycle/administrative and routing requests,
lifecycle subscriptions, and namespaced blueprint-readiness/status
contributions.
- Default-off, source-verified Paper backend messaging for player-bound NPC,
menu, matchmaking, and narrowly allowlisted SLS command integrations.
The exact current scope and intentional limitations are listed in
Compatibility.
ViaVersion is detected when the operator installs it on Velocity; it is not
bundled or required by SLS-LITE. Detection alone does not make an untested
Minecraft client version supported. See
Protocol Compatibility for supported native
and translated paths.
Requirements
- A current compatible Velocity 4.x server.
- JDK 25 to build and run the pinned Velocity generation used by this release.
SLS-LITE itself is emitted as Java 21 bytecode for plugin compatibility.
- Maven 3.9.6 or newer when building from source.
- Any additional Java majors required by the Minecraft versions you launch.
- Permission to create files, bind loopback ports, and launch child Java
processes inside the hosting allocation.
- Enough real host memory for Velocity, SLS-Limbo, and every active backend.
- Outbound HTTPS only when using the Paper or vanilla auto-install providers.
The declared managed-memory budget is admission accounting, not a way to bypass
or discover a hosting-panel limit. SLS-LITE does not bypass provider
restrictions.
Install
- Build with
mvn clean verify or obtain a reviewed release artifact.
- Place
sls-lite-<version>.jar in Velocity's plugins/ directory.
- Start Velocity once to generate
plugins/sls-lite/.
- Follow the canonical
forwarding and first-connection setup,
then review the remaining
config.yml memory, ports, lobby, and security
choices.
- After reviewing the Minecraft EULA, accept it either per automatic software
profile with
software.accept_eula: true or host-wide with
software.auto_accept_eula: true in config.yml.
- Add worlds and blueprints using the copyable
Blueprint Recipe Book, then restart Velocity or
run
/sls reload blueprints.
Reloading changes future assembly without touching running servers. Read
Applying Changes Safely before choosing restart
or reset for a persistent instance.
See Getting Started for the complete clean install,
real-network and isolated-development paths, first transfer, updates, backup,
and removal.
Basic Use
/sls registries
/sls blueprints minigame
/sls join minigame biome_run
/sls list
/sls info
The first operator can issue /sls admin code from the Velocity console and
claim it in game with /sls admin claim <code>. Production proxies must use
online mode for persistent in-game administrators.
Data Model
plugins/sls-lite/
|-- config.yml
|-- administrators.properties
|-- blueprints/
|-- volumes/
| |-- worlds/
| |-- plugins/
| `-- whitelists/
|-- software-profiles/
|-- software/
|-- runtimes/
|-- instances/
`-- sls-limbo/
Blueprint folders are organizational. The dynamic registry used by commands is
the blueprint's blueprint.type.
Documentation
Build
mvn clean verify
The shaded plugin is written to target/sls-lite-<version>.jar; the compile-only
public extension contract is written to target/sls-lite-<version>-api.jar. The plugin build embeds
SLS-LITE's AGPL license, third-party notices, SnakeYAML, and the pinned
NanoLimbo runtime used by SLS-Limbo.
Always begin a distributable build with clean. The shading phase relocates
packaged dependency references, so a second package/install invocation against
the same target/ directory is not a canonical release build.
Only the shaded plugin JAR is installed on Velocity. It already contains the
public API classes. The smaller -api.jar is an SDK/classifier for extension
projects and must not be installed as another plugin.
License
SLS-LITE is licensed under the
GNU Affero General Public License v3.0. Bundled dependency notices
and corresponding source information are under THIRD_PARTY.
Community
评论 0
登录后参与评分
还没有评论,来抢沙发吧