Cobblemon KubeJS Bridge

Bring Cobblemon data, events, storage queries, administrative utilities, and client-side Pokedex displays into KubeJS.

Cobblemon KubeJS Bridge lets modpack developers build custom progression, quests, rewards, commands, interfaces, battle systems, and server mechanics using JavaScript.

Features

Cobblemon events

Listen to server-side events such as:

Pokedex progress changes
Pokemon scans and captures
Pokemon sent, recalled, fainted, gained, healed, or released
Experience gain and level-up
Evolution completion
Battle victory and defeat
Battle escape and forfeit

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

Pokedex API

Query a player's Pokedex progress:

Check whether a species was seen or caught
Count total seen or caught species
Count progress by elemental type
Read individual species progress

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

Species API

Validate species IDs
List implemented species
Read species types
Validate elemental types
Find all species of a type

Both short and namespaced IDs are supported:

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

Party and PC API

Read safe Pokemon snapshots from a player's party and PC:

Search Pokemon by UUID
Count Pokemon by species or type
Keep party, PC, box, and slot information
Read level, HP, nature, ability, moves, IVs, EVs, status, held item, and more

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

Administrative utilities

Trusted server scripts can:

Give a Pokemon to a player
Heal a player's party
Spawn a Pokemon near a player
Spawn a Pokemon at explicit coordinates without assigning an owner

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

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

Client-side Pokedex synchronization

The server synchronizes a read-only Pokedex cache to the owning client. Client scripts can use it for live tooltips and other interfaces without requesting data from the server every frame.

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

The included examples contain a tested dynamic spyglass tooltip.

Requirements

Cobblemon
KubeJS
Rhino, as required by KubeJS
Java 21

Install the bridge on both the client and server when using the synchronized client Pokedex API.

Loader support

NeoForge is currently supported.

Fabric support is not available yet. The Fabric module is only a compile-time stub and does not expose events, APIs, or client synchronization.

Documentation and examples

The project includes:

Complete API documentation
Every function's parameters and return values
Full event field reference
Pokemon and move data model reference
Server and client script examples
Troubleshooting instructions