Pixelmon / Cobblemon Occupation System

PokeOccupation Wiki

PokeOccupation 是面向宝可梦服务器的职业成长插件，提供职业选择、职业点数、技能升级、转职、 队伍共享、拓展职业、商店限制和多版本兼容支持。

查看职业技能 授权验证
像素风宝可梦职业插件控制台界面
V5.2.4 插件版本
8 Pixelmon 职业配置
4 Cobblemon 职业配置
/po 主命令

Installation

安装流程

根据服务端环境选择对应构建包。先安装对应环境的前置依赖，再安装 PokeOccupation 本体。

01

选择版本

项目包含 1.12.2、1.16.5、1.21.1、Cobblemon 和 Cobblemon Fabric 适配模块。

02

安装前置

先安装宝可梦模组环境、AyCore、经济/PAPI 等需要的前置，再启动服务器检查依赖是否正常加载。

03

放入插件

将 `[P][PokeOccupation]宝可梦职业-V5.2.4.jar` 放入服务端 `plugins` 目录。

04

首次启动

启动后检查控制台加载信息，并确认配置文件已生成。

05

填写授权

在 `plugins/PokeOccupation/key.yml` 填写授权信息，再重启服务器完成验证。

Requirements

可用版本与前置依赖

当前源码构建版本为 `V5.2.4`，Java 编译目标为 Java 8；1.21.1 相关模块使用 Java 21 toolchain 编译环境。 `plugin.yml` 声明 `api-version: 1.13`，主命令为 `/po`。

License Verification

授权验证环节

插件启动时会读取 `key.yml` 并连接授权服务。验证通过后继续加载职业系统；验证失败时会在控制台返回错误。 网站文档只展示填写方式，不应公开真实授权码。

Windows 推荐：机器码模式
key: "你的授权码"
mode: "mac"
Linux 推荐：IP 模式
key: "你的授权码"
mode: "ip"
验证提示

更换机器、系统、IP 或服务端环境后，授权绑定信息可能需要重新确认。部署前建议先在正式运行环境完成验证。

Occupation Skills

职业技能

职业配置来自 `occupation/*.yml` 与 `occupation_cobblemon/*.yml`。每个技能都有升级消耗、等级上限、触发概率和每日触发上限。

Team System

职业队伍

职业队伍让玩家以队伍维度沉淀当天点数，并把点数换算成经济奖励或其他货币奖励。

创建与邀请

玩家先选择职业，再通过 `/po create <队伍名称>` 创建队伍。队长可使用 `/po invite <玩家>` 邀请其他有职业且无队伍的玩家。

队长权限

邀请、踢出成员、修改队伍名和部分队伍管理操作要求玩家是队长；非队长会收到无权限提示。

点数换算

默认 `eco: 1.0`，当天队伍点数可按比例换算经济。队长比例 `captainPoints: 5.0`，成员比例 `memberPoints: 10.0`。

奖励发放

默认经济命令为 `eco give %player% %cost%`，也可使用 NyEconomy：`nye give %player% %vault-name% %cost%`。

队伍限制

无职业玩家不能打开队伍界面；已在队伍中的玩家不能被重复邀请；队伍中同一职业位置不可重复占用。

PAPI 显示

无队伍时变量默认显示 `&a无队伍`，GUI 中无成员显示 `&b无成员`，无队长显示 `&f无队长`。

Commands

命令参考

主命令为 `/po`，别名包含 `/poo` 和 `/pokeoccupation`。支持按关键词实时过滤。

命令 说明 权限建议 分类

Configuration

核心配置

默认使用 YAML 存储；当 `Setting.yaml` 为 `false` 时切换数据库。每日点数上限、重置时间、转职冷却和转职核心消耗都在配置中控制。 

Setting:
  yaml: true
  dayLimitPoints: 500.0
  times: "3:59"
  NoOccupation: "&f无职业"

Transfer:
  TransferLimit: true
  keepPoints: true
  lore: "&f能够进行职业转职的核心"
  num: 1

Extend:
  permission: po.upOccupation
  lore: "&f能够进行职业拓展的核心"
  num: 1

Config Files

配置文件速查

这里列出服主最常翻阅的配置文件。示例只保留结构和关键项；授权码、数据库密码等敏感值应在实际服务器本地维护。

PlaceholderAPI

PAPI 变量

插件注册的 PlaceholderAPI 标识符为 `PokeOccupation`。变量可用于菜单、计分板、聊天格式、TAB 或其他支持 PAPI 的插件。

变量 返回内容 默认/来源

FAQ

常见问题

验证失败应该先检查什么？

检查 `key.yml` 是否填写授权码、`mode` 是否符合系统环境、服务器是否能访问授权服务，以及是否更换过机器/IP。

为什么修改重置时间后 reload 没生效？

`Setting.times` 注释中说明该时间建议开服前设置，运行中 reload 不一定会改动定时任务，建议重启服务器。

拓展职业需要什么条件？

玩家需要先有主职业、不能选择与主职业相同的拓展职业，并且需要权限 `po.upOccupation` 和拓展核心。

数据存储选 YAML 还是 MySQL？

小服可使用默认 YAML。玩家多、跨服或需要稳定查询统计时，建议关闭 `Setting.yaml` 并配置 MySQL。

Version

版本与兼容

PokeOccupation V5.2.4

主插件构建包、1.16.5、1.21.1、Cobblemon 与 Cobblemon Fabric 模块均存在 V5.2.4 构建记录。

多版本适配

项目结构包含 `v1_12_2`、`v1_16_5`、`v1_21_1`、`v1_21_1_Cobblemon`、`v1_21_1_Cobblemon_Fabric`。

已复制