CobblemonQuests

即插即用的每日与每周任务系统,支持可配置奖励、连续完成奖励、里程碑和隐藏任务。

CobblemonQuests

你的 Cobblemon 服务器所需的参与循环。每日、每周、精英、隐藏和可重复任务,全服社区目标,排行榜,可配置音效,以及完整的游戏内创作 + 自定义工具包——全部构建在干净的单屏 GUI 上,管理员可以从配置中逐槽位重新排列,无需接触 Java。

功能亮点

面向玩家

  • 6 种任务类型——每日、每周、精英每周、隐藏、可重复和普通(链步骤)。
    • 可重复任务永不轮换。想跑多少次就跑多少次;每个任务的终生完成次数会被追踪并显示在图标上。
    • 精英每周——一个额外困难的每周任务,奖励显著更好,显示在专用槽位并带有发光效果。
    • 隐藏任务在触发条件匹配时(捕捉数量、物种、维度等)以不可见方式解锁,并存放在专用的隐藏查看器 GUI 中,旁边还有你已完成任务的奖杯图标。
  • 15 种目标类型——捕捉、与 NPC 对战、击败野生(与 PvE 胜利分开追踪)、升级、获得等级、进化、孵化蛋、投掷精灵球、使用经验糖果、访问生物群系 / 维度(带防来回刷去重)、捕捉闪光、捕捉传说、完成 PokeHunts、完成突袭。
  • 单屏 6 行任务 GUI——所有内容一目了然:第 0 行为排行榜图标 + 重置计时器,第 1–2 行为每日任务,第 3–4 行为每周任务,第 5 行为连续 / 里程碑 / 隐藏 / 可重复 / 关闭。不再需要翻找子页面。
  • 服务器任务——全服共享目标,带实时 Boss 栏。每位玩家都可贡献。持续时间从 1 小时到 1 周。贡献前三名获得额外奖励;离线贡献者通过排队奖励系统在下次登录时发放。 贡献排行榜带玩家头颅 + 奖牌。
  • 排行榜——前 16 名玩家头颅金字塔,自己的排名带有发光效果。并列现在按谁先达到该值(基于时间戳)来打破,所以超过朋友能让你保持领先。
  • 音效 + 视觉特效——可配置音效用于任务完成、领取、里程碑、连续推进、隐藏发现、链推进和社区目标完成。重大事件时标题 / 副标题闪现。
  • 领取系统——已完成任务显示 ★ READY ★ 发光;可单独领取或点击全部领取。提供自动模式。
  • 每日连续 + 终生里程碑——奖励坚持。里程碑 GUI 分页且完全可配置。
  • 重掷系统,带硬性每轮换上限——daily-per-day 和 weekly-per-week(默认各 1)。无付费兜底。计数器在掷出之前消耗,若池无法产出替代则退还,因此并发点击不会重复消耗。
  • 聊天奖励横幅——每次奖励发放显示一行确认:★ +250 Stars / $ +5000 PokeDollars。格式可完全按服务器自定义。

