Creation/Dev/GScript3 - Revision history

Stefan: /* Enable GS3 */

2013-06-16T11:33:45Z

Enable GS3

← Older revision		Revision as of 07:33, 16 June 2013
Line 7:		Line 7:
	To use GS3 you need to restart the npcserver and add the server option enablegs3=true. At the start of your script add the line		To use GS3 you need to restart the npcserver and add the server option enablegs3=true. At the start of your script add the line
	//#GS3		//#GS3

			''Warning:'' it is work-in-progress right now, we are working on improving compatibility and adding capabilities.

	===Conversion Tool===		===Conversion Tool===

2013-06-16T00:23:04Z

Interaction with GS2

← Older revision		Revision as of 20:23, 15 June 2013
Line 28:		Line 28:
	}		}
	This can be some work, but when the other object is also GS3 then it's much easier (see ''External Declarations'').		This can be some work, but when the other object is also GS3 then it's much easier (see ''External Declarations'').

			To access GS3 objects from GS2 everything stays the same, errors are reported at runtime.

	===Main changes===		===Main changes===

2013-06-16T00:21:44Z

Advantages

← Older revision		Revision as of 20:21, 15 June 2013
Line 52:		Line 52:
	* The structure of objects can be analyzed for automatic script documentation		* The structure of objects can be analyzed for automatic script documentation
	* Dependencies can be analyzed so you can know which scripts access an object or function		* Dependencies can be analyzed so you can know which scripts access an object or function
			* We can make scripts running much faster (not right now but in the future)
	* GraalScript3 can be converted to other languages and platforms, we are preparing something interesting for this to show in a few weeks		* GraalScript3 can be converted to other languages and platforms, we are preparing something interesting for this to show in a few weeks

			We are also preparing a few improvements to make GS3 more interesting, including support for getter and setter functions and private variables.

	==Language Elements==		==Language Elements==

2013-06-16T00:18:47Z

Advantages

← Older revision		Revision as of 20:18, 15 June 2013
Line 49:		Line 49:

	So we have a few advantages:		So we have a few advantages:
	- Helps to write code which is more reliable and readable		* Helps to write code which is more reliable and readable
	- The structure of objects can be analyzed for automatic script documentation		* The structure of objects can be analyzed for automatic script documentation
	- Dependencies can be analyzed so you can know which scripts access an object or function		* Dependencies can be analyzed so you can know which scripts access an object or function
	- GraalScript3 can be converted to other languages and platforms, we are preparing something interesting for this to show in a few weeks		* GraalScript3 can be converted to other languages and platforms, we are preparing something interesting for this to show in a few weeks

	==Language Elements==		==Language Elements==

2013-06-16T00:18:23Z

Advantages

← Older revision		Revision as of 20:18, 15 June 2013
Line 44:		Line 44:

	===Advantages===		===Advantages===
			Using types makes prototyping a little bit harder since you have to think about variable types and declare classes or similar to access data.

			However for bigger projects (most Graal servers fall under this category) it is very important that scripts can be understood by other scripters, have some structure and don't contain bugs which break the economy or similar. By requiring types a lot of errors can already be detected when writing the script instead of at runtime when players are using the script.

			So we have a few advantages:
			- Helps to write code which is more reliable and readable
			- The structure of objects can be analyzed for automatic script documentation
			- Dependencies can be analyzed so you can know which scripts access an object or function
			- GraalScript3 can be converted to other languages and platforms, we are preparing something interesting for this to show in a few weeks

	==Language Elements==		==Language Elements==

2013-06-16T00:09:59Z

Quick Help for Server Staff

← Older revision		Revision as of 20:09, 15 June 2013
Line 42:		Line 42:
	// Can't join here with this.join() or so!		// Can't join here with this.join() or so!
	}		}

			===Advantages===

	==Language Elements==		==Language Elements==

2013-06-16T00:09:35Z

Main changes

← Older revision		Revision as of 20:09, 15 June 2013
Line 30:		Line 30:

	===Main changes===		===Main changes===
			In GS3 you need to declare variable types, function return types and function parameter types. That way we can automatically check if you access the variable correctly or call a function with the good parameters, which means less errors.

			You also need to declare variables of an NPC (at the start of the script):
			var myvar:string;
			var myvar2:number;
			This makes it easier to understand a script and handle objects. If you need to store many dynamic variables for an NPC then you can use arrays or dictionaries.

			Joining of classes is still possible but not dynamically. So you have to put the join-call outside of any function:
			join("myclass");
			function onCreated() {
			// Can't join here with this.join() or so!
			}

	==Language Elements==		==Language Elements==

2013-06-16T00:02:24Z

Interaction with GS2

← Older revision		Revision as of 20:02, 15 June 2013
Line 22:		Line 22:
	extern class GS2NPCName extends TServerNPC {		extern class GS2NPCName extends TServerNPC {
	var money:int;		var money:int;
	function addMoney(amount:int);		function addMoney(amount:int):void;
	}		}
	extern global {		extern global {

2013-06-16T00:02:01Z

Quick Help for Server Staff

@@ Line 17: / Line 17: @@
      var NPCName:NPCName;
    };
 ===Main changes===

2013-06-15T23:58:06Z

← Older revision		Revision as of 19:58, 15 June 2013
Line 2:		Line 2:
	'''GScript3''' (also known as GS3 or GraalScript3) is the latest version of the [[Creation/Dev/GScript\|Graal's scripting language]].<br/>		'''GScript3''' (also known as GS3 or GraalScript3) is the latest version of the [[Creation/Dev/GScript\|Graal's scripting language]].<br/>
	It introduces new syntax and semantic elements, and enable new features in Web browsers.		It introduces new syntax and semantic elements, and enable new features in Web browsers.

			==Quick Help for Server Staff==
			===Enable GS3===
			To use GS3 you need to restart the npcserver and add the server option enablegs3=true. At the start of your script add the line
			//#GS3

			===Conversion Tool===
			To convert scripts from GS2 to GS3 you can use the online tool at http://graalscript3.graalonline.com/
			It can help to convert scripts and also to check for correct syntax, although things like join will not work.

			===Extern Declarations===
			Important: for accessing other objects you need to 'include' the other scripts this way (objects are automatically also member of the class of the same name):
			extern global {
			var NPCName:NPCName;
			};

			===Main changes===

	==Language Elements==		==Language Elements==
Line 33:		Line 50:
	'''Example'''		'''Example'''
	var result : int = 10;		var result : int = 10;
	result '''+=''' 20;		[[result '''+=''' 20;
	echo(result); // 30		echo(result); // 30
			]]
	====append (@) operator====		====append (@) operator====
	'''Usage'''		'''Usage'''