Module:BuildingData: Difference between revisions

From Against the Storm Official Wiki
m (changed function scope)
(added small camps; fixed some icon filenames missing extensions)
 
(5 intermediate revisions by the same user not shown)
Line 20: Line 20:
-- Dependencies
-- Dependencies
--
--
RecipeData = RecipeData or require("Module:RecipeData") -- used to get recipe data
RecipeData = RecipeData or require("Module:RecipeData") -- need recipe relationships
Utility = Utility or require("Module:Utility") -- need normalize functions
Utility = Utility or require("Module:Utility") -- need normalize functions


Line 54: Line 54:
-- Class Variables
-- Class Variables
--
--


-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Line 65: Line 63:
-- the rest of the data. (The lookup method will handle converting it to  
-- the rest of the data. (The lookup method will handle converting it to  
-- lowercase.)
-- lowercase.)
--
-- Structure:
-- Structure:
-- @key a lowercase version of the building name, with the same spaces,  
-- @key a lowercase version of the building name, with the same spaces,  
-- apostrophes, singular, and spelling
-- apostrophes, singular, and spelling
-- @field iconfile a string of the filename.png of the icon used in the  
-- @field page the name of the wiki page, case-sensitive, but otherwise must be
-- game, case-sensitive and must include extension, but without the "File:"
-- the same as the key
-- @field page the name of the wiki page, case-sensitive, but otherwise
-- @field iconfile a string of the filename.png of the icon used in the game,
-- must be the same as the key
-- case-sensitive and must include extension, but without the "File:"
-- @field spec1[opt] the first specialization listed in the in-game  
-- @field specialization[opt] a table of the specializations listed in the  
-- encyclopedia (use the constants, above), if any
-- in-game encyclopedia (use the constants, above), or omit if none
-- @field spec2[opt] the second specialization listed in the in-game
-- @field cost[opt] a table of the building costs (or omit if none), in the  
-- encyclopedia (use the constants, above), if any
-- following format:
-- @field cost1 the first listed resource cost in the in-game encyclopedia
-- { first cost { number, resource },
-- (use constants, above)
--   second cost { number, resource },
-- @field cost2 the second listed resource cost in the in-game encyclopedia
--   etc. }
-- (use constants, above), if any
-- @field cost3 the third listed resource cost in the in-game encyclopedia
-- (use constants, above), if any
-- @field workers the number of worker slots
-- @field workers the number of worker slots
-- @field raintype the color of rain used in the Rain Engine of this building  
-- @field raintype the color of rain used in the Rain Engine of this building  
Line 90: Line 86:
-- Starting Buildings
-- Starting Buildings
["ancient hearth"] = {iconfile="Small Hearth icon.png", page="Ancient Hearth", spec1=S_WARM, workers=1, description="The heart of the colony is protected by the Holy Flame. {{Villagers}} gather here to rest, eat, and receive clothing. If the fire goes out, people will lose hope. Can't be moved. Size: 4x4."},
["ancient hearth"] = { page="Ancient Hearth",
["main warehouse"] = {iconfile="Main_Storage_icon.png", page="Main Warehouse"},
iconfile="Small Hearth icon.png",  
specialization={ S_WARM },  
workers=1,  
description="The heart of the colony is protected by the Holy Flame. Villagers gather here to rest, eat, and receive clothing. If the fire goes out, people will lose hope. Can't be moved. Size: 4x4." },
["main warehouse"] = { page="Main Warehouse",
iconfile="Main_Storage_icon.png" },
-- Camps
-- Camps
["foragers' camp"] = {iconfile="Forager's Camp icon", page="Foragers' Camp"},
["small foragers' camp"] = { page="Small Foragers' Camp",  
["harvesters' camp"] = {iconfile="Harvester Camp icon.png", page="Harvesters' Camp"},
iconfile="Small Foragers' Camp icon.png" },
["herbalists' camp"] = {iconfile="Herbalist's_Camp_icon.png", page="Herbalists' Camp"},
["foragers' camp"] = { page="Foragers' Camp",
["stonecutters' camp"] = {iconfile="Stonecutter's Camp icon.png", page="Stonecutters' Camp"},
iconfile="Forager's Camp icon.png" },
["trappers' camp"] = {iconfile="Trapper's Camp icon.png", page="Trappers' Camp"},
["harvesters' camp"] = { page="Harvesters' Camp",
["woodcutters' camp"] = {iconfile="Woodcutters Camp icon", page="Woodcutters' Camp"},
iconfile="Harvester Camp icon.png" },
["small herbalists' camp"] = { page="Small Herbalists' Camp",
iconfile="Small_Herbalists'_Camp_icon.png" },
["herbalists' camp"] = { page="Herbalists' Camp",
iconfile="Herbalist's_Camp_icon.png" },
["stonecutters' camp"] = { page="Stonecutters' Camp",
iconfile="Stonecutter's Camp icon.png" },
["small trappers' camp"] = { page="Small Trappers' Camp",
iconfile="Small_Trappers'_Camp_icon.png" },
["trappers' camp"] = { page="Trappers' Camp",
iconfile="Trapper's Camp icon.png" },
["woodcutters' camp"] = { page="Woodcutters' Camp",  
iconfile="Woodcutters Camp icon.png" },
-- Farms
-- Farms
["farm field"] = {iconfile="Farmfield_icon.png", page="Farm Field"},
["farm field"] = { page="Farm Field",
["greenhouse"] = {iconfile="Greenhouse_icon.png", page="Greenhouse"},
iconfile="Farmfield_icon.png" },
["herb garden"] = {iconfile="HerbGarden_icon.png", page="Herb Garden"},
["greenhouse"] = { page="Greenhouse",
["plantation"] = {iconfile="Plantation_icon.png", page="Plantation"},
iconfile="Greenhouse_icon.png" },
["small farm"] = {iconfile="SmallFarm_icon.png", page="Small Farm"},
["herb garden"] = { page="Herb Garden",
iconfile="HerbGarden_icon.png" },
["plantation"] = { page="Plantation",
iconfile="Plantation_icon.png" },
["small farm"] = { page="Small Farm",
iconfile="SmallFarm_icon.png" },
-- Food production
-- Food production
["bakery"] = {iconfile="Bakery_icon.png", page="Bakery"},
["bakery"] = { page="Bakery",
["butcher"] = {iconfile="Butcher_icon.png", page="Butcher"},
iconfile="Bakery_icon.png" },
["cellar"] = {iconfile="Cellar_icon.png", page="Cellar"},
["butcher"] = { page="Butcher",
["cookhouse"] = {iconfile="Cookhouse_icon.png", page="Cookhouse"},
iconfile="Butcher_icon.png" },
["field kitchen"] = {iconfile="Field_Kitchen_icon.png", page="Field Kitchen"},
["cellar"] = { page="Cellar",
["granary"] = {iconfile="Granary_icon.png", page="Granary"},
iconfile="Cellar_icon.png" },
["grill"] = {iconfile="Grill_icon.png", page="Grill"},
["cookhouse"] = { page="Cookhouse",
["ranch"] = {iconfile="Ranch_icon.png", page="Ranch"},
iconfile="Cookhouse_icon.png" },
["smokehouse"] = {iconfile="Smokehouse_icon.png", page="Smokehouse"},
["field kitchen"] = { page="Field Kitchen",
iconfile="Field_Kitchen_icon.png" },
["granary"] = { page="Granary",
iconfile="Granary_icon.png" },
["grill"] = { page="Grill",
iconfile="Grill_icon.png" },
["ranch"] = { page="Ranch",
iconfile="Ranch_icon.png" },
["smokehouse"] = { page="Smokehouse",
iconfile="Smokehouse_icon.png" },
-- Housing
-- Housing
["shelter"] = {iconfile="Shelter icon.png", page="Shelter"},
["shelter"] = { page="Shelter",  
["big shelter"] = {iconfile="Big Shelter icon.png", page="Big Shelter"},
iconfile="Shelter icon.png" },
["human house"] = {iconfile="Human House icon.png", page="Human House"},
["big shelter"] = { page="Big Shelter",  
["beaver house"] = {iconfile="Beaver House icon.png", page="Beaver House"},
iconfile="Big Shelter icon.png" },
["lizard house"] = {iconfile="Lizard House icon.png", page="Lizard House"},
["human house"] = { page="Human House",  
["harpy house"] = {iconfile="Harpy House icon.png", page="Harpy House"},
iconfile="Human House icon.png" },
["beaver house"] = { page="Beaver House",  
iconfile="Beaver House icon.png" },
["lizard house"] = { page="Lizard House",  
iconfile="Lizard House icon.png" },
["harpy house"] = { page="Harpy House",  
iconfile="Harpy House icon.png" },
-- Industry
-- Industry
["crude workstation"] = {iconfile="Crude_Workstation_icon.png", page="Crude Workstation"},
["crude workstation"] = { page="Crude Workstation",
["makeshift post"] = {iconfile="Makeshift_Post_icon.png", page="Makeshift Post"},
iconfile="Crude_Workstation_icon.png" },
["advanced rain collector"] = {iconfile="Advanced_Rain_Collector_icon.png", page="Advanced Rain Collector", spec1=S_ENGI, spec2=S_ALCH, cost1=C_PIPES, cost2=C_PARTS, cost3=C_PLANK, description="Can collect [[infused rainwater]] used for crafting and powering [[Rain Engines]] in production buildings. The type of collected rainwater depends on the [[season]]. Can't be moved. Size: 3x2."},
["makeshift post"] = { page="Makeshift Post",
["alchemist's hut"] = {iconfile="Alchemist_Hut_icon.png", page="Alchemist's Hut", spec1=S_ALCH, spec2=S_BREW, cost1=C_PLANK, cost2=C_BRICK, workers=2, recipe1="Crystalized Dew", grade1=2, recipe2="Cosmetics", grade2=2, recipe3="Wine", grade3=2, description="Can produce: {{rl|Crystalized Dew}} {{P2Star}}, {{rl|Cosmetics}} {{P2star}}, {{rl|Wine}} {{P2Star}}. Can use: {{rl|Clearance Water}}. Can't be moved. Size: 3x2."},
iconfile="Makeshift_Post_icon.png" },
["apothecary"] = {iconfile="Apothecary_icon.png", page="Apothecary", spec1=S_ALCH, cost1=C_PLANK, cost2=C_BRICK, workers=2, recipe1="Cosmetics", grade1=2, recipe2="Incense", grade2=2, recipe3="Biscuits", grade3=2, description="Can produce: {{rl|Cosmetics}} {{P2Star}}, {{rl|Incense}} {{P2Star}}, {{rl|Biscuits}} {{P2Star}}. Can use: {{rl|Clearance Water}}. Can't be moved. Size: 3x3."},
["advanced rain collector"] = { page="Advanced Rain Collector",
["artisan"] = {iconfile="Artisan_icon.png", page="Artisan"},
iconfile="Advanced_Rain_Collector_icon.png",  
["brewery"] = {iconfile="Brewery_icon.png", page="Brewery"},
specialization={ S_ENGI, S_ALCH },  
["brick oven"] = {iconfile="Brick_Oven_icon.png", page="Brick Oven"},
cost={ {5,C_PIPES}, {3,C_PARTS}, {5,C_PLANK} },  
["brickyard"] = {iconfile="Brickyard_icon.png", page="Brickyard"},
description="Can collect infused rainwater used for crafting and powering Rain Engines in production buildings. The type of collected rainwater depends on the season. Can't be moved. Size: 3x2." },
["carpenter"] = {iconfile="Carpenter_icon.png", page="Carpenter"},
["alchemist's hut"] = { page="Alchemist's Hut",  
["clothier"] = {iconfile="Clothier_icon.png", page="Clothier"},
iconfile="Alchemist_Hut_icon.png",
["cooperage"] = {iconfile="Cooperage_icon.png", page="Cooperage"},
specialization={ S_ALCH, S_BREW },  
["druid's hut"] = {iconfile="Druid_icon.png", page="Druid's Hut"},
cost={ {5,C_PLANK}, {2,C_BRICK} },  
["flawless brewery"] = {iconfile="Brewery_icon.png", page="Flawless Brewery"},
workers=2,  
["flawless rain mill"] = {iconfile="Rain_Mill_icon.png", page="Flawless Rain Mill"},
raintype=R_CLEAR,  
["furnace"] = {iconfile="Furnace_icon.png", page="Furnace"},
description="Can produce: Crystalized Dew (★★), Cosmetics (★★), Wine (★★). Can use: Clearance Water. Can't be moved. Size: 3x2." },
["kiln"] = {iconfile="Kiln_icon.png", page="Kiln"},
["apothecary"] = { page="Apothecary",
["leatherworker"] = {iconfile="Leatherworks_icon.png", page="Leatherworker"},
iconfile="Apothecary_icon.png",  
["lumber mill"] = {iconfile="Lumbermill_icon.png", page="Lumber Mill"},
specialization={ S_ALCH },  
["mine"] = {iconfile="Mine_icon.png", page="Mine"},
cost={ {5,C_PLANK}, {2,C_BRICK} },  
["press"] = {iconfile="Press_icon.png", page="Press"},
workers=2,  
["provisioner"] = {iconfile="Provisioner_icon.png", page="Provisioner"},
raintype=R_CLEAR,  
["rain collector"] = {iconfile="Rain_Collector_icon.png", page="Rain Collector"},
description="Can produce: Cosmetics (★★), Incense (★★), Biscuits (★★). Can use: Clearance Water. Can't be moved. Size: 3x3." },
["rain mill"] = {iconfile="Rain_Mill_icon.png", page="Rain Mill"},
["artisan"] = { page="Artisan",
["scribe"] = {iconfile="Scribe_icon.png", page="Scribe"},
iconfile="Artisan_icon.png" },
["smelter"] = {iconfile="Smelter_icon.png", page="Smelter"},
["brewery"] = { page="Brewery",
["toolshop"] = {iconfile="Toolshop_icon.png", page="Toolshop"},
iconfile="Brewery_icon.png" },
["weaver"] = {iconfile="Weaver_icon.png", page="Weaver"},
["brick oven"] = { page="Brick Oven",
iconfile="Brick_Oven_icon.png" },
["brickyard"] = { page="Brickyard",
iconfile="Brickyard_icon.png" },
["carpenter"] = { page="Carpenter",
iconfile="Carpenter_icon.png" },
["clothier"] = { page="Clothier",
iconfile="Clothier_icon.png" },
["cooperage"] = { page="Cooperage",
iconfile="Cooperage_icon.png" },
["druid's hut"] = { page="Druid's Hut",
iconfile="Druid_icon.png" },
["flawless brewery"] = { page="Flawless Brewery",
iconfile="Brewery_icon.png" },
["flawless rain mill"] = { page="Flawless Rain Mill",
iconfile="Rain_Mill_icon.png" },
["furnace"] = { page="Furnace",
iconfile="Furnace_icon.png" },
["kiln"] = { page="Kiln",
iconfile="Kiln_icon.png" },
["leatherworker"] = { page="Leatherworker",
iconfile="Leatherworks_icon.png" },
["lumber mill"] = { page="Lumber Mill",
iconfile="Lumbermill_icon.png" },
["mine"] = { page="Mine",
iconfile="Mine_icon.png" },
["press"] = { page="Press",
iconfile="Press_icon.png" },
["provisioner"] = { page="Provisioner",
iconfile="Provisioner_icon.png" },
["rain collector"] = { page="Rain Collector",
iconfile="Rain_Collector_icon.png" },
["rain mill"] = { page="Rain Mill",
iconfile="Rain_Mill_icon.png" },
["scribe"] = { page="Scribe",
iconfile="Scribe_icon.png" },
["smelter"] = { page="Smelter",
iconfile="Smelter_icon.png" },
["toolshop"] = { page="Toolshop",
iconfile="Toolshop_icon.png" },
["weaver"] = { page="Weaver",
iconfile="Weaver_icon.png" },
-- City Buildings
-- City Buildings
["archaeologist's office"] = {iconfile="Archeologist_office_icon.png", page="Archaeologist's Office", cost1=C_PLANK, cost2=C_BRICK, cost3=C_FABRI, description="A building designed to help you study the past. Can be [[upgrade]]d to locate [[archaeological discoveries]] or improve [[exploration]] capabilities. Can be moved for: 5 {{rl|Wood}}. Size: 3x3."},
["archaeologist's office"] = { page="Archaeologist's Office",
["small hearth"] = {iconfile="Temporary_Hearth_icon.png", page="Small Hearth"},
iconfile="Archeologist_office_icon.png",
["warehouse"] = {iconfile="Storage_icon.png", page="Warehouse"},
cost={ {2,C_PLANK}, {2,C_BRICK}, {2,C_FABRI} },  
["trading post"] = {iconfile="Trading_Post_icon.png", page="Trading Post"},
description="A building designed to help you study the past. Can be upgraded to locate archaeological discoveries or improve exploration capabilities. Can be moved for: 5 Wood. Size: 3x3." },
["blight post"] = {iconfile="Blight_Post_icon.png", page="Blight Post"},
["small hearth"] = { page="Small Hearth",
["hydrant"] = {iconfile="Hydrant_icon.png", page="Hydrant"},
iconfile="Temporary_Hearth_icon.png" },
["forsaken altar"] = {iconfile="Altar_icon.png", page="Forsaken Altar"},
["warehouse"] = { page="Warehouse",
iconfile="Storage_icon.png" },
["trading post"] = { page="Trading Post",
iconfile="Trading_Post_icon.png" },
["blight post"] = { page="Blight Post",
iconfile="Blight_Post_icon.png" },
["hydrant"] = { page="Hydrant",
iconfile="Hydrant_icon.png" },
["forsaken altar"] = { page="Forsaken Altar",
iconfile="Altar_icon.png" },
-- Service Buildings
-- Service Buildings
["bath house"] = {iconfile="Bath_House_icon.png", page="Bath House"},
["bath house"] = { page="Bath House",
["clan hall"] = {iconfile="Clan_Hall_icon.png", page="Clan Hall"},
iconfile="Bath_House_icon.png" },
["explorers' lodge"] = {iconfile="Explorers_Lodge_icon.png", page="Explorers' Lodge"},
["clan hall"] = { page="Clan Hall",
["guild house"] = {iconfile="Guild_House_icon.png", page="Guild House"},
iconfile="Clan_Hall_icon.png" },
["monastery"] = {iconfile="Monastery_icon.png", page="Monastery"},
["explorers' lodge"] = { page="Explorers' Lodge",
["tavern"] = {iconfile="Tavern_icon.png", page="Tavern"},
iconfile="Explorers_Lodge_icon.png" },
["temple"] = {iconfile="Temple_icon.png", page="Temple"},
["guild house"] = { page="Guild House",
}
iconfile="Guild_House_icon.png" },
["monastery"] = { page="Monastery",
iconfile="Monastery_icon.png"},
["tavern"] = { page="Tavern",
iconfile="Tavern_icon.png" },
["temple"] = { page="Temple",
iconfile="Temple_icon.png" },
} -- end of tBuildingData




