从零到发布的完整指南

本文将通过一个完整的 2D 平台跳跃游戏案例，手把手指导开发者完成 Defold 项目的创建、开发、调试与发布全流程。读者将掌握核心工作流，并理解如何将引擎特性转化为实际生产力。

1. 项目初始化与基础配置

1.1 创建新项目

1. 启动编辑器：

   • 打开 Defold，点击 New Project，选择 Empty Project 模板
   • 输入项目名称 FirstPlatformer，选择存储路径（避免中文路径）

2. 初始文件结构：

   1 2 3 4 5 6

   FirstPlatformer/ ├── main/ # 主集合容器 │ └── main.collection # 入口场景 ├── builtins/ # 引擎内置资源（只读） ├── input/ # 输入绑定文件（自动生成） └── game.project # 项目全局配置

3. 设置游戏图标：

   • 准备 512x512 PNG 文件 assets/icon.png
   • 在 game.project 中配置：

     1 2	[display] icon = assets/icon.png

1.2 输入系统配置

1. 定义输入动作：

   • 右键 input 文件夹 → New → Input Binding
   • 创建以下动作绑定：

     动作名	按键映射	触控区域
     move_left	A / 左箭头	左侧屏幕1/3
     move_right	D / 右箭头	右侧屏幕1/3
     jump	空格 / W	中间区域点击

2. 导出输入表：

   1 2 3 4 5 6

   -- input/game.input_binding actions = { { name = "move_left", triggers = { keyboard = { key = "a" }, touch = { area = { x=0, y=0, width=0.33, height=1 } } }}, { name = "move_right", triggers = { keyboard = { key = "d" }, touch = { area = { x=0.66, y=0, width=0.34, height=1 } } }}, { name = "jump", triggers = { keyboard = { key = "space" }, touch = { area = { x=0.33, y=0, width=0.34, height=1 } }}} }

2. 场景搭建与角色控制

2.1 创建游戏对象

1. 玩家角色：

   • 右键 main.collection → Add Game Object，命名为 player
   • 添加组件：
     • Sprite：设置纹理为 assets/player.png
     • Collision Object：形状设为胶囊体，分组为 player
     • Script：新建 player.script

2. 平台搭建：

   • 创建 platform 对象，添加：
     • Sprite：使用 assets/ground.png
     • Collision Object：设置为静态刚体，分组为 ground

3. 摄像机跟随：

   • 创建 camera 对象，添加：
     • Camera 组件：设置视口为 1280x720
     • Script：添加 camera.script

2.2 角色控制脚本

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

-- player.script
local MOVE_SPEED = 300
local JUMP_FORCE = 800
local GROUND_GROUP = hash("ground")

function init(self)
    self.velocity = vmath.vector3()  -- 初始化速度向量
    self.is_grounded = false         -- 地面检测状态
end

function update(self, dt)
    -- 获取输入
    local move_left = input.get("move_left")  -- 返回 0 或 1
    local move_right = input.get("move_right")
    local jump = input.get("jump")

    -- 水平移动
    self.velocity.x = (move_right - move_left) * MOVE_SPEED

    -- 跳跃处理
    if jump == 1 and self.is_grounded then
        self.velocity.y = JUMP_FORCE
        self.is_grounded = false
    end

    -- 应用重力
    self.velocity.y = self.velocity.y - (9.8 * 1000 * dt)

    -- 更新位置
    local pos = go.get_position()
    pos = pos + self.velocity * dt
    go.set_position(pos)
end

function on_message(self, message_id, message)
    -- 碰撞检测回调
    if message_id == hash("contact_point_response") then
        if message.group == GROUND_GROUP and message.normal.y > 0.7 then
            self.is_grounded = true
            self.velocity.y = 0
        end
    end
end

2.3 摄像机跟随逻辑

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

-- camera.script
local FOLLOW_SPEED = 0.1  -- 跟随平滑系数
local OFFSET = vmath.vector3(0, 100, 0) -- Y轴偏移

function update(self, dt)
    local player_pos = go.get_position("player")
    local target_pos = player_pos + OFFSET
    local current_pos = go.get_position()
    go.set_position(vmath.lerp(current_pos, target_pos, FOLLOW_SPEED))
end

3. 物理系统与碰撞优化

3.1 碰撞层配置

在 game.project 中定义物理分组：

1
2
3
4
5

