C4Script Documentation: Difference between revisions

Newton (talk | contribs)
No edit summary
Armin (talk | contribs)
No edit summary
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[File:C4Script.png|300px|thumb|right|One of the simpler scripts... :-)]]
__NOTOC__
[[File:C4Script.png|right|frame]]
Like the previous Clonk titles, OpenClonk offers countless possibilites to create your own scenarios, objects and campaigns. Since [http://www.clonk.de/classics.php?lng=en Clonk 4], one of Clonk's most remarkable features has been it's extensibility. The complete content is scripted in C4Script, Clonk's own powerful scripting language, has been developed further since 1998. Now, it feels pretty much like a typical C-style scripting language. If you know other programming languages, you will have no problem to familarize yourself with C4Script and if you never programmed before, it can be a good introduction and practice to programming.
Like the previous Clonk titles, OpenClonk offers countless possibilites to create your own scenarios, objects and campaigns. Since [http://www.clonk.de/classics.php?lng=en Clonk 4], one of Clonk's most remarkable features has been it's extensibility. The complete content is scripted in C4Script, Clonk's own powerful scripting language, has been developed further since 1998. Now, it feels pretty much like a typical C-style scripting language. If you know other programming languages, you will have no problem to familarize yourself with C4Script and if you never programmed before, it can be a good introduction and practice to programming.


Everything about C4Script and the game data is documented in our [http://docs.openclonk.org/en/sdk/ C4Script Documentation].
You may want to develop based on the latest game data there is. See the [https://www.openclonk.org/snapshots/ snapshots] page for the most current builds.


You may want to [http://www.openclonk.org/download/ download] the latest game data first before you add or edit any game content. See the [http://www.openclonk.org/nightly-builds/ nightly builds] page for the most current builds.
== [https://docs.openclonk.org/en/sdk/ OpenClonk Documentation] ==
 
[[File:Cpem.gif|left|link=https://docs.openclonk.org/en/sdk/]] The [https://docs.openclonk.org/en/sdk/ documentation] is a complete reference for everything you need to know about the script language C4Script and its data structures, how the the game data is organized and about the APIs for e.g. dynamic landscape generation, using the particle or the effect system.
Note that the documentation is also still [https://docs.openclonk.org/de/sdk/ available in German], however it lacks maintenance, so always refer to the English version for recent stuff.
 
== [https://wiki.openclonk.org/w/Developing_Content_with_Eclipse C4 Development Toolkit] ==
 
[[File:C4dt.png|left|52px|link=https://wiki.openclonk.org/w/Developing_Content_with_Eclipse]] The [https://wiki.openclonk.org/w/Developing_Content_with_Eclipse C4 Development Toolkit], or short C4DT, is a plugin for Eclipse. Using Eclipse with C4DT for Clonk development makes it very comfortable as the editor offers many useful features for editing and debugging scripts you might know from other IDEs.
 
== Tutorials series ==
* [[Tutorial: Scenario Creation]]
* [[Tutorial: Map Generator - The Basics]]


== Further links ==
== Further links ==
* [[Artists Guide|Graphics]] - Render and texture 3D-models
* [[Artists Guide|Graphics]] - Render and texture 3D-models
* [[Artists_Guide#Sounds_.26_Music|Sounds and music]] - Include sound effects and music into the game
* [[Artists_Guide#Sounds_.26_Music|Sounds and music]] - Include sound effects and music into the game
* [[Content Developers Guide|Game content]] - including creating objects, scenarios and campaigns with C4Script
* [[C4Script Style Guidelines]]
* [[Mercurial Guide]] - How to use our repository
* [https://forum.openclonk.org/board_show.pl?bid=7 Scenario & Object Development forum]
* [[Git Workflow]] - How to use our repository
* [[Developers Guide]] - For engine developers
* [[List Of Community Creations]] - List of community creations

Latest revision as of 17:18, 5 July 2021

Like the previous Clonk titles, OpenClonk offers countless possibilites to create your own scenarios, objects and campaigns. Since Clonk 4, one of Clonk's most remarkable features has been it's extensibility. The complete content is scripted in C4Script, Clonk's own powerful scripting language, has been developed further since 1998. Now, it feels pretty much like a typical C-style scripting language. If you know other programming languages, you will have no problem to familarize yourself with C4Script and if you never programmed before, it can be a good introduction and practice to programming.

You may want to develop based on the latest game data there is. See the snapshots page for the most current builds.

OpenClonk Documentation

The documentation is a complete reference for everything you need to know about the script language C4Script and its data structures, how the the game data is organized and about the APIs for e.g. dynamic landscape generation, using the particle or the effect system.

Note that the documentation is also still available in German, however it lacks maintenance, so always refer to the English version for recent stuff.

C4 Development Toolkit

The C4 Development Toolkit, or short C4DT, is a plugin for Eclipse. Using Eclipse with C4DT for Clonk development makes it very comfortable as the editor offers many useful features for editing and debugging scripts you might know from other IDEs.

Tutorials series

Further links