Modrinth · Fabric, NeoForge

OS Cobblemon Library on your Minecraft server

OS Cobblemon Library runs on Minecraft servers with Fabric or NeoForge. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

A shared foundation for Cobblemon mod development across Fabric and NeoForge.

Downloads
66.7K
Author
LevelsFR
Loader
Fabric, NeoForge
Minecraft
1.21.1
Updated
–

Setup

Install OS Cobblemon Library on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Fabric or NeoForge and choose the matching Minecraft version, for example 1.21.1.

  3. 03

    Install the mod

    Search the mod browser for “OS Cobblemon Library” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    Every player installs the same OS Cobblemon Library release locally and connects using the server address from the panel.

On the server
Required
On the client
Required
Loader
Fabric, NeoForge
Minecraft
1.21.1
License
LicenseRef-All-Rights-Reserved

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

OS Cobblemon Library · Modrinth
Original description by the project author

OS Cobblemon Library

A lightweight shared Cobblemon API and compatibility library for Fabric and NeoForge.

Minecraft Version Fabric NeoForge All Rights Reserved

Discord CurseForge Projects Modrinth Projects


About

OS Cobblemon Library is a shared API and compatibility layer for Cobblemon mods.

It centralizes recurring Pokémon, storage, entity, event, battle and Pokédex integrations behind a focused public API, allowing projects to share the same implementation across Fabric and NeoForge instead of maintaining duplicated Cobblemon integration code.

The library intentionally provides infrastructure rather than standalone gameplay systems.

Highlights

  • Pokémon identity, forms, aspects and marks
  • Reusable Pokémon property matching
  • Namespace-aware species resolution
  • Command-free Pokémon creation and spawning
  • Persistent namespaced Pokémon data
  • Natural and effective IV inspection
  • Ability classification and type helpers
  • Native Pokémon size utilities
  • Party and PC storage queries
  • Pokémon entity identity, ownership and state
  • Reusable Cobblemon event hooks
  • Battle inspection and classification
  • Pokédex progress and completion queries
  • Shared Fabric and NeoForge integration layer

Requirements

Minecraft: 1.21.1
Cobblemon: 1.8.1 to <1.9.0
Java: 21
Loaders: Fabric & NeoForge

Use the file matching your mod loader.

Fabric
  • Fabric Loader 0.17.2+
  • Fabric API
  • Fabric Language Kotlin
  • Cobblemon 1.8.1 to <1.9.0
NeoForge
  • NeoForge 21.1.182+
  • Cobblemon 1.8.1 to <1.9.0

For Players

OS Cobblemon Library is primarily a dependency library.

It does not add standalone gameplay content by itself.

Install it when another mod lists OS Cobblemon Library as a required dependency, and make sure to download the JAR matching your loader.

If none of your installed mods require OS Cobblemon Library, installing it by itself will not add new gameplay features.

For Developers

OS Cobblemon Library provides a focused public API under:

com.ourstory.oscobblemon

The API is organized into reusable Cobblemon-specific domains:

  • pokemon - identity, matching, creation, persistent data, IVs, abilities, types, labels and size
  • entity - Pokémon entity identity, ownership and state
  • storage - Party and PC access, lookup, matching and counts
  • event - reusable Cobblemon event subscriptions and lifecycle handling
  • battle - battle inspection and classification
  • pokedex - species, form, variation and completion queries

Shared functionality is designed to remain loader-independent whenever possible, with Fabric and NeoForge modules handling platform-specific integration.

Pokémon API

The Pokémon API includes helpers for:

  • Stable namespaced species identities
  • Forms, aspects and marks
  • Alpha compatibility
  • Immutable identity snapshots
  • Reusable PokemonMatcher predicates
  • Species resolution across namespaces
  • Pokémon and PokémonEntity creation
  • Direct server-side Pokémon spawning
  • Namespaced persistent mod data
  • Natural and Hyper Trained IV values
  • Perfect IV counts and totals
  • Common, Hidden, Forced and Unknown ability classification
  • Current-form type inspection
  • Data-driven labels
  • Native size categories and safe scale values

Persistent data uses namespaced keys owned by the consuming mod, allowing projects to attach their own state to a Pokémon without copying Cobblemon integration logic.

Storage, Entities & Battles

PokemonStorage provides shared access to player Party and PC storage with:

  • UUID lookup
  • Party slot lookup
  • Membership snapshots
  • Predicate-based searches
  • Predicate-based counts

PokemonEntities provides read-only helpers for:

  • Underlying Pokémon access
  • Pokémon UUIDs
  • Owner UUIDs
  • Battle state
  • Busy state
  • Evolution state
  • Presence and alive checks

BattleInspector provides reusable battle information including:

  • Wild battles
  • Trainer battles
  • PvP battles
  • Battle actors
  • Player UUIDs
  • Participating Pokémon
  • Fainted Pokémon
  • Winners and losers

Event API

Version 1.1 expands the library with Java-friendly Cobblemon event hooks.

Supported event areas include:

  • Capture calculations and completed captures
  • Evolution
  • Battle start and victory
  • Fainting and fleeing
  • Battle gimmick instructions
  • Pokémon sending and recalling
  • Healing
  • Pokémon aspects
  • Pokédex updates
  • Pokémon spawning
  • Entity save and load events
  • Hatching
  • Trading
  • Releasing
  • Nicknames
  • Level changes
  • Experience changes

EventSubscriptionGroup can also track multiple subscriptions and cleanly unsubscribe them together, making it useful for reloadable or optional systems.

Pokédex API

PokedexQueries provides read-only helpers for:

  • Seen and caught species
  • Form progress
  • Aspect progress
  • Shiny knowledge
  • Global Pokédex counts
  • Individual Pokédex counts
  • Completion percentages

Documentation

Complete API documentation, integration guides and compatibility information are available online.

Documentation

GitHub Repository

The documentation includes:

  • Getting Started
  • Public API Overview
  • Integration Patterns
  • Pokémon API
  • Storage API
  • Event API
  • Battle API
  • Pokédex API
  • API stability policy
  • Cobblemon update strategy
  • Local development and Maven usage

License & API Use

OS Cobblemon Library itself is All Rights Reserved and distributed under the OS Cobblemon Library Proprietary API License.

Developers may build and distribute independent mods using the documented public API.

Using the API does not require consuming mods to publish or disclose their own source code.

Redistribution, modified builds, rebranding or copying Library source code are not permitted unless separately authorized.


Support the Project

Using OS Cobblemon Library in your project?

Support continued maintenance, compatibility updates and upcoming Our Story projects through Patreon.

Patreon Discord Support

For integration help, API suggestions, compatibility reports or bug reports, join the Our Story community on Discord.


Game Hosting

Need a server for your Cobblemon projects?

<img src="https://img.shields.io/static/v1?label=Partner&amp;message=BisectHosting&amp;color=5E76FA&amp;logo=BisectHosting&amp;logoColor=white&amp;style=for-the-badge" alt="BisectHosting">

Every purchase helps support the development of Our Story projects.


Created by LevelsFR

CurseForge • Modrinth • Discord • Patreon • GitHub • Docs

FAQ

OS Cobblemon Library questions

Question not listed? Ask our team.

OS Cobblemon Library server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Which loader does OS Cobblemon Library run on?

According to Modrinth, OS Cobblemon Library supports Fabric, NeoForge for Minecraft 1.21.1.

How much RAM does a server with OS Cobblemon Library need?

As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.

Ready for your server with OS Cobblemon Library?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server