MaterialService

非推奨を表示
作成できません
サービス

MaterialService is the game service responsible for managing materials. It is the container for global MaterialVariant instances. MaterialVariant can be child or descendant of MaterialService. For each base Material type, MaterialService internally keeps a set of MaterialVariant references. MaterialVariant.Name is the key to access it. The MaterialVariant.Name and MaterialVariant.BaseMaterial are combined to work as an identifier. If more than one MaterialVariant object has the same name and BaseMaterial under MaterialService, only one of them can be used.

MaterialService has some (Material)Name properties. Assigning a MaterialVariant Name replaces the built-in material with the specified MaterialVariant. If the MaterialService can't find a matching MaterialVariant, it falls back to built-in material. Note BaseMaterial should also match, for example, a MaterialVariant with BaseMaterial Grass can only be assigned to MaterialService.GrassName, not AsphaltName or any other names. These properties are not scriptable but can read and write using MaterialService:GetBaseMaterialOverride() and MaterialService:SetBaseMaterialOverride() function.

MaterialService has a MaterialService.Use2022Materials property that switches between legacy materials and new materials introduced in year 2022. Because legacy and user-generated (new) terrain materials use different encoding, using legacy terrain materials and MaterialVariant at the same time has a performance penalty. If your game is using pre-2022 terrain materials, avoid overriding any built-in materials. Migrate to 2022 materials if possible.

概要

プロパティ

Instance から継承されたものをすべて表示

方法

Instance から継承されたものをすべて表示

プロパティ

AsphaltName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Asphalt. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Asphalt.

BasaltName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Basalt. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Basalt.

BrickName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Brick. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Brick.

CardboardName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

CarpetName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

CeramicTilesName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

ClayRoofTilesName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

CobblestoneName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Cobblestone. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Cobblestone.

ConcreteName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Concrete. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Concrete.

CorrodedMetalName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in CorrodedMetal. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to CorrodedMetal.

CrackedLavaName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in CrackedLava. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to CrackedLava.

DiamondPlateName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in DiamondPlate. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to DiamondPlate.

FabricName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Fabric. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Fabric.

FoilName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Foil. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Foil.

GlacierName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Glacier. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Glacier.

GraniteName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Granite. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Granite.

GrassName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Grass. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Grass.

GroundName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Ground. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Ground.

IceName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Ice. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Ice.

LeafyGrassName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in LeafyGrass. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to LeafyGrass.

LeatherName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

LimestoneName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Limestone. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Limestone.

MarbleName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Marble. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Marble.

MetalName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Metal. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Metal.

MudName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Mud. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Mud.

PavementName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Pavement. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Pavement.

PebbleName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Pebble. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Pebble.

PlasterName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

PlasticName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Plastic. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Plastic.

RockName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Rock. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Rock.

RoofShinglesName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

RubberName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

SaltName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Salt. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Salt.

SandName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Sand. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Sand.

SandstoneName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Sandstone. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Sandstone.

SlateName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Slate. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Slate.

SmoothPlasticName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in SmoothPlastic. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to SmoothPlastic.

SnowName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Snow. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Snow.

Use2022Materials

bool
複製されていません
並列読み取り
robloxのスクリプトセキュリティ

When it's false, built-in materials use the material pack before 2022. When it's true, built-in materials use the material pack released in 2022.

WoodName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in Wood. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to Wood.

WoodPlanksName

string
スクリプト作成できません
並列読み取り
robloxのセキュリティ

Specify MaterialVariant name to override built-in WoodPlanks. The Specified MaterialVariant must have MaterialVariant.BaseMaterial set to WoodPlanks.

Instance から継承されたものをすべて表示

方法

GetBaseMaterialOverride

string

Get the override MaterialVariant name of specified Material type.

パラメータ

material: Enum.Material

Material type to be fetched.


戻り値

string

MaterialVariant name currently set as override.

GetMaterialVariant

MaterialVariant

Get the effective MaterialVariant reference given a MaterialVariant name and BaseMaterial. This MaterialVariant must be a descendant of MaterialService. Returns nil if no matching instance exists.

パラメータ

material: Enum.Material

BaseMaterial of MaterialVariant.

name: string

Name of MaterialVariant.


戻り値

MaterialVariant

A MaterialVariant instance that matches parameters.

SetBaseMaterialOverride

void

Set a MaterialVariant name that overrides a built-in material.

パラメータ

material: Enum.Material

The Material type to be changed.

name: string

Name of the MaterialVariant object.


戻り値

void
Instance から継承されたものをすべて表示

イベント

Instance から継承されたものをすべて表示