Print

Please login or register.
1 Hour 1 Day 1 Week 1 Month Forever
Login with username, password and session length

[fortunawhisk]

A script to reduce the deities each dwarf worships down to one or set a single deity and preferred worship level across all dwarves. I had several dwarves that followed multiple gods, this script was made to fix the stress problems associated with unmet needs there. Script records the first god in the relationship and needs lists, removes all deities and their associated need,  then re-inserts the recorded deity and associated need.

Spoiler (click to show/hide)

Code: [Select]

-- Enforce monotheism on citizens
-- Monotheism 1.0
-- There can be only one...
-- Fortress mode script called from DFHack

local utils=require('utils')

validArgs = utils.invert({
 'help',
 'verbose',
 'deity',
 'level'
})

local args = utils.processArgs({...}, validArgs)
local verbose = false
local override = false



local helpme = [===[

monotheism.lua
=========
This script sets the citizens to only have a single deity. The default mode removes any deity after the first listed. The override mode sets the player selected deity

arguments:
    -help
        print this help message

    -verbose
        prints debug data to the dfhack console. Default is false

-deity
Expects the unit id of the deity to use

-level
Expects an integer value. 1=ardent, 2=faithful, 3=normal, 4=casual, and 5=dubious

    Examples:
        Default:
        monotheism

Override:
monotheism -deity 102 -level 4
     

]===]

-- Handle help requests
if args.help then
    print(helpme)
    return
end

if ( args.verbose ) then
    verbose = true
end

if (args.deity and args.level) then
    override = true
force_deity = tonumber(args.deity)
force_level = tonumber(args.level)
end

function EraseHFLinksDeity (hf)
    for i = #hf.histfig_links-1,0,-1 do
        if hf.histfig_links[i]._type == df.histfig_hf_link_deityst then
            local todelete = hf.histfig_links[i]
            hf.histfig_links:erase(i)
            todelete:delete()
        end
    end
end

function EraseDeityNeeds (needs)
    for i = #needs-1,0,-1 do
        if needs[i].id == 2 then
            needs:erase(i)
        end
    end
end


function set_deities ()

-- Get the local civ id 
local my_civ = df.global.world.world_data.active_site[0].entity_links[0].entity_id
-- dfhack.println (my_civ)
 
 
for i, unit in ipairs(df.global.world.units.all) do
if unit.civ_id == my_civ and dfhack.units.isCitizen(unit) then
 
-- Per citizen variables
local d_counter = 0
local keep_deity = 0
local keep_linkstrength = 0
local keep_focus = 0
local keep_need_level = 0
 
local hf = df.historical_figure.find(unit.hist_figure_id)
if verbose then dfhack.println(dfhack.TranslateName(df.historical_figure.find(unit.hist_figure_id).name, true)) end

-- Identify and count deity related relationships
-- We'll grab the the first deity, delete everything, then reinsert it. Anything else leads to index order errors
for k, histfig_link in ipairs(hf.histfig_links) do


if histfig_link._type == df.histfig_hf_link_deityst then
 
d_counter = d_counter + 1

if d_counter == 1 then
keep_deity = hf.histfig_links[k].target_hf
keep_linkstrength = hf.histfig_links[k].link_strength
if verbose then dfhack.println(" == Will Keep " .. dfhack.TranslateName(df.historical_figure.find(keep_deity).name, true) .. " | " .. hf.histfig_links[k].link_strength ) end
end
         
if d_counter > 1 then
-- Delete relationship
if verbose then dfhack.println(" == Will Remove " .. dfhack.TranslateName(df.historical_figure.find(histfig_link.target_hf).name, true) .. " | " .. hf.histfig_links[k].link_strength) end
end

end

end
 


-- Now we need to remove the needs. Just removing needs is not a great plan. They don't seem to regenerate.
needs =  unit.status.current_soul.personality.needs

for i = #needs-1,0,-1 do
if needs[i].id == 2 then
if verbose then dfhack.println(" == Deity Need " .. dfhack.TranslateName(df.historical_figure.find(needs[i].deity_id).name, true) .. ":" .. needs[i].focus_level .. ":" .. needs[i].need_level ) end
if needs[i].deity_id == keep_deity then
keep_focus = needs[i].focus_level
keep_need_level = needs[i].need_level
if verbose then dfhack.println(" == Keep Deity Need " .. dfhack.TranslateName(df.historical_figure.find(keep_deity).name, true) .. ":" .. keep_focus .. ":" .. keep_need_level ) end
end
end
end


-- We'll now remove all the deity relations
EraseHFLinksDeity(hf)

-- We'll now remove all Deity Needs
EraseDeityNeeds(needs)

