FF7/Field/Script/Opcodes/D0 LINE - Revision history

Dangarfield at 14:43, 21 October 2020

2020-10-21T14:43:59Z

Dangarfield: Update LINE script trigger behaviour

2020-09-09T19:12:52Z

Update LINE script trigger behaviour

BukTop: 4 revisions imported

2019-05-23T02:19:07Z

4 revisions imported

my_wiki>BukTop: 3 revisions imported

2018-04-04T09:34:44Z

3 revisions imported

my_wiki>Synergy Blades at 13:28, 6 February 2007

2007-02-06T13:28:46Z

my_wiki>Synergy Blades: found trigger on/off opcode so this doesn't apply

2006-08-18T16:26:59Z

found trigger on/off opcode so this doesn't apply

my_wiki>Synergy Blades at 20:13, 17 August 2006

2006-08-17T20:13:44Z

New page

* Opcode: '''0xD0'''
* Short name: '''LINE'''
* Long name: Line Definition

==== Memory layout ====
{| border="1" cellspacing="1" cellpadding="3" style="border: 1px solid black; border-collapse: collapse;"
! width="40" | 0xD0
! width="40" | ''XA''
! width="40" | ''YA''
! width="40" | ''ZA''
! width="40" | ''XB''
! width="40" | ''YB''
! width="40" | ''ZB''
|}

==== Arguments ====

* '''const Short''' ''XA'': X-coordinate of the first point of the line.
* '''const Short''' ''YA'': Y-coordinate of the first point of the line.
* '''const Short''' ''ZA'': Z-coordinate of the first point of the line.
* '''const Short''' ''XB'': X-coordinate of the second point of the line.
* '''const Short''' ''YB'': Y-coordinate of the second point of the line.
* '''const Short''' ''ZB'': Z-coordinate of the second point of the line.

==== Description ====

Defines a line on the walkmesh that, when crossed by a playable character, causes one of the entity's scripts to be executed. These are similar to the triggers in [[FF7/Field/3D Related|Section 8]], with the added bonus that (all) lines can be turned on or off in a script by using the [[FF7/Field/Script/Opcodes/D1 LINON|LINON]] opcode.

@@ Line 38: / Line 38: @@
 * script index 7 -> S6 - Go away
-'''[OK]'''
+Here is a JSON file containing a little more details on the occurrences, frequencies and combinations of the LINE op code usage: https://github.com/dangarfield/ff7-fenrir/blob/master/workings-out/output/line-occurences.json
-- Occurrences
+'''S1 - [OK]'''
-The script index 2 Move is often present, but again mostly contains a single RET op code.
+Appears to be the same as the S2 - Move, in that it is triggered on proximity, but it is also triggered with the CIRCLE button. If you hold the circle, it is only triggered once as apposed the directional movements as mentioned above.
-There are 11 occurrences when both index 2 & 3 Move are present and both have more than one single RET op code.
+'''S2 - Move'''
-of these contain exactly the same ops in both (fields - hyou4, hyou5_4)  - A REQEW and a RET with exactly the same params. Every one of these leads to a MAPJUMP.
+Triggered EVERY time an input key is pressed when the character will be in close proximity to the line. If the line is near a wall and a direction key is pressed but the player does not move but they are in proximity to the line, the Move command will be called every time (eg each frame)
-of these (field - del12) contains 2 ops in the index 2 Move script (UC,MENU, and no RET). The index 3 Move script contains 11 ops including a final RET op
+It is not dependent on cross the line in either direction, appears to be purely proximity to the line.
-- Behaviour
+'''S3 - Move'''
-This is triggered every time the player is close to the line.
+Appears to be the same as the S2 - Move, but the proximity is VERY close to the line.
-If the index 2 Move is present, it executes until it receives a RET or finishes all of the ops, then
+Once this has been triggered, moving the character away from the line had no effect, the operations are still queued and played until a return is met.
-'''Go'''
+'''S4 - Go'''
-'''Occurrences''' - This is often present, and always contains a final RET op code.
+Whilst the character is in proximity of the line (irrespective of the buttons pressed), this action is triggered. Appears to be the same distances as S2 - Move. Eg, if you stand on a line that simply plans a sound and returns, the sound will play every frame.
-'''Go 1x'''
+Whilst the character is in proximity of the line (irrespective of the buttons pressed), this action is triggered ONCE. If the character travels away from the proximity of the line then back towards it, this is triggered once more.
-'''Occurrences''' - This is occasionally present, and always contains a final RET op code.
+Once this has been triggered, moving the character away from the line had no effect, the operations are still queued and played until a return is met.
-'''Go away'''
+After the character has been in proximity of line and exits the immediate proximity (but is still within an outer proximity) this script is triggered.
-'''Behaviour''' - Very similar to Go, but the distance that the player has to be away from the point is large (maybe 4x). Examples are the jumps on las0_6
+'''Concurrency'''
-It's worth noting that any combination of Go, Go 1x and Go away can be present an executable on any script.
+It appears as though the priority for running the scripts is as follows:
-Here is a JSON file containing a little more details on the occurrences, frequencies and combinations of the LINE op code usage: https://github.com/dangarfield/ff7-fenrir/blob/master/workings-out/output/line-occurences.json
+* S5 - Go 1x

