-The Complete CFG Coding Tutorial-

CHAPTER 1: The Basics

I will begin by explaining what CFG is. CFG is a type of command based programming language. It is used primarily in the CoD franchise.

The first thing to talk about is binds. Binds are what activate commands, and are the backbone to any scripts.

The command to bind things is, well, "bind".

For Example:


I will use the down dpad for this.

So,


That will do a command when you press dpad down.

Here is a list of all the buttons you can bind:



Now in the game files, they set the buttons to various commands.

So DPAD_DOWN is set to "+actionslot 2", BUTTON_BACK is set to "togglescores".

But how to you assign commands? Easy! Just put the command right after the button.

So lets say I want to make it so that when I press the BACK button, I toggle god mode.

For this, I would do this:



But when you do this, it stops you from seeing the scores. To see the scores, you simply add 2 commands to 1 button.



All commands are separated with a semi-colon.

Here is the list of default commands, with corrosponding buttons.


Now it's all fine and dandy that you can do that, but in the next chapter, we will cover putting commands into patches.

CHAPTER 2: Binds in patches

Ever since the release of the infamous mapname bind exploit, binds have been everywhere. Most people know them as "Infections".

But for those JTAG users, there is a much simpler and easier way.

The standard mapname exploit works like this.


That requires you to get infected, then go into splitscreen and press back.

But using a dvar called "activeAction", you can make it much easier. activeAction basically runs commands on the first frame of the game.

So as soon as you connect, it will run any command.

For Example,



This will make the game speed 600 as soon as the host connects.

The problem with activeAction is that it resets once the command(s) are initiated.

To avoid having to keep getting infected, you can do this.

self setClientDvar( "activeAction", "vstr loop" );
self setClientDvar( "loop", "set activeAction vstr loop;[commands here]" );

This basically loops itself, but is jumping the gun a little.

CHAPTER 3: Variable Strings and Mod Menus

Variable strings are what make mod menus possible.

I will explain them in GPD terms as it is much easier to explain that way.

Variable strings work like this.



The command for a variable string is "vstr".

When you press dpad down, it will run any commands set to x.

This may seem inconvinient, why not just do it with one line? I will explain.


Say if I wanted to make it so that when I press down once, it sets the game speed to 600. But when I press it a second time, it changes the timescale?

To do this, you would do this.


This would alternate between changing the timescale and the game speed.

But if you want to change just 1 dvar through multiple values, you use the command "toggle".

For Example:



You separate each value with a space. Now everytime you press back, it will change the game speed to the next value.

Now, you might ask, "How do I make a mod menu with that!?" Well, its very simple.

The say command prints text onto your screen. You can print a maximum of 8 lines, which can be changed with the dvar "cg_chatHeight".

To make a mod menu, you do this.




Now this may seem daunting, and it is a big step. But I will expain it in stages.

Lets start with the init command.



This tells you to press down to open the menu. It also binds it.



This sets the scrolling strings. These are constantly being changed as you scroll. It also binds A to EXEC, used to activate commands, and B to exit the menu.



This is the main body of the menu. This is where the controls are laid out. Lets look at a single line.




"0" is the string value.

"set DOWN vstr 1" sets DOWN to 1 instead of 0. This means that when you press down again, it goes to 1.

"set UP vstr 7" sets UP to 7. This is so that the menu loops when it hits the top or bottom.

"vstr say1" This activates on the line being called, and shows whats being selected.

"set EXEC vstr command1" This means that when you press A, it calls the EXEC string. On this line, EXEC is set to the string command1. So when you press A, it does whatever is set to command1.

Now lets look at the visuals of the menu.



For the first line, the first option is in red, and for the second line, the second option is in red, etc.

This gives the effect of scrolling, even though in reality it is printing 8 lines at a time.


Now lets look at the command section.



Lets take a single command line and break it down.



This is made of 2 main parts. The string value, and the command section.

You can name a string whatever you want.



To do sub-menus, you have to do a string within a string. (Yeah, Inception joke)

For example:



This is simply another menu threaded to the first menu. Once you get single menus, you can get sub-menus just as quickly.



CHAPTER 4: Advanced Techniques

I do not recommend trying anything from this chapter until you have mastered simple point and click menus. I will assume that you are experienced, and therefore all the stuff in this chapter will be regarded in advanced terms.

First I will cover timing. Wait commands in C# are common, simply do wait [number in seconds]; and it will pause.

Wait commands in CFG are exactly the same, but are done in milliseconds instead, so wait 100; is 1 second.

Flashing text can be achived this way, as can a countdown.

Flashing Text:



Countdown:



While wait commands are running, you cannot do anything but move. No buttons.

Therefore, it is important to not do something like this:



This will not allow you to spawn. Only have wait commands on buttons.

Another thing you can use is the command setFromDvar.

This will take the value of one dvar and set it to another.

For example:



This will put your clantag as your gamertag. Yes, more than four characters.

You can also set it to vstrs.



Just call on the string setclantag, or any other of your choise.


====END====


Here is a command list for CoD 4:



Thanks to Daevius for the command list.

Please tell me if anything is missed out, and thanks for reading!


-XeXWill-