-- Sometimes there isn't a need created for a deity?
-- Oddly, need level doesn't seem directly linked to the linkstrength ranges for deity relationships?
if(keep_need_level == 0) then
if( keep_linkstrength >= 90 ) then
keep_need_level = 10
elseif( keep_linkstrength >= 70 ) then
keep_need_level = 5
elseif( keep_linkstrength >= 50 ) then
keep_need_level = 2
else
keep_need_level = 1
end
end

-- We can test for an override here
if(override) then
    if verbose then dfhack.println(" == Force Deity to " .. force_deity .. "|" .. force_level ) end
keep_deity = force_deity
if( force_level == 1 ) then
keep_need_level = 10
keep_linkstrength = 90
elseif( force_level == 2 ) then
keep_need_level = 5
keep_linkstrength = 75
elseif( force_level == 3 ) then
keep_need_level = 2
keep_linkstrength = 50
elseif( force_level == 4 ) then
keep_need_level = 2
keep_linkstrength = 10
else
keep_need_level = 1
keep_linkstrength = 1
end
if verbose then dfhack.println(" == Force Deity to " .. dfhack.TranslateName(df.historical_figure.find(keep_deity).name, true) .. "|" .. keep_linkstrength .. "|" .. keep_need_level ) end
end

-- We'll now add a deity link.
local new_link = df.histfig_hf_link_deityst:new() -- adding hf link to source
new_link.target_hf = keep_deity
new_link.link_strength = keep_linkstrength
hf.histfig_links:insert('#',new_link)

        -- Recreate our single deity need
local new_need = df.unit_personality.T_needs:new()
new_need.id = 2
new_need.deity_id = keep_deity
new_need.focus_level = keep_focus
new_need.need_level = keep_need_level
unit.status.current_soul.personality.needs:insert("#",new_need)

    end
  end
 
end

set_deities ()


[Pvt. Pirate]

sounds good, needs more info on how to use.

[fortunawhisk]

Dwarves tend to worship multiple deities. This tends to lead to extra stress for unsatisfied worship need(s), because they tend to only pray to a single deity consistently. This script has two modes: Called without parameters, it reduces the number of deity relationships/needs to one for all citizens. Or you can specify a specific deity and relationship/worship level, if you want to see how a fort full of fanatical dwarves plays out. On exactly how to use the script, from the help section:

Code: [Select]

    Examples:
        Default:
        monotheism

        Override:
        monotheism -deity 102 -level 4


[Pvt. Pirate]

so only entering "monotheism" into the console will execute in standard mode, while i got no idea what the parameters would do.

[fortunawhisk]

From the help message:

Code: [Select]

arguments:
    -help
        print this help message

    -verbose
        prints debug data to the dfhack console. Default is false

     -deity
         Expects the unit id of the deity to use

     -level
         Expects an integer value. 1=ardent, 2=faithful, 3=normal, 4=casual, and 5=dubious

If your next question is "How do I find out what the deity unit id should be?", PatrikLundell has an excellent script for listing deity info.
http://www.bay12forums.com/smf/index.php?topic=169626.msg7706526#msg7706526

Here's my own take on that. It also comes with -help and and an example.

Spoiler (click to show/hide)

Code: [Select]

-- Get worshippers per deity
-- deity_list 1.0
-- Courtesy of PatrikLundell's (superior) original
-- http://www.bay12forums.com/smf/index.php?topic=169626.msg7706526#msg7706526


local utils=require('utils')

validArgs = utils.invert({
 'help',
 'verbose'
})

local args = utils.processArgs({...}, validArgs)
local verbose = false

local helpme = [===[

deity_list.lua
=========
This script prints the deities and a count of their worshippers in the fort

arguments:
    -help
        print this help message

    -verbose
        prints debug data to the dfhack console. Default is false

    Examples:
        deity_list
     

]===]

-- Handle help requests
if args.help then
    print(helpme)
    return
end

if ( args.verbose ) then
    verbose = true
end



function show_deities ()
  local deities = {}

  local my_civ = df.global.world.world_data.active_site[0].entity_links[0].entity_id
  -- dfhack.println (my_civ)
 
  for i, entity in ipairs (df.global.world.entities.all[my_civ].unknown1b.deities) do
    -- Populate the deities table with worshipped deities from my civ
-- Distrib is: ardent, faithful, normal, casual, dubious
    table.insert(deities, {entity, 0, {0,0,0,0,0} })
  end

 
  for i, unit in ipairs(df.global.world.units.all) do
    if unit.civ_id == my_civ and dfhack.units.isCitizen(unit) then
 
  local hf = df.historical_figure.find(unit.hist_figure_id)
      if verbose then dfhack.println(dfhack.TranslateName(df.historical_figure.find(unit.hist_figure_id).name, true)) end
   
      for k, histfig_link in ipairs(hf.histfig_links) do
        if histfig_link._type == df.histfig_hf_link_deityst then
  if verbose then dfhack.println(" == Worships " .. dfhack.TranslateName(df.historical_figure.find(histfig_link.target_hf).name, true) .. " |" .. histfig_link.link_strength) end
          local found = false
 
          -- Loop through my_civ's deities, incrementing count based on worshippers
          for l, entry in ipairs(deities) do
            if histfig_link.target_hf == entry[1] then
              entry[2] = entry[2] + 1
 
  if(histfig_link.link_strength >= 90) then
