KantoNPCs
KantoNPCs 是一款专为 CobbleKanto 项目打造的 Cobblemon NPC 实用模组,专注于为冒险地图、城镇、路线、道馆、商店以及多人服务器提供自定义的 NPC 交互体验。
该模组最初是为 CobbleKanto 构建的,但对于希望在基于 Cobblemon 的世界中更好地控制自定义 NPC 行为的地图制作人和服务器管理员来说,它也极具实用价值。
使用 Shockbyte 托管 Minecraft 服务器可享 75 折优惠!准备好与朋友们开启一段史诗般的冒险了吗?只需点击此处或横幅,并使用促销代码 “COBBLEKANTO”,同时您的支持还将帮助我们持续改进模组并开发未来的项目!
功能特性
- 针对不同 NPC 类型的自定义生成物品
- 用于地图事件、城镇、路线、任务、提示和剧情时刻的对话型 NPC
- 支持 Cobblemon 训练家对战的战斗型 NPC
- 具备初始宝可梦感知能力的竞争者型 NPC,以适配冒险进度推进
- 包含买卖界面的 Mart(百货)型 NPC
- 用于 Cobblemon 交换互动的交易员型 NPC
- 针对选定 Cobblemon 队伍槽位的教学型 NPC
- 自定义 NPC 皮肤及细身/宽体模型支持
- 外部皮肤文件夹,支持游戏内刷新/打开文件夹的工作流
- 外部对话文件,便于更轻松地定制地图和服务器内容
- 内置英语和巴西葡萄牙语支持
- 供建造者/管理员使用的 NPC 设置界面
- NPC 预设与移除工具
- 由商店和战斗奖励使用的玩家金钱系统
- Amulet Coin(护符金币)支持,可使战斗奖金翻倍
- 真新镇百货公司自动售货机方块
用途说明
KantoNPCs 主要是一款面向建造者和管理员的工具,旨在创建更加完善的 Cobblemon 冒险世界。
它可以用于在路线、城市、洞穴、道馆、商店、剧情区域、竞争者遭遇点、教学区和自定义事件的服务器大厅中放置 NPC。其目标并非取代所有可能的 NPC 框架,而是提供我们所需的特定系统,使探索体验更贴近我们钟爱的经典冒险地图感受。
大多数设置工具主要面向地图制作人、服务器所有者和操作者,而非普通生存玩家。
文档 / 设置手册
KantoNPCs 是一个配置繁重的工具,包含多种 NPC 类型、对话格式、奖励选项、商店、交易、教学、皮肤以及建造者工作流。主项目页面提供了总体概览,但完整的设置参考可在官方文档中找到:
打开 KantoNPCs Wiki
当你需要字段解释、对话 JSON 示例、选择文件格式、NPC 设置笔记、故障排除步骤或地图/服务器工作流的示例时,请使用该 Wiki。
NPC 类型
对话 NPC (Dialog NPC)
用于正常对话、剧情提示、路线对话、事件文本、是/否选择,以及基于对话的奖励或命令执行。
战斗 NPC (Battle NPC)
用于 Cobblemon 训练家风格的战斗,可配置队伍、对话流程、奖励、奖金、再战冷却时间以及战后行为。
竞争者 NPC (Rival NPC)
一种专注于战斗的 NPC 类型,专为竞争者风格的遭遇设计,包括对追踪玩家所选初始宝可梦进度的支持。
Mart NPC (百货 NPC)
创建具有买卖标签页的商店风格 NPC,可配置产品列表、描述、价格、基于物品的交易成本,并支持 Cobblemon 主题的商店布局。
交易员 NPC (Trader NPC)
创建交换型 NPC,请求特定的 Cobblemon 并给予另一只作为回报。交易与选定的队伍槽位绑定,对于队伍中有重复物种的玩家来说更加安全。
教学 NPC (Move Tutor NPC)
允许建造者创建 NPC,为选定的 Cobblemon 教授配置好的招式,并验证该 Cobblemon 是否学会此招式。
共享 NPC 设置
大多数 NPC 类型采用相似的设置方式,因此你无需为每种 NPC 学习完全不同的系统。
根据 NPC 类型的不同,建造者可配置诸如 NPC 名称、模型类型、皮肤、大小、坐姿、家园位置、注视行为、寻找玩家行为、对话 ID、奖励字段、命令、战斗/队伍数据、商店数据、交易数据或教学数据等。
模组还包含 NPC 预设和移除工具,以便在构建大型路线或城镇时减轻地图编辑的痛苦。
对话系统
KantoNPCs 通过配置文件夹支持外部对话文件,使得在不重新编译模组的情况下更容易编辑对话内容。
NPC 可以使用正常的对话流程、是/否选择、开始/结束/战后对话,以及基于对话的奖励,具体取决于 NPC 类型。
这使其适用于剧情路线、道馆、商店、竞争者遭遇、教学 NPC、路标式提示以及地图专属事件。
商店与金钱
KantoNPCs 包含一个玩家金钱系统,被 Mart NPC、战斗奖励、出售物品以及真新镇百货公司自动售货机所使用。
Mart NPC 可配置自定义的买卖行为,包括物品产品、Cobblemon 风格的产品展示、描述、价格以及基于物品的交易成本。
内置的 Amulet Coin(护符金币)物品在满足配置条件时可使战斗奖金翻倍。
建造者建议
KantoNPCs 功能强大,但也高度依赖配置。
为了获得最佳效果:
- 首先在世界备份副本中配置和测试 NPC。
- 在对玩家开放之前,先在专用服务器上测试战斗 NPC 和竞争者 NPC。
- 如果你的地图包含许多城镇、路线、任务和事件,请保持对话 ID 的组织有序。
- 仔细测试商店价格、卖出价格、物品交易和奖励。
- 对于大型冒险地图,也要在游戏外记录重要的 NPC 信息。
兼容性与依赖项
KantoNPCs v1.0.6 支持 Minecraft 1.21.1、Java 21、Fabric 和 NeoForge。
KantoNPCs v1.0.5 或更早版本仅支持 Fabric。
Fabric:
- Fabric Loader 0.16.10+
- Fabric API
- Cobblemon 1.8.0+
NeoForge:
- NeoForge 21.1.219+
- Cobblemon 1.8.0+
- Kotlin for Forge 5.10.0+
本次发布版本在 Minecraft 1.21.1 环境下,针对 Cobblemon 1.8.2 进行了更新与测试。
已知问题
- DialogPreview 无法与 dialog_arrays 服务器存档同步。这意味着仅视觉效果未显示……已保存的更改应在游戏中实时“翻译”。如果未生效,请重启服务器!
- 服务器中的每位玩家都需要在文件夹中拥有地图中使用的所有皮肤。仅将 .png 文件放置在服务器文件夹中,不会为所有玩家更新。
常见问题解答 (FAQ)
KantoNPCs 可以在没有 Cobblemon 的情况下运行吗?
不可以。KantoNPCs 依赖 Cobblemon 来实现战斗、队伍、物种、招式、导师交易及相关系统。
这仅适用于 CobbleKanto 吗?
不完全是。它最初是为 CobbleKanto 创建的,但其他希望使用以 Cobblemon 为核心的 NPC 系统的地图制作者和服务器管理员也可以使用它。
我可以在自己的地图、服务器或内容中使用它吗?
可以。你可以在地图、服务器、整合包、截图、视频、直播以及其他游戏内容中使用它!
如何获取支持?
请使用项目的问题页面提交错误报告和兼容性问题反馈。如需直接反馈、建议或与项目相关的问题,你也可以通过 Discord 直接向 cobblekanto 发送私信。
特别感谢
如果你有想法或反馈,并希望协助我们为 Cobblemon 社区提供更好的工具,请在 Discord 上给 cobblekanto 发送私信!
使用优惠码 COBBLEKANTO 可在 Shockbyte 享受 Minecraft 服务器 25% 的折扣!准备好与你的朋友们开启一场史诗般的冒险吧!
天生巨人 ??
KantoNPCs 是一款非官方的粉丝自制 Minecraft 模组。
本项目未与 Nintendo、Game Freak、Creatures Inc.、The Pokémon Company、Mojang Studios、Microsoft、Cobblemon 或 CobbledStudios 建立关联、获得其认可、赞助或批准。
Minecraft 是 Microsoft Corporation 的商标。Pokémon 及相关名称是其各自所有者的商标。Cobblemon 属于其各自的创作者。
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
KantoNPCs v1.0.6 supports Minecraft 1.21.1, Java 21, Fabric and NeoForge.
KantoNPCs v1.0.5 or older are only for Fabric.
Fabric:
- Fabric Loader 0.16.10+
- Fabric API
- Cobblemon 1.8.0+
NeoForge:
- NeoForge 21.1.219+
- Cobblemon 1.8.0+
- Kotlin for Forge 5.10.0+
The current release was updated and tested around Cobblemon 1.8.2 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!
Get 25% off your Minecraft server with Shockbyte! Use promo code COBBLEKANTO and get ready to start an epic adventure with your friends!
Gigante pela própria natureza ??
KantoNPCs is an unofficial fan-made Minecraft mod.
This project is not affiliated with, endorsed by, sponsored by, or approved by Nintendo, Game Freak, Creatures Inc., The Pokémon Company, Mojang Studios, Microsoft, Cobblemon, or CobbledStudios.
Minecraft is a trademark of Microsoft Corporation. Pokémon and related names are trademarks of their respective owners. Cobblemon belongs to its respective creators.
评论 0
登录后参与评分
还没有评论,来抢沙发吧