Differences

This shows you the differences between two versions of the page.

--- scripting:reference:system_functions:buildinginformationfunctions [2023/02/28 13:05] – [sysGetBuyPrice] mit
+++ scripting:reference:system_functions:buildinginformationfunctions [2025/05/28 18:58] (current) – external edit 127.0.0.1
@@ Line 2: / Line 2: @@
 System functions that provide information about a building and its contents, and allow you to control the building UI.
+Unless otherwise stated, these functions refer to the building currently being accessed by the player. (This can be overriden using SetBuildingContext).
 ==== sysAmountInStocks ====
@@ Line 43: / Line 45: @@
     if ( $woodSellPrice == 0 )
     {
-        osdaddat( TEXT, 100, 100, 400, 0, "", "Not currently selling wood" )
+        osdadd( TEXT, 100, 100, 400, 0, "", "Not currently selling wood" )
     }
     else
     {
         $woodSellPriceText = sysGetPriceText( $woodSellPrice )
-        osdaddat( TEXT, 100, 100, 400, 0, "", "Currently selling wood at $woodSellPriceText" )
+        osdadd( TEXT, 100, 100, 400, 0, "", "Currently selling wood at $woodSellPriceText" )
     }
     osdactivate()
@@ Line 67: / Line 69: @@
     {
         $employeeName = sysGetPlayerName( $employeeID )
-        osdaddat( TEXT, 100, 100, 400, 0, "", "Employee : $employeeName" )
+        osdadd( TEXT, 100, 100, 400, 0, "", "Employee : $employeeName" )
     }
     else
     {
-        osdaddat( TEXT, 100, 100, 400, 0, "", "There is no-one currently employed at this building" )
+        osdadd( TEXT, 100, 100, 400, 0, "", "There is no-one currently employed at this building" )
     }
     osdactivate()
@@ Line 97: / Line 99: @@
 TBD\\
-==== sysBuildingActivateStockroom ====
+==== sysBuildingGetSoldItem ====
-==== sysBuildingActivateBuyItem ====
+==== sysBuildingGetMadeItem ====
-==== sysBuildingActivateSetPrices ====
+==== sysBuildingGetDemandedItem ====
-==== sysBuildingActivateSellItem ====
+==== sysBuildingGetProducedItem ====
-==== sysBuildingActivateEmployeeList ====
+==== sysBuildingGetTotalSold ====
+^ Format | sysBuildingGetTotalSold ( Item_Name_or_Num )|
+^ Description | Returns the total amount of the item that has been sold (since the count was reset with *buildingresetsoldtotal). If item name is omitted or set to 0, a total of all items is provided. |
+^ Example | ''**$totalSold = sysBuildingGetTotalSold ("Wood")**'' |
+==== sysBuildingGetTotalMade ====
+^ Format | sysBuildingGetTotalMade ( Item_Name_or_Num )|
+^ Description | Returns the total amount of the item that has been made (since the count was reset with *buildingresetmadetotal). If item name is omitted or set to 0, a total of all items is provided. |
+^ Example | ''**$totalMade = sysBuildingGetTotalMade (0)**'' |
 ===== Related System Values =====
@@ Line 107: / Line 118: @@
 \\
 \\
-**$gBuildingNum**, **$gBuildingAccessNum**, **$gBuildingScriptParam**, **$gBuildingX**, **$gBuildingY**, **$gBuildingCode**, **$gBuildingOwnerID**, **$gBuildingNumEmployees**, **$gBuildingMaxEmployees**, **$gBuildingSalePrice**, **$gBuildingWage**, **$gBuildingWorldX**, **$gBuildingWorldY**, **$gBuildingInvestment**,
+**$gBuildingX**, **$gBuildingY** : X,Y location of the building in map coords (default 0 -> 255)\\
-**$gBuildingEfficiency**, **$gBuildingScore**, **$gBuildingType**, **$gBuildingDamage**, **$gBuildingTeam**
+**$gBuildingCode** : Building type code - the number of the building type in the buildings editor list\\
+**$gBuildingNum**, **$gBuildingAccessNum** : Unique ID number of the specific building being accessed \\
+**$gBuildingWorldX**, **$gBuildingWorldY** : X,Y location of the building in world coords\\
+**$gBuildingTeam** : Team the building belongs to (or 0 if none)\\
+**$gBuildingCapacity** : Capacity value of the building (e.g. for homes)\\
+**$gBuildingSpaceRemaining** : Remaining capacity of the building (e.g. for homes)\\
+**$gBuildingTown** : Town building num of the town the building is in (or 0 if the building is not in a town)\\
+**$gBuildingScriptParam**, , **$gBuildingOwnerID**, **$gBuildingNumEmployees**, **$gBuildingMaxEmployees**, **$gBuildingSalePrice**, **$gBuildingWage**,  **$gBuildingInvestment**,
+**$gBuildingEfficiency**, **$gBuildingScore**, **$gBuildingType**, **$gBuildingDamage**,
+===== Collated Player Building Information =====
+The following functions are somewhat different.. rather than being about a specific building, they return information about all the buildings a player currently owns.
+==== sysPlayerBuildingsGetTotalMade ====
+^ Format | sysPlayerBuildingsGetTotalMade ( PlayerID, Item_Name_or_Num )|
+^ Description | Returns the total amount of the item that has been made in the player's current owned buildings. The total count can be reset using *buildingresetmadetotal [building_num] [item_num]. |
+^ Example | ''**$madeTotal = sysPlayerBuildingsGetTotalMade([PlayerID], "Bread")**'' |
+==== sysPlayerBuildingsGetTotalSold ====
+^ Format | sysPlayerBuildingsGetTotalSold ( PlayerID, Item_Name_or_Num )|
+^ Description | Returns the total amount of the item that has been sold from the player's current owned buildings. The total count can be reset using *buildingresetsoldtotal [building_num] [item_num] |
+^ Example | ''**$madeTotal = sysPlayerBuildingsGetTotalSold([PlayerID], "Bread")**'' |