The Great Plateau barrier - Revision history

Leoetlino: Marked this version for translation

2020-05-12T13:58:40Z

Marked this version for translation

← Older revision		Revision as of 13:58, 12 May 2020
Line 1:		Line 1:
	<languages/>		<languages/>
	<translate>		<translate>
			<!--T:1-->
	'''The Great Plateau barrier''' prevents Link from leaving the Great Plateau before he has acquired the paraglider.		'''The Great Plateau barrier''' prevents Link from leaving the Great Plateau before he has acquired the paraglider.

	== Implementation ==		== Implementation == <!--T:2-->

			<!--T:3-->
	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 barrier is implemented by two layers: one is a collision-based check (the voidout fog), another is hardcoded into Link's actor code.

			<!--T:4-->
	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>.		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 ===		=== Fog === <!--T:5-->

			<!--T:6-->
	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.		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 ===		=== Actor code === <!--T:7-->

			<!--T:8-->
	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.		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.

			<!--T:9-->
	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.		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.

			<!--T:10-->
	In that large AI function, the following piece of code can be seen:		In that large AI function, the following piece of code can be seen:

			<!--T:11-->
	<source lang="c++">		<source lang="c++">
	if ( !sForceEnableGlidingAndSurfingAndGiveRupees && !sIsDungeon )		if ( !sForceEnableGlidingAndSurfingAndGiveRupees && !sIsDungeon )
Line 37:		Line 45:
	</source>		</source>

			<!--T:12-->
	A few notes:		A few notes:
	* 奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.		* 奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.
Line 44:		Line 53:
	* 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:		* 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:

			<!--T:13-->
	[[File:The_Great_Plateau_barrier.png\|center]]		[[File:The_Great_Plateau_barrier.png\|center]]

			<!--T:14-->
	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.		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.

			<!--T:15-->
	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.		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.

			<!--T:16-->
	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.		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.
	</translate>		</translate>

Leoetlino: add translate tags

2020-05-12T13:58:25Z

add translate tags

← Older revision		Revision as of 13:58, 12 May 2020
Line 1:		Line 1:
			<languages/>
			<translate>
	'''The Great Plateau barrier''' prevents Link from leaving the Great Plateau before he has acquired the paraglider.		'''The Great Plateau barrier''' prevents Link from leaving the Great Plateau before he has acquired the paraglider.

	== Implementation ==		== 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 barrier is implemented by two layers: one is a collision-based check (the voidout fog), another is hardcoded into Link's actor code.

Line 7:		Line 10:

	=== Fog ===		=== 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.		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 ===		=== 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.		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.

Line 15:		Line 20:

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

	<source lang="c++">		<source lang="c++">
	if ( !sForceEnableGlidingAndSurfingAndGiveRupees && !sIsDungeon )		if ( !sForceEnableGlidingAndSurfingAndGiveRupees && !sIsDungeon )
Line 30:		Line 36:
	}		}
	</source>		</source>

	A few notes:		A few notes:
	* 奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.		* 奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.
Line 44:		Line 51:

	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.		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.
			</translate>

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

imported>Leoetlino: add note about delaying the respawn demo, and clarify what the conditions mean

2019-08-28T08:17:11Z

add note about delaying the respawn demo, and clarify what the conditions mean

← Older revision		Revision as of 08:17, 28 August 2019
Line 21:		Line 21:
	(x < -1600.0 \|\| x > -350.0 \|\| z < 1400.0 \|\| z > 2400.0) )		(x < -1600.0 \|\| x > -350.0 \|\| z < 1400.0 \|\| z > 2400.0) )
	{		{
	player->~~field_2304_x~~ = -1021.7286376953125;		player->respawn_pos.x = -1021.7286376953125;
	player->~~field_2308_y~~ = 253.31527709960938;		player->respawn_pos.y = 253.31527709960938;
	player->~~field_230C_z~~ = 1792.6009521484375;		player->respawn_pos.z = 1792.6009521484375;
	~~return~~ AI_AIBase::changeState(this, "奈落開始待ち", 0);		AI_AIBase::changeState(this, "奈落開始待ち", 0);
			return;
	}		}
	...		...
Line 37:		Line 38:

	[[File:The_Great_Plateau_barrier.png\|center]]		[[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.		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]]		[[Category:Internals]]
	[[Category:Game mechanics]]		[[Category:Game mechanics]]

imported>Leoetlino: fix typo

2018-10-25T12:53:02Z

fix typo