Line 180: Line 271:
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
-- Main lookup function
-- Main lookup function
-- Accepts the in-game name and returns the name of the page on the wiki
--
-- associated with that in-game item, resource, building, etc.
-- Accepts the in-game name and returns the corresponding inner table from
-------------------------------------------------------------------------------
-- tBuildingData. It is preferred that callers use the other getter functions
-- that return specific fields of the inner table rather than the whole thing,
-- to protect variations in this module.
-- @param buildingName the name of the building to look up
-- @return the inner table from the big data table corresponding to the provided
-- building name, or nil if it doesn't exist
function BuildingData.getData(buildingName)
-- If the argument to this function is empty or nil, save some time by
-- skipping the normalize function.
if not buildingName or "" == buildingName then
return nil
end
-- normalize the name to try again
    local buildingName = Utility.normalizeBuildingName(buildingName)
-- get the inner table from the big data table and return it; if it doesn't
-- exist, this will return nil anyway
    return tBuildingData[buildingName] or nil
end
 
 
 
---
-- Getter method for the page name for a building.
--
-- Accepts the in-game name of the building and returns the corresponding name
-- of the page in the wiki for the building. If the buildingName argument is
-- formatted exactly as in the game, this will return a string matching the
-- argument. Since normalization is performed, this can be used to ensure proper
-- formatting of the building's name.
-- @param buildingName the name of the building
-- @return the name of the page on the wiki, or nil if it doens't exist
function BuildingData.getPagename(buildingName)
 
