KantoNPCs

KantoNPCs is a Cobblemon NPC utility mod created for the CobbleKanto project, focused on custom NPC interactions for adventure maps, towns, routes, gyms, shops, and multiplayer servers.

It was originally built for CobbleKanto, but it can also be useful for map makers and server owners who want more control over custom NPC behavior in Cobblemon-based worlds.

Get 25% off your Minecraft server with Shockbyte! Ready to start an epic adventure with your friends? Just click here or on the banner and use promo code “COBBLEKANTO”, plus you’ll be helping us keep improving the mod and developing future projects!

Features

• Custom NPC spawner items for different NPC types
• Dialogue NPCs for map events, towns, routes, quests, hints, and story moments
• Battle NPCs with Cobblemon trainer battles
• Rival NPCs with starter-aware behavior for adventure progression
• Mart NPCs with buy and sell interfaces
• Trader NPCs for Cobblemon exchange interactions
• Move Tutor NPCs for selected Cobblemon party slots
• Custom NPC skins and slim/wide model support
• External skin folder with in-game refresh/open-folder workflow
• External dialogue files for easier map and server customization
• Built-in English and Brazilian Portuguese support
• NPC setup screens for builders/admins
• NPC preset and remove tools
• Player money system used by shops and battle rewards
• Amulet Coin support for battle doubled prize money
• Celadon Dept. Store vending machine block

What It Is For

KantoNPCs is mainly a builder/admin tool for creating more complete Cobblemon adventure worlds.

It can be used to place NPCs in routes, cities, caves, gyms, shops, story areas, rival encounters, tutorial zones, custom events, and server hubs. The goal is not to replace every possible NPC framework, but to provide the specific systems we needed to make exploration feel closer to our beloved classic adventure map experience.

Most setup tools are intended for map makers, server owners, and operators rather than normal survival players.

Documentation / Setup Manual

KantoNPCs is a heavy config tool with several NPC types, dialogue formats, reward options, shops, trades, move tutors, skins, and builder workflows. The main project page gives a general overview, but the full setup reference is available in the official documentation:

Open the KantoNPCs Wiki

Use the wiki when you need field explanations, dialogue JSON examples, choice file formats, NPC setup notes, troubleshooting steps, or examples for map/server workflows.

NPC Types

Dialog NPC
Used for normal conversations, story hints, route dialogue, event text, yes/no choices, and dialogue-based rewards or commands.

Battle NPC
Used for Cobblemon trainer-style battles with configurable teams, dialogue flow, rewards, prize money, rematch cooldowns, and post-battle behavior.

Rival NPC
A battle-focused NPC type designed for rival-style encounters, including starter-aware progression support for maps that track a player's chosen starter.

Mart NPC
Creates shop-style NPCs with buy/sell tabs, configurable product lists, descriptions, prices, item-based trade costs, and support for Cobblemon-themed shop layouts.

Trader NPC
Creates exchange NPCs that request a specific Cobblemon and give another one in return. The trade is tied to the selected party slot, making it safer for players with duplicate species in their party.

Move Tutor NPC
Lets builders create NPCs that teach a configured move to the selected Cobblemon, with validation for whether that Cobblemon can learn the move.

Shared NPC Setup

Most NPC types share a similar setup style, so you do not need to learn a completely different system for every NPC.

Depending on the NPC type, builders can configure things like the NPC name, model type, skin, size, sitting pose, home position, looking behavior, seek-player behavior, dialogue IDs, reward fields, commands, battle/team data, shop data, trade data, or tutor data.

The mod also includes NPC preset and removal tools to make map editing less painful while building large routes or towns.

Dialogue System

KantoNPCs supports external dialogue files through the config folder, making it easier to edit dialogue without rebuilding the mod.

NPCs can use normal dialogue flows, yes/no choices, start/end/post-battle dialogue, and dialogue-driven rewards depending on the NPC type.

This makes it useful for story routes, gyms, shops, rival encounters, tutorial NPCs, signpost-style hints, and map-specific events.

Shops and Money

KantoNPCs includes a player money system used by Mart NPCs, battle rewards, selling items, and the Celadon Dept. Store vending machine.

Mart NPCs can be configured for custom buy/sell behavior, including item products, Cobblemon-style product display, descriptions, prices, and item-based trade costs.

The included Amulet Coin item can double battle prize money when the configured conditions are met.

Builder Recommendations

KantoNPCs is powerful, but it is also configuration-heavy.

For best results:

• Configure and test NPCs in a backup copy of your world first.
• Test battle NPCs and rival NPCs on a dedicated server before opening them to players.
• Keep dialogue IDs organized if your map has many towns, routes, quests, and events.
• Test shop prices, sell prices, item trades, and rewards carefully.
• For major adventure maps, document important NPCs outside the game as well.

Compatibility & Dependencies

• Minecraft 1.21.1
• Fabric Loader
• Fabric API
• Java 21
• Cobblemon 1.7.1 or newer

The current release was updated and tested around Cobblemon 1.7.3 for Minecraft 1.21.1.

Known Issues

• DialogPreview doesn't sync with dialog_arrays server archives. That means that only the visual effect is not shown... saved changes should be "translated" in real time in the game. If not, restart the server!
• Every player in the server needs to have all the skins used in the map in the folder. Placing the .png only on the server folder doesn't update for everyone.

FAQ

Does KantoNPCs work without Cobblemon?

No. KantoNPCs depends on Cobblemon for battle, party, species, move, tutor, and trade-related systems.

Is this only for CobbleKanto?

No. It was created for CobbleKanto, but it can also be used by other map makers and server owners who want Cobblemon-focused NPC systems.

Can I use this in my own map, server or content?

Yes, you can use it in maps, servers, modpacks, screenshots, videos, livestreams, and other gameplay content!

How do I get support?

Use the project issues page for bug reports and compatibility issues. For direct feedback, ideas, or project-related questions, you can also send a direct message to cobblekanto on Discord.

Special Thanks

• To everyone helping polish the CobbleKanto project and its custom mods.

If you have ideas or feedback and want to assist us in delivering better tools for the Cobblemon community, drop a direct message at cobblekanto on Discord!