MaterialService

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

无法创建
服务

材料服务是负责管理材料的游戏服务。它是全球 MaterialVariant 实例的容器。MaterialVariant 可以是MaterialService的子或后裔。对于每种基础材料输入,MaterialService 内部保留一组材料变体参考。MaterialVariant.Name是访问它的关键。MaterialVariant.NameMaterialVariant.BaseMaterial 结合以作为标识符工作。如果多个材料变体对象具有相同名称和基础材料在材料服务下,只能使用其中一个。

MaterialService有一些(Material)名称属性。分配一个材料变体名称会替换内置材料以指定的材料变体。如果材料服务无法找到匹配的材料变体,它将回到内置材料。注意,基础材料也应匹配,例如,基础材料草只能分配给 MaterialService.GrassName,而不是 AsphaltName 或任何其他名称。这些属性不可脚本化,但可以使用 MaterialService:GetBaseMaterialOverride()MaterialService:SetBaseMaterialOverride() 函数阅读和写入。

MaterialService 有一个 MaterialService.Use2022Materials 属性,可以在 2022 年引入的新材料和遗产材料之间切换。因为遗产和用户生成(新)的地形材料使用不同的编码,使用遗产地形材料和物质变体同时有性能滞后。如果你的游戏使用了 2022 年之前的地形材料,请避免覆盖任何内置材料。如果可能,请迁移到 2022 材料。

概要

属性

方法

属性

AsphaltName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的沥青。指定的材料变体必须设置为沥青。

BasaltName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的 Basalt。指定的材料变体必须设置为 Basalt。

BrickName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置砖块。指定的材料变体必须设置为砖块。

CardboardName

不可写入脚本
Roblox 安全性
读取并联

CarpetName

不可写入脚本
Roblox 安全性
读取并联

CeramicTilesName

不可写入脚本
Roblox 安全性
读取并联

ClayRoofTilesName

不可写入脚本
Roblox 安全性
读取并联

CobblestoneName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置鹅卵石。指定的材料变体必须设置为鹅卵石。

ConcreteName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置混凝土。指定的材料变体必须设置为混凝土。

CorrodedMetalName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的腐蚀金属。指定的材料变体必须设置为腐蚀金属。

CrackedLavaName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的CrackedLava。指定的材料变体必须设置为CrackedLava。

DiamondPlateName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的 DiamondPlate。指定的材料变体必须设置为 DiamondPlate。

FabricName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置 Fabric。指定的材料变体必须设置为 Fabric。

FoilName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置铝箔。指定的材料变体必须设置为铝箔。

GlacierName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的冰川。指定的材料变体必须设置为冰川。

GraniteName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置花岗岩。指定的材料变体必须设置为花岗岩。

GrassName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置草。指定的材料变体必须设置为草。

GroundName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置地形。指定的材料变体必须设置为地形。

IceName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的冰。指定的材料变体必须设置为冰。

LeafyGrassName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置叶状草。指定的材料变体必须设置为叶状草。

LeatherName

不可写入脚本
Roblox 安全性
读取并联

LimestoneName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置石灰岩。指定的材料变体必须设置为石灰岩。

MarbleName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置大理石。指定的材料变体必须设置为大理石。

MetalName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置金属。指定的材料变体必须设置为金属。

MudName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置泥。指定的材料变体必须设置为泥。

PavementName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置路面。指定的材料变体必须设置为路面。

PebbleName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置鹅卵石。指定的材料变体必须设置为鹅卵石。

PlasterName

不可写入脚本
Roblox 安全性
读取并联

PlasticName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置塑料。指定的材料变体必须设置为塑料。

RockName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的岩石。指定的材料变体必须设置为岩石。

RoofShinglesName

不可写入脚本
Roblox 安全性
读取并联

RubberName

不可写入脚本
Roblox 安全性
读取并联

SaltName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置盐。指定的材料变体必须设置为盐。

SandName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置沙子。指定的材料变体必须设置为沙子。

SandstoneName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置砂岩。指定的材料变体必须设置为砂岩。

SlateName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置板。指定的材料变体必须设置为板。

SmoothPlasticName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置 SmoothPlastic。指定的材料变体必须设置为 SmoothPlastic。

SnowName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置的雪。指定的材料变体必须设置为雪。

Use2022Materials

未复制
Roblox 脚本安全性
读取并联

当它为 false 时,内置材料使用 2022 年之前的材料包。当它为 true 时,内置材料使用 2022 年发布的材料包。

WoodName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置木材。指定的材料变体必须设置为木材。

WoodPlanksName

不可写入脚本
Roblox 安全性
读取并联

指定 名称来覆盖内置木板。指定的材料变体必须设置为木板。

方法

GetBaseMaterialOverride

获取指定材料输入的覆盖名称 MaterialVariant

参数

material: Enum.Material

要获取的材料类型。

默认值:""

返回

材料变体名称目前设置为覆盖。

GetMaterialVariant

获取给定材料变体名称和基础材料的有效材料变体参考。这种材料变体必须是MaterialService的后裔。返回 nil 如果没有匹配的实例存在。

参数

material: Enum.Material

材料变体的基础材料。

默认值:""
name: string

材料变体名称。

默认值:""

返回

匹配参数的材料变体实例。

SetBaseMaterialOverride

()

设置一个 MaterialVariant 名称,可覆盖内置材料。

参数

material: Enum.Material

要更改的材料类型。

默认值:""
name: string

材料变体对象的名称。

默认值:""

返回

()

活动