-- get the inner table for the building
local tBuilding = BuildingData.getData(buildingName)
if not tBuilding then
return nil
end
-- if the building didn't exist, then nil was already returned, but if the
-- page was undefined, this should return nil instead of an empty string
return tBuilding.page
end
 
 
 
---
-- Getter method for the icon filename for a building.
--  
-- Accepts the in-game name of the building and returns the corresponding
-- filename on the wiki for the building's icon as seen in-game.
-- @param buildingName the name of the building
-- @return the filename, which might be an empty string, or nil if it doesn't
-- exist
function BuildingData.getIconFilename(buildingName)
-- get the inner table for the building
local tBuilding = BuildingData.getData(buildingName)
if not tBuilding then
return nil
end
-- Get the icon filename, if any. If the building doesn't have an icon,
-- then return an empty string. Returning nil is reserved for when the
-- building does not exist.
return tBuilding.iconfile or ""
end
 
 
 
---
-- Getter method for the specializations of a building.
--  
-- Accepts the in-game name of the building and returns the corresponding
-- specializations, if any, as a table of strings.
-- @param the name of the building
-- @return a table with the specializations for the building, which might be
-- empty if the building has no specializations, or nil if the building doesn't
-- exist
function BuildingData.getSpecialization(buildingName)
 
-- get the inner table for the building
local tBuilding = BuildingData.getData(buildingName)
-- if the building didn't exist, return nil
if not tBuilding then
return nil
end
local tSpec = {} -- this is our return variable
-- Get the specialization, if any. If there are none, then return that empty
-- table. Returning nil is reserved for when the building does not exist.
if tBuilding.specialization then
-- overwrite the return variable
tSpec = tBuilding.specialization
end
-- At this point, it could be an empty table, signifying that the building
-- exists but has no specialization.
return tSpec
end






