Spvelocity \u2014 a Paper \/ Spigot plugin that **downloads and launches a Velocity proxy**
\n————————————————————————————<\/p>\n
  <\/p>\n
—<\/p>\n
## What is it?<\/p>\n
Spvelocity is a Paper \/ Spigot plugin that automatically:<\/p>\n
1. Downloads a Velocity jar from a given URL
\n2. Starts Velocity in a separate process
\n3. Lets you control it in-game \/ from console with `\/proxy start|stop|status`<\/p>\n
Perfect for quick network testing, CI pipelines, or ad-hoc test servers.<\/p>\n
—<\/p>\n
## Features<\/p>\n
* **Auto-download** of `velocity.jar` on the very first `\/proxy start`
\n* Works on Paper \/ Spigot 1.12 \u2013 latest (built against the 1.21.4 API)
\n* Requires only Java 11+, recommended Java 17 or 21
\n* Runs in a background thread \u2013 won\u2019t block the main server
\n* Stops Velocity automatically when the Paper server stops
\n* Simple configuration via `plugins\/Spvelocity\/config.yml`<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
* A Paper or Spigot server
\n (1.12 \u2013 latest, built against Paper-1.21.4)
\n* Java 11 or newer (Velocity itself needs 11+)
\n* Internet access the first time you run `\/proxy start` (to download Velocity)<\/p>\n
—<\/p>\n
## Getting started (pre-built jar)<\/p>\n
1. Download `spvelocity- —<\/p>\n ## Building from source<\/p>\n “`bash —<\/p>\n ## Configuration \u2014 `config.yml`<\/p>\n “`yml * Copy the download URL from PaperMC\u2019s downloads page: —<\/p>\n ## Commands & permissions<\/p>\n | Command | Description | Permission | Default | —<\/p>\n ## How it works<\/p>\n 1. `SpvelocityManager` checks whether `plugins\/Spvelocity\/proxy\/velocity.jar` exists —<\/p>\n ## License<\/p>\n MIT License \u2014 see `LICENSE` for details. A plugin that allows you to use velocity as a spigot plugin<\/p>\n","protected":false},"featured_media":147385,"template":"","meta":{"_minecraft_slug":"spvelocity","_minecraft_project_id":"SvLKZLYF","_minecraft_author":"nehatsu.","_minecraft_license":"Apache-2.0","_minecraft_downloads":56,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"spvelocity.zip","_minecraft_size_bytes":457449,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:54:27.230449Z","_minecraft_date_created":"2025-07-09T02:26:14.440052Z","_minecraft_date_modified":"2025-06-29T11:30:42.690884Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/spvelocity","_minecraft_icon_attachment_id":147385,"_minecraft_imported_at":"2026-06-08T20:10:12+00:00","_minecraft_import_hash":"4262cc277e47c4a4e3cf015e886f89ed","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129],"mod_loader":[132,134],"minecraft_version":[62,73,38,78],"class_list":["post-147384","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-2","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n
\n2. Drop it into `
\n3. Start your Paper \/ Spigot server with **Java 17 \/ 21** etc.
\n4. Run in-game or in console:
\n “`text
\n \/proxy start
\n “`
\n \u2192 `velocity.jar` is downloaded to `plugins\/Spvelocity\/proxy\/` and booted on port 25577<\/p>\n
\ngit clone https:\/\/github.com\/
\ncd spvelocity
\nmvn clean package # produces target\/spvelocity-*-shaded.jar
\n“`<\/p>\n
\nvelocity:
\n download-url: “https:\/\/api.papermc.io\/v2\/projects\/velocity\/versions\/3.3.0-SNAPSHOT\/builds\/261\/downloads\/velocity-3.3.0-SNAPSHOT-261.jar”
\n jar-name: “velocity.jar”
\n port: 25577
\n“`<\/p>\n
\n https:\/\/papermc.io\/downloads#Velocity
\n* Stable versions (`3.2.0`, etc.) keep the same URL.
\n* For SNAPSHOTs you may want a script that queries the API for the latest build or update the URL manually.<\/p>\n
\n|——————–|————————————-|————————-|———|
\n| `\/proxy start` | Download & start Velocity | `spvelocity.command` | OP |
\n| `\/proxy stop` | Stop the running Velocity instance | `spvelocity.command` | OP |
\n| `\/proxy status` | Show proxy status | `spvelocity.command` | OP |<\/p>\n
\n2. If not, it downloads it via **Apache Commons IO** from the configured URL
\n3. Runs `java -jar velocity.jar –port
\n4. Redirects proxy output to the Paper console
\n5. When the Paper server shuts down, the child process is destroyed via `destroy()`<\/p>\n
\nFork, modify, redistribute, enjoy!<\/p>\n","protected":false},"excerpt":{"rendered":"