Body Type - Revision history

DeamonHunter: /* Config Options */

2017-10-03T11:58:50Z

‎Config Options

DeamonHunter: A little more to the intro.

2017-05-31T10:15:34Z

A little more to the intro.

DeamonHunter: Initial commit.

2017-05-31T10:14:04Z

Initial commit.

New page

[[Category:Modding]]
In Staxel, *.bodytype files are used to specify how something should move, and the various properties surrounding this.

= Creating a *.bodytype file =

A *.bodytype file mostly contains properties which specify certain characteristics of how it should move, though it does contain references to [[Bone Animations]]. The following is a basic file that is used for Staxel's player models.
<pre>
{
"code" : "staxel.bodyType.HumanoidFemale",
"shoulderHeight" : 1.34375,
"bodyHeight" : 2.125,
"bodyRadius" : 0.65625,
"riserRadius" : 0.46875,
"riserHeight" : 1.140625,
"tposeEmote" : "tpose",
"boneAnimations" : "avatar",
"centerBias" : {
"x" : 0.0,
"y" : 0.0,
"z" : -0.5
},
"layers" : [
"Torso", "Head",
"Shoulder_Right", "UpperArm_Right", "LowerArm_Right", "Hand_Right", "Item_Right",
"Shoulder_Left", "UpperArm_Left", "LowerArm_Left", "Hand_Left", "Item_Left",
"Thigh_Right", "UpperLeg_Right", "LowerLeg_Right",
"Thigh_Left", "UpperLeg_Left", "LowerLeg_Left"
]
}
</pre>

These properties are explained below. With a file like this, it can then be used in a species file to define how they move.

= Config Options =
== "code" ==
'''Valid options (String): <code>A unique string which species what this object is.</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

A string containing the code of the item the blob will be referring to.

== "shoulderHeight" ==
'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This defines how high the shoulders are in the model. This is for things such as camera position etc.

== "bodyHeight" ==
'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This defines the total height of the model from the centre. This is for things such as collision with objects and other players.

== "bodyRadius" ==
'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This defines the total radius of the model from the centre. This essentially allows the model to have a capsule collision box. This is for things such as collision with objects and other players.

== "riserHeight" ==
'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This defines the total height of the riser collision. The riser defines the collision with moving up and down objects like stairs. (Possible wrong.)

== "riserRadius" ==
'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This defines the total radius of the rise. The riser defines the collision with moving up and down objects like stairs. (Possible wrong.)

== "boneAnimations" ==
'''Valid options (String): <code>Any valid string that leads to an [[Bone Animation]].</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This provides the actual animation data to the body type. These animations are used to move models for things that implement Body Type.

== "tposeEmote" ==
'''Valid options (String): <code>Any valid string that leads to an Bone Animation's timelines code. This timeline must be present in the specified Bone Animation</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This provides the default animation that the body type should use when no other information is avaliable. In most cases this is the "T-Pose" animation.

== "centerBias" ==
'''Valid options (Vector3): <code>{"x": 0.0, "y": 0.0, "z":0.0}</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This provides the information of how much should the model be off centre compared to the body type. Most commonly this is used to make sure the model lines up with the animations.

== "layers" ==
'''Valid options (List of strings): <code>A list of names for the layers to be used.</code>'''

'''Default Value:''' No default value is specified. Always need to provide your own.

This is a list of all layer names the animation has, or therefore any implementing model should have.

← Older revision		Revision as of 10:15, 31 May 2017
Line 1:		Line 1:
	[[Category:Modding]]		[[Category:Modding]]
−	In Staxel, *.bodytype files are used to specify how something should move, and the various properties surrounding this.	+	In Staxel, *.bodytype files are used to specify how something should move, and the various properties surrounding this. In particular, these files specify how the animations should link up to the model, as well as specifying collision with other objects.

@@ Line 36: / Line 36: @@
 = Config Options =
 == "code" ==
-'''Valid options (String): <code>A unique string which species what this object is.</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A unique string which identifies what Body Type this is.</code>'''
 '''Default Value:''' No default value is specified. Always need to provide your own.
