Cobblemon KubeJS

Cobblemon KubeJS Bridge

将 Cobblemon 数据、事件、存储查询、管理工具以及
客户端宝可梦图鉴显示功能接入 KubeJS。

Cobblemon KubeJS Bridge 让整合包开发者能够使用 JavaScript
打造自定义进度、任务、奖励、命令、界面、战斗系统和服务端机制。

功能

Cobblemon 事件

监听服务端事件，例如：

• 宝可梦图鉴进度变化
• 扫描和捕获宝可梦
• 宝可梦被派出、收回、击败、获得、治疗或释放
• 获得经验和升级
• 进化完成
• 战斗胜利或失败
• 逃离战斗或弃权

CobblemonEvents.pokemonCaptured(event => {
  event.player.tell(
    `You caught ${event.species} at level ${event.level}!`
  )
})

宝可梦图鉴 API

查询玩家的宝可梦图鉴进度：

• 检查是否见过或捕获过某个宝可梦种类
• 统计见过或捕获过的宝可梦种类总数
• 按元素属性统计进度
• 读取单个宝可梦种类的进度

var caughtFire = CobblemonJS.pokedex.countCaughtByType(
  player,
  'fire'
)

宝可梦种类 API

• 验证宝可梦种类 ID
• 列出已实现的宝可梦种类
• 读取宝可梦种类的属性
• 验证元素属性
• 查找某种属性的所有宝可梦种类

支持简写 ID 和带命名空间的 ID：

CobblemonJS.species.exists('charizard')
CobblemonJS.species.exists('cobblemon:charizard')

队伍和电脑 API

安全读取玩家队伍和电脑中的宝可梦快照：

• 按 UUID 搜索宝可梦
• 按种类或属性统计宝可梦数量
• 保留队伍、电脑、盒子和栏位信息
• 读取等级、生命值、性格、特性、招式、个体值、努力值、状态、携带物品等信息

var party = CobblemonJS.pokemon.getParty(player)
var pokemon = CobblemonJS.pokemon.getByUuid(player, pokemonUuid)

管理工具

受信任的服务端脚本可以：

• 给予玩家一只宝可梦
• 治疗玩家队伍
• 在玩家附近生成一只宝可梦
• 在指定坐标生成一只宝可梦，且不为其指定所有者

CobblemonJS.admin.givePokemon(
  player,
  'charizard level=50 shiny=true'
)

CobblemonJS.admin.spawnPokemon(
  player.serverLevel,
  'rayquaza level=70',
  100,
  80,
  -50
)

客户端宝可梦图鉴同步

服务端会向对应客户端同步只读的宝可梦图鉴缓存。客户端
脚本可将其用于实时工具提示和其他界面，无需每帧都向服务端请求
数据。

CobblemonClientJS.pokedex.countSeen()
CobblemonClientJS.pokedex.countCaught()
CobblemonClientJS.pokedex.countCaughtByType('fire')

附带的示例包含一个经过测试的动态望远镜工具提示。

运行要求

• Cobblemon
• KubeJS
• Rhino（KubeJS 所需）
• Java 21

使用同步客户端宝可梦图鉴 API 时，请在客户端和服务端都安装
此桥接模组。

加载器支持

目前支持 NeoForge。

暂不支持 Fabric。Fabric 模块仅为编译期
占位模块，不提供事件、API 或客户端同步功能。

文档和示例

项目包含：

• 完整的 API 文档
• 每个函数的参数和返回值
• 完整的事件字段参考
• 宝可梦和招式数据模型参考
• 服务端和客户端脚本示例
• 故障排查说明

链接

• 文档
• 源代码
• 问题追踪

备注

• 返回给脚本的宝可梦快照是只读的。
• 管理方法会改变游戏状态，只应通过具有适当权限检查的可信脚本暴露。
• 图鉴计数代表已实现的独特物种，而非重复捕获。
• 未知物种、类型、格式错误的 UUID 以及无效的生成属性会产生描述性的脚本错误。
• 替换模组 jar 或网络代码需要完全重启。