Defaultproperties - Revision history

Wormbo: /* Name values */ aparently UE3 supports single quotes

2008-04-12T12:36:27Z

‎Name values: aparently UE3 supports single quotes

Wormbo: it's probably better to call it "initial value"

2008-04-12T12:32:21Z

it's probably better to call it "initial value"

Wormbo: completed content

2008-04-12T12:29:56Z

completed content

Wormbo: stub for now, will continue tomorrow

2008-04-11T21:58:03Z

stub for now, will continue tomorrow

New page

{{DISPLAYTITLE:defaultproperties}}
The '''defaultproperties''' block is a special section in an [[UnrealScript]] class source file. It can define or redefine default values for all properties declared in the class or inherited from a parent class. Like [[cpptext]] blocks, the defaultproperties block is stripped from the source when the class source is imported by the UnrealScript compiler. This means you can neither see nor specify it in the [[Source code editor]] of [[UnrealEd]] versions coming with [[Unreal Engine]] generations 1 and 2.

To edit default values of a class from within UnrealEd, go to the [[Actor Classes browser]], find and right-click the class in the tree and select "Default properties..." in the pop-up menu. A window titled "Default ''Packagename.Classname'' Properties" similar to the [[Actor Properties window]] will open and allow you to change most of the default values. As with the Actor Properties window, what exactly you are allowed to change depends on the declaration of the corresponding [[variables]].

'''Note:''' All script-editing capabilities have been removed from the Unreal Engine 3 Unreal Editor. This includes editing default values. Instead, you can create [[Archetypes]], but only for non-[[abstract]], [[placeable]] Actor classes.

==Syntax==
'''defaultproperties'''
'''{'''
''[default value]''
''[default value]''
''...''
'''}'''
The keyword ''defaultproperties'' and the braces must each be on their own line. The default values are separated by line breaks and are ''not'' regular UnrealScript code. Instead they are similar to the format of [[T3D files]].

{{stub}}

{{navbox unrealscript}}

@@ Line 82: / Line 82: @@
 The value of a name property may either be a double-quoted, non-empty string or a token that may start with a letter or digit and contain letters, digits, the underscore and the minus character. If the name starts with an underscore or minus character, you need to use the double-quoted notation. Note that the name value may not exceed 63 characters.
-The usual notation in single quotes is ''not'' supported.
+The usual notation in single quotes is not supported in Unreal Engine 1 and 2.
 ===Object values===

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:defaultproperties}}
-The '''defaultproperties''' block is a special section in an [[UnrealScript]] class source file. It can define or redefine default values for all properties declared in the class or inherited from a parent class. If a property is not mentioned in the defaultproperties block, its default value is inherited from the parent class. If a property is not mentioned in any parent class defaultproperties either, its default value is corresponding the [[null value]] of the property's [[type]].
+The '''defaultproperties''' block is a special section in an [[UnrealScript]] class source file. It can define or redefine default values for all properties declared in the class or inherited from a parent class. If a property is not mentioned in the defaultproperties block, its default value is inherited from the parent class. If a property is not mentioned in any parent class defaultproperties either, its default value is corresponding the [[initial value]] of the property's [[type]].
 Like [[cpptext]] blocks, the defaultproperties block is stripped from the source when the class source is imported by the UnrealScript compiler. This means you can neither see nor specify it in the [[Source code editor]] of [[UnrealEd]] versions coming with [[Unreal Engine]] generations 1 and 2. When exporting source scripts from UnrealEd's [[Actor Classes browser]] or with the [[BatchExportCommandlet]], a defaultproperties block is generated for each class from the current default values of all properties that differ from their default value in the parent class. These generated defaults may include values read from [[configuration files|configuration]] and [[localization files]], so make sure they don't include any sensitive data like your login password before you publish them. Also, especially in [[UT2003]] and [[UT3]] exported defaults differ greatly from the imported defaults in some areas.
@@ Line 107: / Line 107: @@
     ''member2''=''value2''
   )'''}'''
-Struct members not mentioned in the definition of the struct property value will inherit the parent class default value. If the property was declared in this class, the default member value for that struct type is inherited. If no default value for that struct member was specified in the struct type, the member type's [[null value]] is used.
+Struct members not mentioned in the definition of the struct property value will inherit the parent class default value. If the property was declared in this class, the default member value for that struct type is inherited. If no default value for that struct member was specified in the struct type, the member type's [[initial value]] is used.
 {{navbox unrealscript}}

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:defaultproperties}}
-The '''defaultproperties''' block is a special section in an [[UnrealScript]] class source file. It can define or redefine default values for all properties declared in the class or inherited from a parent class. Like [[cpptext]] blocks, the defaultproperties block is stripped from the source when the class source is imported by the UnrealScript compiler. This means you can neither see nor specify it in the [[Source code editor]] of [[UnrealEd]] versions coming with [[Unreal Engine]] generations 1 and 2.
+The '''defaultproperties''' block is a special section in an [[UnrealScript]] class source file. It can define or redefine default values for all properties declared in the class or inherited from a parent class. If a property is not mentioned in the defaultproperties block, its default value is inherited from the parent class. If a property is not mentioned in any parent class defaultproperties either, its default value is corresponding the [[null value]] of the property's [[type]].
 To edit default values of a class from within UnrealEd, go to the [[Actor Classes browser]], find and right-click the class in the tree and select "Default properties..." in the pop-up menu. A window titled "Default ''Packagename.Classname'' Properties" similar to the [[Actor Properties window]] will open and allow you to change most of the default values. As with the Actor Properties window, what exactly you are allowed to change depends on the declaration of the corresponding [[variables]].
@@ Line 6: / Line 8: @@
 '''Note:''' All script-editing capabilities have been removed from the Unreal Engine 3 Unreal Editor. This includes editing default values. Instead, you can create [[Archetypes]], but only for non-[[abstract]], [[placeable]] Actor classes.
-==Syntax==
+==General syntax==
   '''defaultproperties'''
   '''{'''
     ''...''
   '''}'''
-The keyword ''defaultproperties'' and the braces must each be on their own line. The default values are separated by line breaks and are ''not'' regular UnrealScript code. Instead they are similar to the format of [[T3D files]].
+The keyword ''defaultproperties'' and the braces must each be on their own line. Especially putting the opening brace on the same line as the keyword ''defaultproperties'' will not work! The default value definitions are separated by line breaks and are ''not'' regular UnrealScript code. They are more similar to the format of [[T3D files]]. Starting with Unreal Engine 2, the defaultproperties block may also contain [[Subobject]] definitions.
-{{stub}}
+===Struct values===
 {{navbox unrealscript}}