View source for The Great Plateau barrier/en

<languages/>
'''The Great Plateau barrier''' prevents Link from leaving the Great Plateau before he has acquired the paraglider.

== Implementation ==

The barrier is implemented by two layers: one is a collision-based check (the voidout fog), another is hardcoded into Link's actor code.

The thing to know about the Great Plateau kill fog and box is that they both disappear after you get the paraglider. The corresponding GameData flag is called <code>IsGet_PlayerStole2</code>.

=== Fog ===

This one is simple: Link will void out as soon as he touches it. The fog is a regular [[map unit]] actor that spawns whenever IsGet_PlayerStole2 is not set. 

=== Actor code ===

Even if the fog is removed or if the player manages to avoid the fog (by stasis launching for example), Link will still void out when he gets too far away from the Plateau.

It turns out that IsGet_PlayerStole2 is also checked by the [[executable]]. More precisely, its value is queried by 5 functions in the entire program. One of them is the [[AIDef:AI/PlayerNormal]] code which is responsible for handling events for the GameROMPlayer (Link) actor.

In that large AI function, the following piece of code can be seen:

<source lang="c++">
if ( !sForceEnableGlidingAndSurfingAndGiveRupees && !sIsDungeon )
{
  if ( !getFlag_IsGet_PlayerStole2(false) &&
       (x < -1600.0 || x > -350.0 || z < 1400.0 || z > 2400.0) )
  {
    player->respawn_pos.x = -1021.7286376953125;
    player->respawn_pos.y = 253.31527709960938;
    player->respawn_pos.z = 1792.6009521484375;
    AI_AIBase::changeState(this, "奈落開始待ち", 0);
    return;
  }
  ...
}
</source>

A few notes:
* 奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.
* sIsDungeon is set when [[GameScene]] [https://gist.github.com/leoetlino/c3e625367affc6a2dadffb9c92d73f6f generates a stage]. It is false if and only if:
**the map type isn't any of the following type: MarioClubTestDungeon, CDungeon, MainFieldDungeon
**'''and''' (the map type isn't GameTestDungeon) or the map name is ActorViewer or in debug mode{{check}}.
* Essentially, what this piece of code does is force Link to void out if (a) debug flags aren't set, (b) he doesn't have the paraglider, (c) Link is not within the bounds of the following rectangle:

[[File:The_Great_Plateau_barrier.png|center]]

On the MainField (Hyrule) and AocField (Trial of the Sword) maps, Link is effectively surrounded by an ''infinitely'' high box that he is not allowed to leave until he has the paraglider.

It is a simple, hardcoded, coordinate-based check, and it is embedded in the ''core'' Player actor code, so glitching past it is impossible barring major bugs that would likely leave the game broken and unplayable.

Given that events can be delayed and that the actual voidout is done by a demo/cutscene, it is possible to get Link stuck in the PlayerHellStartWait state indefinitely and technically leave the authorized area without being voided out immediately. However, doing any kind of useful action (walking, gliding, riding a horse, etc.) is still impossible, as the paraglider check is done before handling any other regular state. As soon as Link leaves the waiting state, he will be voided out.

[[Category:Internals{{#translation:}}]]
[[Category:Game mechanics{{#translation:}}]]