entry[3][1] = entry[3][1] + 1
  elseif(histfig_link.link_strength >= 75) then
    entry[3][2] = entry[3][2] + 1
  elseif(histfig_link.link_strength >= 25) then
    entry[3][3] = entry[3][3] + 1
  elseif(histfig_link.link_strength >= 10) then
    entry[3][4] = entry[3][4] + 1
  else
entry[3][5] = entry[3][5] + 1
  end
 
              found = true
              break
            end
          end
         
          if not found then
    if verbose then dfhack.println("Initializing foreign deity") end
    -- Initialize the entry for this foreign deity
if(histfig_link.link_strength >= 90) then
table.insert (deities, {histfig_link.target_hf, 1, {1,0,0,0,0} } )
elseif(histfig_link.link_strength >= 75) then
table.insert (deities, {histfig_link.target_hf, 1, {0,1,0,0,0} } )
elseif(histfig_link.link_strength >= 25) then
table.insert (deities, {histfig_link.target_hf, 1, {0,0,1,0,0} } )
elseif(histfig_link.link_strength >= 10) then
table.insert (deities, {histfig_link.target_hf, 1, {0,0,0,1,0} } )
else
table.insert (deities, {histfig_link.target_hf, 1, {0,0,0,0,1} } )
end

          end
 
        end -- End deity test
      end -- End citizen relation loop
    end -- End all my citizens test
  end -- End all units in the world loop
 
 
 
  for i = 1, #df.global.world.entities.all[my_civ].unknown1b.deities do
    local distrib = "Ardent: " .. deities[i][3][1] .. "; Faithful:" .. deities[i][3][2] .. "; Normal:" .. deities[i][3][3] .. "; Casual:" .. deities[i][3][4] .. "; Dubious:" .. deities[i][3][5]
    dfhack.println (tostring (deities[i][2]) .. " total worshippers for " .. dfhack.TranslateName(df.historical_figure.find(deities[i][1]).name, true) .. "(" .. deities[i][1] .. ") - " .. distrib )
  end
 
  if #df.global.world.entities.all[my_civ].unknown1b.deities < #deities then
    dfhack.println ("Acquired deities:")
   
    for i = #df.global.world.entities.all[my_civ].unknown1b.deities + 1, #deities do
  local distrib = "Ardent: " .. deities[i][3][1] .. "; Faithful:" .. deities[i][3][2] .. "; Normal:" .. deities[i][3][3] .. "; Casual:" .. deities[i][3][4] .. "; Dubious:" .. deities[i][3][5]
      dfhack.println(tostring(deities[i][2]) .. " total worshippers for " .. dfhack.TranslateName(df.historical_figure.find(deities[i][1]).name, true) .. "(" .. deities[i][1] .. ") - " .. distrib )
    end
  end
end

show_deities ()


Another example. I list the deities, run the mono script in default, check the results, then change everyone over to laltur.

Code: [Select]

[DFHack]# deity_list
...
19 total worshippers for Laltur(93) - Ardent: 1; Faithful:7; Normal:11; Casual:0; Dubious:0
[DFHack]# monotheism
[DFHack]# deity_list
...
9 total worshippers for Laltur(93) - Ardent: 0; Faithful:4; Normal:5; Casual:0; Dubious:0
[DFHack]# monotheism -deity 93 -level 3
[DFHack]# deity_list
...
90 total worshippers for Laltur(93) - Ardent: 0; Faithful:0; Normal:90; Casual:0; Dubious:0


[Pvt. Pirate]

oh, that indent after -verbose in the helpmessage made it look as if it were a subparameter
if you remove that, it should be self-explanatory. maybe i'm an AI without knowing.... i feel dumb now

[FantasticDorf]

This has some potential because script-heavy mods like masterwork could do interesting things with it, still a pleasant addition eitherway for DFhack vanilla because dwarves really are sometimes too zealous to do anything useful.

• Imagine needing to build a workshop to organise your religion by activating this or a variation of the meta-script, a bit like the great-library from the masterwork pack booting you back out to legends mode

[lonewined]

Any plans to update this script for the Steam version?

[myk]

Yes, especially since religion proliferation comes up as a complaint so often. Tracking bug here: https://github.com/DFHack/dfhack/issues/3989