
SP任务
SP Quests 添加了具有多个目标和奖励的可自定义任务、任务日志、个人任务追踪器,以及游戏内管理员编辑器,并可选集成经济系统。
SP Quests
/spadmin → SP Quests → Add quest 会打开共享的原生编辑器。ID 在成功保存时分配(quest_000001、quest_000002……),跳过目录和历史记录中已保存的 ID。已有 ID 保持不变;编辑时无法重命名它们。Category 下拉框提供已有分类和 + Add category…。新分类在点击 Apply 前只是草稿;Cancel 不会写入任何内容。Objectives 和 Rewards 会打开列表编辑器,包含 Add/Remove、上一项/下一项导航和类型下拉框。每个任务有 1–16 个目标和 1–16 个奖励。必须完成所有目标,才能一次性领取整批奖励。

目标类型:KILL、MINE、SUBMIT。奖励:COINS、ITEM 和经验。安装 RPG 后选择 RPG_XP;未安装 RPG 时选择 XP 以获得原版 Minecraft 经验。二者是不同的货币。Minecraft MMORPG 会禁用原版 XP,因此安装后 XP 奖励会被拒绝。RPG_XP 需要 MMORPG 0.5.6+ 和 Core 0.3.0+。经济集成是可选的。仅物品/XP 奖励无需经济模组。货币奖励使用 Core 注册的经济提供者;SP Economy 1.3.0+ 会自动提供。没有兼容的提供者时,整批货币奖励会保持待重试状态。Core 不会存储第二份余额。
/quests 打开时位于 Active,仅显示你已接受且未领取的任务,准备完成的任务排在最前。成功领取和放弃后,任务会从 Active 中移除。选择其他分类可浏览并接受新任务。日志包含分类标签页、右侧的任务以及左侧的单个目标进度和奖励。Accept 开始任务;Submit items 交付匹配的物品;所有任务完成后会出现 Finish quest。长详情和列表可独立滚动;奖励和分类可分页。服务器每页发送 16 个任务,并按分类筛选整个目录/历史记录。管理目录和自身进度表也每页发送 16 行。


安装和命令
在服务器和客户端上安装匹配的 Quests 0.5.2 和 Core 0.3.1,以及 Loader 0.19.5+ 和 Fabric API 0.160.0+26.2。替换旧的 Quests JAR。SP Economy 和 Shop 对 Quests 是可选的。已安装的其他模块仍可能需要 Economy。如果安装了 MMORPG,请将其更新至 0.5.6,并保留其 VitalView 依赖。Quests 和 Core 保留其 ID sp_quests 和 sp_core。0.5.2 无需进行目录/进度迁移。
/quests:日志;/quests list:在聊天中列出所有任务和奖励。/quests accept <id>:冻结已接受的定义和奖励。/quests submit <id>:为所有待处理的 SUBMIT 任务交付可用的普通物品。/quests claim <id>:一次性领取完整奖励批次。/quests abandon <id>:仅放弃未完成的任务。/quests reload:游戏管理员权限重新加载已验证的目录规则。
操作需要生存/冒险模式中的存活玩家。创造/旁观模式下的击杀和挖矿不计入。玩家/ PvP 击杀永不计入。击杀归属跟随所属玩家,包括投射物。挖矿需要成功破坏方块,并在需要时使用正确的工具。玩家放置的方块可以计入。提交使用主物品栏的 36 个槽位,并匹配普通注册表物品组件;自定义物品不计入。多个交付任务可以部分提交,然后重试。重复的目标类型/目标对会被拒绝;请合并其所需数量。
在客户端和服务器上安装匹配的 Quests 0.5.2:日志协议现为 v3。较旧的日志客户端会收到匹配版本/聊天回退提示。
十个起始任务
全新安装会自动创建这些示例,无需经济模组:
| 任务 | 目标 | 物品奖励 |
|---|---|---|
| 牲畜补给 | 击杀 10 头牛 | 5 个皮革 + 5 个生牛肉 |
| 过夜之床 | 击杀 10 只羊 | 1 张白色床 |
| 你的第一座熔炉 | 提交 8 个圆石 + 5 个煤炭 | 1 座熔炉 |
| 石匠 | 挖掘 24 个石头 | 1 把石镐 |
| 照亮前路 | 挖掘 8 个普通煤矿石 | 32 个火把 |
| 木材交付 | 提交 16 个橡木原木 | 64 块橡木木板 |
| 夜间巡逻 | 击杀 10 只僵尸 + 5 只骷髅 | 1 把铁剑 + 1 面盾牌 |
| 为村庄送面包 | 提交 24 个小麦 | 12 个面包 |
| 猎人的弓 | 击杀 5 只蜘蛛 + 提交 8 个线 | 1 把弓 + 16 支箭 |
| 铁制升级 | 挖掘 8 个普通铁矿石 + 提交 8 个粗铁 | 1 把铁镐 |
分类:狩猎、采矿、补给。交付目标会消耗材料。必须完成所有目标,才能一次性领取整批奖励。普通生物掉落物与任务奖励相互独立。普通矿石和深层矿石是不同的注册表目标;挖矿描述会标明目标。
现有目录会被保留。要添加这些示例,请使用 /spadmin → SP Quests → Settings → Add starter quests → Apply。Cancel 不会写入任何内容。已有和已禁用的 ID,以及已接受玩家历史记录中保留的 ID 都会被跳过。重复导入不会复制任务,也不会更改已接受的定义/进度。
可搜索的任务目标
目标目标和物品奖励现在会在共享编辑器中提供自动补全。开始输入显示名称或注册表 ID;下拉列表会随输入更新。KILL 搜索实体,MINE 搜索方块,SUBMIT / ITEM 奖励搜索物品。已安装模组的注册条目也会包含在内。用鼠标或上/下和 Enter/Tab 选择;Escape 关闭建议。所选值会以其注册表 ID 保存,服务器仍会验证它。未知 ID 仍会被拒绝。

