《小游戏开发实战》卷一《市场、品类与产品设计》目录

这是一套关于 小游戏 的书。它不讲 3D 渲染、不讲原生发行、不讲引擎 API，它讲的是在平台的包体、加载与 API 约束下，一款小游戏从市场判断到立项交付怎么被设计出来，并且每一处设计都能被跑出来的数字检验。

卷一《市场、品类与产品设计》回答三个问题：这个市场是什么样、我该做什么品类（第 1–5 章），玩法与系统怎么设计成闭环（第 6–10 章），怎么算清楚账并把它交付出去（第 11–15 章）。卷二《引擎实现与体验打磨》接着把设计落成能跑的内核与原型；卷三《上线变现与长线运营》接着把产品推上线并跑长线。

贯穿全书的是一款虚构的轻度小游戏 《合成小岛》（merge-island：合成 + 放置 + 关卡 + 装扮）与一套工具链 pebble（config/ + sim/ Python + core/ TypeScript + web/ 单文件 HTML）。

这套书与站内既有内容的分工

站内已经有不少相邻内容，写清楚分工比重复写一遍更有价值：

• 小游戏创作平台专题（game-engine） 与 小游戏平台专题（minigame） 合计 49 篇，讲的是做小游戏平台 / 创作工具——编辑器、素材市场、BP 与融资，是 SaaS 创业口径。本套是「在平台上做一款游戏」，是单款产品口径。
• 小程序小游戏开发综述 是一篇 96 行的单篇综述，覆盖引擎选型、性能、变现三块。本套是成体系的 150 篇，且每一节都有可运行产物。
• Cocos 游戏开发系列 是引擎 API 教程（Creator 组件、生命周期、渲染管线）。本套不写引擎 API 教程，core/ 只做平台适配 + 逻辑内核 + 最小渲染抽象。
• 引擎内核系列 讲的是自研引擎（TS + WebGPU）的底层实现。本套的 core/ 只到「配置驱动逻辑 + 平台 API 抽象层 + mock 宿主」这一层，不碰渲染管线内核。
• 产品文档系列（products） 是 PRD 文档。本套的原型是可跑、可调参、可断言、可浏览器打开的工程，不是一份静态 PRD。

可运行性口径

本套用六档标注每个代码块，代码块头部的注释里写着它属于哪一档：

全书有两条核心主张，贯穿三卷：

1. 一份 config，三种消费。pebble/config/ 是设计的唯一真源：Python 仿真、TypeScript 内核、浏览器原型读同一份数字。改一个数，三处结果都跟着变。为此 config/ 里禁浮点——增长率写成整数比（levelBonusNum / levelBonusDen），系数写成整数百分比（ratePct）；幂运算在 TS 侧用 BigInt，除法一律整数地板除。
2. 一份逻辑，两种宿主。游戏逻辑只依赖 Host 抽象（时钟、存储、平台 API），mock 宿主与真机宿主共用同一段代码，结果逐帧一致。确定性回放由此成立——core/ 里禁用 Math.random()，随机数一律用配置里的 seed 加自实现的整数 LCG/PCG。

两条纪律同样贯穿全书：不编造平台后台数字（真实平台只作「公开可观察机制」引用并标注观察时点）；所有仿真数字来自本机实跑，正文写「同机相对量级，绝对数值不可移植」，不写「提升 N 倍」式的绝对话。

明确不在本套范围内

为了让边界清楚，下面这些这套书不讲：

• 3D 渲染与美术管线（模型、骨骼、shader、美术生产流程）。
• 原生 App / 主机 / Steam 发行（那是另一套发行与商务逻辑）。
• Cocos / Godot / Defold 等引擎的 API 教程（站内已有专书）。
• 服务端架构（房间服、匹配、跨服；站内已有《MMO 服务器开发》四卷本 ）。
• 做「小游戏平台 / 创作工具」本身（站内已有 game-engine 与 minigame 两个专题）。
• 真实平台后台数据（X，需真实业务环境）。
• 具体法律意见与买量投放实操（X，需真实业务环境与法务/投手）。

全书目录

前置

第一部分：市场、用户与平台约束（第 1–5 章）

第 1 章 小游戏市场全景——先把「小游戏」这个词界定清楚

第 2 章 榜单与竞品拆解——看清别人在做什么

第 3 章 品类图谱与选择模型——本卷核心（S + B）

第 4 章 平台规则与设计约束——约束反向决定设计

第 5 章 目标用户、动机与生命周期——为谁设计

第二部分：玩法与系统设计（第 6–10 章）

