安装与授权
下载与授权（免费）
- 打开 资源中心，注册并登录。
- 在 StarBag 星月行囊 点「免费领取」，永久授权码会加入你的会员中心。
- 打开详情，下载最新的
StarBag-<版本>-简体授权版.jar。
运行环境
| 项目 | 要求 |
|---|---|
| 服务端 | Paper / Purpur / Folia 1.20 – 26.x（同一个 jar） |
| Java | 17 或以上（服务端版本本身的要求照常，例如 1.20.5+ 需要 Java 21、26.x 需要 Java 25） |
| 前置插件 | 不需要 |
| 数据库 | 默认 SQLite（单服，不用设置）；多个子服共用行囊时改用 MySQL / MariaDB，见 跨服设置 |
| 可选：云界面 CloudUI | /bag 改用全屏的行囊画面，画面文件自动安装，见 云界面行囊 |
| 可选：Vault + 经济插件 / PlayerPoints | 用金币或点券购买格数，见 扩充容量 |
| 可选：PlaceholderAPI | 变量 |
| 可选：CloudSync / HuskSync | 跨服同步玩家物品栏时，当机保护会自动配合，见 当机保护 |
| 不支持 | Spigot（需要 Paper 系服务端） |
实机测试：Paper 1.21.11（单服；两台子服共用 MySQL；云界面画面）与 Paper 26.3（SQLite）。
全新安装
- 把
StarBag-<版本>.jar放进plugins/，启动服务器。 - 打开
plugins/StarBag/token.yml填入授权码，重启（首次启动自动绑定本机）。 - 进服输入
/bag就能打开行囊。
没填授权码时插件照常启动，但行囊功能暂停（后台用灰字说明怎么领取），行囊里的物品都安全地留在数据库里。
多个子服
每个子服都装星月行囊，config.yml 的 database.type 改成 mysql 并连到 同一个数据库，server.id 每个子服填不同的名字。详见 跨服设置。
文件说明
| 文件 | 内容 |
|---|---|
config.yml | 数据库、子服、容量、购买、扩充卷、物品限制、当机保护、备份，见 配置 |
menu.yml | 箱子菜单的标题、按钮、未解锁格子的外观，见 菜单 |
messages.yml | 全部提示文字，见 提示文字 |
item-names.yml（可选） | 补充或修改物品中文名（搜索与记录用） |
token.yml | 授权码 |
data.db | SQLite 数据（单服时） |
rescue.yml | 极少数情况下暂存的物品（玩家下线时数据库连不上），下次进服自动发还 |
升级
关服，替换 JAR，开服。 行囊、记录与设定文件都会保留；新版本新增的设定项会使用默认值。