-A string containing the code of the item the blob will be referring to.
+This option is required to uniquely identify any Body Type. This string '''must''' be unique to all other codes, but does not have any other requirements.
-== "shoulderHeight" ==
+== "bodyHeight" ==
-'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''
+'''Valid options ([[Modding_Key_Terms#Float|Float]]): <code>A positive decimal number. A value of 1 is a single block high.</code>'''
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This defines how high the shoulders are in the model. This is for things such as camera position etc.
+This defines the total height of the model from the centre. This is for things such as collision with objects and other players.
-== "bodyHeight" ==
+== "bodyRadius" ==
-'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''
+'''Valid options ([[Modding_Key_Terms#Float|Float]]): <code>A positive decimal number. A value of 1 is a single block wide.</code>'''
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This defines the total height of the model from the centre. This is for things such as collision with objects and other players.
+This defines the total radius of the model from the centre. This essentially allows the model to have a capsule collision box. This is for things such as collision with objects and other players.
-== "bodyRadius" ==
+== "boneAnimations" ==
-'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>Any valid string that leads to an [[Bone Animation]].</code>'''
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This defines the total radius of the model from the centre. This essentially allows the model to have a capsule collision box. This is for things such as collision with objects and other players.
+This provides the actual animation data to the body type. These animations are used to move models for things that implement Body Type.
-== "riserHeight" ==
+== "centerBias" ==
-'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''
+'''Valid options ([[Modding_Key_Terms#Vector 3|Vector 3]] - [[Modding_Key_Terms#Float|Float]]): <code>{ "x": 0, "y": 0, "z": 0 }</code>'''
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This defines the total height of the riser collision. The riser defines the collision with moving up and down objects like stairs. (Possible wrong.)
+This provides the information of how much should the model be off centre compared to the body type. Most commonly this is used to make sure the model lines up with the animations.
-== "riserRadius" ==
+== "layers" ==
-'''Valid options (Float): <code>A decimal number. A value of 1 is a single block high</code>'''
+'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#String|Strings]]): <code>A list of valid strings. These need to correspond to layers.</code>'''
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This defines the total radius of the rise. The riser defines the collision with moving up and down objects like stairs. (Possible wrong.)
+This is a list of all layer names the animation has, or therefore any implementing model should have.
-== "boneAnimations" ==
-'''Valid options (String): <code>Any valid string that leads to an [[Bone Animation]].</code>'''
+== "riserHeight" ==
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This provides the actual animation data to the body type. These animations are used to move models for things that implement Body Type.
+This defines the total height of the riser collision. The riser defines the collision with moving up and down objects like stairs.
-== "tposeEmote" ==
+== "riserRadius" ==
-'''Valid options (String): <code>Any valid string that leads to an Bone Animation's timelines code. This timeline must be present in the specified Bone Animation</code>'''
+'''Valid options ([[Modding_Key_Terms#Float|Float]]): <code>A positive decimal number. A value of 1 is a single block wide.</code>'''
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This provides the default animation that the body type should use when no other information is avaliable. In most cases this is the "T-Pose" animation.
+This defines the total radius of the rise. The riser defines the collision with moving up and down objects like stairs.
-== "centerBias" ==
-'''Valid options (Vector3): <code>{"x": 0.0, "y": 0.0, "z":0.0}</code>'''
+== "shoulderHeight" ==
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This provides the information of how much should the model be off centre compared to the body type. Most commonly this is used to make sure the model lines up with the animations.
+This defines how high the shoulders are in the model. This is for things such as camera position etc.
-== "layers" ==
-'''Valid options (List of strings): <code>A list of names for the layers to be used.</code>'''
+== "topHeadOffset" ==
 '''Default Value:''' No default value is specified. Always need to provide your own.
-This is a list of all layer names the animation has, or therefore any implementing model should have.
+This is the offset of the head compared to the model. Used to position Expressions that Animals and NPC's play.