01 · 核心玩法循环

零一张图看懂这层在解什么问题

放置经营游戏的核心矛盾:离开时要有产出(挂机),在线时要有掌控感(点击)。 Eatventure 的答案是把两个时钟叠在一起——自动微循环离线也跑,点击升级随时介入立刻见效。

一工位出餐(Station / Order)—— 微循环的发动机

③ 数据与公式

工位配置中,升星上限为 5 星。 工位里程碑配在 station_profit_milestones.csv,核心是一个极省常量的几何矩阵:

station_profit_milestones.csv 真实样本(主题城 ×800 系):

④ 平衡与节奏

工位的两条成长轴形成节奏对比:

⑤ 设计意图 / 可复用结论

二菜品(Item)—— 换皮的产出物,数值不在它身上

③ 数据与公式

菜品配置共 163 道菜。 逐字段看——没有任何利润/速度的数值字段,全是名字与资产引用:

菜品↔餐厅映射见菜品-餐厅映射表;80/163 跨餐厅复用。

④ 平衡与节奏

菜品复用 + 工位里程碑驱动数值,意味着同一道 "Salad" 在第 1 城和第 40 城是完全不同的收入量级——差异全靠 cityMult + 工位公比拉开,菜品本身零改动。

⑤ 设计意图 / 可复用结论

三顾客(Customer / CustomerSlot)—— 没有耐心的"收银终端"

③ 数据与公式

顾客配置共 12 套外观。 其字段全是外观(头/帽/发/身体 ID + 肤色/衣服颜色)+ 金色材质 + Customer Multipliers 下仅两个共享乘子——全表无耐心字段:

顾客类型纯外观换皮(Royal / Knight / Pirate / Greek / Hades… 12 套适配各主题城),数值完全共享。

④ 平衡与节奏

没有耐心条 → 玩家离线时顾客不会流失 → 离线产能可被稳定折算(10% / 3h,见 03)。 在线时,顾客承载量(slot 数 + 桌数)是产能的"下游瓶颈":出餐再快,柜台前没顾客也卖不掉,所以 customer_count / table_count 和出餐提速形成供需两端的配平升级。

⑤ 设计意图 / 可复用结论

四工人 / 角色(Worker / Character)—— 纯外观 + per-restaurant 数值

③ 数据与公式

工人配置共 20 套外观,为纯视觉配置——关键是那两个"升级"字段其实是显示名,不是数值:

// 工人配置全部字段
名字          Name
图标          Icon
工人数量升级   NumberOfWorkersUpgrade   // ← 升级线"显示名",非数值!
移速升级       WalkSpeedUpgrade         // ← 同上
装备设置       EquipmentSettings        // 身体/头/帽/发 资产ID+颜色
肤色          SkinColor

真实的工人数量/速度数值,全部配在餐厅升级配置(每家餐厅独立),按工位子区细分:

移速公式:

工人名字库:34 套国家名库(Spain / Mexico / Luxembourg…)——按城市国籍给工人随机起名,纯本地化氛围,无数值。

④ 平衡与节奏

移速升级是这套数值最优雅的一笔:效果线性恒定(+0.25/级)+ 成本指数上涨。

⑤ 设计意图 / 可复用结论

五堂食容量(Tables / CustomerSlot)—— 产能的下游闸门

③ 数据与公式

restaurant_layout.csv 给出每家餐厅的物理容量(72 餐厅统计);运行时区域数据对应布局,含顾客位 / 柜台 / 小费位 / 工位:

早期是"0 桌纯外带小摊"(LemonadeStand 类),后期才解锁堂食扩容,容量随关卡递进。

④ 平衡与节奏

容量是"看不见的天花板":玩家把出餐提速拉满后会发现收入卡住——因为顾客位/桌位不够,菜卖不出去。这迫使玩家回头点加桌/拉客,形成节奏:

⑤ 设计意图 / 可复用结论

六外卖运输(Transports / FoodDelivery)—— 主题城的批量物流

③ 数据与公式

运输配置关键字段为最大载客量 / 基础速度 / 到达耗时 / 满后发车耗时 / 是否走行人路径。 共 15 种载具:

基础速度几乎全部统一 = 3.0(唯一例外 SmallBoat Pirate = 5.0)——载具差异不在速度,而在"载客量 × 周期":

④ 平衡与节奏

⑤ 设计意图 / 可复用结论

七工人任务调度(Task 体系)—— 微循环的状态机

典型工人生命周期(状态机)

任务体系把工人行为拆成一组成对出现的原子任务(取餐 / 交付 / 移交 / 收获 / 沿路径移动 / 烹饪 / 收小费), 每类任务都有对应的启动系统驱动。派活逻辑核心是"找最近空闲工人":系统在所有空闲工人中挑距离最近者承接当前任务。

③ 数据与公式(运行时)

任务调度是运行时逻辑(无独立配置数值),其输入参数来自前面各表:

运行时有一个遍历刷新工人移动速度的系统,在升级后批量更新所有工人的移速。

④ 核心 tick 伪代码

把 §一~§七 整条链合成一个 tick 循环(核心微循环,综合各表的设计还原):

# ========== 核心微循环:每帧 tick ==========
def tick(dt):
    # 1) 工位出餐
    for st in unlocked_stations:
        st.timer -= dt
        if st.timer <= 0:
            st.tray.append(produce(st.item))                 # 产出一份菜放托盘
            st.timer = st.base_time / cooking_speed(st)       # 重置周期(烹饪提速 +1/+2)

    # 2) 任务调度:把空闲工人派去送餐/收获
    for w in idle_workers():                                  # worker_count 决定并发数
        st = nearest_station_with_food()
        if st:
            task = HarvestingTask(st) if st.item.is_harvestable else PickupTask(st)
            w.assign([task,
                      MoveOnPathTask(path_to_counter(w), speed=base*(1 + n*0.25)),  # +0.25/级
                      DeliverTask(counter)])                  # 交付到柜台

    # 3) 顾客买单卖钱(无耐心:顾客不会愤怒离场)
    while counter.has_food() and has_waiting_customer():      # 容量 = customer_slots + tables
        c = pop_customer()
        gain = base_profit * station_milestone_mult(st)       # 真实倍率在工位里程碑 ×3..×100
        gain *= 16 if c.is_golden else 1                     # 药水触发 → ×16(金色乘子)
        gain *= ascend_multiplier()                           # 养成乘区(装备/宠物/神器)
        money += gain
        spawn_new_customer()                                  # 立即补位(无流失)

    # 4) 外卖运输:批量周期物流(主题城)
    for tr in transports:
        tr.run_cycle(dt)   # 到达 → 装满最大载客量 → 满后发车

# ========== 玩家主动介入:随时点击升级,立刻见效 ==========
def on_player_upgrade(kind, target):
    cost = upgrade_price(kind, target.level)                  # 见 03:指数成本
    if money >= cost:
        money -= cost
        apply(kind, target)        # 提速/雇工/加桌/拉客/利润里程碑 → 下一 tick 立即生效

收入节奏:密集小台阶 + 稀疏大跳档

⑤ 设计意图 / 可复用结论

八订单与小费(Order / Tips)—— 收入的两个口子

③ 数据与公式

收入主公式(承 03 经济与数值):

小费为附加结算项(由收小费任务结算,按订单比例的小额附加,客户端无独立倍率表)。 希腊隐形顾客的订单量乘子 = 3.0,说明个别特殊订单可放大单笔订单量。

④ 平衡与节奏

小费作为副口子,量级远小于主收入,主要服务"工人收钱"的动作反馈与微量优化,不改变经济主轴。

⑤ 设计意图 / 可复用结论

九新手引导(Tutorial)—— ECS 步骤状态机,数据不在配置里

③ 数据与结构(来自反编译代码)

引导进度直接写进存档 TutorialSavegame,全部字段只有 5 个——每条教程线一个进度位,没有统一的步骤配置表:

// TutorialSavegame 全部字段
主动技教程完成    ActiveSkillTutorialComplete   // bool
宠物合成教程步骤  PetMergeTutorialStep          // Nullable<int>,步骤号
宠物商店教程已示  PetShopTutorialShown          // bool
俱乐部通知已示    ClubNotificationShown         // bool
酿造锅教程步骤    BrewKettleTutorialStep        // int,步骤号

步骤号是代码内枚举。以最长的一条(酿造锅活动教程 BrewKettleTutorialStep,14 步)为例:

步骤号按 10 间隔留空(0/10/11/20/…/110),中途可插新步骤而不重排。宠物合成(PetMergeTutorialStep,-1~2)/宠物商店(PetShopTutorialStep,-1~3)同构但更短。

引导的"手指/高亮"表现由一组专用视图承担:

另有 TutorialCheatSystem(可整线关闭主动技/神器/人物/装备箱教程)——开发调试与老玩家跳过用。

④ 平衡与节奏:主线之外的专项教程线

除主线新手期外,每个中后期系统上线时各挂一条独立教程线(类名前缀即功能): 酿造锅活动(BrewKettle*,14 步最长)、人物(Character*)、宠物合成/宠物商店(PetMerge*/PetShop*)、 主动技(ActiveSkill*)、神器(Artifact*)、装备箱(EquipmentChest*)、餐厅购买/餐厅升级(RestaurantBuy*/RestaurantUpgrade*)、 探索(Discovery*)、家园(HomeMeta*)。其中 4 条在客户端留有视图挂点配置:

主线新手期本身则没有独立步骤表——首城被当作"教学母版"逐关打磨(一关引入一个新维度,甚至跑"首城延长"A/B 实验),见 02 进度结构。

⑤ 设计意图 / 可复用结论

十本篇小结:这层的设计哲学

三条贯穿全篇的设计取舍