面向管理员

  • ** literally 可游戏内自定义每一个玩家可见字符串、槽位、物品、颜色和按钮**。无需编辑 jar,无需 Java。每个 GUI 都是 config/cobblemonquests/gui/ 下独立的 HOCON 文件:
    • main_menu.conf、detail_menu.conf、stats_menu.conf、 milestone_menu.conf、leaderboard_menu.conf、 repeatable_menu.conf
    • 设置每个按钮的 slot(0–53)。设置每个菜单的 rows(1–6)。切换任意按钮的 visible 标志。用任意物品 id 替换玻璃板填充物。自定义进度条字符、颜色、长度、括号。通过 name-format 重新排序任务名称各部分。按进度 / 稀有度 / 字母顺序 / 状态 / id 排序任务。
  • 自定义命令按钮——向任意 GUI 添加无限额外按钮:商店链接、Discord、投票、原版命令快捷方式。每个条目接受 slot、item、name、lore、glow,以及带 {player} 替换的 command 模板。
  • 事件命令钩子——当以下事件发生时触发控制台命令:quest-complete、milestone-reached、streak-milestone、claim。接入 Discord webhook、广播消息、发放外部物品——全部无需重新编译。
  • 管理员右键快捷操作——拥有管理员权限时右键任意任务图标,内联打开 完成 / 重置进度 / 查看详情。
  • 任务浏览器——按类型分页(全部 / 每日 / 每周 / 普通 / 精英 / 隐藏 / 可重复),按稀有度 + 类别过滤,可排序,分页。可扩展到数百个任务。
  • 任务编辑器 + 任务创建向导——完整游戏内 CRUD。循环类型 / 类别 / 稀有度,设置目标,通过 4 步向导构建奖励,保存到磁盘,复制,删除(两次点击确认),实时预览。
  • 4 步奖励向导——选择类别(货币 / 物品 / 箱钥匙 / 命令)→ 浏览 + 选择(物品浏览器带 全部 / Cobblemon / 球 / 糖果 / 原版 标签页和完整注册表分页)→ 设置数量 → 回顾 + 确认。
  • 每奖励 display 覆盖——用自定义 MiniMessage 替换任意奖励的说明文本。非常适合品牌化奖励或将原始 padmin givekey 命令隐藏在干净的 <aqua>Special Reward</aqua> 行后面。
  • 奖励显示重命名映射——rewards.display-names 全局将任意物品 id 或钥匙 id 映射到自定义名称。服务器可以发布完全品牌化的工具提示集,无需逐奖励编辑。
  • 链浏览器 + 编辑器 + 向导(管理员侧)——完整游戏内链创作,带步骤选择器、内联任务创建、重排箭头、难度标签、可循环开关、链完成奖励。
  • 服务器任务浏览器 + 编辑器 + 向导——创建全服目标,带目标类型、目标、持续时间(1 小时到 1 周)、基础奖励和前 3 名贡献者额外奖励。活跃目标管理仪表盘:停止、重置、提升进度、实时查看贡献者。
  • 玩家管理 GUI——检查任意在线玩家:活跃任务、连续、Stars 余额、总完成数、可重复完成次数。管理员操作:发放 Stars、重置每日 / 每周、清除玩家数据(两次点击确认)。每次点击都重新检查管理员权限——会话中降权立即生效。
  • 配置编辑器——多页中心:重掷上限 / 池权重 / 开关 / GUI 布局。每个都是带保存的干净子页面。
  • GUI 布局编辑器——可视化 54 槽网格。点击任意槽位循环其角色。保存写入 gui/player_main.conf 并自动重载。
  • 诊断与测试命令:
    • /quests admin debug events——每个跟踪器的触发次数 + 最后触发时间戳 + 最后详情。几秒内分诊“我的任务不推进”报告。
    • /quests admin debug stars <player>——打印权威 Stars 余额 + 终生收入。
    • /quests admin testkey <player> <key> [amount]——实时调用箱钥匙桥接以验证你的模板,无需等待任务。
    • /quests admin testcommand <player> <command...>——通过奖励使用的同一 SafeDispatch 管道试运行任意命令奖励模板。

奖励

  • PokéDollars(Impactor 主要货币)
  • Stars——现在通过可配置经济命令分发(默认:eco deposit {amount} {currency} {player}),因此更新的是真实的 Impactor 货币账户。本地 JSON 账本仅作为排行榜缓存镜像。
  • 物品——任意 Minecraft / Cobblemon 物品 id,带溢出处理。
  • 箱钥匙——全局命令模板加每钥匙覆盖映射(integrations.crate-key-commands),因此 lunar 可路由到 Pebble's Crates,vote 可路由到同一服务器上的 ExcellentCrates,而无需在其他地方分支。默认模板开箱即指向 Pebble's Crates(padmin givekey {player} {amount} {key})。
  • 自定义命令——控制台执行,带 {player} 占位符,通过统一的 SafeDispatch 管道运行,该管道会捕获拼写错误、缺失节点和重入,而不是静默吞掉它们。
  • 所有发放都是原子的,带 8 字符交易 ID 的审计日志记录,并且对离线玩家有弹性——社区目标发放和星星奖励排队到 pendingRewards,并在下次登录时以 ★ You have rewards waiting! ★ 聊天横幅发放。

集成

  • Impactor——PokéDollar + Stars 货币,软依赖。
  • PokeHunts——若已加载则自动挂钩;任务类型 COMPLETE_POKEHUNT。
  • Raids——若已加载则自动挂钩;任务类型 COMPLETE_RAID。
  • LuckPerms——可选,用于权限节点查找;若提供者失败则干净地回退到 op 级别,并带一次性 WARN。
  • Pebble's Crates / ExcellentCrates / CMI——任何箱插件都可通过每钥匙覆盖映射工作。
  • 公共 API——任何模组都可以调用 ExternalEventApi 来提供任务进度,无需类路径依赖。

