

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.
- 01
Configure
4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 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.
- 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.
- 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.

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.

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- OS Cobblemon Library 1.6.0November 21, 2026Minecraft 1.21.1 · NeoForge
- OS Cobblemon Library 1.6.0November 21, 2026Minecraft 1.21.1 · Fabric
Original description by the project author
OS Cobblemon Library
A lightweight shared Cobblemon API and compatibility library for Fabric and NeoForge.
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 sizeentity- Pokémon entity identity, ownership and statestorage- Party and PC access, lookup, matching and countsevent- reusable Cobblemon event subscriptions and lifecycle handlingbattle- battle inspection and classificationpokedex- 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
PokemonMatcherpredicates - 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.
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.
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&message=BisectHosting&color=5E76FA&logo=BisectHosting&logoColor=white&style=for-the-badge" alt="BisectHosting">
Every purchase helps support the development of Our Story projects.
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.
Similar mods
Popular mods in the same category
Fabric API
by modmuss50
Lightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Server-ready
Cloth Config API
by shedaniel
Configuration Library for Minecraft Mods
Server-ready
YetAnotherConfigLib (YACL)
by isxander
A builder-based configuration library for Minecraft!
Server-ready
Fabric Language Kotlin
by modmuss50
This is a mod that enables usage of the Kotlin programming language for Fabric mods.
Ready for your server with OS Cobblemon Library?
4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.