Moddable Games Tools

Moddable.Games

创建你已拥有的游戏。

面向开源棋盘游戏改造工坊的多页面营销网站和工具平台。十款模组。三款原创游戏。两个开源引擎。一个 Discord。

---

技术栈

HTML + Vanilla JS + Zero dependencies + Zero build step

模块化 JS 架构：一个加载器（js/mg-loader.js）会加载 12 个共享模块和各页面专属脚本。不使用内联脚本或样式。

---

路由

URL	页面
/	首页
/mods/	可筛选的模组库
/mods/[slug]/	10 个模组详情页（含 Dungeon Chess）
/games/	游戏中心
/games/nukes/	Nukes
/games/mongo/	Mongo
/games/endless-skies/	Endless Skies
/engines/	引擎中心
/engines/moddable-chess/	Moddable Chess 引擎
/engines/moddable-hexmaps/	Moddable Hexmaps 引擎
/developers/	开发者 / 工具 API
/news/	新闻索引
/news/[slug]/	13 篇文章页面
/tools/	工具中心（骰子、名称、分数）
/tools/ti/	Twilight Imperium 工具
/tools/talisman/	Talisman 工具
/tools/nukes/	Nukes 工具
/submit/	模组提交表单
/about/	关于
/about/roadmap/	18 个月路线图
/team/	团队
/community/	社区 / Discord

---

本地运行

python3 -m http.server 8000

打开 http://localhost:8000/。使用简洁 URL，不带 .html 扩展名。

---

部署到 GitHub Pages

1. 推送到 GitHub
2. Settings → Pages → 从 main 分支的根目录部署
3. 更新各页面中的 <meta name="mg-base"> 标签，使其与部署路径一致：

场景	mg-base 值
自定义域名（根目录）	(移除该标签)
username.github.io 仓库	(移除该标签)
项目仓库（/repo-name/）	/repo-name

---

设计系统

展示字体	Inter Tight 500–700
正文	Inter 400–700
等宽字体	JetBrains Mono 400–600
像素字体	Press Start 2P（仅用于眉题）

#d11a1a  red         Total conversion / Nukes
#3a9928  green       Rebalance / Mongo / Endless Skies
#0c4f8d  blue        Reskin / TI tools
#0a0d2a  cosmicDeep  Hero backgrounds
#f5f4ef  canvasLight Warm off-white sections (not pure white)
#14161c  ink         Primary text on light

规则： 不使用投影。按钮仅使用胶囊样式。每个表面仅使用一种 RGB 主色。所有深色主视觉区域均叠加六边形网格 SVG。

---

JS 架构

js/
├── mg-loader.js            ← entry point, loads all modules
├── mg-core.js              ← tokens, el(), url(), MG.data (fetch layer)
├── mg-buttons.js           ← btn(), linkBtn()
├── mg-cards.js             ← modCard(), pageHero()
├── mg-navbar.js            ← navbar()
├── mg-footer.js            ← footer()
├── mg-search.js            ← global Cmd+K search
├── mg-animations.js        ← scroll reveal + TOC spy
├── mg-mods-content.js      ← mod page content (rules, components, etc.)
├── mg-mod-page.js          ← data-driven mod detail renderer
├── mg-news-article-page.js ← shared news article renderer
└── mg-*-page.js            ← page-specific scripts (home, tools, etc.)

data/
├── mods.json               ← mod library (10 entries)
├── games.json              ← games (3 entries)
├── engines.json            ← engine listings (2 entries)
├── mcp-tools.json          ← MCP tool registry (50 tools, 7 namespaces)
├── news.json               ← news posts (13 entries)
└── team.json               ← team members (4 entries)

页面加载 mg-loader.js（共享模块）以及各自的页面脚本。通过 MG.data.get('mods') → Promise 获取数据；获取单个条目时使用 MG.data.get('mod', 'slug')。旧版 MG.data.load(['mods','news']).then(store => {...}) 仍可使用。

---

更新日志

2026-07-22

