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 服务器变成玩家为了明天而登录的地方,而不仅仅是今天。
设置
- 将
cobblemonquests-1.8.0.jar放入mods/,与 Cobblemon 和(可选)Impactor 放在一起。 - 启动服务器。首次启动时会写入默认配置、示例任务(9 个每日、7 个每周、1 个精英、1 个隐藏、3 个可重复)、一个初始链和 2 个服务器任务模板。
- OP 可以运行
/quests查看玩家中心,运行/quests admin查看管理员面板。 - 使用游戏内向导创建任务、链和服务器任务——或手动编辑
config/cobblemonquests/文件。 - 使用游戏内配置编辑器调整重掷上限、池权重和开关——或编辑
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——分叉、修改、再分发。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。