安全与可靠性

  • 每次操作都重新检查权限——会话中降权有效。每个管理员 GUI 在每次 open() 和点击时都有内部 requiresAdmin() 守卫。
  • 绕过权限仅显式且现在受配置门控。 cobblemonquests.bypass.reroll-cost 和 cobblemonquests.bypass.rate-limit 仅在 config.conf 中匹配的 permissions.bypass.* 标志设为 true 时才生效。仅授予 LP 节点不再足够——因此被遗忘的通配符继承不会静默禁用新的重掷上限。
  • 每玩家速率限制用于重掷和管理员命令。
  • 审计日志位于 logs/cobblemonquests-audit.log,记录每次任务分配、完成、奖励发放、重掷、管理员操作、隐藏发现、里程碑跨越、社区目标变更、配置重载和管理员测试命令,带 8 字符 base36 交易 id。
  • 分配时快照——任务定义在分配时快照,因此配置编辑不会追溯更改发放。
  • 防利用去重用于“访问 N 个生物群系 / 维度”目标——只有不同的生物群系 / 维度 id 计数。来回刷取已死。
  • SafeDispatch——模组运行的每条控制台命令(奖励、星星、箱钥匙)的单一规范路径。将结果 < 1 视为硬失败,并带包含解析后命令字符串的 WARN。重入守卫防止奖励模板意外回调模组时出现无限循环。

一句话电梯演讲

把你的 Cobblemon 服务器变成玩家为了明天而登录的地方,而不仅仅是今天。

设置

  1. 将 cobblemonquests-1.8.0.jar 放入 mods/,与 Cobblemon 和(可选)Impactor 放在一起。
  2. 启动服务器。首次启动时会写入默认配置、示例任务(9 个每日、7 个每周、1 个精英、1 个隐藏、3 个可重复)、一个初始链和 2 个服务器任务模板。
  3. OP 可以运行 /quests 查看玩家中心,运行 /quests admin 查看管理员面板。
  4. 使用游戏内向导创建任务、链和服务器任务——或手动编辑 config/cobblemonquests/ 文件。
  5. 使用游戏内配置编辑器调整重掷上限、池权重和开关——或编辑 config.conf 并运行 /quests admin reload。

命令

/quests                     打开任务中心
/quests stats               打开统计页面
/quests leaderboard         打开排行榜
/quests reroll <slot>       重掷一个任务(适用每轮换上限)
/quests admin               打开管理员面板
/quests admin reload        重载配置 + 任务
/quests admin give <p> <q>  给玩家一个任务
/quests admin complete <p> <q>  强制完成一个任务
/quests admin reset <p>     重置玩家的每日任务
/quests admin resetweek <p> 重置玩家的每周任务
/quests admin goal set <id> 激活一个服务器任务
/quests admin goal stop     停止活跃的服务器任务
/quests admin goal reset    重置服务器任务进度
/quests admin goal progress <n>  手动设置进度
/quests admin debug events  跟踪器活动仪表盘
/quests admin debug stars <p>    打印 Stars 余额 + 终生
/quests admin testkey <p> <key> [n]   实时测试箱钥匙模板
/quests admin testcommand <p> <cmd...>  测试任意命令模板

/cq 是 /quests 的短别名。

兼容性

  • Minecraft 1.21.1 / Fabric
  • 硬依赖:Cobblemon 1.7.3+、Fabric API、Java 21
  • 软依赖:Impactor(PokéDollar + Stars 货币)、LuckPerms(权限节点 + 前缀)、PokeHunts(自动挂钩)、Raids(自动挂钩)、任何箱插件(Pebble's、ExcellentCrates、CMI 等——可按钥匙配置)
  • 与 PokeBuilder 和 StaffChat 和平共存(两者也来自 souljagger)。

路线图

  • 队伍 / 多人任务——随队伍系统更新推出
  • NPC 交互——右键 Cobblemon NPC 打开 /quests
  • 任务商店——用 Stars 购买专属物品
  • 季节性 / 活动任务——限时任务池
  • 面向玩家的链 UI——链后端 + 管理员创作已发布;玩家查看器随队伍更新回归

许可证

MIT——分叉、修改、再分发。