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

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

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

---

核心功能#

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

游戏模式#

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

---

♾️ 无尽模式 (Endless Mode)#

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

核心机制#

text

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

配置参数#

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

行动点系统#

javascript

// 玩家状态
{
  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: "击败哥布林" }
  ]
}

每日反馈内容#

text

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

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

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

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

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

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

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

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

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

无尽模式命令#

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

行动类型消耗#

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

每日重置触发#

javascript

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

世界持久化#

javascript

// 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

数据结构:

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 - 让每一次游戏都是独特的故事