[physics]
collision_groups = [
    { name = "player", mask = ["ground"] },
    { name = "ground", mask = ["player"] }
]

3.2 物理材质调优

1. 创建材质文件：

   • 新建 materials/player.physics_material

   1 2	friction = 0.2 restitution = 0.0 -- 取消弹跳

2. 关联到碰撞体：

   • 在 player 的 Collision Object 组件中设置 Material 属性

4. 用户界面与交互

4.1 创建 HUD

1. GUI 场景文件：

   • 新建 gui/hud.gui
   • 添加节点：
     • Text：显示分数 score_label
     • Box：生命值条 health_bar

2. 脚本绑定：

   1 2 3 4 5 6 7 8 9 10 11 12 13

   -- gui/hud.script local HEALTH_MAX_WIDTH = 200 function init(self) self.health = 100 gui.set_size(gui.get_node("health_bar"), HEALTH_MAX_WIDTH, 20) end function update_health(self, value) self.health = math.clamp(value, 0, 100) local width = (self.health / 100) * HEALTH_MAX_WIDTH gui.set_size(gui.get_node("health_bar"), width, 20) end

4.2 界面与游戏逻辑通信

1. 玩家受伤时触发：

   1 2 3 4 5

   -- player.script function take_damage(self, amount) self.health = self.health - amount msg.post("/gui/hud#script", "update_health", { value = self.health }) end

5. 资源优化与打包

5.1 图集生成

1. 自动打包设置：

   • 创建 atlas/player.atlas，包含所有角色动画帧
   • 在纹理属性中启用 Auto Size 和 Trim

2. 压缩格式选择：

   1 2 3

   [texture_profiles] android = { format = ETC2_RGBA, max_size = 2048 } ios = { format = PVRTC_RGBA_4BPP, max_size = 4096 }

5.2 构建配置

1. 平台特定设置：

   • Android：

     1 2 3

     [android] version_code = 1 application_id = com.yourcompany.firstplatformer

   • iOS：

     1 2	[ios] bundle_identifier = com.yourcompany.FirstPlatformer

2. 执行构建：

   1 2 3 4 5

   # Windows defold.exe build --platform x86_64-win32 --output bin/ # Android defold build --platform armv7-android --certificate ~/android.keystore

6. 调试与性能分析

6.1 实时调试技巧

1. 控制台命令：

   • debug.set_fps(60)：锁定帧率
   • go.set_position(vmath.vector3(0,0,0), "player")：重置玩家位置

2. 性能采样：

   1 2 3 4 5

   function heavy_calculation() profiler.begin("AI") -- ...复杂计算... profiler.end() end

6.2 内存泄漏检测

1. Lua 内存监控：

   1 2 3

   function update(self) print("Lua memory:", collectgarbage("count").." KB") end

2. 对象池使用：

   1 2 3

   factory.create("#enemy_factory", function(id) table.insert(self.active_enemies, id) end)

7. 项目发布与更新

7.1 多平台适配

1. 分辨率适配策略：

   1 2 3 4 5

   function on_window_resized(self, width, height) local design_size = vmath.vector3(1280, 720, 0) local scale = math.min(width/design_size.x, height/design_size.y) gui.set_scale(vmath.vector3(scale, scale, 1)) end

7.2 热更新部署

1. 增量更新流程：

   1 2 3 4 5

   resource.store_resource("http://patch.example.com/v1.1.zip", { on_complete = function() sys.reload() end })

8. 最佳实践总结

通过本项目的完整开发流程，开发者应掌握以下核心技能：

1. 高效场景构建：

   • 使用集合嵌套管理复杂场景
   • 通过父子关系实现对象层级控制

2. 物理交互设计：

   • 合理设置碰撞分组与掩码
   • 调整物理材质参数优化手感

3. 跨平台工作流：

   • 自动化构建脚本编写
   • 平台特定资源的智能管理

4. 性能优化意识：

   • 实时监控内存与CPU使用
   • 采用对象池避免频繁实例化

建议将本项目代码上传至 GitHub 并添加 .gitignore：

1
2
3
4

# Defold 项目忽略规则
build/
*.dmanifest
*.zip

通过实际项目历练，开发者可逐步探索 Defold 的更多高级特性，如网络同步、3D 渲染扩展等，最终成长为全平台游戏开发专家。

• Lua
• Game Development
• Lua游戏开发实战
• Lua Game Development in Action