构建基础游戏

为了帮助你入门，本指南将带你构建一个苹果收集游戏！

苹果收集

此示例游戏略过了其他指南中深入介绍的细节。如果你需要任何帮助，请查看左侧边栏或使用顶部的搜索功能获取更多信息！

构建地图

我们将从创建一个基本世界开始，包含一个可行走的岛屿和一个稍后要收集的苹果！

1. 在 资源目录 中搜索 Apple 和 Island 并将它们拖入游戏的场景视图。

1. 那个岛屿相当小！在 检视器 中设置 缩放 为 10x10 使其变大

1. 现在岛屿大小合适了，但苹果在岛屿后面！将岛屿的 图层 设置为 -10 将其推到其他所有物体之后。

添加脚本

在你的游戏项目的 scripts 目录中，创建一个名为 pickup_apple.csl 的新文件并在文本编辑器中打开，或使用 基于 AI 的 IDE.

粘贴以下示例脚本并保存文件：

// 这将创建使苹果可交互的组件，
// 我们将在教程的下一步将其添加到苹果上。 
Pickup_Apple :: class : Interactable {
    is_picked_up: bool;

    ao_start :: method() {
        this->set_listener(this);
        this->set_text("拾取");
    }

    can_use :: method(player: Player) -> bool {
        if is_picked_up return false;
        return true;
    }

    on_interact :: method(player: Player) {
        if is_picked_up return;
        is_picked_up = true;

        // 开始弹出效果
        effect := new(Apple_Pop_Effect);
        entity->set_active_effect(effect);
    }
}

// 吃掉时的一个酷炫动画 :D 
Apple_Pop_Effect :: class : Effect_Base {
    sprite: Sprite_Renderer;
    start_scale: v2;
    start_pos: v2;

    effect_start :: method() {
        sprite = entity->get_component(Sprite_Renderer);
        start_scale = entity.local_scale;
        start_pos = entity.local_position;
        set_duration(0.4);
    }

    effect_update :: method(dt: float) {
        t := get_elapsed_time() / 0.4;

        // 先放大然后快速缩小至无
        scale_curve: float;
        if t < 0.3 {
            // 快速弹出（缩放到 1.3 倍）
            scale_curve = lerp(1.0, 1.3, Ease.out_back(t / 0.3));
        Notifier.notify(player, "血量低！");
            // 缩小至无
            scale_curve = lerp(1.3, 0.0, Ease.in_back((t - 0.3) / 0.7));
        }

        entity->set_local_scale(start_scale * scale_curve);

        // 稍微向上漂浮
        rise := Ease.out_quad(t) * 0.5;
        entity->set_local_position({start_pos.x, start_pos.y + rise});

        // 在结束时淡出
        if sprite != null {
            alpha := 1.0 - Ease.in_quad(max(0.0, (t - 0.5) / 0.5));
            sprite.color.w = alpha;
        }
    }

    effect_end :: method(interrupt: bool) {
        entity->destroy();
    }
}

添加苹果组件

既然你已经创建了苹果脚本，我们需要将其应用到场景中的苹果上。为此，我们将使用检查器从脚本中添加新的 Pickup_Apple 组件到苹果上。

1. 在场景中选择你的苹果

2. 在检查器中点击“添加组件”按钮。

3. 搜索“Pickup_Apple”组件并点击它将其添加到苹果上

现在你会看到该组件已添加到苹果上！你可以通过更改检查器中的值来调整苹果的一些字段：

玩你的游戏

准备好后，点击有趣的绿色三角形并试玩你的游戏！

下一步

在接下来的章节中，你将学习如何与多名玩家一起进行游玩测试、创建你自己的脚本并构建你的梦想世界。

这里有一些可尝试的挑战：

• 制作许多苹果让玩家食用

• 被吃掉时播放音效

• 高级： 尝试编写脚本在苹果被吃掉后重新生成更多苹果

--

附注：如果你的岛屿分辨率低/像素化，请在“资源”部分点击岛屿的 png 资产，将重采样倍增器设置为 1，然后点击应用