# Vepaper – 从Velocity运行和控制独立的Paper服务器
**版本 1.12.4** · 需要 **Velocity 3.4+** 和 **Java 17+**
---
## 1. 什么是Vepaper？
Vepaper是Velocity代理插件，它启动一个或多个Paper服务器作为**本地
子进程**，并允许您直接从代理管理它们。
* 即插即用安装 – 只需将jar文件放入 *plugins/* 文件夹并启动Velocity。
* 自动下载最新的Paper jar文件。
* 生成 `server.properties` 文件并静默接受Mojang EULA。
* Paper控制台输出被转发到Velocity控制台
（可以使用命令切换）。
* 从Velocity发送任何Paper控制台命令。
* **从不修改**实例文件夹之外的文件
（您的`velocity.toml`、`paper-global.yml`、密钥等保持不变）。
---
## 2. 安装
1. 从源代码构建 (`mvn clean package`, JDK 17) **或** 下载发行版jar文件。
2. 将 `vepaper-*.jar` 放入Velocity的 `plugins/` 文件夹中。
3. 启动/重启Velocity。
* `plugins/vepaper/` 和 `config.properties` 自动创建。
* 默认设置
* 1个Paper实例
* 端口 **25563**
* **4096 MB** RAM
4. 如果需要，修改 `config.properties` 并重启Velocity。
---
## 3. 配置 (`plugins/vepaper/config.properties`)
| 键 | 默认值 | 描述 |
|----------------|---------|-----------------------------------------------|
| `instances` | 1 | 要启动的Paper服务器数量 |
| `startingPort` | 25563 | 第一个实例的TCP端口（下一个=+1） |
| `maxMemoryMb` | 4096 | 每个实例的内存 (MB) |
---
## 4. 命令 (代理控制台 / 游戏中OP)
| 命令 | 效果 |
|----------------------------------------|------------------------------------------------------------------------------------------|
| `/paper ` | 向Paper实例发送任意控制台命令。
• `index` = 0-based顺序
• `port` = TCP端口 |
| `/paperlog on` / `/paperlog off` | 启用 / 禁用日志转发 (默认 **on**)。 |
示例
```text
/paper 0 say Hello from Velocity!
/paper 25563 stop
/paperlog off
```
---
## 5. 每个实例生成的 文件
```
servers/
└─ paper-25563/
├─ paper.jar (自动下载)
├─ eula.txt (始终 `eula=true`)
├─ server.properties (端口等)
└─ latest.log (Paper控制台输出)
```
Vepaper 从不触及 `paper-global.yml`、`spigot.yml`、资源包设置或
任何密钥值 – 您可以随时手动编辑它们。
---
## 6. 卸载
停止Velocity，删除 `vepaper-*.jar` 和 `plugins/vepaper/` 文件夹。
如果不再需要独立的Paper
实例，请删除 `servers/` 下的目录。
---
## 7. 许可
以 **MIT许可证** 发布 – 详情请参阅仓库。