← Older revision		Revision as of 12:53, 25 October 2018
Line 31:		Line 31:
	A few notes:		A few notes:
	* 奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.		* 奈落開始待ち 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 ~~true~~ if and only if:		* 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		**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}}.		**'''and''' (the map type isn't GameTestDungeon) or the map name is ActorViewer or in debug mode{{check}}.

imported>Leoetlino: /* Actor code */

2018-10-22T21:10:39Z

Actor code

← Older revision		Revision as of 21:10, 22 October 2018
Line 21:		Line 21:
	(x < -1600.0 \|\| x > -350.0 \|\| z < 1400.0 \|\| z > 2400.0) )		(x < -1600.0 \|\| x > -350.0 \|\| z < 1400.0 \|\| z > 2400.0) )
	{		{
	...		player->field_2304_x = -1021.7286376953125;
	return AI_AIBase::changeState(this, "奈落開始待ち", 0);		player->field_2308_y = 253.31527709960938;
			player->field_230C_z = 1792.6009521484375;
			return AI_AIBase::changeState(this, "奈落開始待ち", 0);
	}		}
			...
			}
	</source>		</source>
	A few notes:		A few notes:

imported>Leoetlino at 21:01, 22 October 2018

2018-10-22T21:01:37Z

← Older revision		Revision as of 21:01, 22 October 2018
Line 30:		Line 30:
	**the map type isn't any of the following type: MarioClubTestDungeon, CDungeon, MainFieldDungeon		**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}}.		**'''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~~'s coordinates are~~ not ~~inside this~~ rectangle:		* 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]]		[[File:The_Great_Plateau_barrier.png\|center]]

imported>Leoetlino: /* Actor code */

2018-10-22T20:52:24Z

Actor code

← Older revision		Revision as of 20:52, 22 October 2018
Line 16:		Line 16:
	In that large AI function, the following piece of code can be seen:		In that large AI function, the following piece of code can be seen:
	<source lang="c++">		<source lang="c++">
	if ( !~~sIsDebug1~~ && !~~sIsDebug2~~ )		if ( !sForceEnableGlidingAndSurfingAndGiveRupees && !sIsDungeon )
	{		{
	if ( !getFlag_IsGet_PlayerStole2(false) &&		if ( !getFlag_IsGet_PlayerStole2(false) &&
Line 25:		Line 25:
	}		}
	</source>		</source>
	(奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.)		A few notes:
			* 奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.
	~~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's coordinates are not inside this rectangle:		* sIsDungeon is set when [[GameScene]] [https://gist.github.com/leoetlino/c3e625367affc6a2dadffb9c92d73f6f generates a stage]. It is true 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's coordinates are not inside this rectangle:

	[[File:The_Great_Plateau_barrier.png\|center]]		[[File:The_Great_Plateau_barrier.png\|center]]

imported>Leoetlino: /* Actor code */

2018-10-22T18:05:06Z

Actor code

← Older revision		Revision as of 18:05, 22 October 2018
Line 16:		Line 16:
	In that large AI function, the following piece of code can be seen:		In that large AI function, the following piece of code can be seen:
	<source lang="c++">		<source lang="c++">
	if ( !~~isDebug1~~ && !~~isDebug2~~ )		if ( !sIsDebug1 && !sIsDebug2 )
	{		{
	if ( !~~hasParaglider~~(0) &&		if ( !getFlag_IsGet_PlayerStole2(false) &&
	(x < -1600.0 \|\| x > -350.0 \|\| z < 1400.0 \|\| z > 2400.0) )		(x < -1600.0 \|\| x > -350.0 \|\| z < 1400.0 \|\| z > 2400.0) )
	{		{
	...		...
	~~// 奈落開始待ち means 'wait for abyss start' (= voidout)~~		return AI_AIBase::changeState(this, "奈落開始待ち", 0);
	return changeState(v1, "奈落開始待ち", 0);
	}		}
	}
	</source>		</source>
			(奈落開始待ち means (roughly) 'wait for abyss start'. It is the name of the [[AIDef:Action/PlayerHellStartWait]] action for the Player_Link aiprog.)

	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's coordinates are not inside this rectangle:		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's coordinates are not inside this rectangle:

imported>Leoetlino: /* Actor code */

2018-10-21T13:05:01Z

Actor code

← Older revision		Revision as of 13:05, 21 October 2018
Line 12:		Line 12:
	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.		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.

	~~As it~~ turns out, 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.		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:		In that large AI function, the following piece of code can be seen:

imported>Leoetlino at 13:04, 21 October 2018

2018-10-21T13:04:11Z

← Older revision		Revision as of 13:04, 21 October 2018
Line 1:		Line 1:
	'''The Great Plateau barrier'''~~{{un}}~~ prevents Link from leaving the Great Plateau before he has acquired the paraglider.		'''The Great Plateau barrier''' prevents Link from leaving the Great Plateau before he has acquired the paraglider.

	== Implementation ==		== Implementation ==