KantoStarters
KantoStarters 是一款适用于 Fabric/Cobblemon 的工具模组,允许创作者使用普通的 Minecraft 方块构建可配置的选项站。
此模组最初是为 CobbleKanto 项目创建的,但其他希望在自己的 Cobblemon 世界中拥有自定义初始选择、奖励或一次性选择系统的服务器管理员和地图创作者也可以使用它。
KantoStarters 不会添加任何专属的物理方块。相反,它允许你将地图中现有的方块绑定到已配置的选项上。这些选项可用于初始精灵选择、道馆式奖励、化石选择、特殊生物赠送、自定义物品奖励,或玩家必须从一组配置选项中选择一个的任何其他地图事件。
使用 Shockbyte 购买 Minecraft 服务器可享 25% 折扣!准备好和朋友一起开始一场史诗般的冒险了吗?只需点击 这里 或横幅,并使用促销代码 “COBBLEKANTO”,同时你还将帮助我们持续改进模组并开发未来项目!
功能特性
- 自定义初始选择和奖励选择系统
- 通过 JSON 文件配置选择会话
- 将任意普通 Minecraft 方块绑定至已配置的选项
- 带有 YES/NO 确认功能的自定义对话框屏幕
- 支持 Cobblemon 3D 预览
- 支持基于物品的选项的物品预览
- 一次性选择保护
- 可选:如果玩家已有 Cobblemon 则阻止使用该选项
- 可选:控制默认 Cobblemon 初始界面
- 针对不同玩家语言的语言特定对话文件
系统概述
KantoStarters 使用可配置的 选择会话 (choice sessions)。
每个会话可以包含多个选项,但每个物理方块仅链接到一个特定选项。
例如,经典的初始选择台可以用三个方块构建:
- 一个方块链接到
start / bulbasaur
- 一个方块链接到
start / charmander
- 一个方块链接到
start / squirtle
当玩家右键点击其中一个绑定的方块时,会打开一个自定义对话框屏幕,显示预览、对话文本以及 YES/NO 确认按钮。
如果玩家确认选择,模组可以执行命令、给予物品,并将该会话标记为对该玩家已完成。
Show setup and configuration details
设置
在绑定世界中的方块之前,你需要在配置文件中创建或编辑一个选择会话:
config/kantostarters/choice_sessions.json
一个选择站基于两个 ID:
sessionId — 选项组,例如 start、dojo 或 mtmoon
choiceId — 该会话内的具体选项,例如 bulbasaur、charmander 或 helix_fossil
示例:
{
"sessionId": "start",
"enabled": true,
"oneTimeChoice": true,
"blockIfAlreadyHasCobblemon": false,
"textColour": "#3050c8",
"secondConfirmLines": [],
"choices": [
{
"choiceId": "bulbasaur",
"displayName": "Bulbasaur",
"previewSpecies": "bulbasaur",
"dialogId": "start_bulbasaur_dialog",
"dialogLines": [],
"itemRewards": [],
"previewScale": 1.0,
"previewOffsetX": -1,
"previewOffsetY": 4,
"commands": [
"pokegive %player% bulbasaur level=5"
]
}
]
}
推荐设置顺序:
- 在
choice_sessions.json 中创建或编辑会话。
- 创建
sessionId 和 choiceId。
- 运行
/kantostarters reload。
- 注视你想要绑定的方块。
- 运行
/kantostarters set <sessionId> <choiceId>。
- 如有需要,使用
/kantostarters open <sessionId> <choiceId> 测试该选项。
示例:
/kantostarters set start bulbasaur
之后,玩家可以右键点击该方块以打开该特定选项。
要移除你所注视方块的绑定:
/kantostarters unset
所有设置命令都需要操作者/管理员权限。
配置文件
首次启动时,KantoStarters 会在以下位置创建其配置文件:
config/kantostarters/
主要文件:
choice_sessions.json
choice_dialog_arrays_en_us.json
choice_dialog_arrays_pt_br.json
默认情况下,模组包含以下示例会话:
start — Bulbasaur、Charmander 和 Squirtle
dojo — Hitmonlee 和 Hitmonchan
celadoneevee — Eevee
mtmoon — Helix Fossil 和 Dome Fossil
这些仅是默认示例。你可以编辑、删除、扩展或使用你自己的自定义会话替换它们。
在使用 /kantostarters set 之前,始终先在 choice_sessions.json 中创建会话和选项。
会话 (Sessions)
每个会话控制一组相关的选项。
示例:
{
"sessionId": "start",
"enabled": true,
"oneTimeChoice": true,
"blockIfAlreadyHasCobblemon": false,
"textColour": "#3050c8",
"secondConfirmLines": [],
"choices": []
}
sessionId
内部会话名称。它用于诸如以下命令中:
/kantostarters set start bulbasaur
enabled
如果设置为 false,则该会话无法使用。
oneTimeChoice
如果设置为 true,则每个玩家只能完成一次该会话。
确认选项后,玩家将获得内部标签,例如:
ks_done_start
ks_choice_start_bulbasaur
blockIfAlreadyHasCobblemon
如果设置为 true,则队伍或 PC 中已有 Cobblemon 的玩家无法使用此会话。
这对于初始选择系统非常有用,你不希望玩家在已经获得或捕获了某些东西后再领取初始精灵。
textColour
控制对话文本的颜色。
secondConfirmLines
可选的额外确认对话。
当你希望在最终锁定选择之前发出第二次警告时,这非常有用。
选项 (Choices)
每个选项控制会话内的一个可选项目。
示例:
{
"choiceId": "bulbasaur",
"displayName": "Bulbasaur",
"previewSpecies": "bulbasaur",
"dialogId": "start_bulbasaur_dialog",
"dialogLines": [],
"itemRewards": [],
"previewScale": 1.0,
"previewOffsetX": -1,
"previewOffsetY": 4,
"commands": [
"pokegive %player% bulbasaur level=5"
]
}
choiceId
选项的内部 ID。
displayName
在选项界面中显示并使用的名称。
previewSpecies
控制选项界面中显示的预览内容。
对于 Cobblemon 的预览,请使用物种 ID:
"previewSpecies": "bulbasaur"
对于物品预览,请使用完整的物品 ID:
"previewSpecies": "cobblemon:helix_fossil"
dialogId
用于从对话配置文件中加载对话行的 ID。
示例:
"dialogId": "start_bulbasaur_dialog"
dialogLines
如果未找到 dialogId 时使用的备用对话行。
itemRewards
直接物品奖励。
示例:
"itemRewards": [
{
"itemId": "minecraft:diamond",
"count": 1
}
]
如果玩家背包已满,多余的物品会掉落在玩家附近。
预览设置
previewScale、previewOffsetX 和 previewOffsetY 控制预览在选项界面中的视觉位置和大小。
当模型或物品显得过大、过小、过高或过低时,这些设置非常有用。
commands
玩家确认选项时执行的命令。
示例:
"commands": [
"pokegive %player% bulbasaur level=5"
]
支持的占位符:
%player% — 玩家名称
%uuid% — 玩家 UUID
%choice% — 选定的选项 ID
%session% — 会话 ID
命令由服务器以管理员权限执行。
对话文件
KantoStarters 会为不同语言生成单独的对话文件:
config/kantostarters/choice_dialog_arrays_en_us.json
config/kantostarters/choice_dialog_arrays_pt_br.json
示例:
{
"start_bulbasaur_dialog": [
"I see! BULBASAUR is your choice.",
"It's very easy to raise.",
"So, [player], you want to go with",
"the GRASS COBBLEMON BULBASAUR?"
]
}
支持的占位符:
[player]
[choice_display]
[choice_id]
[preview_species]
模组会自动尝试使用玩家选择的 Minecraft 语言。
如果找不到匹配的对话文件,将回退到 en_us。
您可以通过使用相同格式创建文件来添加更多语言。
示例:
config/kantostarters/choice_dialog_arrays_es_es.json
对话格式
对话行会自动为自定义选项界面进行换行处理。
为了获得最佳效果,请保持每行简短易读。
您还可以使用:
/p
作为对话数组内的分页符。
示例:
{
"example_dialog": [
"This is the first page.",
"/p",
"This is the second page."
]
}
初始屏幕
KantoStarters 可以控制是否允许默认的 Cobblemon 初始选择界面打开。
要启用默认初始界面:
/kantostarters DefaultPickStarters on
要禁用默认初始界面:
/kantostarters DefaultPickStarters off
如果您将 KantoStarters 用作主要的初始选择系统,您可能希望:
/kantostarters DefaultPickStarters off
这样可以让您的自定义选择站来处理初始宝可梦的选择。
重要提示:
KantoStarters 本身不会在玩家加入时自动给予初始宝可梦。您应该构建并配置自己的初始区域,绑定所需的方块,并决定玩家如何访问这些选项。
命令
重载配置:
/kantostarters reload
显示基本调试信息:
/kantostarters debug
列出配置的会话和选项:
/kantostarters list
绑定您正看向的方块:
/kantostarters set <sessionId> <choiceId>
移除您正看向的方块的绑定:
/kantostarters unset
直接打开一个选项进行测试:
/kantostarters open <sessionId> <choiceId>
启用或禁用阻止已拥有 Cobblemon 的玩家进入某个会话:
/kantostarters BlockIfAlreadyHasCobblemon <sessionId> <true|false>
启用默认 Cobblemon 初始界面:
/kantostarters DefaultPickStarters on
禁用默认 Cobblemon 初始界面:
/kantostarters DefaultPickStarters off
重置运行命令的玩家的所有 KantoStarters 选项标签:
/kantostarters reset all
重置运行命令的一个会话:
/kantostarters reset <sessionId>
所有命令都需要操作员/管理员权限。
用例
KantoStarters 不仅仅用于首次初始选择。
它非常适合以下场景:
- 初始房间
- 道馆奖励
- 化石选择
- 一次性赠送的生物
- 物品奖励站
- 任务奖励
- 地图进度奖励
- 服务器活动奖励
- 自定义冒险地图选项
已知问题
- KantoStarters 是一个基于配置的模组。错误的会话 ID、选项 ID、物品 ID 或命令语法可能导致选项无法正常工作。
- 如果关闭了
DefaultPickStarters 但未配置任何自定义初始站,玩家可能无法通过默认的 Cobblemon 界面获得初始宝可梦。
兼容性与依赖项
- Minecraft 1.21.1
- Fabric Loader 0.17.2+
- Fabric API
- Java 21
- Cobblemon
常见问题
KantoStarters 在没有 Cobblemon 的情况下能工作吗?
不能。KantoStarters 需要 Cobblemon。
这个模组会添加新的方块或模型吗?
不会。KantoStarters 不会添加物理方块,但您可以将任何方块(甚至是不可见的障碍物)绑定为选项。
为什么我的选项没有打开?
请检查以下内容:
- 模组已安装在客户端和服务端。
- 会话存在于
choice_sessions.json 中。
- 选择位于该会话内部。
- 方块已通过
/kantostarters set 进行绑定。
- 玩家在使用右键点击时未处于潜行状态。
- 会话已启用。
- 玩家尚未完成一次性会话。
- 配置文件已在编辑后重新加载。
为什么我的奖励命令无法生效?
检查 choice_sessions.json 中的命令语法。
不要包含前导的 /。
示例:
"commands": [
"give %player% minecraft:diamond 1"
]
然后运行:
/kantostarters reload
特别感谢
- 感谢所有帮助完善 CobbleKanto 项目及其自定义模组的人们。
- 感谢 Cobblemon 社区激发了更多以冒险为核心的 Minecraft 体验。
如果您有想法或反馈,可以通过我们的公开问题追踪器分享,或在 Discord 上直接向 "cobblekanto" 发送私信。
使用促销码 COBBLEKANTO 在 Shockbyte 购买 Minecraft 服务器可享受 25% 折扣!准备好与朋友们开启一段史诗般的冒险吧!
天生巨人 ??
KantoStarters 是一个非官方的粉丝自制 Minecraft 模组。
本项目未与任天堂、Game Freak、Creatures Inc.、Pokémon Company、Mojang Studios、Microsoft 或 Cobblemon 团队有任何隶属、背书、赞助或批准关系。
Minecraft 是 Microsoft Corporation 的商标。Pokémon 及相关名称是其各自所有者的商标。Cobblemon 属于其各自的创作者。
KantoStarters
KantoStarters is a Fabric/Cobblemon utility mod that lets creators build configurable choice stations using normal Minecraft blocks.
This mod was originally created for the CobbleKanto project, but it can also be used by other server owners and map creators who want a custom starter, reward, or one-time choice system for their own Cobblemon worlds.
KantoStarters does not add physical blocks of its own. Instead, it lets you bind existing blocks from your map to configured choices. Those choices can be used for starter selection, dojo-style rewards, fossil choices, special creature gifts, custom item rewards, or any other map event where the player must choose one option from a configured set.
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 starter and reward choice system
- Configurable choice sessions through JSON files
- Bind any normal Minecraft block to a configured choice
- Custom dialogue screen with YES/NO confirmation
- 3D Cobblemon preview support
- Item preview support for item-based choices
- One-time choice protection
- Optional blocking if the player already has a Cobblemon
- Optional control over the default Cobblemon starter screen
- Language-based dialogue files for different player languages
System Overview
KantoStarters uses configurable choice sessions.
Each session can contain multiple choices, but each physical block is linked to one specific option.
For example, a classic starter table can be built with three blocks:
- one block linked to
start / bulbasaur
- one block linked to
start / charmander
- one block linked to
start / squirtle
When the player right-clicks one of these bound blocks, a custom dialogue screen opens with a preview, dialogue text, and a YES/NO confirmation.
If the player confirms the choice, the mod can run commands, give items, and mark that session as completed for that player.
Show setup and configuration details
Setup
Before binding a block in the world, you need to create or edit a choice session in the config file:
config/kantostarters/choice_sessions.json
A choice station is based on two IDs:
sessionId — the group of choices, such as start, dojo, or mtmoon
choiceId — the specific choice inside that session, such as bulbasaur, charmander, or helix_fossil
Example:
{
"sessionId": "start",
"enabled": true,
"oneTimeChoice": true,
"blockIfAlreadyHasCobblemon": false,
"textColour": "#3050c8",
"secondConfirmLines": [],
"choices": [
{
"choiceId": "bulbasaur",
"displayName": "Bulbasaur",
"previewSpecies": "bulbasaur",
"dialogId": "start_bulbasaur_dialog",
"dialogLines": [],
"itemRewards": [],
"previewScale": 1.0,
"previewOffsetX": -1,
"previewOffsetY": 4,
"commands": [
"pokegive %player% bulbasaur level=5"
]
}
]
}
Recommended setup order:
- Create or edit the session in
choice_sessions.json.
- Create the
sessionId and the choiceId.
- Run
/kantostarters reload.
- Look directly at the block you want to bind.
- Run
/kantostarters set <sessionId> <choiceId>.
- Test the choice with
/kantostarters open <sessionId> <choiceId> if needed.
Example:
/kantostarters set start bulbasaur
After that, players can right-click the block to open that specific choice.
To remove a binding from the block you are looking at:
/kantostarters unset
All setup commands require operator/admin permission.
Config Files
On first launch, KantoStarters creates its config files inside:
config/kantostarters/
Main files:
choice_sessions.json
choice_dialog_arrays_en_us.json
choice_dialog_arrays_pt_br.json
By default, the mod includes example sessions for:
start — Bulbasaur, Charmander, and Squirtle
dojo — Hitmonlee and Hitmonchan
celadoneevee — Eevee
mtmoon — Helix Fossil and Dome Fossil
These are only default examples. You can edit, remove, expand, or replace them with your own custom sessions.
Always create the session and choice in choice_sessions.json before using /kantostarters set.
Sessions
Each session controls a group of related choices.
Example:
{
"sessionId": "start",
"enabled": true,
"oneTimeChoice": true,
"blockIfAlreadyHasCobblemon": false,
"textColour": "#3050c8",
"secondConfirmLines": [],
"choices": []
}
sessionId
The internal session name. It is used in commands such as:
/kantostarters set start bulbasaur
enabled
If set to false, the session cannot be used.
oneTimeChoice
If set to true, each player can complete that session only once.
After confirming a choice, the player receives internal tags such as:
ks_done_start
ks_choice_start_bulbasaur
blockIfAlreadyHasCobblemon
If set to true, players who already have a Cobblemon in their party or PC cannot use this session.
This is useful for starter systems where you do not want players to claim a starter after already receiving or catching something.
textColour
Controls the dialogue text color.
secondConfirmLines
Optional extra confirmation dialogue.
This is useful when you want a second warning before the final choice is locked in.
Choices
Each choice controls one selectable option inside a session.
Example:
{
"choiceId": "bulbasaur",
"displayName": "Bulbasaur",
"previewSpecies": "bulbasaur",
"dialogId": "start_bulbasaur_dialog",
"dialogLines": [],
"itemRewards": [],
"previewScale": 1.0,
"previewOffsetX": -1,
"previewOffsetY": 4,
"commands": [
"pokegive %player% bulbasaur level=5"
]
}
choiceId
The internal ID of the choice.
displayName
The name shown and used by the choice screen.
previewSpecies
Controls the preview shown in the choice screen.
For Cobblemon previews, use a species ID:
"previewSpecies": "bulbasaur"
For item previews, use a full item ID:
"previewSpecies": "cobblemon:helix_fossil"
dialogId
The ID used to load dialogue lines from the dialogue config files.
Example:
"dialogId": "start_bulbasaur_dialog"
dialogLines
Fallback dialogue lines used if no dialogId is found.
itemRewards
Direct item rewards.
Example:
"itemRewards": [
{
"itemId": "minecraft:diamond",
"count": 1
}
]
If the player's inventory is full, leftover items are dropped near the player.
Preview settings
previewScale, previewOffsetX, and previewOffsetY control the visual position and size of the preview inside the choice screen.
These are useful when a model or item appears too big, too small, too high, or too low.
commands
Commands executed when the player confirms the choice.
Example:
"commands": [
"pokegive %player% bulbasaur level=5"
]
Supported placeholders:
%player% — player name
%uuid% — player UUID
%choice% — selected choice ID
%session% — session ID
Commands are executed by the server with admin permission.
Dialog Files
KantoStarters generates separate dialog files for different languages:
config/kantostarters/choice_dialog_arrays_en_us.json
config/kantostarters/choice_dialog_arrays_pt_br.json
Example:
{
"start_bulbasaur_dialog": [
"I see! BULBASAUR is your choice.",
"It's very easy to raise.",
"So, [player], you want to go with",
"the GRASS COBBLEMON BULBASAUR?"
]
}
Supported placeholders:
[player]
[choice_display]
[choice_id]
[preview_species]
The mod automatically tries to use the player's selected Minecraft language.
If a matching dialogue file is not found, it falls back to en_us.
You can add more languages by creating files using the same format.
Example:
config/kantostarters/choice_dialog_arrays_es_es.json
Dialogue Formatting
Dialogue lines are automatically wrapped for the custom choice screen.
For best results, keep each line short and readable.
You can also use:
/p
as a page break inside dialogue arrays.
Example:
{
"example_dialog": [
"This is the first page.",
"/p",
"This is the second page."
]
}
Starter Screen
KantoStarters can control whether the default Cobblemon starter selection screen is allowed to open.
To enable the default starter screen:
/kantostarters DefaultPickStarters on
To disable the default starter screen:
/kantostarters DefaultPickStarters off
If you are using KantoStarters as your main starter selection system, you will probably want:
/kantostarters DefaultPickStarters off
This lets your custom choice stations handle starter selection instead.
Important:
KantoStarters does not automatically give a starter on join by itself. You should build and configure your own starter area, bind the desired blocks, and decide how players access those choices.
Commands
Reload configs:
/kantostarters reload
Shows basic debug info:
/kantostarters debug
Lists configured sessions and choices:
/kantostarters list
Bind the block you are looking at:
/kantostarters set <sessionId> <choiceId>
Remove the binding from the block you are looking at:
/kantostarters unset
Open a choice directly for testing:
/kantostarters open <sessionId> <choiceId>
Enable or disable blocking players who already have a Cobblemon for a session:
/kantostarters BlockIfAlreadyHasCobblemon <sessionId> <true|false>
Enable the default Cobblemon starter screen:
/kantostarters DefaultPickStarters on
Disable the default Cobblemon starter screen:
/kantostarters DefaultPickStarters off
Reset all KantoStarters choice tags for the player running the command:
/kantostarters reset all
Reset one session for the player running the command:
/kantostarters reset <sessionId>
All commands require operator/admin permission.
Use Cases
KantoStarters can be used for more than just the first starter selection.
It works well for:
- starter rooms
- dojo rewards
- fossil choices
- one-time gift creatures
- item reward stations
- quest rewards
- map progression rewards
- server event rewards
- custom adventure map choices
Known Issues
- KantoStarters is a config-based mod. Incorrect session IDs, choice IDs, item IDs, or command syntax may prevent a choice from working correctly.
- If
DefaultPickStarters is turned off but no custom starter station is configured, players may not receive a starter through the default Cobblemon screen.
Compatibility & Dependencies
- Minecraft 1.21.1
- Fabric Loader 0.17.2+
- Fabric API
- Java 21
- Cobblemon
FAQ
Does KantoStarters work without Cobblemon?
No. KantoStarters requires Cobblemon.
Does this mod add new blocks or models?
No. KantoStarters does not add physical blocks, but you can bind any block (even invisible barriers) as a choice option.
Why is my choice not opening?
Check these things:
- The mod is installed on both client and server.
- The session exists in
choice_sessions.json.
- The choice exists inside that session.
- The block was bound with
/kantostarters set.
- The player is not sneaking while right-clicking.
- The session is enabled.
- The player has not already completed a one-time session.
- The config was reloaded after editing.
Why did my reward command not work?
Check the command syntax in choice_sessions.json.
Do not include a leading /.
Example:
"commands": [
"give %player% minecraft:diamond 1"
]
Then run:
/kantostarters reload
Special Thanks
- To everybody helping polish the CobbleKanto project and its custom mods.
- To the Cobblemon community for inspiring more adventure-focused Minecraft experiences.
If you have ideas or feedback, you can share them through our public issue tracker or send a direct message to "cobblekanto" at 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 ??
KantoStarters 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, or the Cobblemon team.
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
登录后参与评分
还没有评论,来抢沙发吧