「游戏玩法机制生成」(game-mechanics)是数据鱼API平台提供的玩法概念生成接口,Base 路径 /api/game-mechanics,只有 2 个端点:健康检查与 generate。它不做数值演算,也不运行战斗过程,而是把「游戏类型 + 核心动作 + 反转规则」三个维度随机组合,输出一句英文概念描述和拆解后的结构化字段。
三个维度分别是 7 种类型、7 种核心动作与 5 种反转规则,组合空间为 245 种。典型输出形如「A Horror where you Stealth, but Gravity flips.」,同时给出 genre、core_action、twist 与 generated_at,便于前端直接取字段渲染,而不是解析整句。
需要区分的是:本接口负责「玩法创意组合」,不负责「数值平衡计算」。ELO、掉落权重、经验曲线属于同门的 game-logic 接口;本接口产出的只是一条可继续展开的机制原型,是否成立、是否好玩仍要人工判断。数据鱼API把它定位为灵感工具,而非设计结论。
方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
GET | /api/game-mechanics/ping | 健康检查 | 否 |
GET | /api/game-mechanics/generate | 随机生成一条玩法概念 | 是 |
鉴权使用 X-API-Key 请求头或 ?api_key= 查询参数,缺失返回 4011,无效返回 4013。两个端点都只接受 GET,generate 没有任何请求参数,也不支持指定数量、种子或语言。
响应统一为 code/msg/data。参数类错误返回 4001 或 4002,目标不存在返回 4004。文档保留了 5032(上游不可用),但实现完全基于本地常量组合,没有外部依赖,正常部署下不会触发;数据鱼API也不会在失败时返回一条编造的概念。
ping 免鉴权,返回 {"status":"ok"},适合探活与网关健康检查;业务端点需要携带 Key。
每次调用从三个常量数组中各抽一个元素,拼接为 idea 并返回各维度原值。
请求参数
参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
无 | — | — | — | 该端点不接受任何请求参数 |
data 字段包括:
字段 | 类型 | 说明 |
|---|---|---|
idea | string | 英文概念句,模板为 A {genre} where you {action}, but {twist}. |
genre | string | 游戏类型,7 选 1 |
core_action | string | 核心动作,7 选 1 |
twist | string | 反转规则,5 选 1 |
generated_at | string | 生成时间,格式 Y-m-d H:i:s |
类型取值为 RPG、FPS、Platformer、Puzzle、Strategy、Horror、Racing;核心动作取值为 Jump、Shoot、Craft、Stealth、Hack、Time-travel、Swap;反转规则取值为 Gravity flips、Limited oxygen、Sound is death、Enemies only move when you do、Health is ammo。
GET /api/game-mechanics/generate响应中的 idea 是固定英文模板,不会随语言参数变化;如果产品面向中文用户,需要在前端为三个枚举建立中文映射,或直接展示原文并附译文。
generated_at 为服务器本地时间,不带时区后缀;跨时区展示时应由客户端统一转换。Game Jam 选题:开赛时连续生成若干条概念,挑一条把「类型 + 动作 + 反转」展开成可玩原型。
策划脑暴:把 twist 当作限制条件,例如「生命即弹药」,反向推导资源循环与战斗节奏。
教学与写作:游戏设计课程用它演示「约束如何催生玩法」,或作为文章配图的结构化素材。
直播与社群互动:观众点一次生成一条概念,主播现场点评,作为轻量互动环节。
本接口不是战斗模拟器,也不接受任何战斗参数。它不会计算伤害、命中、回合或胜率;需要这些能力时应使用数值计算类接口,两者解决的是不同阶段的问题。
idea 是英文模板句,且三个维度都是英文枚举。直接展示给中文用户会显得生硬,建议建立 genre、core_action、twist 到中文的映射表,再用自己的模板重排,而不是对整句做机器翻译。
接口没有幂等性。同一秒内多次调用可能得到相同结果,也可能完全不同;如果需要可复现的灵感序列,应在客户端记录已生成的组合并自行去重,不能依赖服务端顺序。
生成的组合只是创意起点,不构成可玩性、商业性或法律合规性的保证。落地前需人工筛选,并检查名称、设定与现有作品是否存在知识产权冲突。数据鱼API不对基于生成概念开发的产品承担责任。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。