Hey guys,

this section is all about .gsc scripting (fastfile modding) it is written by a buddy of mine, he is the one who created the IHC zone editor to the .zone files. All credit to IHC James we both agreed to add his section to my info post. Enjoy
[color=blue]


[color=red]Fastfile Editing:
Getting Started

[spoil][*] Intro
[*] Preparing your Console
[*] Preparing Black Ops Storage
[*] Patching Black Ops Files
[*] Editing Black Ops Files

Coding Basics for Black Ops[b]

[*] Functions
[*] Comments
[*] Endon Function
[*] Wait
[*] Calling Functions
[*] Variables
[*] If Statements
[*] Select Case Statements
[*] While Statements
[*] For Statements
[*] Final

[b]HUD / Text

[*] Working with _hud_util.gsc - Creation
[*] - Creating a Bar
[*] - Creating a Font String
[*] -Working with _hud_util.gsc - Modifying
[*] - setPoint
[*] - hideElem
[*] - showElem
[*] - destroyElem
[*] - setWidth
[*] - setHeight
[*] - setSize
[*] - setParent
[*] - setText
[*] -Working with _hud_util.gsc - Examples
[*] - Example Bar Creation
[*] - Example Font String Creation
[*] Working with _hud_message.gsc
[*] - oldNotifyMessage
[*] - hintMessage
[*] - notifyMessage
[*] - Other Text
[*] - - iPrintIn
[*] - - iPrintInBold

Pre Cache / Loading



[*] Explanation
[*] Example

DVARS

[*] Using Dvars
[*] - setDvar
[*] - setClientDvar
[*] -Dvar Dump

Models

[*] Basics
[*] Script Model Properties[/b]
[*] - Origin
[*] - Angles
[*] Script Model Functions
[*] - Show
[*] - Hide
[*] - Solid
[*] - Notsolid
[*] Some Model Names

[b]Sounds

[*] Playing Sounds
[*] - Functions to Play
[*] - Examples
[*] Some Sound Names

Weapons

[*] giveWeapon
[*] switchToWeapon
[*] _disableWeapon
[*] _enableWeapon
[*] isWeaponEnabled
[*] Some Weapon Names

Button Binding

[*] OnPlayerConnect
[*] Monitor Function
[*] Waiters
[*] Function Example

Small Mods

[*] giveKillstreak[/b]
[*] - Some Killstreak Names

Misc Functions

[*] Coin Toss
[*] isFlashed
[*] wait
[*] realWait
[*] getGameLength
[*] get_player_height
[*] detatchAll

Some Variables

[*] Self
[*] - Name
[*] - Health
[*] Level
[*] - Hostname
[*] Examples
[*] - Username Check
[*] - Hostname Check
[*] - Hostname -- Username Comparison
Programs

[*] Fast Crypt Tool
[*] iHc Zone Editor
[*] FileZilla
[*] Notepad++


CFG Modding:
GODLYM0DZ CFG Wizard

[*] Getting Ready
[*] Multiplayer
[*] Zombies

Teh1337's Scrolling Mod Menu v2.5

[*] Credit
[*] Tutorial

Other:
Zombie "use" Strings


Fastfile Editing:
Getting Started:

Intro:
Getting Started will teach you how to edit Black Ops Fastfiles, and the requirements to do so

Preparing your Console:
First of all, you will need an Xbox 360 Console that will run unsigned code,
You can do this on a Developer Kit or a console that has been JTAG Exploited.
XeXMenu Is a program you can run on your console to browse, manage and run files connected to your console
You can download XeXMenu from Xbins in:

You can put it onto your Consoles HDD or MEMU using a Transfer Cable and Xport 360 or Xplorer360,
If you dont have a way of transferring straight to your Consoles HDD or MEMU then
you can put it onto a disk, run it on your Console and copy it to your Consoles HDD or MEMU.

Preparing Black Ops Storage:
There are 2 main ways of storing the game,
You can store it on a USB Formatted to FAT32 or you can store it on your Consoles HDD or MEMU,
You can either download the ISO and extract it to one of the storage methods (Not Recommended)
Or you can use XeXMenu to rip your disk (Takes about 20 mins - Much faster)
You can do this by...
Navigating to the directory where you want the files to be created,
Note: Ripping the disk doesnt create a directory for the files, It will extract all the files to your current location,
Press Y, and select Copy DVD, Your DVD Drive will now eject,
Place Black Ops into your drive, and "push" your tray in,
As you here the disk starting to spin, Hit confirm on your screen,
This will now start copying the contents, as stated above this takes around 20 mins.
After this you will no longer need your disk.

Patching Black Ops Files:
Now you will need to patch some files,
The only link I have handy is the TU2 Pack,
[ Register or Signin to view external links. ]
Just copy them files into your Game Directory, overwriting when asked.

