Construyendo un juego básico

Para ayudarte a empezar, esta guía te lleva paso a paso para construir un juego de recolección de manzanas.

Colección de manzanas

Este juego de ejemplo pasa por alto detalles que se cubren en profundidad en otras guías. Si necesitas ayuda, revisa la barra lateral izquierda o usa la función de búsqueda en la parte superior para obtener información adicional.

Construyendo el mapa

¡Empezaremos creando un mundo básico con una isla para caminar y una manzana para recoger más tarde!

1. Busca una Manzana y una Isla en la Catálogo de activos y arrástralas a la vista de escena de tu juego.

1. ¡Esa isla es bastante pequeña! En el Inspector establece la Escala a 10x10 para hacerla más grande

1. Ahora la isla tiene un buen tamaño, pero la manzana está detrás de la isla. Establece la Capa de la isla en -10 para colocarla detrás de todo lo demás.

Añadiendo scripts

En el scripts directorio de tu proyecto de juego, crea un nuevo archivo llamado pickup_apple.csl y ábrelo en un editor de texto o usa un IDE basado en IA.

Pega el siguiente script de ejemplo y guarda el archivo:

// Esto crea el componente que hace que la manzana sea interactuable,
// lo añadiremos a la Manzana en el siguiente paso del tutorial. 
Pickup_Apple :: class : Interactable {
    is_picked_up: bool;

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

    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;

        // Inicia el efecto de explosión
        effect := new(Apple_Pop_Effect);
        entity->set_active_effect(effect);
    }
}

// Una animación genial para cuando la comes :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;

        // Aumenta de tamaño y luego se reduce rápidamente hasta desaparecer
        scale_curve: float;
        if t < 0.3 {
            // Pequeño impulso rápido hacia arriba (escala a 1.3x)
            scale_curve = lerp(1.0, 1.3, Ease.out_back(t / 0.3));
        } else {
            // Reducirse hasta desaparecer
            scale_curve = lerp(1.3, 0.0, Ease.in_back((t - 0.3) / 0.7));
        }

        entity->set_local_scale(start_scale * scale_curve);

        // Flota ligeramente hacia arriba
        rise := Ease.out_quad(t) * 0.5;
        entity->set_local_position({start_pos.x, start_pos.y + rise});

        // Desvanece hacia el final
        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();
    }
}

Advertencia: Después de guardar tu componente en el editor de texto, tendrás que actualizar el motor presionando Ctrl + Shift + R. Este es un requisito temporal y pronto se cargará en caliente.

Añadiendo el componente Manzana

Ahora que has creado tu script de la manzana, tendremos que aplicarlo a la manzana en la escena. Para hacerlo, añadiremos el nuevo Pickup_Apple componente del script usando el Inspector.

1. Selecciona tu Manzana en la escena

2. Haz clic en el botón "Agregar componente" en el Inspector.

3. Busca el componente "Pickup_Apple" y haz clic en él para añadirlo a la manzana

¡Ahora verás que el componente se ha añadido a la manzana! Puedes ajustar algunos campos de la Manzana cambiando los valores en el inspector:

Jugando tu juego

Cuando estés listo, pulsa el divertido triángulo verde y prueba tu juego.

Siguientes pasos

En las próximas secciones, aprenderás a probar tu juego con varios jugadores, a crear tus propios scripts y a construir el mundo de tus sueños.

Aquí tienes algunos desafíos para intentar:

• Haz muchas manzanas para que el jugador se las coma

• Reproduce efectos de sonido cuando se las coman

• Avanzado: intenta escribir un script para reaparecer más manzanas después de que se las coman

--

NOTA APARTE: Si tu isla tiene baja resolución o aspecto pixelado, haz clic en el recurso png de la isla en la sección "Assets", establece el Multiplicador de remuestreo en 1 y haz clic en Aplicar