Fabric is the current release
The public release runs on Fabric — use cobblemon_battlehub-fabric-<version>.jar. A NeoForge build exists and is in testing; it will be published once verified — watch Discord. Note that CarbonChat has no NeoForge build, so the in-menu chat tabs will stay Fabric-only.
Server Requirements
Before starting the installation process, make sure your infrastructure meets all the required dependencies listed below:
Common: Minecraft 1.21.1 · Java 21+ · Cobblemon 1.8.0–1.8.4 (or 1.7.3 — see which jar) · Architectury API 13.0+
| Fabric | NeoForge | |
|---|---|---|
| Loader | Fabric Loader 0.16+ |
NeoForge 21.1.133+ |
| API | Fabric API 0.116.6+1.21.1+ |
— |
| Kotlin runtime | Fabric Language Kotlin 1.13.0+kotlin.2.1.0+ |
Kotlin for Forge 5.7.0+ |
Installation:
The installation process for Cobblemon BattleHUB is simple and straightforward. Follow the steps below to prepare your server correctly.
Step 1: Initial Installation
- Transfer the mod
.jarfor your loader to your server'smodsdirectory, alongside Cobblemon, Architectury API and the Kotlin runtime (Fabric Language Kotlin on Fabric, Kotlin for Forge on NeoForge — plus Fabric API on Fabric). - Start (or restart) the server to load the mod into memory.
- The mod will automatically generate the
cobblemon_battlehubfolder inside your server'sconfig/directory during startup.
Step 2: Configure the Files
Navigate to the newly created config/cobblemon_battlehub/ folder and perform the required basic adjustments in the following files so the mod knows where to operate:
fallbackarenadisconnect.json
This file defines where the player will be teleported when disconnecting or leaving the arena. Set your server lobby coordinates:
json
{
"dimension": "multiworld:void",
"x": 777.5,
"y": 77.0,
"z": 777.5,
"yaw": 0.0,
"pitch": 0.0
}
arenas.json
Here you should configure the dimension where the arena structures will be generated:
{
"dimension": "multiworld:battles",
"arenas": [
// Configure your arenas here
]
}
Step 3: Mod Activation
To unlock the mod, you need to activate your license inside the server:
- 1. Join your server.
- 2. Use the activation command:
/bh activation [LICENSE-KEY]- (The [KEY] is sent to you immediately after payment confirmation via Stripe).
Attention: Single Server License
This license is valid exclusively for a single active instance. Your activation key is permanently bound to the first server that activates it. Multiple activations or key sharing are not possible.
Don't have an activation key yet?
Your license key (License Key) is automatically generated and sent to your email as soon as your Stripe payment is confirmed. To acquire yours, join our Official Discord and open a support ticket.
Step 4: Finalization
After configuring the JSON files and activating your key, run the following command on the server to apply the changes:
/bh reload