Editing Black Ops Files:
Now you are ready to start editing,
First off, you will need a tool to decrypt the Fastfile you want to edit,
FastCryptTool gets this job done, you can download that here,
[ Register or Signin to view external links. ]
patch_mp.ff is the recommended file to edit, so you want to move this to your pc
You can either do this by a hard transfer, or via FTP
To do FTP Transfer, I recommend an ethernet cable between your console and pc
Run XeXMenu on your Console,
Then using a FTP Client such as FileZilla, Type in your Consoles IP (Press LB after starting XeXMenu)
Then XeXMenus default Username is "xbox" and Password is "xbox" (Without quotes)
Open up FastCryptTool and goto File > Import and open patch_mp.ff in the open dialog
Then in the save dialog you will save the .zone (This is a decrypted FastFile)
The .zone file ends up in the above directory (slight bug -_- )
When it asks you if you want to open select no.

Now you can either open the file up again in FastCryptTool
or use a .Zone Editor such as the iHc Zone Editor.
To use FastCrypt Tool, you will have to edit the config file for extra GSC's (explained later)
To open in FastCrypt Tool, just goto File > Open and select the .zone file,
Or if you want to use iHc Zone Editor just hit the open button and select the .zone file,
iHc Zone Editor will auto detect all the GSC's (No need for configs)

The Fastfile (.ff) contains numerous files, Think of it as a .zip / package.
The most popular file within a Fastfile is the GSC,
Idk wtf that stands for, Game Script Code or something ?
Anyway on the list to the left of either of the programs will be the GSC's inside
they fille be formatted in folders.
The recommended GSC to edit is the _challenges.gsc which is located:

You will just see this to on the list, so just click it and it will open.
Now you can edit the code.

