Diagnostika a důvody odmítnutí

Nejdříve zjistěte, zda selhala registrace, admission, nebo až pohyb uvnitř vytvořeného relationship.

Chyba veřejné funkce a reject při hledání zásahu jsou oddělené věci. Pokud jolt_penetrator_tip vrátí undefined nebo setter false, čtěte jolt_get_error_message(). Pokud Tip existuje, sledujte jeho info, reject a všechny relationships po fyzikálním kroku.

Textový a geometrický debug#

// Enable once.
jolt_debug_enable(true);

// Draw GUI:
jolt_penetration_debug_text(16, 16);

// Existing 3D Draw pass:
jolt_debug_draw(JOLT_DEBUG_SHAPES | JOLT_DEBUG_PENETRATION);

jolt_penetration_debug_text(x=16,y=16) vypíše Tip/body IDs, enabled, reject, state, počet relationships, target, has_entered, capture_source a depth. Geometrický flag kreslí hrot, vstupní bod a osu/limit kanálu. Debug nepřidává síly ani nerozhoduje o capture.

Úplná tabulka reject reason#

Následující názvy odpovídají číselným hodnotám nativního reject enumu. GML wrapper vrací číslo; nedefinuje veřejný enum JoltPenetrationReject. Nezaměňujte je s JoltPenetrationState.

Praktický postup při potížích#

• Tip nevznikne: ověřte lokální bod na povrchu, nenulovou osu, podporovaný Dynamic tvar a rozsahy parametrů.
• Tip existuje, ale není entry: ověřte capture_model, target enabled, mask, layer, aktuální úhel a relativní pohyb.
• Relationship existuje, ale je Captured: čekejte na skutečnou nezápornou signed_depth; nezaměňujte jej za selhání registrace.
• Nástroj se zachytí, ale nezasouvá: prohlédněte forward_force, hmotnost, energii nárazu a max_depth.
• Další zásah nefunguje: sledujte RearmPending a clearance celého tělesa. Zkontrolujte, že nemáte starý relationship uložený jako aktuální.

Metriky#

var metrics = jolt_penetration_metrics();
if (is_struct(metrics)) {
    show_debug_message("Relationships: " + string(metrics.relationships));
    show_debug_message("Candidate drops: " + string(metrics.candidate_drops));
    show_debug_message("Event drops: " + string(metrics.event_drops));
}

Počítadla patří světu a během jeho života rostou; pro cenu jednoho intervalu porovnávejte rozdíl dvou vzorků. Gettery jen čtou diagnostiku. Metriky samy neřeknou přesnou první příčinu každého neúspěšného nárazu; pro reprodukci si ukládejte také konfiguraci a trajektorii.

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.