Kuuila Game

通用互动游戏框架，支持单人文字冒险、猜谜及多人武侠游戏，含私聊控制群游戏和实时状态同步。

kuuila-game - Kuuila互动游戏框架 v3.0

🎮 通用互动游戏框架，支持文字冒险、卡牌系统、多人游戏等

版本: v3.0.0 | 作者: kuuila | 许可: MIT

---

核心功能

系统	版本	描述
🃏 卡牌系统	v2.2	155张卡牌，6大类型
🎭 三幕式结构	v2.3	序幕/破章/急章
⏱️ 回合管理	v2.3	回合状态机
👑 城主规则	v2.4	轮换机制，NPC扮演
🌤️ 天气系统	v2.4	6种天气
⚔️ 战斗系统	v2.5	万智牌风格
👹 Boss系统	v2.5	Boss卡组
👤 角色系统	v2.6	属性/技能/成长
🎨 主题系统	v2.7	6大主题
📖 剧情引擎	v2.8	转换链、诡计生成
📜 剧本系统	v2.9	26个克苏鲁剧本
♾️ 无尽模式	v3.1	每日行动点、定时反馈、持久世界
📜 圣人数据	v1.0	623条天主教圣徒/节日记录

游戏模式

• 单人冒险 | 猜谜游戏 | 多人武侠(协作/对抗/轮流) | 沙箱模式 | ♾️ 无尽模式

---

♾️ 无尽模式 (Endless Mode)

持续运行的日常游戏世界，每日限定行动，定时反馈

核心机制

┌─────────────────────────────────────────────────────────────┐
│                    无尽模式生命周期                          │
└─────────────────────────────────────────────────────────────┘
     ┌──────────────────────────────────────────────┐
     │              管理员启动                        │
     │         启动无尽模式 [世界名]                   │
     └──────────────────────────────────────────────┘
                         ↓
     ┌──────────────────────────────────────────────┐
     │           每日定时触发 (如 08:00)              │
     │  • 重置所有玩家行动点                          │
     │  • 生成每日世界事件                            │
     │  • 推送世界状态报告                            │
     │  • 触发随机遭遇                                │
     └──────────────────────────────────────────────┘
                         ↓
     ┌──────────────────────────────────────────────┐
     │           玩家行动阶段 (全天)                   │
     │  • 消耗行动点进行探索/战斗/交互                 │
     │  • 行动点耗尽则当天无法行动                     │
     │  • 等待次日重置                                │
     └──────────────────────────────────────────────┘
                         ↓
     ┌──────────────────────────────────────────────┐
     │           每日结算 (如 23:00)                   │
     │  • 统计当日行动                                │
     │  • 计算收益/损失                               │
     │  • 更新世界状态                                │
     │  • 生成日报                                    │
     └──────────────────────────────────────────────┘
                         ↓
              [循环往复，直到管理员结束]
                         ↓
     ┌──────────────────────────────────────────────┐
     │              管理员结束                        │
     │            结束无尽模式                        │
     └──────────────────────────────────────────────┘

配置参数

参数	默认值	说明
dailyActionPoints	5	每日行动点上限
resetTime	"08:00"	每日重置时间 (Asia/Shanghai)
reportTime	"23:00"	日报生成时间
maxDuration	null	最大持续天数 (null=无限)
autoSave	true	自动保存世界状态

行动点系统

// 玩家状态
{
  playerId: "player_001",
  actionPoints: {
    max: 5,           // 每日上限
    current: 3,       // 当前剩余
    lastReset: "2026-03-21T00:00:00Z"
  },
  dailyActions: [     // 当日行动记录
    { type: "explore", cost: 1, time: "08:30", result: "发现神秘洞穴" },
    { type: "battle", cost: 1, time: "10:15", result: "击败哥布林" }
  ]
}

每日反馈内容

🌅 【无尽世界日报】2026-03-21

📍 当前世界：灵安城
👥 活跃玩家：5人
⏱️ 世界年龄：第 42 天

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 今日世界事件：
• 清晨：迷雾笼罩了北部森林
• 正午：商队抵达城市，交易开放
• 黄昏：神秘旅者在酒馆现身

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎮 你的状态：
• 行动点：3/5 (今日剩余)
• 位置：城市广场
• 状态：健康

💡 今日推荐：
• 探索北部森林 (迷雾可能隐藏秘密)
• 与商队交易 (稀有物品上架)
• 酒馆打听消息 (神秘旅者线索)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

输入「行动 [类型]」开始今日冒险！