-- returns the whole data table for the specified key
---
-- need to run normalize function first
-- Getter method for the building costs of a building.
function BuildingData.getData(strArg)
--
-- Accepts the in-game name of the building and returns the corresponding
-- costs in resources to build as a table of strings. Buildings that the player
-- starts with or are otherwise free to build will have no costs.
-- @param the name of the building
-- @return a table with the costs of the building, which may be empty if the
-- player starts with the building, or nil if the building doesn't exist; the
-- cost table has the following format:
-- { first cost { number, resource },
--   second cost { number, resource },
--   etc. }
function BuildingData.getCosts(buildingName)


-- normalize input
-- get the inner table for the building
    local strArg = Utility.normalizeBuildingName(strArg)
local tBuilding = BuildingData.getData(buildingName)
-- if the building didn't exist, return nil
if not tBuilding then
return nil
end
local tCost = {} -- this is our return variable
-- Get it from the big table below and return it.
-- Get the costs, if any. If there are none, then return that empty table.
    return tBuildingData[strArg]
-- Returning nil is reserved for when the building does not exist.
if tBuilding.cost then
-- overwrite the return variable
tCost = tBuilding.cost
end
-- At this point, it could be an empty table, signifying that the building
-- exists but has no cost.
return tCost
end
end






-- simpler version if all that's needed is the iconfile.
---
-- error handling by the calling module is required.
-- Getter method for the number of worker slots at a building.
function BuildingData.getIconFilename(strArg)
--  
-- Accepts the in-game name of the building and returns the corresponding
-- number of workers the building can take, if any.
-- @param the name of the building
-- @return the number of workers, which might be zero, or nil if the building
-- doesn't exist
function BuildingData.getWorkers(buildingName)