When done just hit save, then in FastCryptTool, goto open it up (if it isn't already)
and goto File > Export and save it as patch_mp.ff again,
now just put this back into your game directory, and start a splitscreen / systemlink game
If the game doesnt load and you get an error message, there is an error within the coding
(Black ops is much stricter than Modern Warfare 2).

Once you have that mastered, You are ready to continue

Coding Basics for Black Ops:


Functions:
Functions are a group of code, you can execute them from other function and even send them values
A function looks like this

FunctionName - This is the name of the function, you will use this to "call" it,
Calling a function means starting it.
Arguments - Argument is a value that can be passed to the function when calling it,
Arguments can be found between the () after the function name,
Each argument is seperated by commas. You don't have to use arguments,
a function without arguments would look like:

{ } - These are the symbols that will contain all the function code.

[size="3"]Comments:[/size]
Comments are a section within coding that will get ignored, to start a comment just type:

And everything after that would be ignored until the start of the next line.
You can also make group comments, group comments start with:

and will only end when it gets to:

Here and example of how comments can be used:

In most Black Ops GSC's you will find a function with the name onPlayerConnect,
It will look like this:

Anywhere under:

you can put your code, this will execute after you connect (game starts)
you are able to make a function that will execute whenever you spawn by:
Adding:

into the OnPlayerConnect function
So it will look like this:

Now you will need to create a function after this so start a new line and put:

When making code withing OnPlayerConnect,
You will reference to yourself as "player"
But elsewhere you will reference yourself as "self"
At the top of GSC's is a function with the name init,
This is the initialization function, which will load/prepare stuff for the game,
such as caching models (loading models),
In the init function may notice:

This is what starts OnPlayerConnect

Endon Function:
To stop your functions messing up when you die / disconnect you can add either of these to the start of a function:


Wait:
Wait is a simple line of code that will wait however long you want like so:


Calling Functions:
you can call a function like so:

Obviously dependant on where you are calling it from.
You can call functions from other GSC's by:

Remember you dont put .gsc in this statement

Variables:
A variable is a stored value that you can set and get.
You can create a variable with a piece of simple code like this:

String - Strings will hold a text value
Integer - Integers will only hold a numeric value
Boolean - Booleans are a true/false value
Array - Arrays is a group of values

If I create a variable within a function, I am unable to access it from another function:

So how do we get around this?
You can save Variables to a self, player or level.
by simply adding it like so:

When setting a variable that you are able to access it anywhere.

[size="3"]If Statements:[/size]
An If statement if a group of code that will only execute if the check matches
heres the structure:

The check will compare 2 values, like so

There are different operators that changes the comparison check

With If statements you can also have else which will execute if the check returns false
heres an example of an if with an else:


Select Case Statements:
The select statement is your #1 solution for not using lots of if statements,
for example:

Can be easily transfered to a select statement like so:


While Statements:
A While statement is a group of code that will repeat forever, or until you want it to stop
While statements look like so:

The code within it will keep repeating if the boolean = true;
heres an example of a continously running while statement:


For Statements:
A For statement is like a while, but has my precise repeating checks

so lets look at the top
for(i=1; i<=3; i++)
i=1; - Will declare the variable i, value 1
i<=3; - This is like the while check, if i is less than or equal to 3 it will execute
i++ - Wether the variable will increase or decrease every time it repeats ( i-- is to decrease )

Final:
Heres an example using some of the stuff above,

What that will do, Is every second, it will make your origin 100 units higher,
until 10 seconds in, Then every second, it will make your origin 250 units higher,
Can you figure that out?

Hope this part has helped some people

HUD / Text:

Working with _hud_util.gsc - Creation
Creating a bar:
This will create a box with gradient, youll have to try to see what I mean, until I take a screenshot.
Function Header:

Usage:

[size="3"]Creating a Font String:[/size]
Create a font string, this will create a text element which you can display on screen
Function Header:

Usage:

Working with _hud_util.gsc - Modifying
setPoint
Sets the point (location) of the element that calls it
Function Header:

Usage:

hideElem
Hides the element that calls it
Usage:

showElem
Shows the element that calls it
Usage:

destroyElem
Destroys the element that calls it
Usage:

setWidth
Sets the width of the element that calls it
Function Header:

Usage:

setHeight
Sets the height of the element that calls it
Function Header:

Usage:

setSize
Sets the width and height of the element that calls it
Function Header:

Usage:

setParent
Sets the parent of the element that calls it
Function Header:

Usage:

getParent
Returns the parent of the element that calls it
Usage:

setText
Sets the text of the element that calls it
Function Header:

Usage:

Working with _hud_util.gsc - Examples
Example Bar Creation
Creates a black bar, size 250w, 250h

Example Font String Creation
Creates a Font String, Font as Objective, Scale as 1
Sets the point to 50, 50 from the top left of the screen
Sets the text to "Text"

Working with _hud_message.gsc
oldNotifyMessage
Modern Warfare 2 Styled Notify Message
Function Header:

Usage:

hintMessage
Typewriter Styled Text
Function Header:

Usage:

notifyMessage
Notify Message, Like Challenge Unlock
You have to spawn the struct and pass it as an argument
Function Header:

Usage:

Example Function

Other Text
iPrintln
Shows text at bottom left of screen
Usage:

iPrintlnBold
Shows text at top of screen
Usage:

[/spoiler]
Pre Cache / Loading:
[spoiler]
Sometimes you will need to Pre Cache / Load something before you can use it

You would put this in the init() function
Example:


DVARS:

Using Dvars:
setDvar
Sets a Dvars value
Function Header:

Example

[size="2"]setClientDvar[/size]
Sets a Clients Dvars value
Function Header:

Example


Dvar Dump (w/ Descriptions):
Credit to Jester
[quote name='jester' timestamp='1291617156' post='2643751']




Models:

Basics:
Spawning a Script Model:

Setting the Model:

Script Model Properties:
Origin - Sets or Gets the Origin of the Script Model
Structure: ( X, Y, Z )

Angles - Sets or Gets the Angles of the Script Model
Structure: ( X, Y, Z )

Script Model Functions:
Show
Shows The Model

Hide
Hides The Model

Solid
Makes the model solid

Notsolid
Makes the model not solid


Some Model Names:


Sounds:

Playing Sounds
Functions to Play
Functions you can use to play sounds

Examples:



Some Sound Names:


Weapons:

giveWeapon
Give weapon to player
Function header:

Example use:

switchToWeapon[b]
Switch players current weapon
Function header:


switchToWeapon( name );
               

Example use:


self switchToWeapon( "crossbow_explosive_mp" );
               

[b]_disableWeapon[b]
Disables weapons


self _disableWeapon();
               

[b]_enableWeapon
Enabled weapons

isWeaponEnabled
return ( !self.disabledWeapon );

Some Weapon Names:


Button Binding:

OnPlayerConnect:

Monitor Function:

Waiters:

Function Example:


Small Mods:

giveKillstreak
Gives you a Killstreak
Function Header:

Usage:

Some Killstreak Names


Misc Functions:

Here are some misc functions that are already in the game:
cointoss()
return RandomInt( 100 ) >= 50 ;

isFlashed
return GetTime() < self.flashEndTime;

wait
Delays the code in seconds

[size="2"]realWait[/size]
Delays the code in seconds

getGameLength
Returns how long the game is

get_player_height
return 70;
Useless, but if you wanna make you code look nice you can use it somewhere

detatchAll
Detatch your head :O


Some Variables:

Here are some misc variables that may come in helpful
[size="3"]Self[/size]
self.name
Gets / Sets the Name of the player (Profile Name / Gamertag)

self.health
Gets / Sets the health of the player

Level
level.hostname
Gets / Sets Name of the game host (Profile Name / Gamertag)

Examples
Username Check
Checks the Username

[size="2"]Hostname Check[/size]
Checks the Username

[size="2"]Hostname == Username Comparison Check[/size]
Checks the Username
[code]
if ( level.hostname == self.name )
{
// You are the Host!
}