StoryEcho——基于大模型的沉浸式互动叙事平台任务管理功能开发

在互动叙事类应用中任务管理功能非常重要的它不仅能引导玩家推进剧情还能通过及时的反馈增强沉浸感。本文将详细介绍 StoryEcho 项目中任务系统的完整开发过程分享我在设计、实现和优化过程中的思考与实践。一、系统设计概览设计目标在开发任务系统时我们确立了以下几个核心目标1.区分主线任务和支线任务主线推动剧情支线丰富世界2.任务进度实时更新玩家能清晰了解当前状态3.任务触发、进度更新、任务完成都要有明确的视觉反馈如弹窗任务百分比显示划掉已完成任务等。二、后端任务系统实现2.1 任务数据结构设计首先定义清晰的任务数据结构# 主线任务定义 MAIN_QUESTS [ { id: main_001, name: 进入迷雾森林, description: 探索森林入口找到进入森林深处的路径, type: main, order: 1, objectives: [ {id: obj_001, description: 与老猎人对话, completion_hint: talk:老猎人}, {id: obj_002, description: 查看古老石碑, completion_hint: action:view_stone}, {id: obj_003, description: 选择一条路径进入, completion_hint: action:choose_path} ], rewards: {exp: 100, gold: 50}, next_quest: main_002 } ]2.2 任务管理器核心实现任务管理器是整个系统的核心负责任务的初始化、触发检查、进度更新和奖励发放class QuestManager: def __init__(self): self.main_quests {q[id]: q for q in MAIN_QUESTS} self.side_quests {q[id]: q for q in SIDE_QUESTS} self.all_quests {**self.main_quests, **self.side_quests} def check_quest_triggers(self, state, intent, target, scene_id, relationships): 检查是否有新任务可触发 # 支持NPC对话触发 # 支持场景进入触发 # 支持特定动作触发 # 支持好感度条件触发触发机制设计支持多种触发条件组合比如支线任务“精灵公主的烦恼”需要同时满足“与艾莉西亚对话”和“好感度≥20”两个条件实现多剧情玩法同时可以避免任务误触发。2.3 目标完成检测目标完成检测是任务系统的关键环节我实现了多种检测方式def _check_objective_complete(self, hint, intent, target, scene_id, inventory, relationships, attributes): hint_type parts[0] hint_value parts[1] if hint_type talk: return intent talk and target hint_value elif hint_type scene: return scene_id hint_value elif hint_type action: return intent hint_value elif hint_type collect: return collected_count required_count elif hint_type attribute: return attributes.get(attr_name, 0) int(required_value) elif hint_type affinity: return relationships.get(npc_name, 0) int(required_value)这种设计使得任务目标可以灵活地与游戏状态交互支持对话、场景移动、物品收集、属性检查、好感度等多种完成条件。2.4 任务进度更新与通知任务进度更新时系统不仅更新内部状态还生成详细的通知消息供前端展示if quest_update[updates] or quest_update[completed_quest]: notification_messages [] for update in quest_update[updates]: if objective_description in update: notification_messages.append({ type: objective_complete, quest_name: update[quest_name], message: f完成目标: {update[objective_description]} }) elif update.get(type) next_quest: notification_messages.append({ type: next_quest_unlock, quest_name: update[quest_name], message: f新主线任务已解锁: {update[quest_name]} }) state[last_quest_update] { type: quest_progress, data: quest_update, notifications: notification_messages }三、前端任务界面优化3.1 任务日志面板上一篇博客有提到我们做了一个初步的前端页面在进行详细功能分工之后我又进一步调整了前端页面的布局将主线任务支线任务已完成任务分离开来。3.2 任务通知弹窗实现与任务状态实时更新为了给玩家及时的任务反馈我实现了带有动画的任务通知弹窗同时在任务日志中会更新任务完成进度条并划掉已完成任务四、总结与展望本次功能开发其实还有一些不足比如任务触发较为生硬对于部分任务如果玩家没有能够输出一模一样的关键词会有无法触发的可能这是我们后期整合代码后要进行的优化以及后续我们会考虑实现更多功能比如任务提示追踪之类的。以上就是这段时间实现的内容。