local data = getData(strArg)
-- get the inner table for the building
local tBuilding = BuildingData.getData(buildingName)
if not tBuilding then
return nil
end
-- if this particular data block doesn't have a iconfile, this will return nil
-- Get the number of worker slots, if any. If there are none, then return  
-- therefore, error handling will be necessary
-- zero. Returning nil is reserved for when the building does not exist.
return data.iconfile or nil
return tBuilding.workers or 0
end
end






-- simpler version if all that's needed is the page name.
---
-- error handling by the calling module is required.
-- Getter method for the type of rain used in Rain Engines in a building.
function BuildingData.getPagename(strArg)
--
-- Accepts the in-game name of the building and returns the corresponding
-- rain type.
-- @param the name of the building
-- @return the rain type, if any, or nil if the building doesn't exist
function BuildingData.getRainType(buildingName)


local data = getData(strArg)
-- get the inner table for the building
local tBuilding = BuildingData.getData(buildingName)
if not tBuilding then
return nil
end
-- if this particular data block doesn't have a page name, this will return nil
-- Get the rain type, if any. If the building cannot have rain engines, then
-- therefore, error handling will be necessary
-- return an empty string. Returning nil is reserved for when the building
return data.page or nil
-- does not exist.
return tBuilding.raintype or ""
end
end






-- simpler version if all that's needed is the description.
---
-- error handling by the calling module is required.
-- Getter method for the description for a building.
function BuildingData.getDescription(strArg)
--  
-- Accepts the in-game name of the building and returns the corresponding
-- description text, as seen in the game.
-- @param buildingName the name of the building
-- @return the description of the building, which might be an empty string, or
-- nil if it doesn't exist
function BuildingData.getDescription(buildingName)


local data = getData(strArg)
-- get the inner table for the building
local tBuilding = BuildingData.getData(buildingName)
if not tBuilding then
return nil
end
-- if this particular data block doesn't have a description, this will return nil
-- Get the description, if any. If the building doesn't have a description,
-- therefore, error handling will be necessary
-- then return an empty string. Returning nil is reserved for when the
return data.description or nil
-- building does not exist.
return tBuilding.description or ""
end
end



Latest revision as of 01:56, 18 February 2023

Documentation for this module may be created at Module:BuildingData/doc

-------------------------------------------------------------------------------
-- This module primarily supplies data and lookup functions for other modules 
-- that support templates like {{Building_link}}.
-- https://hoodedhorse.com/wiki/Against_the_Storm/Template:Building_link
-- 
-- The main data table stores all available data about buildings themselves 
-- and relies on other modules to store relationships between buildings and 
-- products, services, etc.
--
-- The helper functions include getters (to keep the data hidden) and a large
-- deconfliction method to provide some robustness when using the template
-- and from other Lua modules. Looking up a building requires using in-game 
-- names, but forgives small differences in spacing, apostrophes, and plurals.

-- Please help keep this table updated as the game is updated.
-- @module BuildingData
local BuildingData = {}

--
-- Dependencies
--
RecipeData = RecipeData or require("Module:RecipeData") -- need recipe relationships
Utility = Utility or require("Module:Utility") -- need normalize functions



-- 
-- Constants
-- 
-- Specializations
local S_ALCH = "Alchemy"
local S_BREW = "Brewing"
local S_CLOT = "Cloth"
local S_ENGI = "Engineering"
local S_MEAT = "Meat production"
local S_WARM = "Warmth"
local S_WOOD = "Wood"

-- Resource names of building costs
local C_BRICK = "Bricks"
local C_FABRI = "Fabric"
local C_PARTS = "Parts"
local C_PIPES = "Pipes"
local C_PLANK = "Planks"

