Call of Duty 5: Using FXs Client Scripts - Revision history

Zeroy at 10:38, 11 February 2009

2009-02-11T10:38:19Z

New page

[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spawn FXs on the Clientside to ease server load. 

==Theory==

The method might look very similar to the one used in Call of Duty 4 Modern Warfare but it isnt at all. The serverside scripting used is indeed the same, the different is the use now of CSC scripts or ClientSide Script (as opposed to GSC).

The principle is simple, the server gets the FX scripting but doesnt draw them for clients, instead the Clientside Script will draw the FXs and this for each Client connected. The result is that as FXs are locally drawn by and for each Clients the Server load is lighter and lag is reduced.

[[Image:Warning.png]] Everywhere in this tutorial mp_mapname MUST be replaced by your level name, in this example its mp_example

==Server Side Script==

The serverside scripting is the same method as COD4:

''In this example I will use the following FX: '''mp_smoke_column_tall''' -- All files for the below example can be found at the bottom of the Tutorial.''

===CreateFX script===

*If not already there, create a folder createfx under \raw\maps\mp
*In that folder create a new file called mp_mapname_fx.gsc, in it put the following

<pre>
//_createfx generated. Do not touch!!
main()
{
ent = maps\mp\_utility::createOneshotEffect( "mp_smoke_column_tall" );
ent.v[ "origin" ] = ( X, Y, Z );
ent.v[ "angles" ] = ( 270, 0, 0 );
ent.v[ "fxid" ] = "mp_smoke_column_tall";
ent.v[ "delay" ] = -15;
}
</pre>

[[Image:Information.png]] Explanation for each line above:

//_createfx generated. Do not touch!!

*This line simply needs to be there!

ent = maps\mp\_utility::createOneshotEffect( "mp_smoke_column_tall" );

*This line is the call for the FX id, in this case ''mp_smoke_column_tall''

ent.v[ "origin" ] = ( '''X''', '''Y''', '''Z''' );

This line is very Important. X, Y, Z are the coordinate where you wish to place your FX. The best way to find the coordiantes required is to go in Radiant, then place a Script_origin where you want the FX and press 'N' when selecting it to get the X,Y,Z coordinates.

[[Image:fx_1.png]]

ent.v[ "angles" ] = ( 270, 0, 0 );

*This line is as it says the Angle parameters, in the example the FX will be pointing towards sky (smoke ascending)

ent.v[ "fxid" ] = "mp_smoke_column_tall";

*This line is the FX id, it needs to match with the first call to the same FX id.

ent.v[ "delay" ] = -15;

*This last line is the delay to start the FX, keep it untouched at -15.

[[Image:Information.png]] As in COD4 you could add one more line to this to load a Soundalias:

ent.v[ "soundalias" ] = soundalias;

We however wont use it for this example.

The final script used for the example is as follow:

<pre>
//_createfx generated. Do not touch!!
main()
{
ent = maps\_utility::createOneshotEffect( "mp_smoke_column_tall" );
ent.v[ "origin" ] = ( -16, 544, 56 );
ent.v[ "angles" ] = ( 270, 0, 0 );
ent.v[ "fxid" ] = "mp_smoke_column_tall";
ent.v[ "delay" ] = -15;
}
</pre>

===Map FX file===
Under raw/maps/mp/ create another file called mp_mapname_fx.gsc

*Have the following in it:

<pre>
#include maps\mp\_utility;

main()
{
//maps\mp\createart\mp_mapname_art::main();
precacheFX();
spawnFX();
}

precacheFX()
{
level._effect["mp_smoke_column_tall"] = loadfx("maps/mp_maps/fx_mp_smoke_column_tall");
}

spawnFX()
{
if (( getdvar( "createfx" ) != "" ))
{
maps\mp\createfx\mp_mapname_fx::main();
}
}
</pre>

===Map GSC calls===

You now need to call the created Files in your Map GSC

*In your raw/maps/mp/mp_mapname.gsc put the following after '''maps\mp\_load::main();'''

<pre>
maps\mp\mp_mapname_fx::main();
</pre>

===Zone File===

*Last step, in your zone_source/mp_mapname.csv add this line:

<pre>
fx,maps/mp_maps/fx_mp_smoke_column_tall
</pre>

==Client Side Script==

This is the new bit compare to COD4, you knwo have to create CSC files

[[Image:Warning.png]] Note the extension used here isnt .gsc but .csc

===CreateFX file===

*If not already there, create a folder createfx under raw\clientscripts\mp\createfx
*In that folder create a new file the file mp_mapname_fx.csc:
*Inside:

<pre>
//_createfx generated. Do not touch!!
main()
{
ent = clientscripts\_fx::createOneshotEffect( "mp_smoke_column_tall" );
ent.v[ "origin" ] = ( -16, 544, 56 );
ent.v[ "angles" ] = ( 270, 0, 0 );
ent.v[ "fxid" ] = "mp_smoke_column_tall";
ent.v[ "delay" ] = -15;
}
</pre>

===Map FX file===

* Again, create a new file mp_mapname_fx.csc under

raw\clientscripts\mp\

*Inside:

<pre>
#include clientscripts\mp\_utility;

// load fx used by util scripts
precache_util_fx()
{
}

precache_scripted_fx()
{
}

// --- AMBIENT SECTION ---//
precache_createfx_fx()
{

level._effect["mp_smoke_column_tall"] = loadfx("maps/mp_maps/fx_mp_smoke_column_tall");

}

main()
{
clientscripts\mp\createfx\mp_mapname_fx::main();
clientscripts\mp\_fx::reportNumEffects();

precache_util_fx();
precache_createfx_fx();

disableFX = GetDvarInt( "disable_fx" );
if( !IsDefined( disableFX ) || disableFX <= 0 )
{
precache_scripted_fx();
}
}
</pre>

===Map CSC calls===

*You now need to create a new file similar to your Map GSC
*Assuming your Map GSC in \raw\maps\mp\ is like this:

<pre>
main()
{
maps\mp\_load::main();

// If the team nationalites change in this file,
// you must update the team nationality in the level's csc file as well!
game["allies"] = "russian";
game["axis"] = "german";
game["attackers"] = "axis";
game["defenders"] = "allies";
game["allies_soldiertype"] = "russian";
game["axis_soldiertype"] = "german";

}</pre>

Then create a new file '''mp_mapname.csc''' under \raw\clientscripts\mp\ with the following in:

<pre>
#include clientscripts\mp\_utility;

main()
{
// If the team nationalites change in this level's gsc file,
// you must update the team nationality here!
level.allies_team = "german";
level.axis_team = "russian";

// _load!
clientscripts\mp\_load::main();
clientscripts\mp\mp_mapname_fx::main();

thread clientscripts\mp\_fx::fx_init(0);
thread clientscripts\mp\_audio::audio_init(0);

// This needs to be called after all systems have been registered.
thread waitforclient(0);

println("*** Client : mp_example running...");
}
</pre>

===Zone File===

*Now open your Zone file again and add this:

<pre>
rawfile,clientscripts/mp/mp_mapname.csc
rawfile,clientscripts/mp/mp_mapname_fx.csc
rawfile,clientscripts/mp/createfx/mp_mapname_fx.csc
</pre>

Compile and enjoy Lag-free FX in map!

==Download the files==

[[Image:Data.png]] All files in this example are available [http://wiki.modsrepository.com/codww_files/fx_allfiles.zip HERE]

[[Category:Call of Duty 5]]
[[Category:FXs]]
[[Category:Mapping]]
[[Category:Advanced Editing]]

Zeroy at 11:52, 18 December 2008

2008-12-18T11:52:26Z

← Older revision		Revision as of 11:52, 18 December 2008
Line 1:		Line 1:
	[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to ~~spwan~~ FXs on the Clientside to ease server load.<br><br>		[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spawn FXs on the Clientside to ease server load.<br><br>

	[[Image:Warning.png]] <font color="red" size "2">If this Tutorial does not work for you i suggest looking at either of those 2 Tutorials also:</font><br><br>		[[Image:Warning.png]] <font color="red" size "2">If this Tutorial does not work for you i suggest looking at either of those 2 Tutorials also:</font><br><br>

Zeroy at 16:40, 7 December 2008

2008-12-07T16:40:49Z

← Older revision		Revision as of 16:40, 7 December 2008
Line 1:		Line 1:
	[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.<br>		[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.<br><br>

	[[Image:Warning.png]] <font color="red" size "3">If this Tutorial does not work for you i suggest looking at either of those 2 Tutorials also:</font><br>		[[Image:Warning.png]] <font color="red" size "2">If this Tutorial does not work for you i suggest looking at either of those 2 Tutorials also:</font><br><br>

	* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]		* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]

Zeroy at 16:40, 7 December 2008

2008-12-07T16:40:33Z

← Older revision		Revision as of 16:40, 7 December 2008
Line 1:		Line 1:
	[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.<br>		[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.<br>

	[[Image:Warning.png]] <font color="red" size "3">~~This~~ Tutorial ~~should~~ work ~~but not with the Modtools release with have, instead~~ i suggest looking at either of those 2 Tutorials:</font><br>		[[Image:Warning.png]] <font color="red" size "3">If this Tutorial does not work for you i suggest looking at either of those 2 Tutorials also:</font><br>

	* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]		* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]

Zeroy: /* Map CSC calls */

2008-12-05T16:39:10Z

Map CSC calls

← Older revision		Revision as of 16:39, 5 December 2008
Line 226:		Line 226:
	}</pre>		}</pre>

	Then create a new file mp_mapname.csc under \raw\clientscripts\mp\ with the following in:		Then create a new file '''mp_mapname.csc''' under \raw\clientscripts\mp\ with the following in:

	<pre>		<pre>

Zeroy: /* Map GSC calls */

2008-12-05T16:38:50Z

Map GSC calls

← Older revision		Revision as of 16:38, 5 December 2008
Line 205:		Line 205:
	</pre>		</pre>

	===Map ~~GSC~~ calls===		===Map CSC calls===

	*You now need to create a new file similar to your Map GSC		*You now need to create a new file similar to your Map GSC
Line 226:		Line 226:
	}</pre>		}</pre>

	Then create a new file under \raw\clientscripts\mp\ with the following in:		Then create a new file mp_mapname.csc under \raw\clientscripts\mp\ with the following in:

	<pre>		<pre>

