00zX at 22:52, 29 April 2010

2010-04-29T22:52:59Z

00zX at 22:51, 29 April 2010

2010-04-29T22:51:50Z

00zX at 22:49, 29 April 2010

2010-04-29T22:49:48Z

LiKeMiKeS: Spelling

2007-09-11T04:59:32Z

Spelling

New page

==Starting Points ==

* '''UnrealScript''' is an object-orientated programming (OOP) language created by [[Legacy:Epic Games|Epic Games]] for scripting in-game content for the [[Legacy:UnrealEngine|UnrealEngine]]. In some ways it looks and acts like Sun's Java(tm) language. The core of the unreal engine does not run in UnrealScript, but parts of game events do.

* For an overview of how the engine uses UnrealScript, see [[Legacy:Unreal Engine Core|Unreal Engine Core]].

* For introductory tutorials, see [[Legacy:UnrealScript Lessons|UnrealScript Lessons]]. Features a set of simple tutorials to get you set up, and coding your first mutators.

* Find language reference documents below (one within the Wiki), followed by more specific guides and examples.

* Start playing with the GUI in the game with no coding required using the [[Legacy:Interactive GUI|Interactive GUI]] design mode built into UT2003/4

* Stuck? See [[Legacy:Compiler Errors|Compiler Errors]], [[Legacy:Unreal Coding FAQ|Unreal Coding FAQ]] and the rest of [[:Category:Legacy Troubleshooting]]

==Official Reference Docs==

* [[Legacy:UnrealScript Language Reference|UnrealScript Language Reference]] (Tim Sweeney)

* [[Legacy:Mod Authoring|Mod Authoring]] (Brandon Reinhart) (Mainly for UT only)

