Lootable Component - Revision history

DeamonHunter: Update Page.

2017-12-14T10:25:42Z

Update Page.

DeamonHunter: Fix redlinks

2017-09-12T08:34:09Z

Fix redlinks

DeamonHunter: /* "lootEffect" */ Fix redlink.

2017-07-23T06:10:34Z

‎"lootEffect": Fix redlink.

DeamonHunter: Initial commit.

2017-07-20T06:37:03Z

Initial commit.

New page

[[Category:Component Modding]]
[[:Category:Component Modding]] are all optional properties that can be added to any file. Components are useful in extending the original files with even more information, such as the cost of the item or whether the block can be broken by a weapon.

On this page, we go over the Lootable component, signified by the following;
<pre>
"lootable": {
=Content=
}
</pre>
Lootable components are used to add functionality of the Lootable Tile. This component includes some aesthetic and functional changes.

= When and How to use =
Lootable component is needed whenever you want to make an Lootable tile. Specifically, an lootable component is needed whenever a [[Tile]] has it [[Tile#"tileStateKind"]] equal to "staxel.tileState.Lootable". Otherwise Lootable component will do nothing.

To start off with first, you will need to create a [[Tile]] with [[Tile#"tileStateKind"]] equal to "staxel.tileState.Lootable". Once that is done, you can add the following below the last property of the file;
<pre>
"lootable": {
"isTheft": true,
"petalRange": { "x": 100, "y": 200 },
"daysBeforeReset" : 1,
"treasure": "staxel.treasure.whatever",
"lootEffect": "staxel.effect.generic.StealPetals"
},
</pre>

These are the most useful properties to this, while there are more properties. "isTheft" is used to make the game know that this is a theft and will apply penalties to buying. "petalRange" is a Vector 2, that is "x" is the minimum value, and "y" is the maximum value in petals. "daysBeforeReset" is how many days until it resets itself. "treasure" is the [[Treasures|Treasure Pool]] that it will give the player. "lootEffect' is the [[Effects|Effect]] that is played when looting.

With that, this component is mainly complete. Check below for more properties that are useful in some situations.

= Config Options =
All config options must be inside the body of;
<pre>
"lootable": {
=Config Here=
}
</pre>

== "daysBeforeReset" ==
'''Valid options (Int): <code>A positive integer number</code>'''

'''Default Value:''' If not specified, then the default value is 1.

This is the number of days before it will reset itself.

== "isTheft" ==
'''Valid options (Bool): <code>True or False</code>'''

'''Default Value:''' If not specified, will default to false.

This is whether or not this action will count as a theft. Thieving adds penalties to buying items as the town needs to recoup the loss.

== "limitDailyUse" ==
'''Valid options (Bool): <code>True or False</code>'''

'''Default Value:''' If not specified, will default to true.

This is whether or not the amount of times this tile can be looted is limited in a single day.

== "lootEffect" ==
'''Valid options (String): <code>A string containing a code to a [[Effects|Effect]].</code>'''

'''Default Value:''' If not specified, will not play any effect when looting.

This is the effect that will play when looting.

== "nametagTranslation" ==
'''Valid options (String): <code>A string that is unique to other [[Translation]] strings.</code>'''

'''Default Value:''' If not specified, will go with the default tag.

This is for making unique name tags for any tile. This does not work when "isTheft" is active however.

== "petalRange"/"petals" ==
Both of these are connected. They look like;
<pre>
"petalRange": {"x" 0.0, "y" 10.0}
or
"petals": 10
</pre>

"petalRange" is used to define a random range. (From the value specified in "x", to the value specified in "y"). While "petals" is used to specify an exact value.

It is recommended to always use "petalRange" instead of "petals" however.

== "singleUse" ==
'''Valid options (Bool): <code>True or False</code>'''

'''Default Value:''' If not specified, will default to false.

This is whether or not this tile only has one use.

== "treasure" ==
'''Valid options (String): <code>A string containing the code to a [[Treasures|Treasure]] pool.</code>'''

'''Default Value:''' If not specified, will not spawn any items.

This is the treasure pool it will use in order to give out items to the player.

== "usedTile" ==
'''Valid options (String): <code>A string containing the code to a [[Tile]] pool.</code>'''

'''Default Value:''' If not specified, will spawn an air tile.

This is the tile that this tile will get replaced with when looted. This will only happen if "singleUse" is true.

@@ Line 24: / Line 24: @@
 </pre>
-These are the most useful properties to this, while there are more properties. "isTheft" is used to make the game know that this is a theft and will apply penalties to buying. "petalRange" is a Vector 2, that is "x" is the minimum value, and "y" is the maximum value in petals. "daysBeforeReset" is how many days until it resets itself. "treasure" is the [[Treasure Pools|Treasure Pool]] that it will give the player. "lootEffect' is the [[Effects|Effect]] that is played when looting.
+These are the most useful properties to this, while there are more properties. [[#"isTheft"]] is used to make the game know that this is a theft and will apply penalties to buying. [[#"petalRange"/"petals"|"petalRange"]] is a Vector 2, that is "x" is the minimum value, and "y" is the maximum value in petals. [[#"daysBeforeReset"]] is how many days until it resets itself. [[#"treasure"]] is the [[Treasure Pools|Treasure Pool]] that it will give the player. [[#"lootEffect"]] is the [[Effects|Effect]] that is played when looting.
 With that, this component is mainly complete. Check below for more properties that are useful in some situations.
@@ Line 38: / Line 38: @@
 == "daysBeforeReset" ==
-'''Valid options (Int): <code>A positive integer number</code>'''
+'''Valid options ([[Modding_Key_Terms#Integer|Integer]]): <code>A positive integer number</code>'''
 '''Default Value:''' If not specified, then the default value is 1.
@@ Line 45: / Line 45: @@
 This is the number of days before it will reset itself.
 == "isTheft" ==
-'''Valid options (Bool): <code>True or False</code>'''
+'''Valid options ([[Modding_Key_Terms#Bool|Bool]]): <code>True or False</code>'''
 '''Default Value:''' If not specified, will default to false.
@@ Line 56: / Line 64: @@
 == "limitDailyUse" ==
-'''Valid options (Bool): <code>True or False</code>'''
+'''Valid options ([[Modding_Key_Terms#Bool|Bool]]): <code>True or False</code>'''
 '''Default Value:''' If not specified, will default to true.
@@ Line 65: / Line 73: @@
 == "lootEffect" ==
-'''Valid options (String): <code>A string containing a code to a [[Effect]].</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A string containing a code to a [[Effect]].</code>'''
 '''Default Value:''' If not specified, will not play any effect when looting.
@@ Line 73: / Line 81: @@
 == "nametagTranslation" ==
-'''Valid options (String): <code>A string that is unique to other [[Translation]] strings.</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A string that is unique to other [[Translation]] strings.</code>'''
 '''Default Value:''' If not specified, will go with the default tag.
@@ Line 93: / Line 101: @@
 It is recommended to always use "petalRange" instead of "petals" however.
 == "singleUse" ==
-'''Valid options (Bool): <code>True or False</code>'''
+'''Valid options ([[Modding_Key_Terms#Bool|Bool]]): <code>True or False</code>'''
 '''Default Value:''' If not specified, will default to false.
@@ Line 104: / Line 121: @@
 == "treasure" ==
-'''Valid options (String): <code>A string containing the code to a [[Treasure Pools|Treasure Pool]].</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A string containing the code to a [[Treasure Pools|Treasure Pool]].</code>'''
 '''Default Value:''' If not specified, will not spawn any items.
@@ Line 113: / Line 130: @@
 == "usedTile" ==
-'''Valid options (String): <code>A string containing the code to a [[Tile]] pool.</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A string containing the code to a [[Tile]] pool.</code>'''
 '''Default Value:''' If not specified, will spawn an air tile.