Zeroy: /* Client Side Script */

2008-12-05T14:24:20Z

Client Side Script

← Older revision		Revision as of 14:24, 5 December 2008
Line 138:		Line 138:
	This is the new bit compare to COD4, you knwo have to create CSC files		This is the new bit compare to COD4, you knwo have to create CSC files

	[[Image:Warning.png]] <font color="red">Note the extension used here isnt .gsc but .csc</font>		[[Image:Warning.png]] <font color="red">Note the extension used here isnt .gsc but .csc</font>

	===CreateFX file===		===CreateFX file===

Zeroy at 14:23, 5 December 2008

2008-12-05T14:23:55Z

← Older revision		Revision as of 14:23, 5 December 2008
Line 1:		Line 1:
	[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.		[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.<br>

	[[Image:Warning.png]] <font color="red" size "3">This Tutorial should work but not with the Modtools release with have, instead i suggest looking at either of those 2 Tutorials:</font>		[[Image:Warning.png]] <font color="red" size "3">This Tutorial should work but not with the Modtools release with have, instead i suggest looking at either of those 2 Tutorials:</font><br>

	* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]		* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]
	* [[Call of Duty 5: FXs Script_Struct\|Adding FXs to Level Method #3]]		* [[Call of Duty 5: FXs Script_Struct\|Adding FXs to Level Method #3]]<br><br>

	==Theory==		==Theory==

Zeroy at 14:23, 5 December 2008

2008-12-05T14:23:41Z

← Older revision		Revision as of 14:23, 5 December 2008
Line 1:		Line 1:
	[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.		[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.

	[[Image:Warning.png]] <font color="red" size "3">This Tutorial ~~SHOULD~~ work but not with the Modtools release with ~~currently~~ have, instead i suggest looking at either of those 2 Tutorials:</font>		[[Image:Warning.png]] <font color="red" size "3">This Tutorial should work but not with the Modtools release with have, instead i suggest looking at either of those 2 Tutorials:</font>

	* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]		* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]

Zeroy at 14:23, 5 December 2008

2008-12-05T14:23:21Z

← Older revision		Revision as of 14:23, 5 December 2008
Line 1:		Line 1:
	[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.		[[Image:Nutshell.png]] This tutorial will explain how to use the same method used by Treyarch in the Stock Maps to spwan FXs on the Clientside to ease server load.

			[[Image:Warning.png]] <font color="red" size "3">This Tutorial SHOULD work but not with the Modtools release with currently have, instead i suggest looking at either of those 2 Tutorials:</font>

			* [[Call of Duty 5: Adding FXs\|Adding FXs to Level Method #2]]
			* [[Call of Duty 5: FXs Script_Struct\|Adding FXs to Level Method #3]]

	==Theory==		==Theory==