随机、数学与更多

此页面是一个“你会经常使用”的工具杂烩：随机数、格式化、时间以及一些在大多数游戏中出现的核心子系统。

如果你在寻找数组/切片，请参见 数组与集合.

随机数 (RNG)

Random 使用显式的 u64 种子。通过传递种子来 ref 以便它会更新。

rng: u64 = rng_seed_time();
// 或者每个实体确定性地：
// rng: u64 = rng_seed(entity.id);

// 范围值是包含端点的
roll := rng_range_int(ref rng, 1, 10);
chance := rng_range_float(ref rng, 0, 1);

如果你希望游戏行为确定性，请保持 RNG 由服务器权威控制。不要仅在客户端决定重要结果。

数学函数

常用的数学辅助函数：

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);

字符串格式化

使用 % 使用参数数组的占位符：

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

如果你需要在百分号旁（或紧挨另一个参数）放置参数，使用 %0 作为……的别名 %:

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

对于小数舍入，使用 format_float:

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

日志记录

日志遵循相同的格式化规则：

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

时间

current_time := get_time();       // 游戏时间
real_time := get_real_time();     // 真实世界时间
frame := get_frame_number();      // 当前帧编号

音效 (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);

重要的长音效请仅在服务器端播放（Game.is_server()），否则错误预测可能导致重复播放（音乐、死亡音效等）。

经济快速入门（货币）

经济货币是 每个玩家 和 自动持久化.

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);
}

见 Economy 用于完整指南。