无尽模式命令

命令	说明
启动无尽模式 [世界名]	管理员：启动无尽世界
结束无尽模式	管理员：结束当前世界
无尽状态	查看世界状态
我的行动点	查看剩余行动点
行动 [类型] [目标]	消耗行动点执行行动
今日事件	查看今日世界事件
世界历史	查看世界大事件记录
无尽设置 [参数] [值]	管理员：调整配置

行动类型消耗

行动类型	消耗	说明
探索	1	探索区域，可能发现秘密
战斗	2	与敌人战斗
交互	1	与NPC对话/交易
休息	0	恢复状态，不消耗点数
制造	2	制作物品
研究	2	研究线索/技能

每日重置触发

// 定时任务配置示例
{
  "type": "endless_mode_reset",
  "schedule": "0 8 * * *",  // 每天 08:00
  "timezone": "Asia/Shanghai",
  "actions": [
    "resetActionPoints",
    "generateDailyEvents", 
    "pushWorldReport",
    "triggerRandomEncounter"
  ]
}

世界持久化

// world_state.json
{
  "worldId": "lingan_endless_001",
  "name": "灵安城",
  "theme": "修仙",
  "age": 42,  // 天数
  "players": { ... },
  "events": [ ... ],
  "state": {
    "weather": "多云",
    "mood": "紧张",
    "ongoingEvents": ["商队访问", "迷雾笼罩"]
  },
  "history": [
    { day: 1, event: "世界诞生" },
    { day: 15, event: "首次Boss战" },
    { day: 42, event: "迷雾开始蔓延" }
  ]
}

管理员工具

命令	说明
无尽玩家列表	查看所有玩家状态
无尽强制重置	手动触发每日重置
无尽添加事件 [事件]	注入世界事件
无尽调整点数 [玩家] [数量]	调整玩家行动点
无尽统计	查看世界统计数据

📜 圣人数据 (saint_details.json)

623条天主教圣徒/节日记录，可作为无尽模式中的特殊圣人/事件触发源

数据位置: data/endless/saint_details.json

数据结构:

{
  "url": "https://...",
  "name": "主显节",
  "subtitle": "Epiphany of the Lord",
  "content": "节日详细经文与解说...",
  "images": ["https://..."],
  "tags": []
}

可用字段: name(名称), subtitle(副标题), content(正文), images(图片), tags(标签)

适用场景

• 🏠 公会日常 — 成员每日打卡完成任务
• 🎯 长线养成 — 角色持续成长
• 🌍 共建世界 — 多人共同塑造世界
• 📅 定期聚会 — 固定时间集体活动

---

6大主题

武侠 | 修仙 | 克苏鲁 | 赛博朋克 | 中世纪战团 | 民国上海滩

---

命令列表

基础

• 启动游戏 [类型] - 启动游戏
• 开始游戏 / 退出游戏
• 查看状态

卡牌

• 抽卡 [数量] - 抽卡
• 查看手牌 / 打出手牌 [索引]
• 组合 [索引...] - 生成故事
• 洗牌 [类型] / 重置卡组

三幕式

• 下一回合 - 推进回合
• 当前阶段 / 设定主线 [任务]
• 添加敌人 [名称] / 开始Boss战

城主

• 城主状态 / 轮换城主
• 地块行动 [类型] / 天气判定

主题

• 切换主题 [主题]
• 当前主题 / 主题列表

剧本

• 剧本列表 / 剧本详情 [id]
• 选择剧本 [id] / 随机剧本 [难度]
• 开始剧本 / 推进剧本 / 完成剧本
• 分配角色 [玩家] [角色]
• 发现线索 [线索ID] / 分析线索 [线索ID]
• 关联线索 [线索1] [线索2]
• 线索图谱 / 剧本进度

---

版本历史

• v3.1.0 ♾️ 新增无尽模式：每日行动点系统、定时反馈机制、持久世界状态、管理员工具
• v3.0.0 🎉 正式发布版！完整功能集成
• v2.9.0 - 剧本系统（26个克苏鲁剧本、线索管理、角色分配）
• v2.8.0 - 剧情引擎（转换链、诡计生成）
• v2.7.0 - 6大主题系统
• v2.6.0 - 角色系统
• v2.5.0 - 战斗+Boss系统
• v2.4.0 - 城主规则+天气
• v2.3.0 - 三幕式+回合管理
• v2.2.0 - 卡牌系统(155张)
• v1.0.0 - 基础版本

---

🎮 Kuuila Game - 让每一次游戏都是独特的故事