-- Rain types for rain engines
local R_DRIZZ = "Drizzle Water"
local R_CLEAR = "Clearance Water"
local R_STORM = "Storm Water"



--
-- Class Variables
--

-------------------------------------------------------------------------------
-- Primary data table for this module.
-- 
-- This table stores the details of buildings according to in-game information.
-- A design decision of this table is to make the key the same as the page 
-- name, so that whenever .page is referenced, it can be used again to retrieve 
-- the rest of the data. (The lookup method will handle converting it to 
-- lowercase.)
--
-- Structure:
-- @key a lowercase version of the building name, with the same spaces, 
-- apostrophes, singular, and spelling
-- @field page the name of the wiki page, case-sensitive, but otherwise must be 
-- the same as the key
-- @field iconfile a string of the filename.png of the icon used in the game, 
-- case-sensitive and must include extension, but without the "File:"
-- @field specialization[opt] a table of the specializations listed in the 
-- in-game encyclopedia (use the constants, above), or omit if none
-- @field cost[opt] a table of the building costs (or omit if none), in the 
-- following format:
-- 		{ first cost { number, resource },
--		  second cost { number, resource },
--		  etc. }
-- @field workers the number of worker slots
-- @field raintype the color of rain used in the Rain Engine of this building 
-- (use constants, above), if any
-- @field description the in-game description text, in plain text
-- @table tBuildingData the primary data table for buildings
local tBuildingData = { 
	
	-- Starting Buildings
	["ancient hearth"] = { page="Ancient Hearth", 
		iconfile="Small Hearth icon.png", 
		specialization={ S_WARM }, 
		workers=1, 
		description="The heart of the colony is protected by the Holy Flame. Villagers gather here to rest, eat, and receive clothing. If the fire goes out, people will lose hope. Can't be moved. Size: 4x4." },
	["main warehouse"] = { page="Main Warehouse", 
		iconfile="Main_Storage_icon.png" },
	
	-- Camps
	["small foragers' camp"] = { page="Small Foragers' Camp", 
		iconfile="Small Foragers' Camp icon.png" },
	["foragers' camp"] = { page="Foragers' Camp", 
		iconfile="Forager's Camp icon.png" },
	["harvesters' camp"] = { page="Harvesters' Camp", 
		iconfile="Harvester Camp icon.png" },
	["small herbalists' camp"] = { page="Small Herbalists' Camp", 
		iconfile="Small_Herbalists'_Camp_icon.png" },
	["herbalists' camp"] = { page="Herbalists' Camp", 
		iconfile="Herbalist's_Camp_icon.png" },
	["stonecutters' camp"] = { page="Stonecutters' Camp", 
		iconfile="Stonecutter's Camp icon.png" },
	["small trappers' camp"] = { page="Small Trappers' Camp", 
		iconfile="Small_Trappers'_Camp_icon.png" },
	["trappers' camp"] = { page="Trappers' Camp", 
		iconfile="Trapper's Camp icon.png" },
	["woodcutters' camp"] = { page="Woodcutters' Camp", 
		iconfile="Woodcutters Camp icon.png" },
	
	-- Farms
	["farm field"] = { page="Farm Field", 
		iconfile="Farmfield_icon.png" },
	["greenhouse"] = { page="Greenhouse", 
		iconfile="Greenhouse_icon.png" },
	["herb garden"] = { page="Herb Garden", 
		iconfile="HerbGarden_icon.png" },
	["plantation"] = { page="Plantation", 
		iconfile="Plantation_icon.png" },
	["small farm"] = { page="Small Farm", 
		iconfile="SmallFarm_icon.png" },
	
	-- Food production
	["bakery"] = { page="Bakery", 
		iconfile="Bakery_icon.png" },
	["butcher"] = { page="Butcher", 
		iconfile="Butcher_icon.png" },
	["cellar"] = { page="Cellar", 
		iconfile="Cellar_icon.png" },
	["cookhouse"] = { page="Cookhouse", 
		iconfile="Cookhouse_icon.png" },
	["field kitchen"] = { page="Field Kitchen", 
		iconfile="Field_Kitchen_icon.png" },
	["granary"] = { page="Granary", 
		iconfile="Granary_icon.png" },
	["grill"] = { page="Grill", 
		iconfile="Grill_icon.png" },
	["ranch"] = { page="Ranch", 
		iconfile="Ranch_icon.png" },
	["smokehouse"] = { page="Smokehouse", 
		iconfile="Smokehouse_icon.png" },
	
	-- Housing
	["shelter"] = { page="Shelter", 
		iconfile="Shelter icon.png" },
	["big shelter"] = { page="Big Shelter", 
		iconfile="Big Shelter icon.png" },
	["human house"] = { page="Human House", 
		iconfile="Human House icon.png" },
	["beaver house"] = { page="Beaver House", 
		iconfile="Beaver House icon.png" },
	["lizard house"] = { page="Lizard House", 
		iconfile="Lizard House icon.png" },
	["harpy house"] = { page="Harpy House", 
		iconfile="Harpy House icon.png" },
	
	-- Industry
	["crude workstation"] = { page="Crude Workstation", 
		iconfile="Crude_Workstation_icon.png" },
	["makeshift post"] = { page="Makeshift Post", 
		iconfile="Makeshift_Post_icon.png" },
	["advanced rain collector"] = { page="Advanced Rain Collector", 
		iconfile="Advanced_Rain_Collector_icon.png", 
		specialization={ S_ENGI, S_ALCH }, 
		cost={ {5,C_PIPES}, {3,C_PARTS}, {5,C_PLANK} }, 
		description="Can collect infused rainwater used for crafting and powering Rain Engines in production buildings. The type of collected rainwater depends on the season. Can't be moved. Size: 3x2." },
	["alchemist's hut"] = { page="Alchemist's Hut", 
		iconfile="Alchemist_Hut_icon.png",
		specialization={ S_ALCH, S_BREW }, 
		cost={ {5,C_PLANK}, {2,C_BRICK} }, 
		workers=2, 
		raintype=R_CLEAR, 
		description="Can produce: Crystalized Dew (★★), Cosmetics (★★), Wine (★★). Can use: Clearance Water. Can't be moved. Size: 3x2." },
	["apothecary"] = { page="Apothecary", 
		iconfile="Apothecary_icon.png", 
		specialization={ S_ALCH }, 
		cost={ {5,C_PLANK}, {2,C_BRICK} }, 
		workers=2, 
		raintype=R_CLEAR, 
		description="Can produce: Cosmetics (★★), Incense (★★), Biscuits (★★). Can use: Clearance Water. Can't be moved. Size: 3x3." },
	["artisan"] = { page="Artisan", 
		iconfile="Artisan_icon.png" },
	["brewery"] = { page="Brewery", 
		iconfile="Brewery_icon.png" },
	["brick oven"] = { page="Brick Oven", 
		iconfile="Brick_Oven_icon.png" },
	["brickyard"] = { page="Brickyard", 
		iconfile="Brickyard_icon.png" },
	["carpenter"] = { page="Carpenter", 
		iconfile="Carpenter_icon.png" },
	["clothier"] = { page="Clothier", 
		iconfile="Clothier_icon.png" },
	["cooperage"] = { page="Cooperage", 
		iconfile="Cooperage_icon.png" },
	["druid's hut"] = { page="Druid's Hut", 
		iconfile="Druid_icon.png" },
	["flawless brewery"] = { page="Flawless Brewery", 
		iconfile="Brewery_icon.png" },
	["flawless rain mill"] = { page="Flawless Rain Mill", 
		iconfile="Rain_Mill_icon.png" },
	["furnace"] = { page="Furnace", 
		iconfile="Furnace_icon.png" },
	["kiln"] = { page="Kiln", 
		iconfile="Kiln_icon.png" },
	["leatherworker"] = { page="Leatherworker", 
		iconfile="Leatherworks_icon.png" },
	["lumber mill"] = { page="Lumber Mill", 
		iconfile="Lumbermill_icon.png" },
	["mine"] = { page="Mine", 
		iconfile="Mine_icon.png" },
	["press"] = { page="Press", 
		iconfile="Press_icon.png" },
	["provisioner"] = { page="Provisioner", 
		iconfile="Provisioner_icon.png" },
	["rain collector"] = { page="Rain Collector", 
		iconfile="Rain_Collector_icon.png" },
	["rain mill"] = { page="Rain Mill", 
		iconfile="Rain_Mill_icon.png" },
	["scribe"] = { page="Scribe", 
		iconfile="Scribe_icon.png" },
	["smelter"] = { page="Smelter", 
		iconfile="Smelter_icon.png" },
	["toolshop"] = { page="Toolshop", 
		iconfile="Toolshop_icon.png" },
	["weaver"] = { page="Weaver", 
		iconfile="Weaver_icon.png" },
	
	-- City Buildings
	["archaeologist's office"] = { page="Archaeologist's Office", 
		iconfile="Archeologist_office_icon.png",
		cost={ {2,C_PLANK}, {2,C_BRICK}, {2,C_FABRI} }, 
		description="A building designed to help you study the past. Can be upgraded to locate archaeological discoveries or improve exploration capabilities. Can be moved for: 5 Wood. Size: 3x3." },
	["small hearth"] = { page="Small Hearth", 
		iconfile="Temporary_Hearth_icon.png" },
	["warehouse"] = { page="Warehouse", 
		iconfile="Storage_icon.png" },
	["trading post"] = { page="Trading Post", 
		iconfile="Trading_Post_icon.png" },
	["blight post"] = { page="Blight Post", 
		iconfile="Blight_Post_icon.png" },
	["hydrant"] = { page="Hydrant", 
		iconfile="Hydrant_icon.png" },
	["forsaken altar"] = { page="Forsaken Altar", 
		iconfile="Altar_icon.png" },
	
	-- Service Buildings
	["bath house"] = { page="Bath House", 
		iconfile="Bath_House_icon.png" },
	["clan hall"] = { page="Clan Hall", 
		iconfile="Clan_Hall_icon.png" },
	["explorers' lodge"] = { page="Explorers' Lodge", 
		iconfile="Explorers_Lodge_icon.png" },
	["guild house"] = { page="Guild House",	
		iconfile="Guild_House_icon.png"	},
	["monastery"] = { page="Monastery", 
		iconfile="Monastery_icon.png"},
	["tavern"] = { page="Tavern", 
		iconfile="Tavern_icon.png" },
	["temple"] = { page="Temple", 
		iconfile="Temple_icon.png" },
		
} -- end of tBuildingData