* [http://udn.epicgames.com/pub/Technical/UnrealScriptReference/ UDN's UnrealScript Reference] (Unreal Developer Network – some features don't work on builds before 600)

==UDN Official Language Reference ==

Official documentation from [[udn2:UnrealScriptReference]] (udn.epicgames.com):

* [[udn2:UnrealScriptReference.html#Variables|Variables]]
** [[udn2:UnrealScriptReference.html#Simple_Variables|Simple Variables]]
*** [[udn2:UnrealScriptReference.html#Variable_specifiers|Variable Specifiers]]
** [[udn2:UnrealScriptReference.html#Arrays|Arrays]]
*** [[udn2:UnrealScriptReference.html#Dynamic_Arrays|Dynamic Arrays]]
** [[udn2:UnrealScriptReference.html#Enumerators|Enumerators]]
** [[udn2:UnrealScriptReference.html#Structs|Structs]]
** [[udn2:UnrealScriptReference.html#Object_and_actor_reference_varia|Object and Actor Reference Variables]]
** [[udn2:UnrealScriptReference.html#Class_Reference_Variables|Class Reference Variables]]
* [[udn2:UnrealScriptReference.html#Expressions|Expressions]]
* [[udn2:UnrealScriptReference.html#Functions|Functions]]
* [[udn2:UnrealScriptReference.html#Program_Structure|Program Structure]]
* [[udn2:UnrealScriptReference.html#States|States]]
* [[udn2:UnrealScriptReference.html#Language_Functionality|Language Functionality]]
** [[Legacy:Operators|Operators]]
** [[Legacy:Global Function|General Purpose Functions]]
** [[udn2:UnrealScriptReference.html#Variable_specifiers|Variable Specifiers]]
* [[udn2:UnrealScriptReference.html#Advanced_Language_Features|Advanced Language Features]]
** [[Legacy:Exec Directive|#EXEC Directive]]

'''Fyfe''': This is a work in progress, at the moment most of the above links to the UDN because it has better/more accurate description of the language functionality.
: '''''Side note:''''' can we get an icon for udn interwiki links like the one we used to have for udntech and udncontent?

'''nogginBasher''': The udn links don't work for me I get %23 instead of #. Anyway, I prefer the formatting on Tim Sweeny's [[Legacy:UnrealScript_Language_Reference|UnrealScript_Language_Reference]]. :)

----

==UnrealWiki Core Language Reference==

===Syntax===
* [[Legacy:Class Syntax|Class Syntax]]
** [[Legacy:Default Properties|Default Properties]]
** [[Legacy:Replication Block|Replication Block]]
* [[Legacy:Variable Syntax|Variable Syntax]]
** [[Legacy:Typecasting|Typecasting]]
** [[Legacy:Built-In Struct|Built-In Struct]]
* [[Legacy:Function Syntax|Function Syntax]]
** [[Legacy:Latent Function|Latent Function]]
** [[Legacy:Iterator|Iterators]]
** [[Legacy:Global Function|Global Function]]
** [[Legacy:Static Function|Static Function]]
* [[Legacy:Operators|Operators]]
* [[Legacy:Flow Syntax|Flow Syntax]]
* [[Legacy:Special UnrealScript Keywords|Special UnrealScript Keywords]]
* [[Legacy:Exec Directive|Exec Directive]]
* [[Legacy:Compiler Errors|Compiler Errors]]
* [[Legacy:UnrealScript Keywords|UnrealScript Keywords]] – All keywords in a single list

We're also working on an [[Wikipedia:EBNF]] specification of the [[Legacy:UnrealScript Grammar|UnrealScript Grammar]], but bear in mind it's fairly technical.

===Geometry===
* [[Legacy:UnrealScript Vector Maths|UnrealScript Vector Maths]]
* [[Legacy:Vector|Vector]]
* [[Legacy:Rotator|Rotator]]
* [[Legacy:Quaternion|Quaternion]]

===Objects===
* [[Legacy:Creating Actors And Objects|Creating Actors and Objects]]
* [[Legacy:Object Pool|Object Pool]]
* [[Legacy:Destroying Objects|Destroying Objects]]
* [[Legacy:Default Properties|Default Properties]]
* [[Legacy:State|State]]
* [[Legacy:Extending States|Extending States]]
* [[Legacy:Linked List|Linked List]]
* [[Legacy:Mutator Topics|Mutator Topics]]

===Playing with the GUI===
* Read up on the [[Legacy:Interactive GUI|Interactive Gui Design Mode]]
* Read the [[Legacy:GUI Overview|GUI Overview]]
* Find out all about the [[Legacy:Automated Component|relevance of the automated component]]

===Extending Core Functions===
* [[Legacy:Probe Function|Probe Function]]
* [[Legacy:Scripting Operators|Scripting Operators]]
* [[Legacy:Useful Maths Functions|Useful Maths Functions]]
* [[Legacy:Useful Mutator Functions|Useful Mutator Functions]] for UT
* [[Legacy:Official UnMath Page|Official UnMath Page]]

See also [[Legacy:Open Source|Open Source]].

==Engine==

===Classes===
* [[Legacy:Package|Package]] – Very basic introduction to UT package files, and how they're assembled (.u, .utx, .umx, .uax, .unr)

* [[Legacy:Class Tree|Class Tree]] (navigate also from [[Legacy:Object|Object]] or [[Legacy:Actor|Actor]]. To jump directly, use the search function at the foot of this page)
* [[Legacy:UnrealScript Source|UnrealScript Source]]

===How stuff works===
* [[Legacy:Taking Damage|Taking Damage]] – The effects of the TakeDamage function in the Pawn class.
* [[Legacy:Armor Damage Absorption|Armor Damage Absorption]] – How a player's inventory reduces damage.
* [[Legacy:Communication Between Objects|Communication Between Objects]]
* [[Legacy:PlayerController|PlayerController]] – An engine eyes view of the player.
* [[Legacy:How UT Weapons Work|How UT Weapons Work]]
* [[Legacy:How UT2003 Weapons Work|How UT2003 Weapons Work]]
* [[Legacy:Chain Of Events At Level Startup|Chain of Events at Level Startup]]
* [[Legacy:Chain Of Events When Spawning Actors|Chain of Events when Spawning Actors]]

===Graphics===
* [[Legacy:RotatedText|Displaying Rotated Text on a Canvas]]

===Other Things===
* [[Legacy:Localization|Localization]]
* [[Legacy:Replication|Replication]] – Everyone's "favorite". How to make actors work in network play.
* [[Legacy:Obfuscation|Obfuscation]]
* [[Legacy:Config Vars And .Ini Files|Config Vars And .Ini Files]]
* [[Legacy:InputKeyMap|Input Key Map]]
* [[Legacy:Code References|Code References]]
* [[Legacy:Compiling With UCC|Compiling With UCC]] – Compiling outside of UnrealEd. (UEd isn't the best tool for modding, anyway. :))

==Techniques==
* [[Legacy:Coding Guidelines|Coding Guidelines]] – Ideas about coding style in general
* [[Legacy:Maintaining Compatibility|Maintaining Compatibility]] – What's good and what's bad when writing a certain type of mod
* [[Legacy:Debugging Techniques|Debugging Techniques]] – What to do to find out, what's wrong
* [[Legacy:Code Optimization|Code Optimization]] – How to make your UnrealScript code run ''fast''

==UnrealScript for Mappers==

Pages that cover basics, aimed at mappers.
* [[Legacy:Create A Subclass|Create A Subclass]]
* [[Legacy:Embedding Code|Embedding Code]]
* [[Legacy:Mapping Hello World|Mapping Hello World]] – Using custom code in an embedded subclass.
* [[Legacy:InitialState|InitialState]]
* [[Legacy:Writing And Using An Embedded Mutator|Writing and Using an Embedded Mutator]]
* [[Legacy:Scripting Custom Brushbuilders|Scripting Custom Brushbuilders]]

==Scripting Utilities==
* [[Legacy:CVS|CVS]] (Concurrent Versions System)
* [[Legacy:UnCodeX|UnCodeX]]
* See [[Legacy:Application|Application]] for a full list

==Miscellaneous==
* [[Legacy:Garbage Collection|Garbage Collection]]
* [[Legacy:UnrealScript Operators And Keywords|UnrealScript Operators and Keywords]] – this is marked for either deletion or rewriting as a starter tutorial

==External Links==
* A good read: [http://mindprod.com/jgloss/unmain.html How To Write Unmaintainable Code].
* The [http://groups.yahoo.com/group/unrealscript/ UnrealScript Yahoo Group] has over 10,000 archived messages on UnrealScript topics.
* UDN's [http://udn.epicgames.com/pub/Powered/UnrealTournament2003LinksTechnical/ Unreal Tournament 2003 Coding Links] has some miscellaneous references to tutorials and fourms.

==Related Topics==
* [[:Category:Legacy Tutorial]] – automatic list of all tutorials on this site
* [[Legacy:Testing Lab|Testing Lab]]

==Discussion==

'''Wormbo:''' Something makes me feel this page needs to be refactored since it's the portal to all UnrealScript-related topics.

'''Tarquin:''' yes! Any ideas?

'''scumble:''' The page might be better split up a bit. The section named "Core" is really about basic functions in UnrealScript, a reference guide really (could be named more instructively) and "Engine" is essentially about exploring implementations in UnrealScript of more elaborate game functions. It would work nicely on a page of its own.

'''Recondite''' Maybe I'm missing something, but after trying to do some rather simple OO operations (initialize an array of complex class instances outside of a function/prior to the actor loading default props to the editor), and not finding any documentation saying this is possible...(is there an init method?)...and running into the struct by-value / lack of true inner class capability...and where is the map class... maybe it's a documentation issue, but i really don't agree with emphasizing that unrealscript is a java-style language. it is a scripting language with quite a few quirks, and doesnt seem to have a full feature set needed for OO work. but (sigh) perhaps i should write up a page to discuss the differences.

'''El Muerte:''' there's no ''init'' function that is called before the defaultproperties are set. In the defaultproperties however you can initialize arrays with complex things. But you can only use Object classes and not Actor classes. This is, for example, how the whole GUI system works. When a class instance is created the first thing done is loading the defaultproperties. After that some events are called, depending on if it's a Object or Actor (when an Object is created the Created() event will be called, for Actors the first event would be PreBeginPlay()), do your initializing there.

The map data type has no unrealscript implementation (yet), so you can't use it.

And UnrealScript is a java-style language, note the ''-style'', nobody claims unrealscript is like Java, so don't expect the same features of java within unrealscript (for that matter, Java doesn't have support for enums (not yet anyway), structures, etc.). It's just that the way classes are handled in UnrealScript can only be compared to Java, there is, afaik, no other language looks more like UnrealScript than Java. UnrealScript has all the features for the basic OO principle, sure it doesn't implement all OO principles, but afaik know there's no language that does.

----

'''xX)(Xx:''' Didn't know where to put this, so sorry if its a little off-topic, but it seemed a sensible place to ask anyway, is there any kind of limit as to how many mutators you can have, coz recently, none of the mutators that I download or create, don't show up in the choose mutator list, as i have a '''LOT''' of mutators, i am guessing this is the case, i have reached the limit as to how many mutators it is possible to have :( can anyone clarify this, or point out a soloution/fix ? thanks :)

'''Tricadex:''' The limit seems to be 250, http://www.planetunreal.com/mutation has(had, they havn't updated in a while) a contest to see if anyone could get more :)

'''El Muerte:''' there is no real limit, never has been. However pre-UT2004 having a lot of mutators slows down the game during start-up. In UT2004 the mutator info is cached. Also this is not the right place to ask, the [[Legacy:Help Desk|Help Desk]] is the right place.

----

'''Fyfe:''' A plan for refactoring. This page has turned into an overview page for coding not unrealscript, the plan in my head at the moment is to make this page an intro&/overview for unrealscript "The Programming Language". The rest should be moved out to a page covering the [[Legacy:UnrealEngine|UnrealEngine]] and a page covering Coding and/or Moding.

''note:'' most of these pages need refactored as well.

* UnrealScript Language Reference
** [[Legacy:Variable Type|Variable Type]]
*** [[Legacy:Dynamic Array|Dynamic Array]]
*** [[Legacy:Typecasting|Typecasting]]
** [[Legacy:Variable Syntax|Variable Syntax]]
** [[Legacy:Function Syntax|Function Syntax]]
*** [[Legacy:Static Function|Static Function]]
** [[Legacy:Class Syntax|Class Syntax]]
*** [[Legacy:Default Properties|Default Properties]]
*** [[Legacy:Replication Block|Replication Block]]
** [[Legacy:Operators|Operators]]
** [[Legacy:Flow Syntax|Flow Syntax]]
** [[Legacy:State|State]]
*** [[Legacy:Extending States|Extending States]]
*** [[Legacy:Latent Function|Latent Function]]
** [[Legacy:Exec Directive|Exec Directive]]
** Built-Ins – Needs a better name?
*** [[Legacy:Global Function|Global Function]]
*** [[Legacy:Built-In Struct|Built-In Struct]]
*** [[Legacy:Iterator|Iterator]] – Rename to [[Legacy:Built-In Iterators|Built-In Iterators]]?
** [[Legacy:UnrealScript Keywords|UnrealScript Keywords]]
*** [[Legacy:Special UnrealScript Keywords|Special UnrealScript Keywords]] – These should be moved into the appropriate syntax pages (eg <tt>Self</tt> and <tt>Super</tt> to [[Legacy:Class Syntax|Class Syntax]])

'''Fyfe:''' Just noticed the best solution for the refactoring of this is in the title of my plan, [[udn2:UnrealScriptReference]]. This describes the language better than any of the pages in the list above.

MythOpus: googling broken links helps find them :D

2007-07-17T21:03:45Z

googling broken links helps find them :D

Ambershee: *Marked a broken link.

2007-07-17T08:23:36Z

*Marked a broken link.

← Older revision		Revision as of 22:52, 29 April 2010
Line 1:		Line 1:
−	{{legacy page\|new=[[~~UnrealScript~~\|Unreal Script]]}}	+	{{legacy page\|new=[[UnrealScript_overview\|Unreal Script]]}}
	==Starting Points ==		==Starting Points ==

← Older revision		Revision as of 22:51, 29 April 2010
Line 1:		Line 1:
−	{{legacy page\|new=[[Unreal Script]]}}	+	{{legacy page\|new=[[UnrealScript\|Unreal Script]]}}
	==Starting Points ==		==Starting Points ==

@@ Line 1: / Line 1: @@
 ==Starting Points ==
@@ Line 21: / Line 22: @@
 * [http://udn.epicgames.com/pub/Technical/UnrealScriptReference/ UDN's UnrealScript Reference] (Unreal Developer Network &ndash; some features don't work on builds before 600)
-==UGN Official Language Reference ==
+==UDN Official Language Reference ==
 Official documentation from [[udn2:UnrealScriptReference]] (udn.epicgames.com):