Struct Shortcut 

pub struct Shortcut {
    pub id: ShortcutId,
    pub gate: AnchorId,
    pub unlock: AnchorId,
    pub on_unlock: Vec<QuestEffect>,
}

A stage-5 shortcut door (spec-0016 §2) — the souls loop-back.

The owner’s definition of the pattern: between two rest points there are two routes. The short one starts sealed and holds nothing; the long one is full of enemies and mechanisms. You earn the far side the hard way, pull one mechanism, and the short route opens forever. That moment is the design.

The compiler owns three obligations, none of them optional:

1. the unlock affordance is reachable while the gate is still sealed — the long route genuinely exists (DW0373);
2. opening the gate genuinely shortens the trip across it — a shortcut that pays nothing is a leak, not a shortcut (DW0360);
3. permanence is structural: no close-gate may target a shortcut gate (DW0372). There is no re-sealing verb to reach for.

close-gate on a NON-shortcut gate (the point-of-no-return staging beat) is untouched by this — the two verbs are deliberately disjoint.

Fields

id: ShortcutId

Unique shortcut id (shortcut/<kebab>).

gate: AnchorId

The gate anchor this shortcut opens. Sealed from world-load (the prefab carries the physical fill), and its metadata must declare the fill block the compiler clears — the same requirement close-gate has.

unlock: AnchorId

The FAR-side anchor whose interaction fires the permanent open. The compiler summons the affordance there and polls it, reusing the v0.4 interaction-entity use primitive.

on_unlock: Vec<QuestEffect>

Effects fired once, when the shortcut opens — the bar lifting, the elevator descending, the sound of a door you will never have to earn again. Emitted server-source-safe (the poll lives on the tick).

Trait Implementations

impl Clone for Shortcut

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Shortcut

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Shortcut

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Shortcut

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for Shortcut

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Shortcut

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Shortcut