-------------------------------------------------------------------------------
-- Main lookup function
-- 
-- Accepts the in-game name and returns the corresponding inner table from
-- tBuildingData. It is preferred that callers use the other getter functions
-- that return specific fields of the inner table rather than the whole thing,
-- to protect variations in this module.
-- @param buildingName the name of the building to look up
-- @return the inner table from the big data table corresponding to the provided
-- building name, or nil if it doesn't exist
function BuildingData.getData(buildingName)
	
	-- If the argument to this function is empty or nil, save some time by 
	-- skipping the normalize function.
	if not buildingName or "" == buildingName then
		return nil
	end
	
	-- normalize the name to try again
    local buildingName = Utility.normalizeBuildingName(buildingName)
	
	-- get the inner table from the big data table and return it; if it doesn't
	-- exist, this will return nil anyway
    return tBuildingData[buildingName] or nil
end



---
-- Getter method for the page name for a building.
-- 
-- Accepts the in-game name of the building and returns the corresponding name
-- of the page in the wiki for the building. If the buildingName argument is 
-- formatted exactly as in the game, this will return a string matching the
-- argument. Since normalization is performed, this can be used to ensure proper
-- formatting of the building's name.
-- @param buildingName the name of the building
-- @return the name of the page on the wiki, or nil if it doens't exist
function BuildingData.getPagename(buildingName)

	-- get the inner table for the building
	local tBuilding = BuildingData.getData(buildingName)
	if not tBuilding then
		return nil
	end
	
	-- if the building didn't exist, then nil was already returned, but if the
	-- page was undefined, this should return nil instead of an empty string
	return tBuilding.page
