KantoStarters

模组

· 作者 CobbleKanto

可配置的 Cobblemon 初始精灵和奖励选择站,支持自定义对话、预览、一次性选择、命令以及默认初始精灵屏幕控制。

0 本站下载 0 关注 更新于 4 周前

最新 0.0.5 · 1.21.1 · NeoForge

一键开服(送7天)

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"
      ]
    }
  ]
}

推荐设置顺序:

  1. 在 choice_sessions.json 中创建或编辑会话。
  2. 创建 sessionId 和 choiceId。
  3. 运行 /kantostarters reload。
  4. 注视你想要绑定的方块。
  5. 运行 /kantostarters set <sessionId> <choiceId>。
  6. 如有需要,使用 /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 属于其各自的创作者。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源