• 将 Maze Rats（94 个程序化表格）添加到 oracle 流程和 oracles 页面
• 遭遇构建器现可通过系统选择器支持 D&D 5e 和 Pathfinder 1e
• Discord /encounter 命令使用自动补全，便于未来选择系统
• 重建 rules-index.json（涵盖 41 款游戏的 8,426 个条目，并添加表格类型索引）
• MCP Worker 升级至 v1.7.0

2026-07-20

• 为所有尚未跟踪的交互模块添加 GA4 分析跟踪
• API playground：工具选择、类别展开、工具运行事件
• Hex embed：布局、尺寸、玩家、样式变更和地图生成
• TI Dashboard：游戏开始、策略选择、跳过、Mecatol 占领、议程抽取 / 处理、游戏结束
• 在 GA4 中注册 tool_name 自定义维度，用于按 MCP 工具细分
• D&D 遭遇构建器、Discord oracle 命令和 /test 套件（来自上一会话）
• 关闭问题 #131、#132、#135

2026-06-10

• 在 tools.moddable.games 部署 MCP 工具服务（6 个命名空间中共有 42 个可由 AI 调用的工具）
• 提供 MCP 协议（SSE）、REST API、llms.txt、OpenAPI 3.1 和 .well-known/mcp.json 发现功能
• 新增 /developers/ 部分：着陆页、/api/ 子页面和 /examples/ 子页面
• 紫色部分强调色（#8b5cf6）、SVG 主视觉特色图和独特的 OG 图片
• 在精选 Mod 和 Nukes 部分之间新增首页“For Developers”横幅
• 调整导航顺序：Mods、Engines、Games、Tools、Developers、About、News（SVG/立方体交替）
• 新增 dice_roll 和 ti4_random_factions 作为网站原生工具
• 谜题生成使用预计算池（Cloudflare Workers 免费层）
• 在 chess.moddable.games 和 hex.moddable.games 中新增 AI 集成部分
• 在 tools.moddable.games Worker 中添加 favicon 和完整的 OG/Twitter 元标签

2026-06-09

• TI4 目标追踪器：新增完整的游戏对局模式，支持玩家计分、秘密目标和奖励 VP 追踪
• 支持所有扩展（基础版、Prophecy of Kings、Discordant Stars、Thunder's Edge）
• 设置界面支持选择玩家数量、VP 目标、扩展开关和颜色分配
• 记分板包含进度条、选项卡界面（公共/秘密/奖励）和获胜者判定

2026-06-05

• 使用新的共享 sectionHero() 组件，为全部 17 个页面统一主视觉系统
• 两级设计：完整的宇宙主题主视觉（tier-1 索引页）和精简的子页面主视觉（tier-2）
• 配色系统：风格一致的子页面部分使用 RGB 强调色，风格不同的子页面使用 CMYK
• 添加视差滚动效果，包含醒目的文字淡出、六边形网格缩放和渐变变暗
• 添加动画 3D 特色元素：旋转立方体（Tools、Engines、About）和动画 SVG（Mods、Games、News）
• 调整导航顺序，使立方体和 SVG 特色交替排列：Mods、Engines、Games、Tools、News、About
• 修正 Endless Skies 强调色（由绿色改为蓝色，与详情页一致）
• 修正 Mods 页面从导航栏下拉菜单进行哈希值更改筛选的问题
• 修正 Tools 页面加载时自动滚动到搜索栏的问题
• 统一所有主视觉文案：tier-1 页面采用 2 行标题，突出单个关键词，并配以 2 行平衡的导语
• 为静态网站构建系统迁移创建 GitHub issue #81
• 新增资源：hex-grid-purple.svg、hex-grid-cyan.svg、hex-grid-magenta.svg、hex-grid-amber.svg

2026-06-04

