Server Launch System Lite

# !(https://cdn.modrinth.com/data/cached_images/7115a8404f7d6a94fd7aab586d6c4de1e9b3846c.png)

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 (https://github.com/Yeetoxic/SLS-LITE/blob/main/DOCS/compatibility/README.md).

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 (https://github.com/Yeetoxic/SLS-LITE/blob/main/DOCS/networking/Protocol_Compatibility.md) 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.

1. Build with `mvn clean verify` or obtain a reviewed release artifact. 2. Place `sls-lite-.jar` in Velocity's `plugins/` directory. 3. Start Velocity once to generate `plugins/sls-lite/`. 4. Follow the canonical (https://github.com/Yeetoxic/SLS-LITE/blob/main/DOCS/setup/README.md#forwarding-and-first-connection), then review the remaining `config.yml` memory, ports, lobby, and security choices. 5. 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`. 6. Add worlds and blueprints using the copyable (https://github.com/Yeetoxic/SLS-LITE/blob/main/DOCS/blueprints/README.md), then restart Velocity or run `/sls reload blueprints`.

Reloading changes future assembly without touching running servers. Read (https://github.com/Yeetoxic/SLS-LITE/blob/main/DOCS/operations/Applying_Changes.md) before choosing restart or reset for a persistent instance.

See (https://github.com/Yeetoxic/SLS-LITE/blob/main/DOCS/setup/README.md) for the complete clean install, real-network and isolated-development paths, first transfer, updates, backup, and removal.

## Basic Use

```text /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 c