Vytvoření postavy

Vytvoří a spravuje kapslový CharacterVirtual controller ve výchozím physics worldu.

jolt_character() vytvoří spravovaný JoltCharacter. Jeho veřejná pozice leží na základně kapsle u chodidel, celková výška zahrnuje obě zaoblené části a směr nahoru je +Z, dokud jej nezmění referenční rámec.

Syntaxe#

jolt_character(x, y, z, options=undefined)

Minimální nastavení#

jolt_start();

var player = jolt_character(0, 0, 1, {
    radius: 0.4,
    height: 1.8,
    layer: jolt_default_layer()
});

if (is_undefined(player)) {
    show_error(jolt_get_error().message, true);
}

Options#

Životní cyklus a identita#

player.is_valid()
player.get_native_handle()
jolt_managed_character_count()
player.destroy()

destroy() odebere nativní controller, zneplatní spravovaný wrapper a vyčistí binding i pole kontaktů.

Napojení GameMaker instance#

player.bind_instance(id);

// Po jolt_update():
player.sync();

sync() zapíše do napojené instance x, y, z, jolt_ground_state a jolt_is_crouched. unbind_instance() spojení odstraní bez zničení postavy.

Nastavení po vytvoření#

player = jolt_character();
if (!is_undefined(player)) {
    player.set_position(0, 0, 2);
    player.set_radius(0.4);
    player.set_height(2.0);
}

Výška je celá kapsle, pozice označuje chodidla. Změna rozměrů je okamžitá a při neplatných hodnotách nebo zablokování vrací false. crouch_height zachovává poměr.

Ověřené kontrakty operací#

Následující kontrakty rozlišují jednotky, návratové hodnoty, chyby a životnost podle aktuální implementace. Nevynechávej kontrolu výsledku: false, 0 a undefined mohou mít u různých metod odlišný význam.