end



---
-- Getter method for the icon filename for a building.
-- 
-- Accepts the in-game name of the building and returns the corresponding 
-- filename on the wiki for the building's icon as seen in-game.
-- @param buildingName the name of the building
-- @return the filename, which might be an empty string, or nil if it doesn't 
-- exist
function BuildingData.getIconFilename(buildingName)
	
	-- get the inner table for the building
	local tBuilding = BuildingData.getData(buildingName)
	if not tBuilding then
		return nil
	end
	
	-- Get the icon filename, if any. If the building doesn't have an icon,
	-- then return an empty string. Returning nil is reserved for when the 
	-- building does not exist.
	return tBuilding.iconfile or ""
end



---
-- Getter method for the specializations of a building.
-- 
-- Accepts the in-game name of the building and returns the corresponding 
-- specializations, if any, as a table of strings.
-- @param the name of the building
-- @return a table with the specializations for the building, which might be
-- empty if the building has no specializations, or nil if the building doesn't 
-- exist
function BuildingData.getSpecialization(buildingName)

	-- get the inner table for the building
	local tBuilding = BuildingData.getData(buildingName)
	
	-- if the building didn't exist, return nil
	if not tBuilding then
		return nil
	end
	
	local tSpec = {} -- this is our return variable
	
	-- Get the specialization, if any. If there are none, then return that empty 
	-- table. Returning nil is reserved for when the building does not exist.
	if tBuilding.specialization then
		-- overwrite the return variable
		tSpec = tBuilding.specialization
	end
	
	-- At this point, it could be an empty table, signifying that the building
	-- exists but has no specialization.
	return tSpec
end



---
-- Getter method for the building costs of a building.
-- 
-- Accepts the in-game name of the building and returns the corresponding 
-- costs in resources to build as a table of strings. Buildings that the player
-- starts with or are otherwise free to build will have no costs.
-- @param the name of the building
-- @return a table with the costs of the building, which may be empty if the 
-- player starts with the building, or nil if the building doesn't exist; the
-- cost table has the following format:
-- 		{ first cost { number, resource },
--		  second cost { number, resource },
--		  etc. }
function BuildingData.getCosts(buildingName)

	-- get the inner table for the building
	local tBuilding = BuildingData.getData(buildingName)
	
	-- if the building didn't exist, return nil
	if not tBuilding then
		return nil
	end
	
	local tCost = {} -- this is our return variable
	
	-- Get the costs, if any. If there are none, then return that empty table. 
	-- Returning nil is reserved for when the building does not exist.
	if tBuilding.cost then
		-- overwrite the return variable
		tCost = tBuilding.cost
	end
	
	-- At this point, it could be an empty table, signifying that the building
	-- exists but has no cost.
	return tCost
end



---
-- Getter method for the number of worker slots at a building.
-- 
-- Accepts the in-game name of the building and returns the corresponding 
-- number of workers the building can take, if any.
-- @param the name of the building
-- @return the number of workers, which might be zero, or nil if the building 
-- doesn't exist
function BuildingData.getWorkers(buildingName)

	-- get the inner table for the building
	local tBuilding = BuildingData.getData(buildingName)
	if not tBuilding then
		return nil
	end
	
	-- Get the number of worker slots, if any. If there are none, then return 
	-- zero. Returning nil is reserved for when the building does not exist.
	return tBuilding.workers or 0
end



---
-- Getter method for the type of rain used in Rain Engines in a building.
-- 
-- Accepts the in-game name of the building and returns the corresponding 
-- rain type.
-- @param the name of the building
-- @return the rain type, if any, or nil if the building doesn't exist
function BuildingData.getRainType(buildingName)

	-- get the inner table for the building
	local tBuilding = BuildingData.getData(buildingName)
	if not tBuilding then
		return nil
	end
	
	-- Get the rain type, if any. If the building cannot have rain engines, then 
	-- return an empty string. Returning nil is reserved for when the building 
	-- does not exist.
	return tBuilding.raintype or ""
end



---
-- Getter method for the description for a building.
-- 
-- Accepts the in-game name of the building and returns the corresponding 
-- description text, as seen in the game.
-- @param buildingName the name of the building
-- @return the description of the building, which might be an empty string, or 
-- nil if it doesn't exist
function BuildingData.getDescription(buildingName)

	-- get the inner table for the building
	local tBuilding = BuildingData.getData(buildingName)
	if not tBuilding then
		return nil
	end
	
	-- Get the description, if any. If the building doesn't have a description,
	-- then return an empty string. Returning nil is reserved for when the 
	-- building does not exist.
	return tBuilding.description or ""	
end



-- Return this class when required into another module.
return BuildingData