• 根据真实规则书（v0.9.0）重写 Planet Mongo 游戏页面：4X 六边形领土控制、8 个派系、隐藏指令、中央市场
• 根据真实规则书（v0.2.0）重写 Endless Skies 游戏页面：4X 工人摆放、8 个派系、飞船舱室、虫洞网络
• 两个页面现在都如实标注为“In development”，不包含杜撰内容
• 从两个页面移除虚构的社区 Mod（目前尚无真实 Mod）
• 删除失效的单个游戏 JS 文件和自定义 CSS（页面使用共享的、由数据驱动的渲染器）
• 更新两个游戏的元标签和 OG 描述
• 从 moddable-rules 同步所有 Mod 元数据：版本、标语、统计数据、开发状态
• 替换 Talisman Worlds 徽标（采用来自 moddable-rules 的新圆形徽章，并正确放置在 410x410 画布上）
• 修正 Talisman Worlds 主视觉标题（之前仍显示为“Talisman: Hexed”）
• 将虚构的 Econopoly 内容替换为真实规则书机制（资源、VP、选择行动）
• 将虚构的 Hyper Imperium 内容替换为真实机制（3D 探索、承诺交易、雇佣兵建造）
• 根据真实规则书首页信息重写 games-sync.json（所有条目均已过时）
• 为全部 6 个社区 Mod 添加 RGB 立方体占位徽标（#61 部分完成）
• 关闭 #25（网站端 Mod 下载链接已完成）、#78、#79

2026-06-02

• 将 MCE 同步至 v0.7.1／70 个变体（之前为 v0.6.8／64 个）：统计数据、功能、用户 API、开发者指南
• 将 Dungeon Chess 从 /games/ 移至 /mods/——它是对国际象棋的完全改编，并非原创游戏
• 新增新闻文章：“Building Games on Chess”（MCE v0.7.1 用户 API + DC v1.2.0 渲染器迁移）
• 根据实际的可修改规则规则手册重写 Nukes 游戏页面（移除所有虚构内容）
• 为游戏索引卡片添加游戏徽标（410x410 标准化 PNG）
• 更新全站所有计数：10 个模组、3 款游戏、13 篇新闻文章
• 为游戏页面和新文章重新生成 OG 图片
• 为游戏／模组卡片中的徽标缩略图添加 .game-card__logo CSS
• 修复游戏引擎介绍区域正文的居中对齐
• 创建议题 #78（Mongo 同步）和 #79（Endless Skies 同步），用于后续重写规则手册
• 升级至 v1.0.60

2026-05-28

• 根据 moddable-chess v0.6.8 同步国际象棋引擎统计数据：变体数量从 39/54→64、引擎版本、棋盘类型
• 更新 9 个文件中所有过时的国际象棋相关信息（引擎页面、工具页面、新闻卡片、数据文件）
• 在引擎页面、统计数据和用户列表中新增 Colony，作为第 4 款由 hexmaps 驱动的游戏（#71）
• TI4 工具：添加 Discordant Stars 和 Thunder's Edge 扩展包（36 个派系、26 个目标、20 个议程）（#68）
• 银河地图生成器：将玩家人数下拉菜单替换为 7 种官方 TI4 布局变体（3p–8p + Hyper Imperium）
• Hexmap 嵌入：添加样式选择器（每款游戏均提供 Artistic/Classic/Kenney/Realistic），并统一 URL 参数
• Hexmap 嵌入：添加 postMessage 桥接，以便无需重新加载 iframe 即可点击“新地图”重新生成地图
• 新增 Dice Lab，路径为 /tools/dice/——提供骰子投掷器，以及 Risk、TI4、Axis & Allies、X-Wing、Blood Bowl、Memoir '44、自定义模式的战斗模拟器（#67）
• 将工具索引中的骰子投掷器合并至 Dice Lab，作为第一个标签页
• 从 Nukes 工具中移除打击规划器组件（与完整的 hexmaps 嵌入功能重复）
• 从工具索引中移除 Hex Map Generator 卡片（它应归入“引擎”，而非“工具”）
• 将所有 hexmaps 引擎栏中的“支持的游戏”数量从 3→4
• 页脚列标题现在可点击，并链接至各自的索引页面
• 将“Mod-specific tools”重命名为“Per-game tools”，并统一间距和锚点
• 标签页选择会保留在 URL 哈希中（/tools/dice/#risk），方便分享
• 修复模组详情页面目录的滚动定位功能（动态渲染后调用 initTocSpy）
• 为模组按钮配置真实 URL：rules.moddable.games、BGG、Wikipedia、itch.io（#25 第 1 部分）
• 移除 Nuke Catan 模组（系虚构内容，无支持材料）——首页版块现在链接至 Nukes 游戏和 nuking-catan 文章
• 根据 category/baseGame 自动生成相关模组（不再使用硬编码数组）
• 修复所有引用中的模组／游戏数量：9 个模组、4 款游戏

