v50 Steam/Premium information for editors
- v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
- Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.
Editing Advanced Entity Position Mechanics
Jump to navigation
Jump to search
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
If you are creating a redirect to the current version's page, do not use any namespace. For example: use #REDIRECT [[Cat]], not #REDIRECT [[Main:Cat]] or #REDIRECT [[cv:Cat]]. See DF:Versions for more information.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
{{Quality|Fine}} | {{Quality|Fine}} | ||
{{Modding}} | {{Modding}} | ||
+ | {{stub}} | ||
= Introduction = | = Introduction = | ||
+ | |||
+ | <span style="color:red"> | ||
+ | '''this is a draft. please let me finish it. joostheger.'''</span> | ||
[http://www.bay12forums.com/smf/index.php?topic=182239.0 Discussion thread on the forum] | [http://www.bay12forums.com/smf/index.php?topic=182239.0 Discussion thread on the forum] | ||
− | This article is the result of an investigation into the mechanisms involved in entity positions. It can be useful for modders or advanced players to understand how this part of | + | This article is the result of an investigation into the mechanisms involved in entity positions. It can be useful for modders or advanced players to understand how this part of Dwarf Fortress works. |
==What is an entity?== | ==What is an entity?== | ||
Line 17: | Line 21: | ||
There are two basic types of positions that are customizable: '''civ(ilization)''' level and '''site level'''. Positions with the tag [SITE] are at site level, positions without the tag [SITE] are at 'civ level'. These two types of nobles can be considered '''loosely related systems'''. There are a few places where they can interact with each other. | There are two basic types of positions that are customizable: '''civ(ilization)''' level and '''site level'''. Positions with the tag [SITE] are at site level, positions without the tag [SITE] are at 'civ level'. These two types of nobles can be considered '''loosely related systems'''. There are a few places where they can interact with each other. | ||
− | + | Citizen-level positions are in charge of the civilization as a whole, managing national trade, laws, and wars. These are, for example, the vanilla [[monarch]], [[princes]], [[diplomat]] and [[general]]. | |
'''LAND_HOLDERS''' nobles are also positions at civ-level. These units are members of the national government, but have gained hold over some land or site. Once they do, they move to that place, but their position is still regarded as a civ-level position. | '''LAND_HOLDERS''' nobles are also positions at civ-level. These units are members of the national government, but have gained hold over some land or site. Once they do, they move to that place, but their position is still regarded as a civ-level position. | ||
Line 23: | Line 27: | ||
Site-level position holders are members of a site government (subsidiary to the civilization), and manage local affairs in that location. These are, for example, the [[mayor]], the [[sheriff]] and the [[broker]]. | Site-level position holders are members of a site government (subsidiary to the civilization), and manage local affairs in that location. These are, for example, the [[mayor]], the [[sheriff]] and the [[broker]]. | ||
==Table of interaction between different position-levels== | ==Table of interaction between different position-levels== | ||
− | In this table, the possible interactions between different position levels are | + | In this table, the possible interactions between different position levels are summerized. |
The header row shows the positions defining the tokens. | The header row shows the positions defining the tokens. | ||
− | The left | + | The left colllumn shows the position type that is referred. |
Example: | Example: | ||
{| {{prettytable}} | {| {{prettytable}} | ||
Line 40: | Line 44: | ||
* <span style="color:blue">Possible in mods</span></br> | * <span style="color:blue">Possible in mods</span></br> | ||
* <span style="color:red">Not possible</span></br> | * <span style="color:red">Not possible</span></br> | ||
− | * <span style="color:orange">possible to some | + | * <span style="color:orange">possible to some extend.</span></br> |
* <span style="color:gray">not yet fully investigated.</span></br> | * <span style="color:gray">not yet fully investigated.</span></br> | ||
{| {{prettytable}} | {| {{prettytable}} | ||
Line 93: | Line 97: | ||
Nobles from your civilization can come to live at your fortress. This happens in vanilla with landholders such as [[Baron]], [[Count]] and [[Duke]], with the Monarch, but sometimes also with non-landed LAND_HOLDERS. | Nobles from your civilization can come to live at your fortress. This happens in vanilla with landholders such as [[Baron]], [[Count]] and [[Duke]], with the Monarch, but sometimes also with non-landed LAND_HOLDERS. | ||
− | When a civ-level noble becomes a citizen at your location, | + | When a civ-level noble becomes a citizen at your location, his position is shown among the site-level positions in your [[nobles screen]]. They appears to function as a site-level noble. They may have demands, mandates, squads and the like. They can appoint nobles at the site-level. |
If they have certain RESPONSIBILITY's, they do the tasks that go with them. | If they have certain RESPONSIBILITY's, they do the tasks that go with them. | ||
=General= | =General= | ||
− | ==Fortress mode, world-gen and their differences== | + | ==Fortress-mode, world-gen and their differences== |
Their are a few differences in how positions function, between fortress-mode (normal play-mode) and the world generation (world-gen). | Their are a few differences in how positions function, between fortress-mode (normal play-mode) and the world generation (world-gen). | ||
− | In '''fortress mode''', the player has some control over the appointment of nobles, limited by elections, automatic filled-in positions and succession rules. Pre-fortress mode, which is | + | In '''fortress-mode''', the player has some control over the appointment of nobles, limited by elections, automatic filled-in positions and succession rules. Pre-fortress mode, which is refered to as '''world-gen''', the game will always attempt to assign nobles whenever possible. It is subjected to the same rules as in fortress-mode, but there are some exceptions. In '''World Automation''', which is the thing that happens in the world while you play fortress mode, it seems as if the same rules are applied as fortress mode. |
− | A difference between | + | A difference between Player-fortress-mode and world-gen, is causes by visibility (see below). Positions that are not visible by the player and thus not available for assignment, will be available in world-gen and will thus be automatically assigned. |
In fortress mode, a position that is both ELECTED and APPOINTED_BY, cannot be appointed by the player and is also not elected, and can thus not be filled. But in world-gen sites however, these positions are automatically filled. | In fortress mode, a position that is both ELECTED and APPOINTED_BY, cannot be appointed by the player and is also not elected, and can thus not be filled. But in world-gen sites however, these positions are automatically filled. | ||
Line 109: | Line 113: | ||
Positions with AS_NEEDED are almost never created and filled in world-gen (depending on its RESPONSIBILITY's), but can always be used in player mode. | Positions with AS_NEEDED are almost never created and filled in world-gen (depending on its RESPONSIBILITY's), but can always be used in player mode. | ||
− | A | + | A positions can in fortress mode be filled by the same unit. A unit can gain multiple positions in fortess-mode, for example because of [[elections]]. This will not happen in world-gen mode: a unit can only have one position. See also remarks on 'embark' and 'Loosing a position'. |
In world-gen, SUCCESSION between civ-levels en SITE-levels may happen. This will not happen in fortress-mode, or even off-site in World Automation. | In world-gen, SUCCESSION between civ-levels en SITE-levels may happen. This will not happen in fortress-mode, or even off-site in World Automation. | ||
Line 118: | Line 122: | ||
A unit can hold multiple positions in its civilisation OR site-entity, however this does not happen in world-gen. Only at player-managed sites units can be holding multiple positions at once. (It is probably not possible for a unit to hold a position in two different civilisations or two different sites. ) | A unit can hold multiple positions in its civilisation OR site-entity, however this does not happen in world-gen. Only at player-managed sites units can be holding multiple positions at once. (It is probably not possible for a unit to hold a position in two different civilisations or two different sites. ) | ||
− | In world-gen, if there are | + | In world-gen, if there are to many positions to be filled, they simply stay empty until more units are available. |
− | In world-gen, a unit at a site might | + | In world-gen, a unit at a site might inherrit a civ-level position and still remains a member of the local goverment. When this happens however, they move to the capital. |
− | In world-gen, if a unit gains a new position, either | + | In world-gen, if a unit gains a new position, either inherrited or otherwise, it drops the previous one. If a unit assumes a civ-position in fortress mode, it leaves the current position. |
If a unit holds the same (site-)position multiple times, it has no additional effect. | If a unit holds the same (site-)position multiple times, it has no additional effect. | ||
− | If a unit | + | If a unit holdes multiple different positions of the same entity, he has all those positions responsibilities and properties stacked up. It is presumable that the demands for those combined positions are determined by the highest. |
A unit holding a position with a succession-token CAN be assigned another position with a (different) succession-token. | A unit holding a position with a succession-token CAN be assigned another position with a (different) succession-token. | ||
Line 132: | Line 136: | ||
A unit holding a position with a squad-position cannot hold another squad-position. It is dropped from the first, when it gets its second assigned. | A unit holding a position with a squad-position cannot hold another squad-position. It is dropped from the first, when it gets its second assigned. | ||
A unit holding a position with a succession-token cannot be assigned to a squad-position. The unit is simply not available. It works the other way around, though. | A unit holding a position with a succession-token cannot be assigned to a squad-position. The unit is simply not available. It works the other way around, though. | ||
− | |||
=RESPONSIBILITY= | =RESPONSIBILITY= | ||
− | If a civ-noble having certain | + | If a civ-noble having certain responsibilites arrives at a site and start to live there, it will perform the tasks coming with that responsibility. This means that a civ-manager wil do managing, while he's a citizen of your fortress. |
The only AS_NEEDED-position that is created in world-gen is that of the responsibility DELIVERS_MESSAGES, of a site level. | The only AS_NEEDED-position that is created in world-gen is that of the responsibility DELIVERS_MESSAGES, of a site level. | ||
Line 148: | Line 151: | ||
Warning: Do not mistake "availability" for "visibility"! | Warning: Do not mistake "availability" for "visibility"! | ||
− | Of all the possible positions existing in your | + | Of all the possible positions existing in your sites entity, there may only some available. |
* Positions with [REQUIRES_POPULATION] require the population to have a specific size. | * Positions with [REQUIRES_POPULATION] require the population to have a specific size. | ||
* Positions with [REQUIRES_MARKET] will only appear in "large" sites (which may have different rules for different site types). This tag has no effect in fort mode. | * Positions with [REQUIRES_MARKET] will only appear in "large" sites (which may have different rules for different site types). This tag has no effect in fort mode. | ||
Line 156: | Line 159: | ||
A position that requires a certain population will become available, even if it doesnt have [APPOINTED_BY] or [ELECTED]. In that case, see 'automatic assignment' and 'assumption' | A position that requires a certain population will become available, even if it doesnt have [APPOINTED_BY] or [ELECTED]. In that case, see 'automatic assignment' and 'assumption' | ||
− | In fortress-mode, in some cases 'succession' is evaluated | + | In fortress-mode, in some cases 'succession' is evaluated immidiatly after a position becomes available. See: Succession. |
==Visibility of positions== | ==Visibility of positions== | ||
A position might be available, but can still be invisible for the player in the [[nobles screen]]. The positions with their respective holders are visible for players: | A position might be available, but can still be invisible for the player in the [[nobles screen]]. The positions with their respective holders are visible for players: | ||
* All site-positions that are already filled-in (even if they could not be re-filled-in considering current conditions) | * All site-positions that are already filled-in (even if they could not be re-filled-in considering current conditions) | ||
− | * Site-positions that are | + | * Site-positions that are apointable by a filled-in site position |
* Civ-positions of units that are also a citizen of your fortress. | * Civ-positions of units that are also a citizen of your fortress. | ||
If a position becomes available, for example because a certain pop number has reached or if it is available from the start(like expedition leader), als long as it cannot be appointed, it still is INVISIBLE for the player. | If a position becomes available, for example because a certain pop number has reached or if it is available from the start(like expedition leader), als long as it cannot be appointed, it still is INVISIBLE for the player. | ||
− | It might strike | + | It might strike as odd, may a position becomes filled automaticly in fortress mode, when that position is not even visible. This might be the case if the current holder of a non-appoinable position dies or succeeds another position. Regardless of player-visibility, these positions will be automaticly filled in if the nescesary requisitions are met. It might happen with the expedition-leader. |
− | A situation with a non-visible but available position, is for example when a position is solely appointed by the | + | A situation with a non-visible but available position, is for example when a position is solely appointed by the expedion leader, when the expedion leader's position is left vacant. It can no longer be appointed by the player and is invisible. Then, it gets automatically assumed, proving that the position still was available. |
=NUMBER= | =NUMBER= | ||
Line 172: | Line 175: | ||
If the ruling position (with PRECEDENCE of 1) has a NUMBER higher than 1, a random unit of the ones holding these positions is shown as 'head of state' in the embark screen. | If the ruling position (with PRECEDENCE of 1) has a NUMBER higher than 1, a random unit of the ones holding these positions is shown as 'head of state' in the embark screen. | ||
− | ==Automatic | + | ==Automatic spreadin of assumed, non-singular positions== |
− | If there are civ-positions that have a NUMBER higher then '1' and which are assumed (not APPOINTED_BY or ELECTED) but are '''not DUTY_BOUND''', these are automatically spread among the civilisation, based on population. If there are a number of '''20''' available slots of that position, they spread among a | + | If there are civ-positions that have a NUMBER higher then '1' and which are assumed (not APPOINTED_BY or ELECTED) but are '''not DUTY_BOUND''', these are automatically spread among the civilisation, based on population. If there are a number of '''20''' available slots of that position, they spread among a cilivation with a combined population of, for example, 1000 of which your fortress has 100 (10%), '''2''' of your fortress' citizens will assume that position. |
− | This may probably also work with elected and appointed positions, but that may be depending on the death of the current holders and this needs more testing. | + | This may probably also work with elected and appointed positions, but that may be depending on the death of the current holders and this needs more testing. Assumpion works within a day, anyway. |
==AS_NEEDED== | ==AS_NEEDED== | ||
− | These positions can be created | + | These positions can be created automaticly by the game in world-gen. This however only works with |
− | * | + | * LAND_HOLDER's |
* squad commanders (needs more testing) | * squad commanders (needs more testing) | ||
* Messengers at sites | * Messengers at sites | ||
− | For all other types of positions, | + | For all other types of positions, the're not created in world-gen, even if they are defined with RESPONSIBILITY's. For example, even in war, The game wouldn't create a MILITARY_GOALS position, if they have AS_NEEDED as number. |
− | However, in fortress-mode / | + | However, in fortress-mode / playermode, these positions can be created by the player at will. |
Positions with AS_NEEDED need to be created first, before any symbols are assignable as 'symbols' (objects) for the position holder to carry or wear. | Positions with AS_NEEDED need to be created first, before any symbols are assignable as 'symbols' (objects) for the position holder to carry or wear. | ||
Positions with AS_NEEDED cannot be created and then ELECTED in fortress-mode. It only works with APPOINTED_BY. | Positions with AS_NEEDED cannot be created and then ELECTED in fortress-mode. It only works with APPOINTED_BY. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
{{Category|Modding}} | {{Category|Modding}} | ||
{{Category|Guides}} | {{Category|Guides}} |