Well first of all, you will need the following:
VCMP Server Software
VCMP Client Software
mIRC Software
When the VCMP Server Software is running, it enables other people to connect to your server.
(You may need to make some changes to other software for others to actually be able to connect to your server, such as opening ports in your router and firewall.)
The VCMP client server simply allows you to connect to another computer running the VCMP server software.
mIRC.
Designed for chatroom stuff, but thanks to it's amazing built-in scripting language features, it has the ability to send/receive data to other software such as the VCMP server software.
Scripting is based on events. Events are simply things that happen. A few examples of events are:
A player gets into a vehicle.
A player leaves a server.
A player types some text.
A player kills another player.
When certain events occur, the VCMP server software sends data to all the mIRCs connected to the VCMP server software.
mIRC receives that data, and depending on what that data is, mIRC will know which event just happened!
The VCMP server software also sends event-specific data to mIRC.
Such as if the event was "A player gets into a vehicle", the other data sent would be the ID of the player that got into the vehicle, and the ID of the vehicle that the player got in to.
So basically:
Event occurs in VCMP -> Inform mIRC of the event
mIRC will then read your script, and execute the code in it.
--
Lets say for example, I wanted to kick a player when they typed !kickme
Here is the code that should work with GUS 9.0
on *:SIGNAL:vcmp.command:{
if ($2 == !kickme) vcmp.kick $1
}
So the first line is: on *:SIGNAL:vcmp.command:{
There are 3 parts to this line, each part is seperated by a colon.
First part: on *
The word "on" tells mIRC that the code is an event.
The * is something to do with the chatroom-side of mIRC, so don't worry about that.
Second part: SIGNAL
This word just tells mIRC that the event is a signal.
(This is needed because there are other types of events apart from Signals in mIRC.)
Third part: vcmp.command
This is simply the name of the Signal.
Different Signal names are used for different events.
For example, using GUS 9.0, the Signal name for a player spawning is: vcmp.spawn
The 2 brackets { and } simply surround code.
When the vcmp.command signal occurs, the code inside those curly brackets will be executed.
Now the line of code inside these curly brackets is: if ($2 == !kickme) vcmp.kick $1
This is a basic if statement.
A basic if statement works by comparing 2 values.
The 2 values in this if statement are "$2" and "!kickme"
$2 is an identifier.
The $ sign tells mIRC that it is an identifier.
The number to the right of the $ sign, tells mIRC which value to fetch.
Remember earlier I mentioned about the VCMP server software sending data to mIRC, and it also sends other data, such as the ID of the player and the ID of the vehicle?
Well this is how we fetch that other data.
When mIRC reads an identifier, it will replace it with it's actual value.
Inside the vcmp.command signal, here are the values sent to the signal:
$1 is the ID of the player who typed the command.
$2 is the command the player typed.
$3 is the first word the player typed after the command.
$4 is the second word the player typed after the command.
$3- is all the words the player typed after the command.
Now back to the if statement.
Remember what we originally wanted. To kick the player if they typed !kickme
So we won't need to use $3, as we don't care what the player typed after the command.
We will need to use $2, because $2 contains the command that the player typed.
If the player didn't type !kickme, then we don't want the "vcmp.kick $1" code being executed
The if statement: if ($2 == !kickme)
is just like saying: if the player typed the command !kickme, then do some code
Now the code to do, is: vcmp.kick $1
Remember, $1 holds the ID of the player who typed the command
When mIRC reads "vcmp.kick $1" it will kick the player who has the ID $1 (if $1 holds the value 7, it will kick the player with ID 7)
So to sum it all up:
VCMP event happens in client (player types !kickme) -> VCMP client tells VCMP server what happened -> VCMP server tells mIRC what happened -> mIRC reads your script -> mIRC tells the VCMP server to kick the player
There's alot more to mIRC scripting than that ofcourse.
Anyway, hope it has helped you.
Edit:
If you want to know more about the features of mIRC scripting or the VCMP possibilites, just say so