2026-05-27

• 新增工具：资源仪表板、背包追踪器、角色分配器（均可通过游戏预设完全配置）
• 移除：地图网格生成器（功能重复）、投票亭（需要服务器）、战斗胜算（重制为 Dice Lab #67）
• 修复工具页面上不可见的按钮（浅色背景使用了错误的变体）
• 工具索引：添加 Hex Map Generator 卡片，更新特定模组的卡片描述
• Hexmaps 工具卡片链接至引擎页面（而非外部生成器）
• Nukes 游戏页面：添加“生成地图”主视觉 CTA
• 在工具页面中嵌入 moddable-hexmaps 引擎：/tools/nukes/、/tools/talisman/、/tools/ti/（#62）
• 共享嵌入模块（js/mg-hexmap-embed.js）+ CSS（css/tools-hexmaps.css）
• 在所有三个页面添加“Powered by Moddable Hexmaps”引擎横幅
• 通过 iframe 使用 URL 参数分享种子的功能正常
• 新增 /engines/ 板块：顶级导航项、索引页面、Moddable Chess 和 Moddable Hexmaps 页面
• 将 Chess 和 Hexmaps 从“Games”重新归类至“Engines”——它们是 SDK，而非游戏
• 更新导航：Mods | Games | Engines | Tools | News | About
• 将 /games/moddable-chess/ 移至 /engines/moddable-chess/（旧 URL 会重定向）
• 创建 /engines/moddable-hexmaps/ 展示页面（绿色强调色，暂未嵌入——等待 hexmaps#7）
• 页脚、搜索、工具中的 chess 页面和 news.json 均已更新为新路径
• 游戏索引：移除 chess，添加“由我们的引擎驱动”提示
• 创建 data/engines.json，作为引擎列表的数据源
• 跨项目问题：moddable-chess#47、moddable-hexmaps#17
• 修复首页崩溃问题：“Fog of War Chess”已从 mods.json 移除，但仍在首页精选列表中被引用
• 修复主视觉视差效果溢出所在区块边界的问题——将其包裹在 overflow:hidden 容器中
• 修复 home-tabs 导航被上方区块遮挡的问题——移除裁切负外边距的 overflow:hidden
• 版本从 1.0.29 升至 1.0.30（上一提交漏掉了版本更新）
• 新闻文章：作者侧边栏卡片，包含突出显示的团队照片、姓名、角色和个人资料链接
• 新闻文章：真实分享链接（X、Facebook、LinkedIn、复制 URL）
• 新闻文章：全部 12 篇文章现在都有带真实链接的提示卡片（不再有失效的 # href）
• 新闻文章：未指定手动 modCard 时，根据标签自动生成提示卡片的混合机制
• 新闻文章：优化右侧栏间距（主题、模组卡片）
• 为所有新闻文章添加 teamSlug 字段——作者信息从 team.json 渲染，而非硬编码
• 为每位团队成员生成 OG 图片，包含突出显示的照片 + 阴影狭缝效果
• 替换 16 张模板 OG 图片：10 个模组页面（六边形网格卡片）+ 6 个工具页面（几何图标）
• OG 脚本改为数据驱动：build/gen-mod-og.py（读取 mods.json）、build/gen-tools-og.py
• 模组徽标：在 mods.json 中添加 logo 字段，并在卡片、详情页主视觉和 OG 图片中显示徽标
• 从 moddable-rules 复制 Talisman: Hexed + Econopoly 徽标；Hyper Imperium 已有徽标
• 修复模组详情页主视觉因 DOMContentLoaded 竞态条件而始终无法渲染的问题
• 组件列表样式：强调色描边项目符号，间距更佳
• 生成所有剩余 OG 图片——不再有模板占位图（关闭 #53）
• 新增 4 个构建脚本，供日后重新生成：gen-team-og.py、gen-mod-og.py、gen-tools-og.py、gen-remaining-og.py
• 创建 #61（缺失的模组/工具徽标）和 moddable-chess#44（棋盘主题）