个人任务 HUD
接受任务不会自动显示它。打开 /quests,选择一个已接受的任务,然后选择 Track 将其显示在 HUD 上;Untrack 将其移除。你最多可以有十个活动任务,但只显示你选择的两个。所有活动任务无论是否被追踪都会继续推进。可完成任务会显示 Ready to finish;已领取或已放弃的任务会从 HUD 中消失。
追踪器使用紧凑的金色任务标题列表,并显示各个目标的计数。/questshud 打开个人设置:Show HUD、背景、已完成目标可见性、缩放、不透明度、宽度、可见任务数量以及 X/Y 位置。Move HUD 打开拖动预览。Save 提交草稿;Cancel/Escape 丢弃它。没有追踪任务时,预览会使用示例任务。F1 和其他界面会隐藏正常游戏 HUD;位置编辑器会显式预览它。
选择按玩家 UUID 和世界保存在 sp-quests-tracking.json 中,最多可保存 16 个选中的任务。个人外观设置保存在本地的 config/sp-quests/hud.json 中,并在该客户端安装的所有世界间共享。服务器会验证选择,并仅发送该玩家被追踪的定义和进度,与日志当前页面无关。断开连接会清除之前世界的 HUD;重新打开该世界时,已选任务会恢复。


可选经济
SP Quests 不需要 SP Economy,也不链接到其实现类。它会自动使用在 Core 中注册的单一经济提供者。/spadmin → SP Quests → Settings 会显示检测到的提供者或 Unavailable。第三方经济需要一个实现 Core EconomyService 的适配器;仅安装任意经济模组并不会使其 API 兼容。此版本未捆绑第三方适配器或多提供者选择。
使用 SP Economy 时,奖励金额保持为 SPCoins。其他兼容提供者使用通用货币标签和金粒图标。金额保留其现有整数单位;不会自动转换、迁移余额或创建钱包。所有正的 COINS 条目都通过所选提供者的现有钱包支付。零值 COINS 条目和仅物品/XP 批次不会访问经济服务。
如果任务包含金钱且不存在提供者,其所有奖励都会保持未领取;物品和 XP 不会单独支付。安装兼容的提供者并重启以重试。已有的已接受任务会保留其冻结的奖励。全新安装包含十个仅物品的起始任务。现有目录会被保留;使用 Settings → Add starter quests 添加示例。更改经济提供者不会复制余额或转换已接受的奖励单位。
数据和迁移
目录:config/sp-quests/quests.json,格式 2,包含 nextQuestNumber、categories、quests 和可选的 disabled。最多 128 个任务和 64 个分类(每个 32 个字符)。名称最多 80 个字符;描述 1000 个字符。目标包含 type、target、count(1–100000)。奖励包含 type、item、amount:金币 0–10^12,物品每个条目 1–4096,XP/RPG_XP 每种类型合计 1–1000000。注册表 ID 会被验证。非物品奖励使用空物品值。ID 计数器仅在任务保存有效成功时保存。目录重新加载/编辑/禁用仅影响未来的接受。
世界数据:<world>/sp-quests.json,格式 2,按玩家 UUID,最多保留 1024 个任务 ID。每个状态包含其冻结的定义、progressByObjective、聚合的 progress 和 claimed。每次成功变更都通过临时文件替换保存。无效/未来版本的文件会停止加载,而不是重置数据。
格式 1 的目录和进度会自动加载。缺失的数组会变为旧的单目标/金币奖励;ID、已接受规则、部分进度和领取历史都会保留。首次写入格式 2 时,会将原始文件备份一次为 quests.json.pre-v2(目录)或 sp-quests.json.pre-v2(世界)。现有备份永远不会被覆盖。旧的标量任务字段保留为兼容适配器。不要用旧二进制加载格式 2 数据;降级时请恢复完整备份。
奖励会预先检查整个物品栏以及 XP/钱包限制。物品栏已满时会拒绝该批次,且不会掉落物品。正常钱包/任务/效果写入失败会恢复金币、物品栏、XP 和领取资格。单独的钱包、任务、Minecraft 玩家和 RPG 角色文件不具备崩溃原子性:请备份完整世界。进程突然崩溃不提供恰好一次的事务保证。
Daily/Weekly/Monthly 是分类,不会自动重置。任务链、队伍归功、NPC 和管理员进度重置尚未实现。即使目录定义被禁用或移除,已接受的任务仍然可用。
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。