WDFUSE Tutorial - Scripting - Revision history

Df21admin: /* Explosions */

2024-07-17T20:55:04Z

Explosions

← Older revision		Revision as of 13:55, 17 July 2024
Line 238:		Line 238:
	stop: 16 hold		stop: 16 hold
	seqend		seqend
	This maps to explosive triggers. Any time something explodes (like a thermal detonator or a fuel canister) the elevator will trigger. Go ahead and run the game. Try shooting the canister ~~when~~ your pistol - notice after it explodes the elevator moves up. This is not just a random curiosity, but can be cleverly used to make explodable walls, etc.		This maps to explosive triggers. Any time something explodes (like a thermal detonator or a fuel canister) the elevator will trigger. Go ahead and run the game. Try shooting the canister with your pistol - notice after it explodes the elevator moves up. This is not just a random curiosity, but can be cleverly used to make explodable walls, etc.
	[[File:Elev7BlowUp.png\|thumb\|thumb\|954x954px\|center]]		[[File:Elev7BlowUp.png\|thumb\|thumb\|954x954px\|center]]
	You can also pick-up the nearby concussion rifle and try shooting the elevator to test this mask.		You can also pick-up the nearby concussion rifle and try shooting the elevator to test this mask.

Df21admin at 21:13, 18 March 2024

2024-03-18T21:13:24Z

Show changes

Testuser: TEST CHANGE

2024-03-10T20:26:42Z

TEST CHANGE

← Older revision		Revision as of 13:26, 10 March 2024
Line 1:		Line 1:
	== INF Scripting ==		== INF Scripting ==
	To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.		To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.

	This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .		This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .
	----'''Important!'''		----'''Important!'''

Testuser at 19:52, 10 March 2024

2024-03-10T19:52:25Z

← Older revision		Revision as of 12:52, 10 March 2024
Line 2:		Line 2:
	To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.		To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.

	This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .		This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .
	----'''Important!'''		----'''Important!'''

Testuser at 19:35, 10 March 2024

2024-03-10T19:35:29Z

← Older revision		Revision as of 12:35, 10 March 2024
Line 1:		Line 1:
	== INF Scripting ==		== INF Scripting ==
	To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.		To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.

	This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .		This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .

Df21admin: /* INF Scripting */ test

2024-03-10T19:17:08Z

INF Scripting: test

← Older revision		Revision as of 12:17, 10 March 2024
Line 1:		Line 1:
	== INF Scripting ==		== INF Scripting ==
	To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.		To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.

	This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .		This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .

Df21admin at 05:29, 18 July 2022

2022-07-18T05:29:52Z

← Older revision		Revision as of 22:29, 17 July 2022
Line 2:		Line 2:
	To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.		To make your level geometry interactive you would need to learn the '''INF''' programming language. Scripts written in INF tell the '''JEDI''' engine to control almost every component in the game. From moving elevators, morphing platforms, opening doors, changing lights, moving water and completing objectives, the possibilities for unique adventures in Dark Forces are endless. One can create some amazing and unique experiences not present in the base game.

	This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section.		This tutorial will gradually introduce you to the basic INF concepts. While it helps to understand programming, '''it is not required''' as the INF script is more similar to a state machine than modern object-oriented programming. For this section it is critical that you have the community-made INF documentation open as you follow along. Therefore make sure to open '''[https://df-21.net/documentation/DFSPECS/df_specs.htm this page]''' and keep it handy. It contains Dark Forces component specifications such as GOBs and LFDs but we will be focusing on the '''INF''' section .
	----'''Important!'''		----'''Important!'''

DF21net at 18:36, 9 July 2022

2022-07-09T18:36:56Z