2026-05-26

• 将所有页面中的国际象棋变体数量从 20 更新至 39（关闭 #55、#54）
• 移除无用的 mg-game-dungeon-chess-page.js——这是一个未在任何地方加载的孤立文件（关闭 #52）
• 修复 chess 工具页面中的内联 style="display:none"——改用 CSS 类和 classList 切换
• 将导航栏、页脚和卡片中的内联 style:{} 对象重构为专用 CSS 文件
• 新增文件：css/navbar.css、css/footer.css、css/cards.css（共 63 条规则）
• 加载器通过 document.write 自动注入组件 CSS——无需逐页修改 HTML
• 仅保留数据驱动的动态值（强调色、图片 URL）作为内联样式字符串

2026-05-24

• 通过 build/stamp-meta.py 添加每页的 OG/Twitter 元标签（关闭 #35）
• 完善 4 个占位页面：/press（统计卡片、色板、素材）、/subscribe（表单 + 成功状态）、/tools/decks（牌组构建器）、/tools/chess（变体选择器）
• 将所有新页面添加到导航栏下拉菜单、页脚链接和工具索引中
• 创建新的 Moddable-Games/moddable-chess 仓库 — 包含 14 种变体的共享国际象棋引擎
• 将现有国际象棋仓库重命名为 Moddable-Games/dungeon-chess
• 添加 favicon 集（SVG + PNG）、apple-touch-icon、PWA 清单和 theme-color（关闭 #8）
• 为 web.moddable.games 添加 CNAME 和生产环境 OG URL，做好 GitHub Pages 部署准备（关闭 #9）
• 为所有页面生成 47 张品牌 OG 社交图片
• 根据 URL 自动检测本地开发路径 — 无需手动添加 mg-base 元标签
• 响应式设计审查：检查 11 个 CSS 文件中的移动端断点（关闭 #6）
• 添加 ARIA 地标、跳转到内容链接和导航中的 aria-current=page（关闭 #24）
• 修复占位 # 链接 — 社区渠道现在改用非链接 div（关闭 #26）
• TI4 议程投票器扩充：卡片从 6 张增加到 46 张，包含完整基础游戏牌组（关闭 #3）
• 无障碍：加深石色，以满足 WCAG AA 对比度要求（关闭 #11）
• 性能：延迟加载首屏以下的图片（关闭 #14）
• 工具交互审查：确认所有小组件均可正常使用（关闭 #27）
• 将仓库设为公开，GitHub Pages 已在 web.moddable.games 上线
• 添加团队成员详情页，包含撰写的文章、详细简介和队友链接（关闭 #32）

2026-05-25

• 重建 Nukes 工具（#49）：打击规划器、战斗计算器、人质追踪器、单位参考 — 基于真实规则手册
• 国际象棋工具：提供 20 种可玩的变体（新增 No Castling、Torpedo、Horde、Extinction、Breakthrough、Maharaja）
• 国际象棋游戏页面：统计数据与 v0.4.2 引擎保持一致，CTA 链接到 chess.moddable.games，变体网格分为 6 类
• 修复导航下拉菜单被页眉的 overflow:hidden 裁切的问题
• 在 Moddable Chess 页面为 Dungeon Chess 设置精选卡片样式（深色背景）
• 移动端将 Hero 立方体居中
• 修复移动端导航：抽屉在加载时隐藏，并防止水平溢出
• 修复首页 Hero 背景在移动端重复显示的问题
• 修复移动端团队页面弹出内容重叠的问题（增大行间距）
• 版本系统：bump.sh 从 version.txt 单一读取版本号，页脚显示版本
• 在 52 个 HTML 文件的所有 CSS/JS 加载地址中添加缓存破坏参数 ?v=
• 从页脚移除粉丝制作免责声明（之后移至许可页面）
• 国际象棋嵌入：通过来自 chess.moddable.games 的 iframe 提供可实时游玩的棋盘
• 国际象棋引擎参数：theme=light、boardonly=1、bg=、accent=、radius=
• 对局设置：模式选择器（对战 AI / 轮流操作），将玩家名称传递给引擎
• 根据变体棋盘尺寸动态调整 iframe 宽高比
• 国际象棋引擎宣传区：全宽深色横幅，展示独特卖点
• 媒体资料包：将样式化的项目符号列表改为带边框的强调卡片
• 自动检测本地 moddable-chess 路径，以便测试 iframe

