SCED/objects/Fan-MadeAccessories.aa8b38/CleanUpHelper.26cf4b.ttslua
2022-11-10 23:59:55 -08:00

346 lines
12 KiB
Plaintext

-- Clean Up Helper
-- made by: Chr1Z
-- description: Cleans up the table for the next scenario in a campaign:
-- - sets counters to default values (resources and doom) or trauma values (health and sanity, if not disabled) from campaign log
-- - puts everything on playmats and hands into respective trashcans
-- - use the IGNORE_TAG to exclude objects from tidying (default: "CleanUpHelper_Ignore")
information = {
version = "2.0",
last_updated = "10.10.2022"
}
-- enable this for debugging
SHOW_RAYS = false
-- these objects will be ignored
IGNORE_GUIDS = {
-- big playmat, change image panel and investigator counter
"b7b45b"; "f182ee"; "721ba2";
-- bless/curse manager
"afa06b"; "bd0253"; "5933fb";
-- stuff on agenda/act playmat
"85c4c6"; "4a3aa4"; "fea079"; "b015d8"; "11e0cf"; "9f334f"; "70b9f6"; "0a5a29";
-- doom/location token bag
"47ffc3"; "170f10";
-- table
"4ee1f2"
}
-- objects with this tag will be ignored
IGNORE_TAG = "CleanUpHelper_ignore"
-- colors and order for following tables
COLORS = { "White"; "Orange"; "Green"; "Red"; "Agenda" }
-- counter GUIDS (4x damage, 4x sanity, 4x resource and 1x doom)
TOKEN_GUIDS = {
"eb08d6"; "e64eec"; "1f5a0a"; "591a45";
"468e88"; "0257d9"; "7b5729"; "beb964";
"4406f0"; "816d84"; "cd15ac"; "a4b60d";
"85c4c6"
}
-- default values (4x damage, 4x horror, 4x resources, 1x doom)
DEFAULT_VALUES = {
0; 0; 0; 0;
0; 0; 0; 0;
5; 5; 5; 5;
0
}
PLAYERMAT_GUIDS = { "8b081b"; "bd0ff4"; "383d8b"; "0840d5" }
CLUE_GUIDS = { "d86b7c"; "1769ed"; "032300"; "37be78" }
TRASHCAN_GUIDS = { "147e80"; "f7b6c8"; "5f896a"; "4b8594"; "70b9f6" }
PLAYMATZONE = getObjectFromGUID("a2f932")
-- values for physics.cast (4 entries for player zones, 5th entry for agenda/act deck, 6th for campaign log)
PHYSICS_POSITION = {
{ x = -54.5, y = 2, z = 21 };
{ x = -54.5, y = 2, z = -21 };
{ x = -25.0, y = 2, z = 26 };
{ x = -25.0, y = 2, z = -26 };
{ x = -02.0, y = 2, z = 10 };
{ x = -00.0, y = 2, z = -27 }
}
PHYSICS_ROTATION = {
{ x = 0, y = 270, z = 0 };
{ x = 0, y = 270, z = 0 };
{ x = 0, y = 000, z = 0 };
{ x = 0, y = 180, z = 0 };
{ x = 0, y = 270, z = 0 };
{ x = 0, y = 000, z = 0 }
}
PHYSICS_SCALE = {
{ x = 36.6, y = 1, z = 14.5 };
{ x = 36.6, y = 1, z = 14.5 };
{ x = 28.0, y = 1, z = 14.5 };
{ x = 28.0, y = 1, z = 14.5 };
{ x = 55.0, y = 1, z = 13.5 };
{ x = 05.0, y = 1, z = 05.0 }
}
local BUTTON_PARAMETERS = {}
BUTTON_PARAMETERS.function_owner = self
-- saving the options
function onSave() return JSON.encode({ tidy_playermats, import_trauma, reset_resources }) end
function onLoad(saved_data)
local loaded_data = JSON.decode(saved_data)
if loaded_data ~= nil then
tidy_playermats = loaded_data[1]
import_trauma = loaded_data[2]
reset_resources = loaded_data[3]
else
tidy_playermats = true
import_trauma = true
reset_resources = true
end
self.addContextMenuItem("More Information", function()
printToAll("------------------------------", "White")
printToAll("Clean Up Helper v" .. information["version"] .. " by Chr1Z", "Orange")
printToAll("last updated: " .. information["last_updated"], "White")
printToAll("ignore tag: " .. IGNORE_TAG, "White")
printToAll("Player order in the campaign log for trauma import:\nWhite, Orange, Green, Red", "White")
end)
-- index 0: button as label
BUTTON_PARAMETERS.label = "Clean Up Helper v" .. information["version"]
BUTTON_PARAMETERS.click_function = "none"
BUTTON_PARAMETERS.position = { x = 0, y = 0.1, z = -1.525 }
BUTTON_PARAMETERS.height = 0
BUTTON_PARAMETERS.width = 0
BUTTON_PARAMETERS.font_size = 165
BUTTON_PARAMETERS.font_color = "Black"
self.createButton(BUTTON_PARAMETERS)
-- index 1: option button for playermats
BUTTON_PARAMETERS.label = "Tidy playermats: " .. (tidy_playermats and "✓" or "✗")
BUTTON_PARAMETERS.color = { 0, 0, 0, 0.95 }
BUTTON_PARAMETERS.click_function = "toggle1"
BUTTON_PARAMETERS.position.z = -0.8
BUTTON_PARAMETERS.height = 275
BUTTON_PARAMETERS.width = 1550
BUTTON_PARAMETERS.font_size = 165
BUTTON_PARAMETERS.font_color = "White"
self.createButton(BUTTON_PARAMETERS)
-- index 2: option button for trauma import
BUTTON_PARAMETERS.label = "Import trauma: " .. (import_trauma and "✓" or "✗")
BUTTON_PARAMETERS.click_function = "toggle2"
BUTTON_PARAMETERS.position.z = -0.1
self.createButton(BUTTON_PARAMETERS)
-- index 3: option button for resources
BUTTON_PARAMETERS.label = "Reset resources: " .. (reset_resources and "✓" or "✗")
BUTTON_PARAMETERS.click_function = "toggle3"
BUTTON_PARAMETERS.position.z = 0.6
self.createButton(BUTTON_PARAMETERS)
-- index 4: start button
BUTTON_PARAMETERS.label = "Start!"
BUTTON_PARAMETERS.click_function = "cleanUp"
BUTTON_PARAMETERS.position.z = 1.3
BUTTON_PARAMETERS.width = 775
self.createButton(BUTTON_PARAMETERS)
-- create single table for ignoring
for _, v in ipairs(CLUE_GUIDS) do table.insert(IGNORE_GUIDS, v) end
for _, v in ipairs(TRASHCAN_GUIDS) do table.insert(IGNORE_GUIDS, v) end
for _, v in ipairs(PLAYERMAT_GUIDS) do table.insert(IGNORE_GUIDS, v) end
for _, v in ipairs(TOKEN_GUIDS) do table.insert(IGNORE_GUIDS, v) end
end
---------------------------------------------------------
-- click functions for option buttons
---------------------------------------------------------
function toggle1()
tidy_playermats = not tidy_playermats
self.editButton({ index = 1, label = "Tidy playermats: " .. (tidy_playermats and "✓" or "✗") })
end
function toggle2()
import_trauma = not import_trauma
self.editButton({ index = 2, label = "Import trauma: " .. (import_trauma and "✓" or "✗") })
end
function toggle3()
reset_resources = not reset_resources
self.editButton({ index = 3, label = "Reset resources: " .. (reset_resources and "✓" or "✗") })
end
---------------------------------------------------------
-- main function
---------------------------------------------------------
function cleanUp()
printToAll("------------------------------", "White")
printToAll("Clean up started!", "Orange")
printToAll("Resetting counters...", "White")
getTrauma()
resetCounters()
printToAll("Discarding player hands...", "White")
discardHands()
printToAll("Tidying big playmat...", "White")
startLuaCoroutine(self, "tidyPlaymatCoroutine")
end
---------------------------------------------------------
-- modular functions, called by other functions
---------------------------------------------------------
-- set counters to reset values
function resetCounters()
for i, guid in ipairs(TOKEN_GUIDS) do
-- skip this step for resource tokens when option disabled (token number 9-12)
if reset_resources or (i < 9 or i > 12) then
local TOKEN = getObjectFromGUID(guid)
if TOKEN ~= nil then
TOKEN.setVar("val", RESET_VALUES[i])
TOKEN.call("updateVal")
TOKEN.call("updateSave")
else
printToAll("Token number " .. i .. " could not be found and was skipped.", "Yellow")
end
end
end
end
-- read values for trauma from campaign log if enabled
function getTrauma()
-- load default values
RESET_VALUES = {}
for k, v in pairs(DEFAULT_VALUES) do
RESET_VALUES[k] = v
end
-- stop here if trauma import is disabled
if not import_trauma then
printToAll("Default values for health and sanity loaded.", "Yellow")
return
end
-- get campaign log
local c_log = findObjects(6)[1]
if c_log == nil then
printToAll("Campaign log not found in standard position!", "Yellow")
printToAll("Default values for health and sanity loaded.", "Yellow")
return
end
-- get data from campaign log if possible
local counterData = c_log.hit_object.getVar("ref_buttonData")
if counterData ~= nil then
printToAll("Trauma values found in campaign log!", "Green")
for i = 1, 10, 3 do
RESET_VALUES[1 + (i - 1) / 3] = counterData.counter[i].value
RESET_VALUES[5 + (i - 1) / 3] = counterData.counter[i + 1].value
end
else
printToAll("Trauma values could not be found in campaign log!", "Yellow")
printToAll("Default values for health and sanity loaded.", "Yellow")
end
end
-- discard all hand objects
function discardHands()
for i = 1, 4 do
local trashcan = getObjectFromGUID(TRASHCAN_GUIDS[i])
local hand = Player[COLORS[i]].getHandObjects()
if trashcan == nil then return end
for j = #hand, 1, -1 do trashcan.putObject(hand[j]) end
end
end
-- clean up for big playmat
function tidyPlaymatCoroutine()
local trashcan = getObjectFromGUID(TRASHCAN_GUIDS[5])
if PLAYMATZONE == nil then
printToAll("Scripting zone for big playmat could not be found!", "Red")
elseif trashcan == nil then
printToAll("Trashcan for big playmat could not be found!", "Red")
else
for _, obj in ipairs(PLAYMATZONE.getObjects()) do
-- ignore these elements
if indexOf(IGNORE_GUIDS, obj.getGUID()) == nil and obj.hasTag(IGNORE_TAG) == false then
coroutine.yield(0)
trashcan.putObject(obj)
end
end
end
printToAll("Tidying playermats and agenda mat...", "White")
startLuaCoroutine(self, "tidyPlayerMatCoroutine")
return 1
end
-- clean up for the four playermats and the agenda/act playmat
function tidyPlayerMatCoroutine()
for i = 1, 5 do
-- skip playermat (1-4) if option disabled
if tidy_playermats or i == 5 then
-- delay for animation purpose
for k = 1, 30 do coroutine.yield(0) end
-- get respective trashcan
local trashcan = getObjectFromGUID(TRASHCAN_GUIDS[i])
if trashcan == nil then
printToAll("Trashcan for " .. COLORS[i] .. " playmat could not be found!", "Red")
return
end
for _, entry in ipairs(findObjects(i)) do
local obj = entry.hit_object
local desc_low = string.lower(obj.getDescription())
-- ignore these elements
if indexOf(IGNORE_GUIDS, obj.getGUID()) == nil and
obj.hasTag(IGNORE_TAG) == false and
desc_low ~= "action token" then
coroutine.yield(0)
trashcan.putObject(obj)
-- flip action tokens back to ready
elseif desc_low == "action token" and obj.is_face_down then
obj.flip()
end
end
end
end
printToAll("Clean up completed!", "Green")
return 1
end
---------------------------------------------------------
-- helper functions
---------------------------------------------------------
-- find objects depending on index (1 to 4 for playermats, 5 for agenda/act playmat, 6 for campaign log)
function findObjects(num)
return Physics.cast({
direction = { 0, 1, 0 },
max_distance = 2,
type = 3,
size = PHYSICS_SCALE[num],
origin = PHYSICS_POSITION[num],
orientation = PHYSICS_ROTATION[num],
debug = SHOW_RAYS
})
end
-- helper to search array
function indexOf(array, value)
for i, v in ipairs(array) do
if v == value then
return i
end
end
end