Overview#
Pokécube Core serves as the central library and functional engine for the Pokécube mod series in Minecraft. Unlike traditional turn-based Pokémon mods, Pokécube Core implements a real-time combat system where creatures, known as Pokémobs, move and attack freely in the world.
By default, the Core mod includes the essential mechanics, items, and a single Pokémob (Zubat) to demonstrate functionality. To access the full roster of over 800 Pokémon, players typically install the Pokécube Mobs addon. The mod focuses on a "Minecrafty" aesthetic, utilizing box-based models that are highly optimized for performance, allowing for hundreds of entities to be loaded simultaneously without significant lag.
Getting Started#
Upon first joining a world, players are prompted to choose a Starter Pokémob. This selection provides the player with their first companion, a set of 10 basic Pokécubes, a Pokédex (PokeWatch), and a portable Pokécenter (Healer).
Basic Controls
- R: Send out or recall the selected Pokémob.
- G: Command the Pokémob to perform an action or attack a target.
- Arrow Keys: Cycle through the Pokémobs in your inventory (Left/Right) and select active moves (Up/Down).
- Backslash (): Open the Pokémob's inventory and statistics GUI.
Pokémobs (Mobs)#
Pokémobs are dynamic entities with complex AI. They possess individual personalities, genders, and genetic traits.
Statistics and Attributes
| Every Pokémob is defined by six core stats, which grow as they level up: | Stat | Description |
|---|---|---|
| HP | Health points; when it reaches zero, the mob faints and must be revived. | |
| Attack | Determines damage dealt by physical moves. | |
| Defense | Reduces damage taken from physical moves. | |
| Sp. Atk | Determines damage dealt by special/elemental moves. | |
| Sp. Def | Reduces damage taken from special moves. | |
| Speed | Influences movement speed and attack frequency in real-time combat. |
Behavior and Aggression
Wild Pokémobs have varying aggression levels:
- Passive: Will not attack unless provoked.
- Aggressive: Will chase and attack players or other mobs on sight.
- Berserk: Rare state where the mob attacks everything in its vicinity.
Pokémobs also interact with the environment; for example, Fire-types may accidentally start fires, while Grass-types may cause plants to grow faster.

Items#
Pokécube Core adds a vast array of items for capturing, healing, and enhancing Pokémobs.
Pokécubes
These are the primary tools for capturing wild Pokémobs. Different cubes have different catch rate multipliers.
| Item | Catch Multiplier | Special Effect |
|---|---|---|
| Pokécube | 1x | Standard capture device. |
| Greatcube | 1.5x | Higher success rate. |
| Ultracube | 2x | High-performance capture. |
| Mastercube | 255x | Guaranteed capture. |
| Snagcube | N/A | Used to capture Pokémobs already owned by other trainers (if enabled). |
Essential Tools
- Pokédex (PokeWatch): Displays detailed info on Pokémobs, including types, moves, and spawn locations. Right-clicking a block with it shows which mobs can spawn in that biome.
- Revive: Restores a fainted Pokémob to half health. Can be crafted by brewing Oran Berries.
- Exp. Share: When held by a Pokémob outside its cube, it shares experience gained from battles even if it didn't participate.
- Shiny Charm: Increases the likelihood of encountering Shiny Pokémobs in the wild.
Functional Blocks#
The mod introduces several machines necessary for managing a Pokémob team.
- Healer (Pokécenter): Right-clicking this block heals all Pokémobs in the player's inventory. It requires no power by default but can be configured to use Redstone or Energy.
- PC (Storage System): Allows players to store Pokémobs beyond the 6-slot inventory limit. It features a searchable interface and box management.
- Trading Table: Used to trade Pokémobs between players. Certain species only evolve when traded via this block.
- Fossil Reanimator: Used to bring ancient Pokémobs back to life from Fossil items found while mining.
- Energy Siphon: Extracts energy from Electric-type Pokémobs to power other machines in the mod.
Mechanics#
Catching
To catch a Pokémob, you must throw a Pokécube at it. The success rate is determined by the formula:
Catch Rate = ((3 * MaxHP - 2 * CurrentHP) * Rate * BallModifier) / (3 * MaxHP) * StatusModifier
Lowering the target's HP and inflicting status effects (Sleep, Paralysis) significantly increases the odds.
Evolution
Evolution occurs through several methods:
- Leveling: Reaching a specific level threshold.
- Evolution Stones: Using items like the Fire Stone or Water Stone on the mob.
- Trading: Exchanging the mob via a Trading Table.
- Happiness: Increasing the mob's bond through walking and winning battles.
Breeding
Two Pokémobs of opposite genders and compatible Egg Groups can breed if left in a Daycare Block. They will eventually produce an Egg, which must be carried in the player's inventory or placed in a warm environment to hatch.
Commands#
Admins can use these commands to manage the world and Pokémobs:
/pokemake <species> [args]: Spawns a custom Pokémob. Arguments includes(shiny),l:<level>, andn:<nickname>./pokespawn <species>: Spawns a wild Pokémob of the specified species./pokecube cull: Removes all wild Pokémobs that are not near a player to reduce lag./pokecube restore <player>: Recovers lost or glitched Pokémobs for a specific player./pokesettings <option> [value]: Views or modifies configuration settings directly from the in-game chat.
Configuration#
The mod is highly customizable via the pokecube.cfg file. Key configurable aspects include:
- Spawn Rates: Adjust the density of Pokémobs in specific biomes.
- Damage Multipliers: Scale the damage dealt by Pokémobs to players or the environment.
- Dimension Control: Whitelist or blacklist specific dimensions (like the Nether or End) for Pokémob spawning.
- Resource Packs: Pokécube Core allows users to completely override mob models, textures, and sounds using standard Minecraft resource packs.