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