维塔侠 (Vittaxia)

一个以武侠世界为背景的 Flutter 单机文字挂机游戏。
你可以创建角色、探索地图、触发随机事件、回合制战斗、修炼武学、经营装备与背包，并在离线期间持续获得收益。

项目状态

• 当前版本：0.1.0
• 平台：Flutter（Android / iOS / macOS / Windows）
• 数据存储：本地 SQLite（Drift）
• 语言：简体中文

核心玩法

基础系统

• 角色成长：9个境界，4个阶段，属性随成长提升
• 探索事件：8个地点，70+个随机事件，多分支选择
• 回合战斗：技能释放、状态效果、连招系统、战斗感悟
• 武功系统：20+个技能，熟练度提升，被动技能
• 装备系统：套装效果、强化+10、品质升级、重铸、宝石镶嵌
• 背包与商店：分类管理、批量购买、消耗品使用

核心玩法 🆕

• 修炼系统：三种修炼方式，离线挂机收益，6种时长选择
• 师门系统：4个师门，专属技能，师门任务，贡献兑换
• NPC互动：9个主要NPC，5个好感度等级，动态对话，送礼系统
• 江湖势力：8个势力，8个声望等级，影响商店折扣和任务解锁
• 论剑台：挑战NPC对手，提升排名，获得奖励
• 成就称号：15个成就，11个称号，提供属性加成
• 结义传承：与NPC结拜，角色退隐后可继承能力

任务系统

• 主线任务：30个任务，完整的古玉之谜故事线
• 支线任务：24个支线，丰富的NPC故事
• 师门任务：日常任务和一次性任务，获得贡献度

技术栈

• Flutter + Dart
• Riverpod（状态管理）
• GoRouter（路由）
• Drift + sqlite3_flutter_libs（本地数据库）
• Freezed + json_serializable（数据模型）

本地运行

1. 环境要求

• Flutter SDK（与 pubspec.yaml 对应，Dart ^3.8.1）
• 可用的 Flutter 平台工具链（Android Studio / Xcode 等）

2. 安装依赖

flutter pub get

3. 启动项目

flutter run

4. 常用开发命令

# 静态检查
flutter analyze

# 测试
flutter test

# 代码生成（模型/数据库变更后）
dart run build_runner build --delete-conflicting-outputs

目录结构

lib/
  core/        # 路由、主题、数据库、通用工具
  data/        # 静态配置数据（技能、敌人、物品、地图等）
  features/    # 业务模块（战斗、技能、背包、任务、探索等）
  models/      # 数据模型
  shared/      # 共享组件
test/          # 测试

数据说明

• 角色、背包、技能、任务进度等存储在本地 SQLite
• 默认数据库文件名：vittaxia.db
• 数据库版本：v3（支持师门系统）
• 当前不依赖服务器，适合本地离线开发与游玩

最近更新

2026-02-25 - 核心玩法系统大幅扩展 🎉

重大更新:

• ✨ 修炼系统：三种修炼方式（打坐/武技/历练），真正的放置挂机核心
• ✨ NPC好感度：5个等级，动态对话，送礼系统，深层剧情
• ✨ 装备系统：套装效果、强化+10、品质升级、重铸、宝石镶嵌
• ✨ 江湖势力：8个势力，8个声望等级，影响商店和任务
• ✨ 战斗深度：10种状态、技能连招、武器特性、战斗感悟、Boss机制
• ✨ 社交竞技：论剑台、排行榜、成就系统、称号系统、结义传承
• ✨ 内容扩充：主线补全到30个任务，随机事件增加到70+个
• 📊 代码规模：新增26个文件，9328行代码

游戏定位明确: 轻度MUD + 放置养成武侠游戏

详细说明: 查看 IMPROVEMENTS.md 了解完整改进内容

2026-02-21 - 师门系统与任务优化

新增功能:

• ✨ 师门系统：4个师门可供选择，9个专属技能
• ✨ 任务弹窗：接取和完成任务时显示详细弹窗
• 🐛 修复天星石任务无法完成的 Bug

许可证

本项目采用 CC BY-NC 4.0（署名-非商业性使用）。
你可以在非商业场景下使用、修改和分发源码；禁止任何未经授权的商业用途。
详见根目录 LICENSE 文件。