[Tutorial] Simple Scripting Lessons - Preparations

[FG28_Kodiak]

After looking into the posibilities of using triggers on Cliffs of Dover without scripting (http://forum.1cpublishing.eu/showthread.php?t=28454) , in this lesson we will make some preperations to make scripting easier for us.

When scripting in Cliffs of Dover, we will be using C# (C Sharp) (http://en.wikipedia.org/wiki/C_Sharp...mming_language). This has some advantages, but also some disadvantages. The advantages are that one doesn't have to learn a programming language which was specificaly designed for CloDo. There are enough books and pages on the internet which can be helpful in learning the language. Also, one can use all the posibilieties of .Net. The disadvantages are that especially beginners (I just wanted a victory message!) can be shocked by the posibilites of scripting. The commands are cryptical in part, and that the language is object-oriented doesn't make it easier. Although, beginners will probably have the most problems with missing semicolons or wrongly placed brackets.

Because of this, at first, we will have a look at the Editor which is integrated into Cliffs of Dover. Sadly, it neither supports syntax highlighting nor aumotatic intenting. Basicly, it offers less than Windows Notepad.


Although, one can open a menu by right clicking which can compile the code. This can be useful when searching for mistakes. As an example, in this code a semicolon was forgoten, and then the code was compiled:


As expected, the output window shows us an error message:


Now we correct the missing semicolon and try it again:


Now everything seems to be all right:


After saving, the CloDo editor automaticaly creates a file with the ending "cs". Script files in Cliffs of Dover have to have the same name as the mission file, but with the ending "cs" instead of "mis".


As one can see, Cliffs of Dover doesn't offer to much help with scripting. Because of this, one should look for alternatives to the integrated editor. There are two posibilites: One can use an extended editor, like the freeware Notepad++ http://notepad-plus-plus.org/. It offers syntax highlighting and automated intenting, at least.


Or one gets a professional developing environment. In this case we are lucky, as Microsoft offers one free of charge (registration is requiered though), namely Microsoft Visual C# Express
http://www.microsoft.com/visualstudi...csharp-express

Especially for beginners, I would recommend downloading and installing this package, because the editor offers a lot of funtions which make programming a lot easier. Syntax errors are shown directly in the editor by a red marking, for example.


After downloading and installing Microsoft Visual C# Express, we start a new project.


In the window which now pops up, we choose "Class Library" and enter a fiting name for our "project", as we will loose track at "ClassLibrary10", at the latest. Now we click OK.


Express now creates all necessary files and opens the editor. The code lines which are already in there can be deleted, as we don't need them.


We simply replace them with the standard framework (more of that in the next lesson), which is needed to script a mission.


After adding it, the Express editor already shows us the first errors. "The type or Namespace ...". This means, that the developing environment doesn't know the used assemblies (http://en.wikipedia.org/wiki/.NET_assembly). To change that, we select "References" in the Solution Explorer (orange arrow) and click it with the right mouse button.


Now we click "Add References"


In the dialogue box we choose "Browse" and navigate to the folder ..\Steam\SteamApps\common\il-2 sturmovik cliffs of dover\parts\core and highlight the files "antlr.runtime.dll", "core.dll", "gamePages.dll", "gamePlay.dll", "gameWorld.dll", "HostView.dll", "maddox.dll", "part.dll", "sound.dll" and "Strategy.dll"


and in the folder ..\Steam\SteamApps\common\il-2 sturmovik cliffs of dover\parts\bob the files "partBob.dll" and "Campaign.dll". We don't need all of them, but it doesn't hurt to add them to the project so we don't have to look for them later, if we might need them.


To call up another useful tool of the Express Editor, namely the Object-Explorer, we switch the Editor into expert mode.


Now we activate the Object-Browser (and yes, a simple "CTRL+W, J would have done the job, too)


In the Object-Explorer we can look more closely at the classes which are present in the Dlls.


The Express Editor also has the useful function autocomplete at it's disposal.



In the next lesson we will finally start with scripting - I promise!

Suggestions or criticism are always welcome.

Thanks again to FG28_Elatan for the translation.

[KDN]

Keep it coming ...if possible
I got Visual C sharp installed and got a dummies book along with another one that takes a littel different approach and have started getting into it but since I have no reference "pegs" my motivation is kind of ...limp!!
You have given me something to build on since it is CoD related, now I can go back with more enthusiasm.
Cheers!!

[Smokeynz]

I downloaded and installed the ms express editor, as a newbie to C# the editor has alot of advantages. I recommend getting it.

As noted it finds missing brackets and colons and basic syntax errors, however it does not see many other errors

Something I get caught up in with clod is exchanging information, passing data from one section to another. common error is "cannot covert "int" to "bool""

Although C# has a reasonble learning curve, maybe list commonly used elements with relation to clod as it stands, maybe why they are there.

examples,
using system xxxxx

main class
Amission

int
pvt int
bool
string

advance stuff
indexing
switches

[Ataros]

Great work as usual! Thank you very much for going into all the details!

[Ataros]

Originally Posted by KDN

I got Visual C sharp installed and got a dummies book along with another one that takes a littel different approach and have started getting into it but since I have no reference "pegs" my motivation is kind of ...limp!!

You can try starting making your own simple mission based on these scripts http://forum.1cpublishing.eu/showthread.php?t=26523 Or just study those scripts for starters and use your textbook to find answers when you are lost.

It is much more fun to work with CloD related code.

[Pato Salvaje]

OOOOOOHHHH!!!! MY GOD!...

Kodiak, you´ve made my day!! I was learning by my own, but this is a great step forward for me!!!... please keep coming...
I have MS express ready and waiting to script...

[salmo]

<Post deleted .... problem fixed> Thanks Kodiak for a useful tutorial

[SG1_Lud]

Awesome! TY very much Kodiak.
S!

[moggel]

I'm experienced with VS and C# and got exited to realize scripting is done in my "native language". Are there any dokumentation for the libraries that I can explore?

Thanks

[FG28_Kodiak]

No, not at the moment.