Villager Jobs - Revision history

DeamonHunter: Updated to new section

2017-12-05T10:04:25Z

Updated to new section

DeamonHunter: Oops.

2017-11-21T05:01:36Z

Oops.

DeamonHunter: Fix redLinks.

2017-11-21T04:00:19Z

Fix redLinks.

DeamonHunter: Update formatting and added some missing information.

2017-11-21T03:34:48Z

Update formatting and added some missing information.

DeamonHunter: Updated to new category.

2017-07-08T06:53:54Z

Updated to new category.

DeamonHunter: Small fixes.

2017-06-24T07:19:53Z

Small fixes.

DeamonHunter: Initial commit.

2017-06-24T07:07:33Z

Initial commit.

New page

[[Category:Modding]][[Category:VillagerModding]]
[[:Category:VillagerModding|Villagers]] in Staxel are fairly moddable, with many parts being able to be switched out, and new creations can add to the pool.

This page is about Villager Jobs, these are found in .villagerjob files and contains information for;

* The dialogues specific for the job
* Starting and ending times
* Tools and tiles that should be used for the job
* The [[Totems|totem]] that signifies the workplace

The file specifies the entire set of information needed for a villager to do their job. Villager jobs help with locking progression of items and help bring more life to the world. Most workplaces have to be built by the player so the world can quickly start to become more built over time.

That being said, a villager is not forced to have a job, so this file contains no mandatory information for a villager.

= Creating a *.villagerjob file =
Creating a villager job file is mostly specifying other files that might be necessary for the job. This file is then used in a [[Villager NPCs|.villagernpc]] villager files. The file commonly looks like:
<pre>
{
"code" : "staxel.village.job.Barkeep",
"startingTime" : 0,
"endingTime" : 1440,
"workPlace" : "staxel.totem.workplace.Tavern",
"primaryDialogue" : "staxel.village.dialogue.Barkeep",
"dialoguePools" : [
"staxel.dialoguePool.Barkeep"
],
"jobItems" : [
{
"code" : "staxel.item.tool.Net"
}
],
"workPlaceTools" : [
"staxel.tileObject.shop.CashRegister"
],
"weightedScripts" : [
{
"script" : "staxel.script.StandAroundIdle",
"weight" : 25.0
}
]
}
</pre>

As with many other villager files, most properties just contain a code that points towards another file of the correct type. The first two properties that stand out are the start time and the end time. This is the amount of time in seconds from the start of the day change transition. The second would be the job items property. This contains a list of items which are to be spawned. There is more information on how to create these [[Spawned Items|on this page]] (Currently not made). The third and final is "workPlaceTools", which specifies the tiles/tile objects in a workplace that the villager can "interact" with. (Stand around.) With all of these properties out of the way, you now have a working villager job.

= Config Options =

