New features since Clonk Rage - Revision history

Newton at 14:16, 1 September 2013

2013-09-01T14:16:38Z

← Older revision		Revision as of 14:16, 1 September 2013
Line 1:		Line 1:
			'''This article is outdated!'''

	This article is written for all those, who know Clonk Rage and would like to know what's new in OpenClonk. Since the project went open source, quite a few new experimental features have been introduced. In this newest installment of the Clonk series, we've left behind the old shackles and created something more advanced than anything you've ever seen in Clonk.		This article is written for all those, who know Clonk Rage and would like to know what's new in OpenClonk. Since the project went open source, quite a few new experimental features have been introduced. In this newest installment of the Clonk series, we've left behind the old shackles and created something more advanced than anything you've ever seen in Clonk.

Newton: /* C4DT */

2010-09-16T20:07:58Z

C4DT

← Older revision		Revision as of 20:07, 16 September 2010
Line 75:		Line 75:
	* An outline for opened script files		* An outline for opened script files
	* A built-in parser finds and warns about potential script errors and warnings without having to start the engine(!)		* A built-in parser finds and warns about potential script errors and warnings without having to start the engine(!)
			* refactoring of variables and functions
	* A real debug mode for the engine: '''[http://wiki.openclonk.org/w/C4DT_Running_Scenarios Debug scenarios]''' in the Eclipse debugger(!)		* A real debug mode for the engine: '''[http://wiki.openclonk.org/w/C4DT_Running_Scenarios Debug scenarios]''' in the Eclipse debugger(!)

Newton: /* C4Script changes */

2010-09-15T20:28:17Z

C4Script changes

