跳到主要内容

安装与获取

下载与授权（免费）​

  1. 打开 资源中心，注册并登录。
  2. 在 StarVocation 星月天职 点「免费领取」，永久授权码会加入你的会员中心。
  3. 打开详情，下载最新的 StarVocation-<版本>-简体授权版.jar。

运行环境​

项目要求
服务端Paper / Purpur（及其分支），1.20 – 26.x
Java17 以上（26.x 需要 Java 25）
必需前置MythicLib（属性、技能施放都靠它，与 MMOCore 相同），要用支持你服务端版本的版本
推荐前置MythicMobs（MythicMobs 技能、击杀 MythicMobs 怪物给经验）、PlaceholderAPI（记分板 / TAB / 聊天显示职业）
可选联动MMOItems（物品等级 / 职业需求、物品技能消耗魔力）、云界面 CloudUI（个人资讯显示职业，见云界面）、Vault（money 触发）、WorldGuard（MythicLib 的技能区域旗帜）
数据库默认 SQLite，不用配置；多服共享用 MySQL 8 / MariaDB

实机测试：Purpur 1.21.4、Paper 1.21.11、Paper 26.3（新旧两种 MythicLib，搭配与不搭配 MythicMobs）；1.20.1 做过接口兼容检查。

不要和 MMOCore 同时安装

两个职业插件会同时给经验、同时处理技能键位。请先用 /sv admin import mmocore 导入配置与数据，再移除 MMOCore，见从 MMOCore 迁移。

安装​

  1. 把 StarVocation-<版本>-简体授权版.jar 放进 plugins/（MythicLib 必须已安装），启动服务器。
  2. 首次启动会生成 plugins/StarVocation/，里面有默认职业「旅人」与示例职业「剑士」（含子职业「狂剑士」、4 个技能、技能树与经验表），以及 token.yml。
  3. 按下面的「授权」填好授权码后重启。
  4. 进服输入 /sv 看到「旅人 Lv.1」，/sv class 选择剑士，/sv skills 装备技能，按 F 进入施放模式、按数字键施放。
MythicLib 的 MMOCORE 设定会自动修正

MythicLib 默认从 MMOCore 读取等级、职业与魔力（level-plugin / class-plugin / mana-plugin: MMOCORE），没装 MMOCore 时每次开服会出现三行黄字 Could not load ... plugin MMOCORE， skill/default_skills.yml 里 MMOCore 才有的 3 个技能也会出现 Could not find builtin skill。

第一次启动星月天职时会自动修正（原文件备份在 plugins/StarVocation/backups/mythiclib/），再重启一次后这些黄字就不会出现：

MythicLib 设定改成
level-plugin'%starvocation_level%'（MMOItems 等的等级需求读取职业等级）
class-plugin'%starvocation_class_id%'
mana-pluginNONE（与原本找不到 MMOCore 时相同）
skill/default_skills.yml 的 AMBERS、NEPTUNE_GIFT、SNEAKY_PICKY注释掉

不想自动修改：config.yml 的 compat.mythiclib-config: false。装着 MMOCore 时不会修改。

授权​

星月天职免费，授权码在资源中心免费领取：

  1. 首次启动会生成 plugins/StarVocation/token.yml，此时插件处于「未授权模式」：服务器照常开启，玩家数据照常读取，但职业、技能、经验、属性与菜单都暂停。
  2. 登录 会员中心，在「我的授权」复制 StarVocation 的授权码（没有的话先到 资源中心 免费领取），填进 token.yml 的 key:，重启服务器。
  3. 首次验证会自动绑定本机（后台会显示本机机器码）；换服务器时请先在会员中心自助解绑。
plugins/StarVocation/token.yml
key: 'XXXX-XXXX-XXXX-XXXX'
  • 授权在后台验证，不会拖慢开服；连不上授权服务器时每 60 秒自动重试，连上后立即生效，不需要重启。
  • 验证通过后每 6 小时在后台复核一次；断网时可使用最近一次验证结果离线运行 72 小时。
  • 授权被停用、解绑或过期时，职业功能会暂停并在后台说明原因；玩家数据不会丢失。
  • /sv admin version 可以查看当前版本与授权状态。

文件夹结构​

plugins/StarVocation/
├─ config.yml          # 数据库、施放模式、经验、战斗、兼容（与 MMOCore 同名的选项可直接沿用）
├─ messages.yml        # 全部消息
├─ stats.yml           # 所有职业共用的基础属性（MMOCore 格式）
├─ exp-sources.yml     # 经验组
├─ triggers.yml        # from{source=...} 用的触发组
├─ classes/            # 职业，每个文件一个职业，可放子文件夹
├─ skills/             # 技能，每个文件一个技能，可放子文件夹、中文文件名
├─ attributes/         # 属性点
├─ skill-trees/        # 技能树
├─ exp-tables/         # 经验表
├─ expcurves/          # 经验曲线（每行一个数字）
├─ menus/              # 界面
└─ data.db             # SQLite 数据（使用 MySQL 时不会产生）

以 _ 开头的文件与文件夹不会被读取，可以用来放草稿或备注。修改后输入 /sv admin reload 即可生效。

最后于 更新