2026-05-23

• 将 MG.data 重构为基于 Promise 的 API：get(name) → Promise，get(type, slug) → 查找单个条目
• 对进行中的请求去重（相同资源不会重复请求）
• 移除 ready() 方法（未使用）；保留 load() 以向后兼容
• 修复响应式团队页面：移动端（≤600px）上的突出图片会缩小
• 搜索索引在首次打开时异步加载新闻（不再依赖同步缓存）
• 为全部 13 个 mod 页面套用模板 — HTML 外壳统一，Hero 根据数据渲染
• 将全部 12 篇新闻正文提取为 data/articles/{slug}.html 局部文件
• 将文章元数据（作者、导语、目录、modCard）移至 data/news.json
• 新闻页面外壳现在使用统一模板 — 由 JS 渲染整个页面
• 为每页 Open Graph / Twitter 元标签创建 issue #35

2026-05-22

• 将所有数据从 JS 模块提取到 JSON 文件（data/mods.json、games.json、news.json、team.json）
• 在 mg-core.js 中添加 MG.data 获取层，采用异步 load()/get() 模式
• 移除 4 个数据 JS 模块（mg-mods-data.js、mg-games-data.js、mg-news-data.js、mg-team-data.js）
• 更新所有使用数据的脚本，采用 MG.data.load().then() 模式
• 在全局 CSS 重置规则中添加 text-wrap: pretty，防止孤行
• 重新设计工具页面：添加可筛选的卡片网格和分类栏（游戏之夜、规划、创作、模组专属）
• 将 3 个深色主题的工具小组件（骰子、计时器、座位安排）改为统一的浅色卡片样式
• 在工具页主视觉区域添加 3D 旋转 CSS 骰子
• 重新设计团队页面，照片头像从卡片中凸显出来（4 列网格）
• 移除 font-test.html

2026-05-21

• 将所有内联脚本提取到外部 JS 文件中（45 个页面均不再包含内联脚本）
• 创建数据驱动的模组页面渲染器（mg-mod-page.js + mg-mods-content.js）
• 创建共享新闻文章渲染器（mg-news-article-page.js，带有 data-toc）
• 将团队数据提取到 mg-team-data.js
• 添加目录滚动侦测功能，并用强调色突出显示
• 添加全局规则：禁止内联 <script> 块（与禁止内联样式的规则一致）
• 总计：移除 5220 行内联 JS，新增 3537 行规范的外部模块代码

2026-05-20

• 将模组和游戏数据提取到共享 JS 模块（mg-mods-data.js、mg-games-data.js）
• 将所有内联样式提取到外部 CSS 文件；完成 JS 模块拆分
• 将 _mg.js 拆分为语义化模块（核心、组件、动画）
• 添加全局搜索（Cmd+K），并使模组卡片整体可点击
• 添加滚动显现动画系统、主视觉区域入场动画编排和按钮微交互
• 游戏页面主视觉区域：双列布局搭配浮动徽标
• 首页：添加核家族插画、Hyper Imperium 徽标和发光的区块分隔线
• 根据 WordPress 创建全部 12 篇新闻文章，并正确链接新闻索引
• 为导航下拉菜单添加动画和蓝色强调状态
• 移除所有内联样式属性；全站采用语义化 BEM 类系统
• 创建 12 个模组详情页、游戏中心、Moddable Chess、Dungeon Chess 和路线图
• 修复双重 URL 问题，移除多余的导航项，清理未使用的资源

2026-05-19

• 重构网站，支持简洁 URL 和 GitHub Pages 部署
• 提交网站初始版本

---

许可证

MIT