Aleatorio, Matemáticas y Más

Esta página es una mezcla de utilidades que «usarás constantemente»: RNG, formato, tiempo y algunos subsistemas centrales que aparecen en la mayoría de los juegos.

Si buscas arrays/slices, consulta Arrays y Colecciones.

Números aleatorios (RNG)

Random usa una u64 semilla. Pasa la semilla por ref para que se actualice.

rng: u64 = rng_seed_time();
// o determinista por entidad:
// rng: u64 = rng_seed(entity.id);

// Los valores de rango son inclusivos
roll := rng_range_int(ref rng, 1, 10);
chance := rng_range_float(ref rng, 0, 1);

Si quieres un comportamiento determinista para la jugabilidad, mantén el RNG con autoridad del servidor. No generes resultados importantes solo en el cliente.

Funciones matemáticas

Ayudantes matemáticos comunes:

angle_sin := sin(x);
angle_cos := cos(x);

result := pow(2.0, 3.0);   // 8.0
root := sqrt(16.0);        // 4.0

value := lerp(0.0, 100.0, 0.5);  // 50.0
clamped := clamp(value, 0.0, 10.0);

absolute := abs(-5);
minimum := min(5, 10);
maximum := max(5, 10);

len := length(v);
len_sq := length_squared(v);
normalized := normalize(v);

Formateo de cadenas

Usa % marcadores con un arreglo de argumentos:

format_string("Value: %", {42});
format_string("health: 100%%");

Si necesitas un argumento adyacente a un signo de porcentaje (o junto a otro argumento), usa %0 como alias de %:

hp := 67;
format_string("health: %0%%", {hp}); // "health: 67%"

Para el redondeo decimal, usa format_float:

value := 3.14159;
format_string("pi: %", {format_float(value, decimals=2)}); // "pi: 3.14"

Registro (Logging)

El registro sigue las mismas reglas de formato:

log_info("Name: %, age: %", {player->get_username(), 12});

Tiempo

current_time := get_time();       // tiempo del juego
real_time := get_real_time();     // tiempo del mundo real
frame := get_frame_number();      // número de fotograma actual

Efectos de sonido (SFX)

sound := get_asset(SFX_Asset, "sfx/click.wav");

desc := SFX.default_sfx_desc();
desc.entity_to_follow = entity.id;
desc.delay = 0.25;

sound_id := SFX.play(sound, desc);
SFX.stop(sound_id);

Reproduce sonidos largos importantes solo en el servidor (Game.is_server()), de lo contrario la predicción incorrecta puede causar reproducciones duplicadas (música, SFX de muerte, etc.).

Inicio rápido de economía (monedas)

Las monedas de la economía son por jugador y persistidos automáticamente.

coin_icon := get_asset(Texture_Asset, "ui/coin.png");
Economy.register_currency("Coins", coin_icon);

Economy.deposit_currency(player, "Coins", 10);
coins := Economy.get_balance(player, "Coins");

COST :: 50;
if Economy.can_withdraw_currency(player, "Coins", COST) {
    Economy.withdraw_currency(player, "Coins", COST);
}

Ver Economy para la guía completa.