For the complete documentation index, see llms.txt. This page is also available as Markdown.

씬 제한 사항

내 씬에 얼마나 많은 것을 넣을 수 있나요?

메타버스에서 성능을 개선하기 위해, 모든 씬이 따라야 하는 제한 집합을 마련했습니다. 이러한 제한은 파셀당 적용됩니다. 따라서 씬이 클수록 이러한 제한 값도 더 높게 설정됩니다.

다음과 작업할 때 Creator Hub, 씬에서 3D 모델이 사용하는 리소스에 대한 통계와 씬의 제한을 볼 수 있습니다.



이 메뉴를 확장하면 세부 정보를 볼 수 있습니다.



💡 팁: 파셀 수별 모든 세부 수치의 참고 표는 다음을 참조하세요:

참고 표

씬 제한 규칙

다음은 씬이 동시에 렌더링할 수 있는 요소의 최대 수입니다:

n 는 씬이 차지하는 파셀 수를 나타냅니다.

  • 삼각형: n x 10000 씬에 있는 모든 모델의 총 삼각형 수.

  • 엔티티: n x 200 씬 내 엔티티 수.

  • 바디: n x 300 씬 내 메시 수.

  • 재질: log2(n+1) x 20 씬 내 재질 수입니다. 모델의 일부로 가져온 재질도 포함됩니다.

  • 텍스처: log2(n+1) x 10 씬 내 텍스처 수입니다. 모델의 일부로 가져온 텍스처도 포함됩니다.

  • 높이: 330미터 차지하는 파셀 수와 관계없이 씬의 최대 높이입니다.

    경고: 200미터보다 높은 곳에 배치된 엔티티는 멀티플레이어 동기화 문제를 겪을 수 있습니다. 플레이어가 상호작용하는 콘텐츠나 플레이어 간에 동기화되는 콘텐츠는 그 높이보다 낮게 유지하세요.

    중요: 이러한 제한에는 현재 씬에서 렌더링되고 있는 엔티티만 계산됩니다. 씬이 3D 모델 사이를 전환하는 경우 중요한 것은 특정 시점에 렌더링되는 모델이며, 전체 합계가 아닙니다. 플레이어 아바타와 플레이어가 씬 밖에서 가져온 아이템도 이러한 제한을 계산할 때는 포함되지 않습니다.

  • 총 파일 크기: Genesis City에서 -파셀당 15MB - 최대 300MB. 월드의 경우 다음을 참조하세요 월드 크기. 콘텐츠 서버에 업로드된 파일의 총 크기입니다. 3D 모델과 오디오가 포함됩니다. node.js 패키지처럼 업로드되지 않는 파일은 포함되지 않습니다. 배포를 확정하기 전에 게시될 파일의 전체 목록과 각 파일 크기를 볼 수 있습니다.

  • 파일 수: 파셀당 200개 파일 업로드된 파일의 총 개수입니다. 3D 모델과 오디오가 포함됩니다. node.js 패키지처럼 업로드되지 않는 파일은 포함되지 않습니다.

  • 최대 파일 크기 파일당 50MB 씬의 어떤 유형의 개별 파일도 50MB를 초과할 수 없습니다. 작은 씬은 총 파일 크기 제한도 초과할 수 없기 때문에 더 엄격하게 제한됩니다(예: 단일 파셀 씬의 총 제한은 15MB입니다).

💡 팁: 씬 프로젝트 폴더의 모든 파일이 파일 크기 제한에 포함되는 것은 아니며, 서버에 업로드되는 파일만 포함됩니다. node_modules 폴더의 모든 내용은 매우 크지만 업로드되지 않는 종속성이므로 포함되지 않습니다. 같은 규칙이 /src 폴더에도 적용되는데, 소스 코드는 업로드되지 않기 때문입니다.

업로드에서 제외하려는 다른 파일이나 폴더를 다음에 .dclignore 파일에 나열할 수 있습니다.

최적화 중

다음을 참조하세요 성능 최적화 이러한 제한 아래로 씬을 유지하고 플레이어에게 더 부드럽게 실행되도록 하는 방법에 대한 팁입니다.

📱 모바일: 이 페이지의 하드 제한은 모든 클라이언트에 적용되지만, 모바일 기기는 데스크톱보다 여유가 적습니다. 모바일 앱을 대상으로 할 때는 이 제한보다 충분히 낮게 유지하고, 더 적은 삼각형, 더 적은 재질, 더 작은 텍스처를 선호하세요.