← Older revision		Revision as of 11:36, 9 July 2022
Line 389:		Line 389:

	With that lets proceed to [[WDFUSE Tutorial - Scripting II\|Scripting Part II]] where you can learn more about Doors and other triggers.		With that lets proceed to [[WDFUSE Tutorial - Scripting II\|Scripting Part II]] where you can learn more about Doors and other triggers.


			'''WDFUSE Tutorials'''
			#[[WDFUSE Tutorial - Introduction\|Introduction]]
			#[[WDFUSE Tutorial - Configuration]]
			#[[WDFUSE Tutorial - Basic Geometry]]
			#[[WDFUSE Tutorial - Basic Geometry II]]
			#[[WDFUSE Tutorial - 3D Renderer]]
			#[[WDFUSE Tutorial - Advanced Geometry]]
			#[[WDFUSE Tutorial - Advanced Geometry II]]
			#[[WDFUSE Tutorial - Advanced Geometry III]]
			#[[WDFUSE Tutorial - Objects]]
			#[[WDFUSE Tutorial - Scripting]]
			#[[WDFUSE Tutorial - Scripting II]]
			#[[WDFUSE Tutorial - Scripting III]]

DTPhase1 at 21:37, 8 July 2022

2022-07-08T21:37:14Z

← Older revision		Revision as of 14:37, 8 July 2022
Line 38:		Line 38:

	=== Class Elevators ===		=== Class Elevators ===
	All classes in the game are made out of '''Elevators'''. In fact, almost every kind of game logic in the game is done with an elevator. That's how Dark Forces keeps track of the level state and makes things interactive. Elevators make sectors and walls dynamic. They can obviously be used to create lifts, platforms, doors etc., but you often also need dummy (i.e. non-accessible) elevators for level control purposes.		All classes in the game are made out of '''Elevators'''. In fact, almost every kind of game logic in the game is done with an elevator. That's how Dark Forces keeps track of the level state and makes things interactive. Elevators make sectors and walls dynamic. They can obviously be used to create lifts, platforms, doors etc., but you often also need dummy (i.e. non-accessible, completely beyond the area the player is intended to roam) elevators for level control purposes.

	Some of the common ones you will be using are...		Some of the common ones you will be using are...
Line 94:		Line 94:
	Add a stop at height '''10''' and change all the delays to '''1,''' nobody wants to wait that long between stops! Click the '''Syntax Checker''' button at the top to make sure you didn't make a mistake. If you did, the bar at the bottom will to red and the error will be highlighted. Now run the game. What happens?		Add a stop at height '''10''' and change all the delays to '''1,''' nobody wants to wait that long between stops! Click the '''Syntax Checker''' button at the top to make sure you didn't make a mistake. If you did, the bar at the bottom will to red and the error will be highlighted. Now run the game. What happens?

	The elevator moves at the same speed but the stops are much shorter right? Also notice that when the elevator ~~comesdown~~, it doesn't stop in the middle. This is because it runs all the stops from top to bottom. If you wanted it to stop in the middle again you would have to add another '''stop: 8 1''' below the last stop.		The elevator moves at the same speed but the stops are much shorter right? Also notice that when the elevator comes down, it doesn't stop in the middle. This is because it runs all the stops from top to bottom. If you wanted it to stop in the middle again you would have to add another '''stop: 8 1''' below the last stop.

	=== Texture Anchoring ===		=== Texture Anchoring ===
Line 115:		Line 115:


	While the stops are the same, the elevator class has changed. FC stands for "'''FloorCeiling'''" and this means that both the floor and ceiling will move at the same time. There is also a new keyword called '''speed.''' The name is self-explanatory, it just tells the elevator how fast it should be moving. Go ahead and change the speed value to '''0''' ('''or instant!''') '''.''' If you run the game you will see that the ceiling moves along with the floor immediately.		While the stops are the same, the elevator class has changed. FC stands for "'''FloorCeiling'''" and this means that both the floor and ceiling will move at the same time. There is also a new keyword called '''speed.''' The name is self-explanatory, it just tells the elevator how fast it should be moving, in Dark Forces units per second. Go ahead and change the speed value to '''0''' ('''or instant!''') '''.''' If you run the game you will see that the ceiling moves along with the floor immediately.
	[[File:ELEV3.png\|none\|thumb\|834x834px]]		[[File:ELEV3.png\|none\|thumb\|834x834px]]

Line 221:		Line 221:
	stop: 16 hold		stop: 16 hold
	seqend		seqend
	This maps to the user pressing the Use or Nudge key (typically '''E''' ) from inside the sector. This means that it will move when you activate it yourself. Go ahead and try it out .		This maps to the user pressing the Use or Nudge key (typically '''E''' ) from inside the sector. This means that it will move when you activate it yourself. Go ahead and try it out.
	seq		seq
	class: elevator move_floor		class: elevator move_floor
Line 238:		Line 238:
	stop: 16 hold		stop: 16 hold
	seqend		seqend
	This maps to explosive triggers. Any time something explodes (like a thermal detonator or a fuel canister) the elevator will trigger. Go ahead and run the game. Try shooting the canister when your pistol - notice after it explodes the elevator moves up.		This maps to explosive triggers. Any time something explodes (like a thermal detonator or a fuel canister) the elevator will trigger. Go ahead and run the game. Try shooting the canister when your pistol - notice after it explodes the elevator moves up. This is not just a random curiosity, but can be cleverly used to make explodable walls, etc.
	[[File:Elev7BlowUp.png\|none\|thumb\|954x954px]]		[[File:Elev7BlowUp.png\|none\|thumb\|954x954px]]
	You can also pick-up the nearby concussion rifle and try shooting the elevator to test this mask.		You can also pick-up the nearby concussion rifle and try shooting the elevator to test this mask.
Line 260:		Line 260:
	Look at the '''Wall Editor''' INF (It's the same yellow button at the top). Note: if the icon is greyed out it means it does not have any INF code applied to it.		Look at the '''Wall Editor''' INF (It's the same yellow button at the top). Note: if the icon is greyed out it means it does not have any INF code applied to it.
	[[File:Switch1.png\|none\|thumb\|734x734px]]		[[File:Switch1.png\|none\|thumb\|734x734px]]
	Notice that just like with elevators there is a new class called '''Trigger'''. Triggers send a message to a client sector when triggered. They can be used to create switches, tripwires etc. Triggers can also be used to display text.		Notice that just like with elevators there is a new class called '''Trigger'''. Triggers send a message to a client sector when triggered. They can be used to create switches, tripwires etc. Triggers can also be used to display text ― in fact, the only way to display custom text is to use triggers.

	Some common triggers classes are..		Some common triggers classes are..
Line 296:		Line 296:
	message: 1 ELEVATORS3(8) done		message: 1 ELEVATORS3(8) done
	seqend		seqend
	Messages are sent from triggers when they are triggered and elevators when they arrive at stops. They are sent to other triggers and elevators, and in some cases just regular sectors and lines (except message: lights, which is sent to the system). They do various things to their recipients. Messages are placed in the sequence of elevators and triggers.		Messages are sent from triggers when they are triggered and elevators when they arrive at their corresponding stops. They are sent to other triggers and elevators, and in some cases just regular sectors and lines (except message: lights, which is sent to the system). They do various things to their recipients. Messages are placed in the sequence of elevators and triggers.

	The syntax differs depending on where the message comes from.		The syntax differs depending on where the message comes from.

DF21net: /* Entity Masks */

2022-07-03T03:07:06Z

Entity Masks

← Older revision		Revision as of 20:07, 2 July 2022
Line 388:		Line 388:
	'''Important:''' This tutorial cannot possibly cover ever single combination of classes. If you are wondering how something is done in the game - just load up the mission and look at the original code.		'''Important:''' This tutorial cannot possibly cover ever single combination of classes. If you are wondering how something is done in the game - just load up the mission and look at the original code.

	With that lets proceed to Scripting Part II where you can learn more about Doors and other triggers.		With that lets proceed to [[WDFUSE Tutorial - Scripting II\|Scripting Part II]] where you can learn more about Doors and other triggers.