材料服务是负责管理材料的游戏服务。它是全球 MaterialVariant 实例的容器。MaterialVariant 可以是MaterialService的子或后裔。对于每种基础材料输入,MaterialService 内部保留一组材料变体参考。MaterialVariant.Name是访问它的关键。MaterialVariant.Name 和 MaterialVariant.BaseMaterial 结合以作为标识符工作。如果多个材料变体对象具有相同名称和基础材料在材料服务下,只能使用其中一个。
MaterialService有一些(Material)名称属性。分配一个材料变体名称会替换内置材料以指定的材料变体。如果材料服务无法找到匹配的材料变体,它将回到内置材料。注意,基础材料也应匹配,例如,基础材料草只能分配给 MaterialService.GrassName,而不是 AsphaltName 或任何其他名称。这些属性不可脚本化,但可以使用 MaterialService:GetBaseMaterialOverride() 和 MaterialService:SetBaseMaterialOverride() 函数阅读和写入。
MaterialService 有一个 MaterialService.Use2022Materials 属性,可以在 2022 年引入的新材料和遗产材料之间切换。因为遗产和用户生成(新)的地形材料使用不同的编码,使用遗产地形材料和物质变体同时有性能滞后。如果你的游戏使用了 2022 年之前的地形材料,请避免覆盖任何内置材料。如果可能,请迁移到 2022 材料。
概要
属性
指定 MaterialVariant 名称来覆盖内置的沥青。
指定 MaterialVariant 名称来覆盖内置的 Basalt。
指定 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 如果没有匹配的实例存在。
参数
材料变体的基础材料。
材料变体名称。
返回
匹配参数的材料变体实例。