Cobblemon Cinematics

Cobblemon Cinematics is a client-side cinematic mod for Minecraft 1.21.1, NeoForge, and Cobblemon 1.7.3. It adds procedural animation, dynamic cameras, and sound effects to Trainer battles and badge acquisition without bundling large background frame sequences.

Features

• Trainer battle intros: Plays a Pokemon-inspired sequence with high-speed backgrounds, flashes, the Trainer's name, and an animated NPC model when a Cobblemon Trainer battle begins.
• Double-battle intros: When the opposing side contains two Trainers, both NPC models, names, and send-out animations are presented in a dedicated split layout.
• Trainer Poke Ball animation: Cobblemon NPCs use their own send_out skeletal animation and Poke Ball item attachment. Other Trainer entities use a compatible fallback animation.
• Battle camera: Frames all active Pokemon using their bounding-box size, the current FOV and display aspect ratio, then focuses on the attacker and target after a move is selected.
• Dynamic camera hint: Shows the currently bound camera-toggle key during automatic camera operation.
• Cinematic audio: Reuses Cobblemon and Minecraft sound events for battle introductions, Mega Evolution, Dynamax, Z-Power, and Terastallization without bundling copyrighted Pokémon game audio.
• Camera collision: Scores alternate yaw and pitch positions for clearance and subject visibility, then uses Minecraft's native collision detection as the final wall-clipping safeguard.
• Badge acquisition cinematic: Plays a procedural golden backdrop, particles, rings, the actual badge item model, and an acquisition sound when a matching item is obtained.
• Screen compatibility: Pauses the game and opens a dedicated screen when no screen is active. If another screen is already open, the cinematic renders above it without blocking its interaction.
• Optional mod compatibility: Does not depend on a specific badge mod. The default configuration recognizes Badge Box and Cobblemon Pokemon Badges items and can also match custom modpack items.
• Mega Showdown cinematics: When Mega Showdown is installed, Mega Evolution, Dynamax, Z-Power, and Terastallization receive distinct code-drawn battle presentations.

All backgrounds, speed lines, light beams, particles, rings, and flashes are drawn in real time by code. The mod does not include background images or badge textures from the reference mod.

Requirements

Required:

• Minecraft 1.21.1
• NeoForge 21.1.x
• Kotlin for Forge 5.12+
• Cobblemon 1.7.3

Badge Box, Cobblemon Pokemon Badges, and Mega Showdown are optional. Badge items are recognized through configurable matching rules. Mega Showdown is detected at runtime and is not loaded or referenced when absent.

Configuration

The client configuration is stored in config/cobblemoncinematics-client.toml.

Intro whitelist and blacklist entries use complete resource IDs such as cobblemon:mew. Blacklists always take priority. An empty whitelist or a whitelist containing * allows every ID; a blacklist containing * blocks every ID. Wild intros have no separate toggle: the Pokemon lists directly determine which species receive them.

Badge Matching Rules

badges.itemMatchers supports three rule types:

[badges]
itemMatchers = [
  "item:examplemod:league_badge",
  "regex:^examplemod:[a-z0-9_]+_badge$",
  "tag:examplemod:badges"
]

• item: matches one exact item ID.
• regex: matches a regular expression against the complete namespace:path ID.
• tag: matches any item in the specified item tag.

NeoForge reloads the client configuration after the rules are changed. One-time badge progress is stored per save/server and player, so a new save starts with its own badge presentations. Delete config/cobblemoncinematics-badges.json to clear all local progress.

Controls

• V: Temporarily enables or disables the dynamic camera during battle. This key can be rebound in Minecraft's control settings.

Cinematic Test Commands

These client commands can be run from chat anywhere in a loaded world. They open an isolated test screen and replay the complete visual cinematic, including its model rendering, procedural effects, title, and sound:

/cobblemoncinematics test battle_intro
/cobblemoncinematics test badge
/cobblemoncinematics test mega
/cobblemoncinematics test dynamax
/cobblemoncinematics test zmove
/cobblemoncinematics test terastalization
/cobblemoncinematics test all

The intro uses the local player as a test Trainer, the badge test uses a temporary Nether Star, and gimmick tests render a client-only Pikachu when no battle Pokémon exists. Explicit test commands bypass feature toggles and do not require Mega Showdown because they only exercise this mod's presentation layer; automatic triggering from real battles remains available only when Mega Showdown is installed and respects every corresponding configuration option. all plays every test cinematic sequentially.