vespigot

Vepaper – run and control standalone Paper servers from Velocity

Version 1.12.4 · requires Velocity 3.4+ and Java 17+

1. What is Vepaper?

Vepaper is a Velocity proxy plug-in that launches one or more Paper servers as local sub-processes and lets you manage them directly from the proxy.

• Drop‐in install – just put the jar in plugins/ and start Velocity.
• Latest Paper jar is downloaded automatically.
• Generates server.properties and silently accepts the Mojang EULA.
• Paper console output is relayed to the Velocity console
  (can be toggled with a command).
• Send any Paper console command from Velocity.
• No file is ever modified outside the instance folder
  (your velocity.toml, paper-global.yml, secrets, etc. stay untouched).

2. Installation

1. Build from source (mvn clean package, JDK 17) or download the release jar.
2. Place vepaper-*.jar in Velocity's plugins/ folder.
3. Start / restart Velocity.
   • plugins/vepaper/ and config.properties are created automatically.
   • Default settings
     • 1 Paper instance
     • port 25563
     • 4096 MB RAM
4. Modify config.properties if needed and restart Velocity.

3. Configuration (plugins/vepaper/config.properties)

4. Commands (proxy console / in-game OP)

Examples

/paper 0 say Hello from Velocity!
/paper 25563 stop
/paperlog off

5. Files generated per instance

servers/
 └─ paper-25563/
     ├─ paper.jar         (auto-downloaded)
     ├─ eula.txt          (always `eula=true`)
     ├─ server.properties (port etc.)
     └─ latest.log        (Paper console output)

Vepaper never touches paper-global.yml, spigot.yml, resource-pack settings, or any secret values – you can edit them manually whenever you like.

6. Uninstallation

Stop Velocity, remove vepaper-*.jar and the plugins/vepaper/ folder.
Delete the directories under servers/ if you no longer need the standalone Paper instances.

7. License

Released under the MIT License – see the repository for details. ```