材料服務是負責管理材料的遊戲服務。它是全球 MaterialVariant 實例的容器。MaterialVariant 可以是MaterialService的子孫或後代。對於每種基本物料輸入,MaterialService 內部保留一組物料變體參考。MaterialVariant.Name是存取它的關鍵。MaterialVariant.Name 和 MaterialVariant.BaseMaterial 結合以作為標示符工作。如果多於一個材料變體對象具有相同名稱和基材料在材料服務下,只能使用其中一個。
材料服務有一些(材料)名稱屬性。指派一個材料變體名稱會替換內建材料以指定的材料變體。如果材料服務無法找到匹配的材料變體,它會回到內置材料。注意,基本材料也應相符,例如,帶有基本材料草的材料變體只能分配給 MaterialService.GrassName,而不是 AsphaltName 或任何其他名稱。這些屬性無法使用腳本,但可以使用 MaterialService:GetBaseMaterialOverride() 和 MaterialService:SetBaseMaterialOverride() 函數來閱讀和寫入。
材料服務有一個 MaterialService.Use2022Materials 屬性,可以在舊材料和2022年新引入的材料之間切換。因為舊版本和使用者生成的(新)地形材料使用不同的編碼,使用舊版本地形材料和「物質變體」同時會有效能損失。如果您的遊戲使用 2022 年之前的地形材料,請避免覆蓋任何內置材料。如果可能,請移至 2022 年材料。
概要
屬性
指定 MaterialVariant 名稱以覆蓋內建的瀝青。
指定 MaterialVariant 名稱來覆蓋內置的巴薩爾特。
指定 MaterialVariant 名稱來覆蓋內置磚塊。
指定 MaterialVariant 名稱來覆蓋內建的石子。
指定 MaterialVariant 名稱來覆蓋內建混凝土。
指定 MaterialVariant 名稱以覆蓋內置的腐蝕金屬。
指定 MaterialVariant 名稱以覆蓋內建的CrackedLava。
指定 MaterialVariant 名稱來覆蓋內置的 DiamondPlate。
指定 MaterialVariant 名稱來覆蓋內建 Fabric。
指定 MaterialVariant 名稱來覆蓋內置鋁箔。
指定 MaterialVariant 名稱以覆蓋內建的冰川。
指定 MaterialVariant 名稱來覆蓋內置的花崗岩。
指定 MaterialVariant 名稱來覆蓋內置的草。
指定 MaterialVariant 名稱以覆蓋內置的地面。
指定 MaterialVariant 名稱來覆蓋內置的冰。
指定 MaterialVariant 名稱來覆蓋內置的葉狀草。
指定 MaterialVariant 名稱來覆蓋內置的石灰岩。
指定 MaterialVariant 名稱來覆蓋內置的大理石。
指定 MaterialVariant 名稱來覆蓋內置金屬。
指定 MaterialVariant 名稱以覆蓋內建的泥。
指定 MaterialVariant 名稱以覆蓋內建的路面。
指定 MaterialVariant 名稱以覆蓋內建的卵石。
指定 MaterialVariant 名稱以覆蓋內置塑膠。
指定 MaterialVariant 名稱以覆蓋內置的 Rock。
指定 MaterialVariant 名稱來覆蓋內建的鹽。
指定 MaterialVariant 名稱以覆蓋內建沙。
指定 MaterialVariant 名稱來覆蓋內建沙岩。
指定 MaterialVariant 名稱來覆蓋內置的板。
指定 MaterialVariant 名稱以覆蓋內建的 SmoothPlastic。
指定 MaterialVariant 名稱以覆蓋內置的雪。
切換內置材料包。
指定 MaterialVariant 名稱來覆蓋內置的木頭。
指定 MaterialVariant 名稱來覆蓋內置的木板。
方法
獲得指定物料類輸入的覆蓋 MaterialVariant 名稱。
獲得有名稱和材料的有效物質變體參考。
設置一個 MaterialVariant 名稱,可覆蓋內置材料。
屬性
CardboardName
CarpetName
CeramicTilesName
ClayRoofTilesName
LeatherName
PlasterName
RoofShinglesName
RubberName
方法
GetMaterialVariant
取得有效的材料變體參考,包括材料變體名稱和基本材料。此材料變體必須是MaterialService的後裔。如果沒有符合的實例存在,返回 nil 。
參數
材料變體的基本材料。
材料變體名稱。
返回
一個符合參數的材料變體實例。