← Older revision		Revision as of 20:28, 15 September 2010
Line 88:		Line 88:
	* All functions that are working in context of an object have been stripped of their respective object parameters. E.g., write <code>clonk->GetX();</code> instead <code>GetX(clonk)</code>		* All functions that are working in context of an object have been stripped of their respective object parameters. E.g., write <code>clonk->GetX();</code> instead <code>GetX(clonk)</code>
	* Some obsolete functions have been removed or replaced. For example <code>FindObject()</code> now works like the <code>FindObject2()</code> from Clonk Rage and <code>FindObject2()</code> was removed. Numbered local variables are gone (use arrays instead) and references have been removed.		* Some obsolete functions have been removed or replaced. For example <code>FindObject()</code> now works like the <code>FindObject2()</code> from Clonk Rage and <code>FindObject2()</code> was removed. Numbered local variables are gone (use arrays instead) and references have been removed.
	* Many ''functionalities'', like climbing ladders, rope physics, bases, workshop or clonk controls have been written in unitized library objects (referred to as script libraries) which are then included by the concrete objects. This makes it easier to include functionalities of other objects without having to inherit ''everything''. For example, all production buildings <code>#include Library_Workshop</code> to inherit the basic workshop functionality. Also, functionality is moved from the engine into these script libraries. For example the base functionality.		* Many ''functionalities'', like climbing ladders, rope physics, bases, workshop or clonk controls have been written in unitized library objects (referred to as script libraries) which are then included by the concrete objects. This makes it easier to include functionalities of other objects without having to inherit ''everything''. For example, all production buildings <code>#include Library_Workshop</code> to inherit the basic workshop functionality. Also, much functionality is moved from the engine into these script libraries. For example the base functionality.
	* A new type called Proplist has been introduced. Proplists are associative arrays with prototype inheritance, like Javascript objects. Objects and Object Definitions are also Proplists now and Objects inherit from their Definition. Local named variables are now properties of the object.		* A new type called Proplist (property list) has been introduced. Proplists are basically associative arrays with prototype inheritance, like Javascript objects. For example <code>var info = { XP = 1200, Comment = "I'm new here." }; Log("%d",info.XP);</code> logs "1200". Objects and Object Definitions are also Proplists now and Objects inherit from their Definition: <code>Log("%s",Bow.Name);</code> logs the localized name of the bow. Local named variables are now properties of the object.
	* ActMaps are stored as Proplists in a property of the Object Definition.		* ActMaps are stored as Proplists in a property of the Object Definition. Probably, the DefCore.txt will follow in the future.
	* DescXX.txt, Names.txt are not used anymore. The name is set in the script and translated in the StringTblXX.txt. A description is only needed for some objects and also defined in script and translated in the stringtable.		* DescXX.txt, Names.txt are not used anymore. The name is set in the script and translated in the StringTblXX.txt. A description is only needed for some objects and also defined in script and translated in the stringtable.
	* PlayerControls have been revised. Scenarios and objects can now use and overload arbitrary keys, mouse buttons and gamepad events. The Clonk script defines a new interface (see <code>ControlUse</code>) for object interaction.		* PlayerControls have been revised. Scenarios and objects can now use and overload arbitrary keys, mouse buttons and gamepad events. The Clonk script defines a new interface (see <code>ControlUse</code>) for object interaction.
	* Variables can now be <code>nil</code> ~~(be~~ not ~~assigned)~~. <code>nil</code> is not ~~equal to~~ <code>0</code> or <code>~~false~~</code>. For functions, nil can be used to not specify an optional parameter (as it ~~were~~ left out). For example <code>[http://docs.openclonk.org/en/sdk/script/fn/Sound.html Sound("Water",true,nil,nil,+1)]</code> plays the water sound for all players in a loop, at 100% volume (the default) while <code>Sound("Water",true,nil,0,+1)</code> plays the same sound only for player zero. Also, you can distinguish between a function with no return value (returning <code>nil</code>) and a e.g. function returning the number <code>0</code>. Regardless of if a variable <code>foo</code> is either <code>nil</code>, <code>0</code> or <code>false</code>, this statement still logs "yay": <code>if(!foo) Log("yay");</code>		* Variables can now be <code>nil</code>, regardless of their type. <code>nil</code> is like null in other programming languages and is usally used to indicate that something is not set in C4Script. For example whether a variable is <code>0</code> or <code>nil</code> is not the same. It is <code>0</code> if it contains the integer value <code>0</code> and <code>nil</code> if it is not set. For functions, <code>nil</code> can be used to not specify an optional parameter (as if it was left out). For example <code>[http://docs.openclonk.org/en/sdk/script/fn/Sound.html Sound("Water",true,nil,nil,+1)]</code> plays the water sound for all players in a loop, at 100% volume (the default) while <code>Sound("Water",true,nil,0,+1)</code> plays the same sound only for player zero. Also, you can distinguish between a function with no return value (returning <code>nil</code>) and a e.g. function returning the number <code>0</code>. Regardless of if a variable <code>foo</code> is either <code>nil</code>, <code>0</code> or <code>false</code>, this statement still logs "yay": <code>if(!foo) Log("yay");</code>
	* <code>#strict</code> is not used anymore. All scripts are considered to be "#strict 2".		* <code>#strict</code> is not used anymore. All scripts are considered to be <code>#strict 2</code>.
	* As usual, some new functions and engine callbacks have been added. Refer to the documentation.		* As usual, some new functions and engine callbacks have been added. Refer to the documentation.

Newton: /* C4DT */

2010-09-15T19:39:58Z

C4DT

← Older revision		Revision as of 19:39, 15 September 2010
Line 78:		Line 78:

	The old editor.exe from Clonk Rage has been removed. C4DT is the definite successor of this old friend of the C4Script developer. A more than worthy one, actually, because C4Script development really can't get any more sophisticated than with this Eclipse plugin.		The old editor.exe from Clonk Rage has been removed. C4DT is the definite successor of this old friend of the C4Script developer. A more than worthy one, actually, because C4Script development really can't get any more sophisticated than with this Eclipse plugin.
			{{Clear}}
	[[File:Eclipse_ContentAssist.png\|600px]]		[[File:Eclipse_ContentAssist.png\|600px]]

Newton: /* New Game Content and Concepts */

2010-09-15T19:39:33Z

New Game Content and Concepts

← Older revision		Revision as of 19:39, 15 September 2010
Line 51:		Line 51:

	Since '''all game content has been created from scratch''', the many new or remade tools, weapons, items, buildings, vehicles and animals, rules, goals and environment objects must be mentioned. Apart from the objects, we are completely replacing the old graphics, sound effects and textures. Textures for example are not grayscale images anymore which are then colored in the tone of the texture but full-color textures with more variation, making the landscape look a lot better and detailed. New sound effects are collected from various free (creative commons) archives or made by ourselves.		Since '''all game content has been created from scratch''', the many new or remade tools, weapons, items, buildings, vehicles and animals, rules, goals and environment objects must be mentioned. Apart from the objects, we are completely replacing the old graphics, sound effects and textures. Textures for example are not grayscale images anymore which are then colored in the tone of the texture but full-color textures with more variation, making the landscape look a lot better and detailed. New sound effects are collected from various free (creative commons) archives or made by ourselves.
	So actually, the question should rather be, what is ''not'' new? Well, regarding the game content, nothing.
			So actually, the question should rather be, what is ''not'' new?

			Well, regarding the game content, nothing.
	However, we did not just remake the old objects, some new concepts are already visible in the game content. For example, the annoying automatic melee-fight was removed and is now replaced with various melee weapons to be used in close combat. The classic explosives which only differed in the size of their explosion are now being replaced by more specialized mining tools an weapons, such as the dynamite box.		However, we did not just remake the old objects, some new concepts are already visible in the game content. For example, the annoying automatic melee-fight was removed and is now replaced with various melee weapons to be used in close combat. The classic explosives which only differed in the size of their explosion are now being replaced by more specialized mining tools an weapons, such as the dynamite box.
	But instead of listing all the new or remade objects here, you should just play the game and see by yourself :-P.		But instead of listing all the new or remade objects here, you should just play the game and see by yourself :-P.

Newton: /* C4DT */

2010-09-15T19:37:08Z

C4DT

← Older revision		Revision as of 19:37, 15 September 2010
Line 60:		Line 60:

	==== C4DT ====		==== C4DT ====

			One tool for the clonk development has to be highlighted here: [http://wiki.openclonk.org/w/Developing_Content_with_Eclipse C4DT, the Clonk Development Tools for Eclipse]. Eclipse is an extensible open source IDE which supports a multitude of programming and script languages. Now, also C4Script:
			The C4DT plugin enables you to develop content for Clonk using the powerful Eclipse IDE. Since C4DT does not try to be a standalone IDE, it inherits many features of Eclipse and thus facilitates development a lot. Features include:

	[[File:Eclipse_ProblemsView.png\|right\|300px]]		[[File:Eclipse_ProblemsView.png\|right\|300px]]
	One tool for the clonk development has to be highlighted: Through a plugin, it is now possible to [http://wiki.openclonk.org/w/Developing_Content_with_Eclipse script and develop content with Eclipse], a very advanced and popular IDE. Since it is just a plugin and not a standalone IDE, C4Script development with Eclipse inherits many features of the IDE's original features and adds a bunch more. Thus, it facilitates development a lot. Features include:		* Syntax highlighting for C4Script, landscape.txts and INI-like files like the DefCore.txt or the Scenario.txt
	* Syntax highlighting for C4Script, landscape.txts and INI-like files like DefCore.txt		* All references to valid identifiers (variables, functions) can be turned into hyperlinks to their declaration location. This even works for text placeholders for the translation file StringTblXX.txt
	* All references to valid identifiers (variables, functions) can be turned into hyperlinks to ~~the~~ declaration location ~~them~~.		* Quickly jump to object definitions by typing the name or ID of the object
	* Quickly jump to ~~certain~~ object definitions ~~with one mouseclick~~		* Context-sensitive content assistance and parameter hints while typing(!) (see below)
	* Context-sensitive content assistance and parameter hints while typing		* Helpful auto-completion and -indention
	* ~~Intelligent~~ auto-completion and -indention		* An outline for opened script files
	* A built-in parser finds and warns about potential script errors and warnings		* A built-in parser finds and warns about potential script errors and warnings without having to start the engine(!)
	* A real debug mode for the engine: '''[http://wiki.openclonk.org/w/C4DT_Running_Scenarios ~~debug~~ scenarios] in the Eclipse debugger'''		* A real debug mode for the engine: '''[http://wiki.openclonk.org/w/C4DT_Running_Scenarios Debug scenarios]''' in the Eclipse debugger(!)

			The old editor.exe from Clonk Rage has been removed. C4DT is the definite successor of this old friend of the C4Script developer. A more than worthy one, actually, because C4Script development really can't get any more sophisticated than with this Eclipse plugin.
	[[File:Eclipse_ContentAssist.png\|600px]]		[[File:Eclipse_ContentAssist.png\|600px]]

Newton: /* C4DT */

2010-09-15T19:02:56Z

C4DT

← Older revision		Revision as of 19:02, 15 September 2010
Line 70:		Line 70:
	* A built-in parser finds and warns about potential script errors and warnings		* A built-in parser finds and warns about potential script errors and warnings
	* A real debug mode for the engine: '''[http://wiki.openclonk.org/w/C4DT_Running_Scenarios debug scenarios] in the Eclipse debugger'''		* A real debug mode for the engine: '''[http://wiki.openclonk.org/w/C4DT_Running_Scenarios debug scenarios] in the Eclipse debugger'''
	[[File:Eclipse_ContentAssist.png\|~~500px~~]]		[[File:Eclipse_ContentAssist.png\|600px]]

	==== C4Script changes ====		==== C4Script changes ====

Newton at 17:54, 15 September 2010

2010-09-15T17:54:34Z

← Older revision		Revision as of 17:54, 15 September 2010
Line 1:		Line 1:
	This article is written for all those, who know Clonk Rage and would like to know what's new in OpenClonk. Since the project went open source, quite a few new experimental features have been introduced. In this newest installment of the Clonk series, we've left behind the old shackles and created something more advanced than anything you've ever seen in Clonk.		This article is written for all those, who know Clonk Rage and would like to know what's new in OpenClonk. Since the project went open source, quite a few new experimental features have been introduced. In this newest installment of the Clonk series, we've left behind the old shackles and created something more advanced than anything you've ever seen in Clonk.

	~~Considering that OpenClonk is still work in progress, it~~ is safe to say, that with OpenClonk, we are making the biggest leap in terms of new features, changes ~~and reinvention in the history of Clonk~~ since Clonk 4.		It is safe to say, that with OpenClonk, we are making the biggest leap in terms of new features and changes since Clonk 4.

	=== General ===		=== General ===

Newton at 17:53, 15 September 2010

2010-09-15T17:53:58Z

← Older revision		Revision as of 17:53, 15 September 2010
Line 1:		Line 1:
	This article is written for all those, who know Clonk Rage and would like to know what's new in OpenClonk. Since the project went open source, quite a few new experimental features have been introduced. In this newest installment of the Clonk series, we've left behind the old shackles and created something more advanced than anything you've ever seen in Clonk.		This article is written for all those, who know Clonk Rage and would like to know what's new in OpenClonk. Since the project went open source, quite a few new experimental features have been introduced. In this newest installment of the Clonk series, we've left behind the old shackles and created something more advanced than anything you've ever seen in Clonk.

	It is safe to say, that with OpenClonk, we are making the biggest leap in terms of new features, changes and reinvention in the history of Clonk since Clonk 4.		Considering that OpenClonk is still work in progress, it is safe to say, that with OpenClonk, we are making the biggest leap in terms of new features, changes and reinvention in the history of Clonk since Clonk 4.

	=== General ===		=== General ===

Newton at 17:53, 15 September 2010

2010-09-15T17:53:13Z

← Older revision		Revision as of 17:53, 15 September 2010
Line 1:		Line 1:
	This ~~section~~ is written for all those, who know Clonk Rage and would like to know what's new in OpenClonk. Since the project went open source, quite a few new experimental features have been introduced. In this newest installment of the Clonk series, we've left behind the old shackles and created something more advanced than anything you've ever seen in Clonk.		This article is written for all those, who know Clonk Rage and would like to know what's new in OpenClonk. Since the project went open source, quite a few new experimental features have been introduced. In this newest installment of the Clonk series, we've left behind the old shackles and created something more advanced than anything you've ever seen in Clonk.

			It is safe to say, that with OpenClonk, we are making the biggest leap in terms of new features, changes and reinvention in the history of Clonk since Clonk 4.

	=== General ===		=== General ===



	New in OpenClonk is the possibility to '''zoom''' in and out. Now, the clonk can be displayed in a proper size, larger than a mouse cursor ;-). Use the scroll wheel on the mouse or F5/F6 to zoom.		New in OpenClonk is the possibility to '''zoom''' in and out. Now, the clonk can be displayed in a proper size, larger than a mouse cursor ;-). Use the scroll wheel on the mouse or F5/F6 to zoom.