씬 경계

미리보기를 실행할 때 파셀 경계 밖에 위치한 콘텐츠는 렌더링 시 빨간색으로 강조 표시됩니다. 콘텐츠의 일부라도 이 경계 밖에 있으면 플레이어가 씬을 방문할 때 그 부분은 렌더링되지 않습니다.

큰 오브젝트의 끝부분이 경계를 벗어나면, 그 끝부분은 오브젝트에서 잘려 나갑니다.

단일 파셀 씬의 크기는 16미터 x 16미터입니다. 씬에 여러 파셀이 있는 경우, 크기는 파셀 배치에 따라 달라집니다.

엔티티를 지하에 배치하여 숨기거나 일부만 드러나게 할 수 있습니다. 씬에는 기본 지면 높이 아래로 내려가는 터널을 만들 수 없으며, 플레이어는 y = 0 높이 아래로 이동할 수 없습니다.

셰이더 제한

Decentraland에서 사용하는 3D 모델은 지원되는 셰이더와 재질을 사용해야 합니다. 다음을 참조하세요 3D 모델 재질 에서 지원되는 셰이더 목록을 확인하세요.

메시 압축

조명

개별 플레이어가 Explorer UI에서 자신의 스카이박스 설정을 변경할 수는 있지만, 씬의 조명 조건을 기본 설정에서 모든 플레이어에 대해 변경할 수는 없습니다.

텍스처 크기 제한

텍스처 크기는 다음 숫자와 일치하는 너비와 높이 숫자(픽셀 단위)를 사용해야 합니다:

이 수열은 2의 거듭제곱으로 이루어져 있습니다: f(x) = 2 ^ x . 1024는 텍스처 크기로 허용하는 최대값이며, 그보다 큰 텍스처는 에셋 번들 변환 과정에서 축소됩니다. 이는 다른 렌더링 엔진에서도 꽤 흔한 요구 사항으로, 그래픽 프로세서의 내부 최적화 때문입니다.

너비와 높이가 같은 숫자일 필요는 없지만, 둘 다 이 수열에 속해야 합니다.

텍스처의 권장 크기는 1024x1024입니다, 이는 국내 네트워크를 통해 전송하기에 최적의 크기이며, 적절한 로딩/품질 경험을 제공하는 것으로 확인되었습니다.

유효한 다른 크기 예시는 다음과 같습니다:

월드 크기

Decentraland 월드 는 단일 씬으로 로드되므로 서로 다른 제한이 있습니다.

  • Decentraland NAMEs에 게시된 월드는 동일한 지갑이 소유한 모든 월드에서 공유되는 저장 공간 예산에서 차감됩니다. 소유한 각 NAME은 100MB를 제공하고, 각 LAND 파셀은 추가로 100MB를 제공하며, 보유한 MANA 2,000개마다 추가로 100MB를 제공합니다. 이 예산은 원하는 대로 각 월드에 배분할 수 있습니다.

  • ENS 도메인에 게시된 월드의 제한은 36MB 이며 확장할 수 없습니다.

예산이 얼마나 사용되었고 얼마나 남았는지는 다음에서 확인할 수 있습니다 Manage Creator Hub의 섹션 또는 다음에서 월드 탭의 Builder탭에서 확인할 수 있습니다. 예산을 초과하면(예: 자산을 판매하거나 이전한 후) 월드가 접근 불가능해지기 전에 48시간 안에 공간을 확보해야 합니다.

다음을 참조하세요 월드 크기 제한 자세한 내용은

콘텐츠 서버에 업로드된 파일의 총 크기입니다. 3D 모델과 오디오가 포함됩니다. node.js 패키지처럼 업로드되지 않는 파일은 포함되지 않습니다. 배포를 확정하기 전에 게시될 파일의 전체 목록과 각 파일 크기를 볼 수 있습니다.

월드의 다른 모든 제한은 삼각형, 재질 등을 포함하여 파셀당 적용됩니다. 월드에 파셀을 추가하는 것은 무료이므로, 씬에 최대 300x300 파셀(총 90,000개)까지 추가할 수 있으며, 해당 파셀 수에 상응하는 제한을 적용받을 수 있습니다.

마지막 업데이트