← Older revision		Revision as of 19:12, 9 September 2020
Line 26:		Line 26:

	Defines a line on the walkmesh that, when crossed by a playable character, causes one of the entity's scripts to be executed. These are similar to the triggers in [[FF7/Field/3D Related\|Section 8]]. All the lines in the current field can be turned on or off by using the [[FF7/Field/Script/Opcodes/D1 LINON\|LINON]] opcode.		Defines a line on the walkmesh that, when crossed by a playable character, causes one of the entity's scripts to be executed. These are similar to the triggers in [[FF7/Field/3D Related\|Section 8]]. All the lines in the current field can be turned on or off by using the [[FF7/Field/Script/Opcodes/D1 LINON\|LINON]] opcode.
		+
		+	==== Additional Detail ====
		+
		+	There are generally 6 scripts (other than the init and main) if the entity is a LINE (taken from Makou Reactor):
		+
		+	* script index 2 -> S1 - [OK]
		+	* script index 3 -> S2 - Move
		+	* script index 4 -> S3 - Move
		+	* script index 5 -> S4 - Go
		+	* script index 6 -> S5 - Go 1x
		+	* script index 7 -> S6 - Go away
		+
		+	'''[OK]'''
		+
		+	Occurrences - This is often present, but mostly contains a single RET op code.
		+
		+	Behaviour - I'm sure this is triggered when the player is close to the line and presses the [OK] button, eg blin59
		+
		+	'''Move'''
		+
		+	- Occurrences
		+
		+	The script index 2 Move is often present, but again mostly contains a single RET op code.
		+
		+	The script index 3 Move is not often present but when it is, the script index 2 typically isn't, again, always ends with a RET.
		+
		+	There are 11 occurrences when both index 2 & 3 Move are present and both have more than one single RET op code.
		+
		+	10 of these contain exactly the same ops in both (fields - hyou4, hyou5_4) - A REQEW and a RET with exactly the same params. Every one of these leads to a MAPJUMP.
		+
		+	1 of these (field - del12) contains 2 ops in the index 2 Move script (UC,MENU, and no RET). The index 3 Move script contains 11 ops including a final RET op
		+
		+	As a result of the above, I believe that it is relatively safe to assume the following logic:
		+
		+	- Behaviour
		+
		+	This is triggered every time the player is close to the line.
		+
		+	If the index 2 Move is present, it executes until it receives a RET or finishes all of the ops, then
		+
		+	If the index 3 Move is present, it executes until it receives a RET or finishes all of the ops.
		+
		+	'''Go'''
		+
		+	'''Occurrences''' - This is often present, and always contains a final RET op code.
		+
		+	'''Behaviour''' - I'm sure this is triggered every time the player leaves the line
		+
		+
		+	'''Go 1x'''
		+
		+	'''Occurrences''' - This is occasionally present, and always contains a final RET op code.
		+
		+	'''Behaviour''' - I'm sure this is triggered when the player leaves the line, but only once for the duration of the time in the field. Come examples are doors remaining open after they are programmatically triggered. bugin2.
		+
		+
		+	'''Go away'''
		+
		+	'''Occurrences''' - Can be present alongside Go and Go 1x. Always contains a final RET op code.
		+
		+	'''Behaviour''' - Very similar to Go, but the distance that the player has to be away from the point is large (maybe 4x). Examples are the jumps on las0_6
		+
		+
		+	It's worth noting that any combination of Go, Go 1x and Go away can be present an executable on any script.
		+
		+	Here is a JSON file containing a little more details on the occurrences, frequencies and combinations of the LINE op code usage: https://github.com/dangarfield/ff7-fenrir/blob/master/workings-out/output/line-occurences.json

← Older revision		Revision as of 16:26, 18 August 2006
Line 25:		Line 25:
	==== Description ====		==== Description ====

−	Defines a line on the walkmesh that, when crossed by a playable character, causes one of the entity's scripts to be executed. These are similar to the triggers in [[FF7/Field/3D Related\|Section 8]]~~, with~~ the ~~added bonus that (all)~~ lines can be turned on or off ~~in a script~~ by using the [[FF7/Field/Script/Opcodes/D1 LINON\|LINON]] opcode.	+	Defines a line on the walkmesh that, when crossed by a playable character, causes one of the entity's scripts to be executed. These are similar to the triggers in [[FF7/Field/3D Related\|Section 8]]. All the lines in the current field can be turned on or off by using the [[FF7/Field/Script/Opcodes/D1 LINON\|LINON]] opcode.

← Older revision	Revision as of 02:19, 23 May 2019
(No difference)

← Older revision	Revision as of 09:34, 4 April 2018
(No difference)

@@ Line 6: / Line 6: @@
 {| border="1" cellspacing="1" cellpadding="3" style="border: 1px solid black; border-collapse: collapse;"
 ! width="40" | 0xD0
-! width="40" | ''XA''
+! width="80" | ''XA''
-! width="40" | ''YA''
+! width="80" | ''YA''
-! width="40" | ''ZA''
+! width="80" | ''ZA''
-! width="40" | ''XB''
+! width="80" | ''XB''
-! width="40" | ''YB''
+! width="80" | ''YB''
-! width="40" | ''ZB''
+! width="80" | ''ZB''
 |}