第 6 章 核心玩法与核心循环——本卷的 P + W 起点

第 7 章 关卡与难度曲线——让「刚好难」

第 8 章 成长、进度与放置收益——「再来一局」的动力

第 9 章 社交与裂变机制——小游戏特有的传播面

第 10 章 变现设计前置——先想清楚怎么赚钱

第三部分：立项、验证与交付（第 11–15 章）

第 11 章 产品文档、预算与立项决策——把想法变成可决策的文档

第 12 章 玩法原型与可玩性验证——用原型回答「好不好玩」

第 13 章 商业化模型与收入预测——把账算清楚

第 14 章 开发预算与资源计划——钱和人怎么排

第 15 章 立项评审与设计案交付——把一卷收口

附录

三条阅读路径

路径 A：产品经理的市场课（第 1–5 章顺序读）
从定义边界与平台分发开始，经榜单拆解、品类选择模型，到平台约束与用户动机。这条路径回答「我该做什么品类、给谁做」。读完你能用一张加权评分表解释你的品类选择，并用脚本证明它对权重不敏感。

路径 B：策划的玩法与系统课（第 6–10 章顺序读）
从核心循环拆解开始，经关卡难度、成长放置、社交裂变，到变现前置。这条路径回答「玩法怎么设计成闭环」。读完你能画出核心循环、跑出难度曲线与 K 因子，并让一个最小原型在浏览器里跑起来。

路径 C：立项决策课（第 11–15 章顺序读）
从一页纸与预算估算开始，经原型验证、收入预测、资源计划，到立项评审与设计案交付。这条路径回答「这笔账值不值得投」。读完你能产出一份自洽的立项材料并给出止损线。

常见问题速查

环境准备

正文里的代码块都可以在本机复现。需要的东西只有两样，下面这段 S 层脚本会替你确认：

# file: sim/ch00_env_check.py
# tier: S
# verify: /opt/homebrew/bin/python3 sim/ch00_env_check.py
"""环境自检：确认《小游戏开发实战》三卷需要的运行时都在，并打印 pebble 的能力阶梯。

本机有两个 python3，不要混：
  /opt/homebrew/bin/python3 = 3.14.6（带 numpy / pandas / PIL），S 层仿真一律用它；
  /usr/bin/python3          = 3.9.6（系统自带，无 numpy/pandas），只能跑最朴素的脚本。
"""

from __future__ import annotations

import os
import shutil
import subprocess
import sys

EXPECT_PY = "/opt/homebrew/bin/python3"


def main() -> int:
    ok = True

    # /opt/homebrew/bin/python3 是符号链接，比较时解析到真实二进制再判断
    real = os.path.realpath(sys.executable)
    print(f"python     {sys.version.split()[0]}  ({real})")
    if real != os.path.realpath(EXPECT_PY):
        print(f"           注意：正文脚本一律用 {EXPECT_PY}，当前解释器不同")

    try:
        import numpy
        import pandas

        print(f"numpy      {numpy.__version__}")
        print(f"pandas     {pandas.__version__}")
    except ImportError as e:  # noqa: BLE001
        ok = False
        print(f"FAIL 缺依赖：{e}（S 层需要 numpy 与 pandas）")

    node = shutil.which("node")
    if not node:
        ok = False
        print("FAIL node 未安装（P 层需要 Node 26 或更高）")
    else:
        ver = subprocess.run([node, "-v"], capture_output=True, text=True).stdout.strip()
        major = int(ver.lstrip("v").split(".")[0])
        note = "" if major >= 26 else "  （低于 26，原生 TypeScript 不可用）"
        print(f"node       {ver}{note}")
        ok = ok and major >= 26

    print("pebble 能力阶梯：S 仿真 / P 内核 / W 网页 / D 静态 / X 不可复现 / B 基准")
    print("OK 环境就绪" if ok else "FAIL 环境不满足")
    return 0 if ok else 1


if __name__ == "__main__":
    raise SystemExit(main())

• Python 3.14.6（/opt/homebrew/bin/python3）加 numpy 与 pandas：S 层仿真用。
• Node 26 或更高：P 层内核直接跑 TypeScript，不需要 tsc、不需要 npm install、不需要 package.json，断言用 Node 内置的 node --test。

图表不用 matplotlib（本机未安装）——本套的 SVG 是纯 Python 用标准库 xml.etree 画出来的，零依赖、可复现。完整的环境口径、pebble/ 目录结构与全部实跑命令见附录 A 。

本页是全书目录。可以从序 开始顺序读，或直接进入第 1 章 1.1 小游戏的定义与边界 。