== "code" ==
'''Valid options (String): <code>A unique string which job 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 job this file will be referring to.

== "dialoguePools" ==
'''Valid options (List of strings): <code>A list of strings that each point to a [[Dialogue Pools|Dialogue Pool]]</code>'''

'''Default Value:''' Can be omitted.

This is the list of dialogue pools that will be used while the villager is working. All dialogue pools in this section should have the "Job" type.

=== "primaryDialogue" ===
'''Valid options (String): <code>A string that points to a [[Dialogue Pools|Dialogue Pool]]</code>'''

'''Default Value:''' Can be omitted. Is not forced to say any dialogue first if omitted.

This specifies a dialogue which must be played first before all other dialogues. Useful for when something should be done first before all else.

=== "jobItems" ===
'''Valid options (List of Blobs (Objects)): <code>A list of [[Spawned Items]]. In most cases these blobs can just contain a Code of an [[Item]] file</code>'''

'''Default Value:''' Can be omitted.

This contains a list of items that the villager will hold in their hand. In most cases an items code can be used, however special cases arise for clothing and tiles. (To be elaborated later.)

== "startingTime"/"endingTime" ==
'''Valid options (Int): <code>An integer which is between 0-1440 (Start and End of the day)</code>'''

'''Default Value:''' No default value. Must be specified.

The points to the time in which the villager will start/end their job. These times are specified in seconds after the day has been started. In terms of what it actually does, it changes dialogues to the job ones specified above and it also changes the scripts (how the villager behaves) to the ones specified.

== "weightedScripts" ==
'''Valid options (List of blobs(items)): <code>A list of 2 property blobs.</code>'''

'''Default Value:''' Can be omitted.

This is a list of weighted scripts. These scripts involve how the villager should act, and the weight specifies how likely the particular script will be gotten compared to the others. These blobs look like;

<pre>
{
"script": "staxel.script.StandAroundIdle",
"weight": 25.0
}
</pre>

== "workplace" ===
'''Valid options (String): <code>A string which points to a [[Totem|totem's code]].</code>'''

'''Default Value:''' Can be omitted. Omitting this means that the villager has no workplace.

This is the totem which is specified as the workplace for the villager. If one exists in the village, then the villager can use this workplace. If one doesn't exist, then the villager will end up using the dialogue specified by [[#"workPlaceMissingPools"]] instead of their normal job dialogue.

== "workPlaceMissingPools" ==
'''Valid options (List of strings): <code>A list of strings that each point to a [[Dialogue Pools|Dialogue Pool]]</code>'''

'''Default Value:''' Can be omitted.

This is the list of dialogue pools that will be used if the villager is missing their workplace. All dialogue pools in this section should have the "WorkPlaceMissing" type.

== "workPlaceTools" ==
'''Valid options (List of strings): <code>A list of strings that each point to a [[Tiles|Tile]]</code>'''

'''Default Value:''' Can be omitted.

This is the list of tiles in which the villager will "interact" with if they are in the workplace. Interacting with mostly involves standing nearby at this point in time.

@@ Line 44: / Line 44: @@
 As with many other villager files, most properties just contain a code that points towards another file of the correct type. The first two properties that stand out are the start time and the end time. This is the amount of time in seconds from the start of the day change transition. The second would be the job items property. This contains a list of items which are to be spawned. There is more information on how to create these
-at [[[Items#Universal Spawning Rules]] (Currently not made). The third and final is "workPlaceTools", which specifies the tiles/tile objects in a workplace that the villager can "interact" with. (Stand around.) With all of these properties out of the way, you now have a working villager job.
+at [[[Items#How to Spawn an Item]] (Currently not made). The third and final is "workPlaceTools", which specifies the tiles/tile objects in a workplace that the villager can "interact" with. (Stand around.) With all of these properties out of the way, you now have a working villager job.
@@ Line 77: / Line 77: @@
 == "jobItems" ==
-'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#Blob|Blobs]]): <code>A list of blobs containing [[Items]]. See [[Items#Universal Spawning Rules]] for more details.</code>'''
+'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#Blob|Blobs]]): <code>A list of blobs containing [[Items]]. See [[Items#How to Spawn an Item]] for more details.</code>'''
 '''Default Value:''' If not specified, will not hold any items during the job.

@@ Line 77: / Line 77: @@
 == "jobItems" ==
-'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#Blobs|Blobs]]): <code>A list of blobs containing [[Items]]. See [[Items#Universal Spawning Rules]] for more details.</code>'''
+'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#Blob|Blobs]]): <code>A list of blobs containing [[Items]]. See [[Items#Universal Spawning Rules]] for more details.</code>'''
 '''Default Value:''' If not specified, will not hold any items during the job.

@@ Line 43: / Line 43: @@
 </pre>
-As with many other villager files, most properties just contain a code that points towards another file of the correct type. The first two properties that stand out are the start time and the end time. This is the amount of time in seconds from the start of the day change transition. The second would be the job items property. This contains a list of items which are to be spawned. There is more information on how to create these [[Spawned Items|on this page]] (Currently not made). The third and final is "workPlaceTools", which specifies the tiles/tile objects in a workplace that the villager can "interact" with. (Stand around.) With all of these properties out of the way, you now have a working villager job.
+As with many other villager files, most properties just contain a code that points towards another file of the correct type. The first two properties that stand out are the start time and the end time. This is the amount of time in seconds from the start of the day change transition. The second would be the job items property. This contains a list of items which are to be spawned. There is more information on how to create these
@@ Line 122: / Line 123: @@
 == "workplace" ==
-'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A string which points to a [[Totem|totem's code]].</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A string which points to a [[Totems|totem's code]].</code>'''
 '''Default Value:''' If not specified, the villager will not have a workplace, and will just wander.
@@ Line 149: / Line 150: @@
 == "workPlaceTools" ==
-'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#String|Strings]])): <code>A list of strings that each point to a [[Tiles|Tile]]</code>'''
+'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#String|Strings]])): <code>A list of strings that each point to a [[Tile]]</code>'''
 '''Default Value:''' If not specified, will not stand around certain tiles in the workplace.

@@ Line 49: / Line 49: @@
 == "code" ==
-'''Valid options (String): <code>A unique string which job what this object is.</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A unique string which job this object is.</code>'''
 '''Default Value:''' No default value is specified. Always need to provide your own.
@@ Line 58: / Line 58: @@
 == "dialoguePools" ==
-'''Valid options (List of strings): <code>A list of strings that each point to a [[Dialogue Pools|Dialogue Pool]]</code>'''
+'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#String|Strings]]): <code>A list of strings that each point to a [[Dialogue Pools|Dialogue Pool]].</code>'''
-'''Default Value:''' Can be omitted.
+'''Default Value:''' If not specified, will rely on the villagers normal dialogue.
@@ Line 67: / Line 67: @@
 == "primaryDialogue" ==
-'''Valid options (String): <code>A string that points to a [[Dialogue]]</code>'''
+'''Valid options ([[Modding_Key_Terms#String|String]]): <code>A string that points to a [[Dialogue]].</code>'''
-'''Default Value:''' Can be omitted. Is not forced to say any dialogue first if omitted.
+'''Default Value:''' If not specified, will not force a certain dialogue to appear first. (While working.)
@@ Line 76: / Line 76: @@
 == "jobItems" ==
-'''Valid options (List of Blobs (Objects)): <code>A list of [[Spawned Items]]. In most cases these blobs can just contain a Code of an [[Item]] file</code>'''
+'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#Blobs|Blobs]]): <code>A list of blobs containing [[Items]]. See [[Items#Universal Spawning Rules]] for more details.</code>'''
-'''Default Value:''' Can be omitted.
+'''Default Value:''' If not specified, will not hold any items during the job.
-This contains a list of items that the villager will hold in their hand. In most cases an items code can be used, however special cases arise for clothing and tiles. (To be elaborated later.)
+This contains a list of items that the villager will hold in their hand. Any valid item can be used.
 == "startingTime"/"endingTime" ==
-'''Valid options (Int): <code>An integer which is between 0-1440 (Start and End of the day)</code>'''
+'''Valid options ([[Modding_Key_Terms#Integer|Integer]]): <code>An integer which is between 0-1440. (Start and End of the day)</code>'''
-'''Default Value:''' No default value. Must be specified.
+'''Default Value:''' No default value is specified. Always need to provide your own.
@@ Line 94: / Line 94: @@
 == "weightedScripts" ==
-'''Valid options (List of blobs(items)): <code>A list of 2 property blobs.</code>'''
+This is a [[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#Blobs|Blobs]] that contain properties for weighting scripts. These scripts involve how the villager should act, and the weight specifies how likely the particular script will be gotten compared to the others. These blobs look like;
-−
-'''Default Value:''' Can be omitted.
-−
-−
-This is a list of weighted scripts. These scripts involve how the villager should act, and the weight specifies how likely the particular script will be gotten compared to the others. These blobs look like;
 <pre>
@@ Line 108: / Line 103: @@
 </pre>
-== "workplace" ===
+'''Default Value:''' No default value is specified. Always need to provide your own.
-'''Valid options (String): <code>A string which points to a [[Totem|totem's code]].</code>'''
-'''Default Value:''' Can be omitted. Omitting this means that the villager has no workplace.
 This is the totem which is specified as the workplace for the villager. If one exists in the village, then the villager can use this workplace. If one doesn't exist, then the villager will end up using the dialogue specified by [[#"workPlaceMissingPools"]] instead of their normal job dialogue.
 == "workPlaceMissingPools" ==
-'''Valid options (List of strings): <code>A list of strings that each point to a [[Dialogue Pools|Dialogue Pool]]</code>'''
+'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#String|Strings]]): <code>A list of strings that each point to a [[Dialogue Pools|Dialogue Pool]].</code>'''
-'''Default Value:''' Can be omitted.
+'''Default Value:''' If not specified, will not play any dialogue concerning missing their workplace.
@@ Line 128: / Line 149: @@
 == "workPlaceTools" ==
-'''Valid options (List of strings): <code>A list of strings that each point to a [[Tiles|Tile]]</code>'''
+'''Valid options ([[Modding_Key_Terms#List|List]] of [[Modding_Key_Terms#String|Strings]])): <code>A list of strings that each point to a [[Tiles|Tile]]</code>'''
-'''Default Value:''' Can be omitted.
+'''Default Value:''' If not specified, will not stand around certain tiles in the workplace.
 This is the list of tiles in which the villager will "interact" with if they are in the workplace. Interacting with mostly involves standing nearby at this point in time.

@@ Line 1: / Line 1: @@
-[[Category:Modding]][[Category:VillagerModding]]
+[[Category:Modding]][[Category:Villager Modding]]
-[[:Category:VillagerModding|Villagers]] in Staxel are fairly moddable, with many parts being able to be switched out, and new creations can add to the pool.
+[[:Category:Villager Modding|Villagers]] in Staxel are fairly moddable, with many parts being able to be switched out, and new creations can add to the pool.
 This page is about Villager Jobs, these are found in .villagerjob files and contains information for;