快速上手
本页将引导你在 5 分钟内完成 UltiTools 的安装和基本配置。
前置条件
- Paper 1.21+ 服务端（下载 Paper）
- Java 21
可选前置插件
- Vault — 经济系统和权限前置（UltiEconomy、UltiKits 等模块需要）
- PlaceholderAPI — 变量占位符（UltiSideBar 等模块需要）
- LuckPerms — 权限管理（推荐）
安装步骤
1. 下载 UltiTools
从 GitHub Releases 下载最新版本的 UltiTools JAR 文件。
2. 安装插件
- 关闭服务端
- 将
UltiTools-x.x.x.jar放入服务器的plugins/文件夹 - 启动服务端
首次启动时，UltiTools 将自动生成配置文件和目录结构。
3. 安装功能模块
UltiTools 核心只是一个框架，你需要安装模块来获得实际功能。
方法一：使用 UPM 包管理器（推荐）
在服务器控制台或游戏中（需要 OP 权限）执行：
/upm install UltiEssentials安装完成后需要重启服务器。
方法二：手动安装
从 UltiCloud 下载模块 JAR 文件，放入 plugins/UltiTools/plugins/ 目录，然后重启服务器。
4. 基本配置
编辑 plugins/UltiTools/config.yml：
yaml
# 数据存储方式：json, sqlite, mysql
datasource:
type: "sqlite"
# 语言：zh 中文, en 英文
language: "zh"修改配置后执行 /ul reload 使配置生效。
常用命令
| 命令 | 说明 |
|---|---|
/ul list | 查看已安装的模块 |
/ul reload | 重载所有配置文件 |
/ul reload <模块名> | 重载指定模块的配置 |
/upm list | 查看可用模块列表 |
/upm install <模块名> | 安装模块 |
/upm update all | 更新所有模块 |
注意
以上命令均需要 OP 权限。/ul reload 只能重载配置文件，安装新模块或更新 JAR 后需要重启服务器。
下一步
贡献者
Ling Bao
Claude Opus 4.6