MaterialService

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음
서비스

MaterialService는 재료를 관리하는 게임 서비스입니다.그것은 전역 MaterialVariant 인스턴스의 컨테이너입니다.MaterialVariant 는 MaterialService의 자식이나 후손일 수 있습니다.각 기본 재료 입력대해 MaterialService는 내부적으로 재료 변형 참조 집합을 유지합니다.MaterialVariant.Name는 액세스하는 데 필요한 키입니다.MaterialVariant.Name 및 MaterialVariant.BaseMaterial 는 식별자로 작동하도록 결합됩니다.한 개 이상의 재료 변형 개체에 재료 서비스에서 동일한 이름과 기본 재료가 있는 경우, 이들 중 하나만 사용할 수 있습니다.

MaterialService에는 (Material)Name 속성이 있습니다.재료 변형 이름을 할당하면 기본 재료를 지정된 재료 변형으로 바꿉니다.MaterialService가 일치하는 MaterialVariant을 찾을 수 없으면 기본 재료로 돌아갑니다.예를 들어 기본 재료 잔디가 있는 재료 변형과 기본 재료 잔디가 매치되어야 합니다(예: 아스팔트명이나 다른 이름이 아닌 MaterialService.GrassName에만 할당될 수 있음).이 속성은 스크립트할 수 없지만 MaterialService:GetBaseMaterialOverride() 및 MaterialService:SetBaseMaterialOverride() 함수를 사용하여 읽고 쓸 수 있습니다.

MaterialService에는 2022년에 도입된 새 재료와 레거시 재료 간을 전환하는 MaterialService.Use2022Materials 속성이 있습니다.레거시 및 사용자 생성(새) 지형 자료는 다른 인코딩을 사용하기 때문에 레거시 지형 자료와 재료 변형을 동시에 사용하면 성능 저하가 발생합니다.게임에서 2022년 이전 지형 재료를 사용하는 경우 기본 재료를 재정의하지 않도록 주의하십시오.가능하면 2022 재료로 마이그레이션하십시오.

요약

속성

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

메서드

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

속성

AsphaltName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 아스팔트를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 아스팔트로 설정되어야 합니다.

BasaltName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 Basalt를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterialBasalt로 설정해야 합니다.

BrickName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 벽돌을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 벽돌로 설정해야 합니다.

CardboardName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

CarpetName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

CeramicTilesName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

ClayRoofTilesName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

CobblestoneName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 코블스톤을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 코블스톤으로 설정되어야 합니다.

ConcreteName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 콘크리트를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 콘크리트로 설정되어야 합니다.

CorrodedMetalName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 CorrodedMetal을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 CorrodedMetal로 설정되어야 합니다.

CrackedLavaName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 CrackedLava를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형은 MaterialVariant.BaseMaterial CrackedLava로 설정되어야 합니다.

DiamondPlateName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 DiamondPlate를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterialDiamondPlate로 설정해야 합니다.

FabricName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 Fabric을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형은 Fabric에 MaterialVariant.BaseMaterial 설정되어야 합니다.

FoilName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 포일을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 포일로 설정되어야 합니다.

GlacierName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장 글레이저를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 글레이저로 설정되어야 합니다.

GraniteName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 그라나이트를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial Granite로 설정해야 합니다.

GrassName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 잔디를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial Grass로 설정해야 합니다.

GroundName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 지상을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 지상으로 설정되어야 합니다.

IceName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 Ice를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형은 Ice에 MaterialVariant.BaseMaterial 설정되어야 합니다.

LeafyGrassName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 LeafyGrass를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial LeafyGrass로 설정해야 합니다.

LeatherName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

LimestoneName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장 석회석을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 석회석으로 설정되어야 합니다.

MarbleName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 대리석을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 대리석으로 설정되어야 합니다.

MetalName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 메탈을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 메탈로 설정되어야 합니다.

MudName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 Mud를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형은 Mud에 MaterialVariant.BaseMaterial 설정되어야 합니다.

PavementName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장 포장을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 포장으로 설정되어야 합니다.

PebbleName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 조약돌을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 Pebble로 설정되어야 합니다.

PlasterName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

PlasticName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장 플라스틱을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 플라스틱으로 설정해야 합니다.

RockName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 록을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형은 MaterialVariant.BaseMaterial 로 설정되어야 합니다.

RoofShinglesName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

RubberName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

SaltName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 Salt를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 Salt로 설정되어야 합니다.

SandName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 모래를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 모래로 설정되어야 합니다.

SandstoneName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장 사암을 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 가 사암으로 설정되어야 합니다.

SlateName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 슬레이트를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial 슬레이트로 설정되어야 합니다.

SmoothPlasticName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 SmoothPlastic를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형에는 MaterialVariant.BaseMaterial SmoothPlastic로 설정해야 합니다.

SnowName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 Snow를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형은 Snow에 MaterialVariant.BaseMaterial 설정되어야 합니다.

Use2022Materials

boolean
복제되지 않음
Roblox 스크립트 보안
병렬 읽기

거짓일 때, 기본 제공 재료는 2022년 이전에 재료 팩을 사용합니다. 진실일 때, 기본 제공 재료는 2022년에 출시된 재료 팩을 사용합니다.

WoodName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장 우드를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형은 MaterialVariant.BaseMaterial 에 Wood로 설정되어야 합니다.

WoodPlanksName

string
스크립팅할 수 없음
Roblox 보안
병렬 읽기

내장된 WoodPlanks를 재정의하기 위해 MaterialVariant 이름을 지정하십시오. 지정된 재료 변형은 WoodPlanks에 MaterialVariant.BaseMaterial 설정되어야 합니다.

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

메서드

GetBaseMaterialOverride

string

지정된 재료 입력재정의 이름 MaterialVariant을 가져옵니다.

매개 변수

material: Enum.Material

검색할 재료 유형.

기본값: ""

반환

string

현재 재료 변형 이름이 재정의로 설정되었습니다.

GetMaterialVariant

MaterialVariant

재료 변형 이름과 기본 재료를 주어 효과적인 재료 변형 참조를 가져옵니다.Get the effective MaterialVariant reference given a MaterialVariant name and BaseMaterial.이 재료 변형은 MaterialService의 후손이어야 합니다.일치하는 인스턴스가 없으면 nil를 반환합니다.

매개 변수

material: Enum.Material

재료 변형의 기본 재료.

기본값: ""
name: string

재료 변형의 이름.

기본값: ""

반환

MaterialVariant

매개 변수와 일치하는 재료 변형 인스턴스.

SetBaseMaterialOverride

()

내장 재료를 재정의하는 MaterialVariant 이름을 설정하십시오.

매개 변수

material: Enum.Material

변경할 재료 유형.

기본값: ""
name: string

재료 변형 개체의 이름.

기본값: ""

반환

()
Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

이벤트

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기