UGC 검증 시스템은 사용자가 아바타 자산을 마켓플레이스에 업로드하고 게시할 수 있기 전에 자산이 플랫폼 사양을 충족하는지 확인하는 Roblox의 기술 메커니즘입니다. 이 프로세스는 아바타 몸체, 화장품, 의류 및 액세서리가 플랫폼 전반에 걸쳐 일관되게 작용하도록 보장합니다.
UGC 검증 시스템은 다음과 같은 시점에서 실행됩니다:
- 스튜디오를 통해 아바타 자산을 마켓플레이스에 업로드하려고 할 때.
- 경험 내 아바타 자산 생성을 위해 AvatarCreationService API를 호출할 때.
이 과정에서 UGC 검증 시스템은 자산이 자산 유형에 따라 특정한 검증 카테고리에 대한 요구 사항을 충족하는지 확인합니다. 이러한 요구 사항의 포괄적인 목록은 신체 사양, 다이나믹 헤드 사양, 메이크업 사양, 강체 액세서리 사양 및 레이어드 액세서리 사양을 참조하십시오.
아바타 자산이 검증을 통과하면, 사용자는 업로드 수수료를 지불하고 자산을 검토를 위해 제출하며 마켓플레이스에서 판매를 진행할 수 있으며, 또는 플레이어는 경험 내에서 자신이 생성한 아바타 자산을 구매할 수 있습니다.
아바타 자산이 검증을 통과하지 못하면, 사용자 또는 플레이어는 아바타 자산이 검증을 통과하지 못한 이유에 대한 정보가 담긴 오류 메시지를 받습니다. 문제 해결을 위해 UGC 검증 시스템에는 자산 특화 시각화 도구가 포함되어 있어 자산이 검증을 통과할 수 있도록 수정하거나 개선할 방법에 대한 시각적 가이드를 제공합니다.
마켓플레이스에 사용할 의도가 없는 자산, 예를 들어 게임 내에서만 사용할 자산은 검증 프로세스를 통과할 필요가 없습니다. 그럼에도 불구하고 검증 프로세스는 사용자 정의 몸체 및 액세서리에 대한 문제 해결 및 디버깅에 여전히 유용할 수 있습니다.
검증 카테고리
UGC 검증 시스템은 검증을 여러 고수준 카테고리로 조직합니다. 이러한 카테고리에 대한 정보와 해당 카테고리의 검증 영역에 대한 설명은 다음 표를 검토하십시오.
| 카테고리 | 검증하는 항목 |
|---|---|
| 스키마 |
|
| 메시 기하학 |
|
| 텍스처 / 재료 |
|
| 리깅 / 스키닝 |
|
| 내부 및 외부 케이지 |
|
| 첨부물 |
|
| 다이나믹 헤드 |
|
| 보안 / 검토 |
|
시각화 검증
UGC 검증 시스템은 아바타 자산이 마켓플레이스에 준비되지 않은 경우 이를 식별하고 이해하며 진단하고 수정하는 데 도움이 되는 선택적 시각화 도구를 포함합니다. 활성화되면 시각화 검증은 비 준수 자산에 대한 검증 오류 정보와 개선이 필요한 준수 자산에 대한 품질 평가를 제공합니다.
UGC 검증 시스템의 시각화 도구에 액세스하려면 먼저 베타 기능을 활성화해야 합니다. 선택적 시각화 검증을 활성화하고 사용하려면:
스튜디오에서 파일 > 베타 기능으로 이동합니다.
UGC 검증 시각화를 활성화합니다.
스튜디오를 다시 시작한 후, 메자닌에서 플러스 아이콘을 클릭하여 사용자 지정 탭을 추가합니다. 새로운 탭이 표시됩니다.
사용자 지정 탭에서 도구 추가 버튼을 클릭합니다. 도구 추가 팝업 창이 표시됩니다.
UGC 검증을 활성화하여 툴바에 추가한 후 창을 닫습니다.
사용자 지정 탭으로 돌아가 UGC 검증 버튼을 선택하여 플러그인을 실행합니다. UGC 검증 창이 표시됩니다.
탐색기 창에서 캐릭터 몸체, 다이나믹 헤드, 강체 액세서리 또는 레이어드 액세서리를 선택한 후 UGC 검증 창으로 돌아가 검증 실행 버튼을 클릭합니다. 팝업 창이 표시됩니다.
팝업 창에서:
선택한 아바타 자산의 자산 유형을 확인합니다. 예를 들어 Enum.AccessoryType.Pants 레이어드 액세서리를 선택한 경우 드롭다운 메뉴를 사용하여 PantsAccessory를 선택합니다.
검증 실행 버튼을 클릭합니다.
검증 서비스는 백그라운드에서 실행되며 자산 상태에 따라 오류 및/또는 경고의 조합으로 UGC 검증 창에서 결과를 보고합니다. 각 시각적 검증에 대한 정보는 다음 하위 섹션을 참조하십시오.
Measure_Cage_Distance_Head
Measure_Cage_Distance_Head는 아바타 헤드의 외부 케이지가 헤드 메시를 얼마나 밀접하게 감싸는지를 점수로 매기는 검증 점검입니다. 이 검증은 케이지가 메시에서 너무 멀리 떠 있거나 케이지가 메시 안으로 들어가지 않도록 확인합니다.
| 오류 코드 | 심각도 |
|---|---|
| 입력 데이터가 올바르지 않거나 불완전하기 때문에 품질 점수를 제대로 계산할 수 없습니다. 모델을 확인하거나 버그 보고서를 제출하십시오. | 검증 차단 |
| 헤드 케이지가 헤드 메시와 교차합니다. {negativeSDFPercent}%의 헤드 케이지 정점이 헤드 메시 안에 있습니다. | 검증 차단 |
| 헤드 케이지가 헤드 메시에서 너무 멀리 떨어져 있습니다. 헤드 케이지와 메시 간의 최대 거리는 {max_sdf}로 허용된 임계값인 {max_sdf_threshold}를 초과합니다. | 검증 차단 |
| 자산 품질 경고: 헤드 케이지 거리 점수는 {score}입니다. 헤드 케이지와 메시 간의 최대 거리는 {max_distance}이고, {negative_sdf_percent}%의 헤드 케이지 정점이 헤드 메시 안에 있습니다. | 경고 |
Measure_Cage_Mesh_Distance
Measure_Cage_Mesh_Distance는 레이어드 의류의 외부 케이지가 렌더링된 메시를 얼마나 밀접하게 추적하는지를 점수로 매기는 검증 점검입니다. 이 검증은 케이지가 너무 멀리 떠 있거나 메시 안으로 밀어넣는 경우에 플래그가 지정됩니다.
| 오류 코드 | 심각도 |
|---|---|
| 입력 데이터가 올바르지 않거나 불완전하기 때문에 품질 점수를 제대로 계산할 수 없습니다. 모델을 확인하거나 버그 보고서를 제출하십시오. | 검증 차단 |
| 외부 케이지가 렌더 메시와 교차합니다. {negativeSDFPercent}%의 외부 케이지 정점이 렌더 메시 안에 있습니다. | 검증 차단 |
| 외부 케이지가 렌더 메시에서 너무 멀리 떨어져 있습니다. 외부 케이지와 메시 간의 최대 거리는 {max_sdf}로 허용된 임계값인 {max_sdf_threshold}를 초과합니다. | 검증 차단 |
| 자산 품질 경고: 케이지-메시 거리 점수는 {score}입니다. 외부 케이지와 메시 간의 최대 거리는 {max_distance}이고, {negative_sdf_percent}%의 외부 케이지 정점이 렌더 메시 안에 있습니다. | 경고 |
Measure_Cage_Mesh_Distance_Avatar
Measure_Cage_Mesh_Distance_Avatar는 전체 몸체 외부 케이지가 몸체 메시를 얼마나 밀접하게 따르는지를 점수로 매기는 검증 점검입니다. 이 검증은 케이지가 표면에서 너무 멀리 떠 있거나 교차할 경우 플래그를 지정합니다.
| 오류 코드 | 심각도 |
|---|---|
| 입력 데이터가 올바르지 않거나 불완전하기 때문에 품질 점수를 제대로 계산할 수 없습니다. 모델을 확인하거나 버그 보고서를 제출하십시오. | 검증 차단 |
| 몸체 케이지가 몸체 메시와 교차합니다. {negativeSDFPercent}%의 몸체 케이지 정점이 몸체 메시 안에 있습니다. | 검증 차단 |
| 몸체 케이지가 몸체 메시에서 너무 멀리 떨어져 있습니다. 몸체 케이지와 메시 간의 최대 거리는 {max_sdf}로 허용된 임계값인 {max_sdf_threshold}를 초과합니다. | 검증 차단 |
| 자산 품질 경고: 몸체 케이지 거리 점수는 {score}입니다. 몸체 케이지와 메시 간의 최대 거리는 {max_distance}이고, {negative_sdf_percent}%의 몸체 케이지 정점이 몸체 메시 안에 있습니다. | 경고 |
Measure_Cage_Relevancy
Measure_Cage_Relevancy는 외부 케이지를 이동시켜 실제로 액세서리를 덮는 정도를 점수로 매기는 검증 점검입니다. 이 검증은 케이지 수정이 의류가 필요로 하는 위치에 고정되도록 해야 합니다.
| 오류 코드 | 심각도 |
|---|---|
| 입력 데이터가 올바르지 않거나 불완전하기 때문에 품질 점수를 제대로 계산할 수 없습니다. 모델을 확인하거나 버그 보고서를 제출하십시오. | 검증 차단 |
| {outer_cage_face_irrelevant_percent}%의 수정된 외부 케이지 정점이 액세서리를 덮지 않고 있습니다. 필요할 때만 외부 케이지를 이동하고 있는지 확인하십시오. | 검증 차단 |
| 자산 품질 경고: 케이지 관련성 점수는 {score}입니다. {irrelevant_percent}%의 수정된 외부 케이지 정점이 액세서리를 덮지 않고 있습니다. | 경고 |
Measure_Cage_UV
Measure_Cage_UV는 내부 및 외부 케이지 UV가 레이어드 의류 템플릿에 맞는지 확인하는 검증 점검입니다. 템플릿과 맞지 않는 UV는 자산이 몸에 잘 감기지 않게 만듭니다.
| 오류 코드 | 심각도 |
|---|---|
| 입력 데이터가 올바르지 않거나 불완전하기 때문에 품질 점수를 제대로 계산할 수 없습니다. 모델을 확인하거나 버그 보고서를 제출하십시오. | 검증 차단 |
| 케이지 {cage_name}에 {incorrect_uv_count}개의 잘못된 UV 값이 있습니다. 케이지 UV를 수정하십시오. | 검증 차단 |
| 자산 품질 경고: 케이지 UV 점수는 {score}이고, {cage_name}의 잘못된 UV 수는 {incorrect_uv_count}개입니다. | 경고 |
Measure_Cage_UV_Avatar
Measure_Cage_UV_Avatar는 각 신체 부위에 대해 UV가 표준 템플릿에 머무르게 하는 케이지가 있는지를 검사하는 검증 점검입니다. 잘못된 케이지 UV는 레이어드 의류가 몸에 잘 감기지 않게 만듭니다.
| 오류 코드 | 심각도 |
|---|---|
| 입력 데이터가 올바르지 않거나 불완전하기 때문에 품질 점수를 제대로 계산할 수 없습니다. 모델을 확인하거나 버그 보고서를 제출하십시오. | 검증 차단 |
| 케이지 {cage_name}에 {incorrect_uv_count}개의 잘못된 UV 값이 있습니다. 케이지 UV를 수정하십시오. | 검증 차단 |
| 자산 품질 경고: 케이지 UV 점수는 {score}이고, {cage_name}의 잘못된 UV 수는 {incorrect_uv_count}개입니다. | 경고 |
Measure_Degen_Triangles
Measure_Degen_Triangles는 각 메시 부품에 대해 퇴행삼각형 (영역이 0 또는 거의 0인 면)을 점수로 매기는 검증 점검입니다. 퇴행 삼각형은 표면을 추가하지 않으며 렌더링을 방해할 수 있습니다.
| 오류 코드 | 심각도 |
|---|---|
| 자산 품질: {partName}는 {degenerate_triangle_percent}%의 퇴행 삼각형이 있습니다 (점수: {score}). | 경고 |
| 자산 품질 점수는 {measureName}에 대해 계산할 수 없었습니다. 입력 데이터가 불완전하거나 잘못되었습니다. 이는 업로드를 차단하지 않습니다. | 경고 |
Measure_Dynamic_Head
Measure_Dynamic_Head는 다이나믹 헤드가 애니메이션이 가능한지 검증하는 점검입니다. 애니메이션이 가능한 다이나믹 헤드는 헤드 케이지, FACS 데이터, 정렬된 랜드마크가 있으며 눈을 감고, 입을 열고, 감정을 표현할 수 있습니다.
| 오류 코드 | 심각도 |
|---|---|
| 입력 데이터가 올바르지 않거나 불완전하기 때문에 품질 점수를 제대로 계산할 수 없습니다. 모델을 확인하거나 버그 보고서를 제출하십시오. | 검증 차단 |
| 마켓플레이스의 다이나믹 헤드는 눈과 입 정점이 케이지에서 메시 정점과 일치하도록 올바르게 케이지가 되어야 합니다. 케이지 및 메시의 정렬을 개선하십시오. | 검증 차단 |
| 다이나믹 헤드에 대해 미소 표현을 감지할 수 없습니다. 입의 케이지 랜드마크를 조정하여 입이 헤드에서 어디에 위치하는지와 일치하도록 하고 미소 표현을 할 수 있도록 하십시오. | 검증 차단 |
| 다이나믹 헤드의 왼쪽 눈 감기 표현을 감지할 수 없습니다. 왼쪽 눈의 케이지 랜드마크를 조정하여 왼쪽 눈이 헤드에서 어디에 위치하는지와 일치하도록 하고 감을 수 있도록 하십시오. | 검증 차단 |
| 마켓플레이스의 다이나믹 헤드에는 헤드 케이지가 없습니다. 다이나믹 헤드에 대한 헤드 케이지를 만들어 주십시오. | 검증 차단 |
| 다이나믹 헤드의 입 열기 표현을 감지할 수 없습니다. 입의 케이지 랜드마크를 조정하여 입이 헤드에서 어디에 위치하는지와 일치하도록 하고 열 수 있도록 하십시오. | 검증 차단 |
| 마켓플레이스의 다이나믹 헤드는 애니메이션되어야 하지만 이 헤드는 FACS 데이터가 없습니다. | 검증 차단 |
| 다이나믹 헤드의 오른쪽 눈 감기 표현을 감지할 수 없습니다. 오른쪽 눈의 케이지 랜드마크를 조정하여 오른쪽 눈이 헤드에서 어디에 위치하는지와 일치하도록 하고 감을 수 있도록 하십시오. | 검증 차단 |
| 다이나믹 헤드의 찌푸리기 표현을 감지할 수 없습니다. 입의 케이지 랜드마크를 조정하여 입이 헤드에서 어디에 위치하는지와 일치하도록 하고 찌푸리기 표현을 할 수 있도록 하십시오. | 검증 차단 |
| 자산 품질 경고: 다이나믹 헤드 표현 점수는 {score}입니다. | 경고 |
Measure_Joint_Number
Measure_Joint_Number는 몸체 리깅의 관절 설정을 예상 구성과 비교하여 점수로 매기는 검증 점검입니다. 몸체 리깅의 관절 설정은 고충실도 리깅의 왼쪽 및 오른쪽 손의 관절 수를 포함합니다.
| 오류 코드 | 심각도 |
|---|---|
| 자산 품질: 관절 구성 점수가 {score} (관절: {joint_number}, 왼손: {left_hand_joint_number}, 오른손: {right_hand_joint_number}). | 경고 |
| 자산 품질 점수는 {measureName}에 대해 계산할 수 없었습니다. 입력 데이터가 불완전하거나 잘못되었습니다. 이는 업로드를 차단하지 않습니다. | 경고 |
Measure_Mesh_Manifold
Measure_Mesh_Manifold는 각 메시 부품을 점수로 매겨 매니폴드 무결성을 검사하고, 홀, 비매니폴드 엣지 및 기하학적 유사한 문제를 찾습니다.
| 오류 코드 | 심각도 |
|---|---|
| 자산 품질: {partName}는 메시 매니폴드 문제가 있습니다 (점수: {score}). | 경고 |
| 자산 품질 점수는 {measureName}에 대해 계산할 수 없었습니다. 입력 데이터가 불완전하거나 잘못되었습니다. 이는 업로드를 차단하지 않습니다. | 경고 |
Measure_Mesh_Outside_OuterCage
Measure_Mesh_Outside_OuterCage는 액세서리의 렌더 메시가 얼마나 많은 부분이 케이지 사이에 있는지를 점수로 매기는 검증 점검입니다. 외부 케이지 밖으로 빠져나온 메시가 착용할 때 변형이 심합니다.
| 오류 코드 | 심각도 |
|---|---|
| 입력 데이터가 올바르지 않거나 불완전하기 때문에 품질 점수를 제대로 계산할 수 없습니다. 모델을 확인하거나 버그 보고서를 제출하십시오. | 검증 차단 |
| {mesh_outside_outer_cage_percent}%의 메시 정점이 액세서리의 외부 케이지 밖에 있습니다. 케이지의 사이에 더 많은 액세서리가 있도록 조정하십시오. | 검증 차단 |
| 자산 품질 경고: 메시 포함 점수는 {score}입니다. {mesh_outside_outer_cage_percent}%의 메시 정점이 외부 케이지 밖에 있습니다. | 경고 |
Measure_Texture_Complexity
Measure_Texture_Complexity는 각 텍스처에 대해 시각적 복잡성을 점수로 매겨, 자산에 세부 사항을 거의 추가하지 않는 평면 또는 거의 비어 있는 텍스처를 플래그로 지정합니다.
| 오류 코드 | 심각도 |
|---|---|
| 자산 품질 점수는 {measureName}에 대해 계산할 수 없었습니다. 입력 데이터가 불완전하거나 잘못되었습니다. 이는 업로드를 차단하지 않습니다. | 경고 |
| 자산 품질: 텍스처 {textureName}는 복잡성이 낮습니다 (점수: {score}). | 경고 |
Measure_Texture_Resolution
Measure_Texture_Resolution는 각 텍스처를 픽셀 크기로 점수로 매겨 자산이 몸에 선명하게 유지되도록 충분히 높은 해상도를 보상합니다.
| 오류 코드 | 심각도 |
|---|---|
| 자산 품질 점수는 {measureName}에 대해 계산할 수 없었습니다. 입력 데이터가 불완전하거나 잘못되었습니다. 이는 업로드를 차단하지 않습니다. | 경고 |
| 자산 품질: 텍스처 {textureName}의 해상도는 {texture_width}x{texture_height} (점수: {score})입니다. | 경고 |
Measure_Triangle_Intersection
Measure_Triangle_Intersection는 각 메시 부품에 대해 서로 교차하는 삼각형을 점수로 매기는 검증 점검입니다. 면들이 서로를 통과하여 엉망이거나 겹치는 기하학을 생성합니다.
| 오류 코드 | 심각도 |
|---|---|
| 자산 품질 점수는 {measureName}에 대해 계산할 수 없었습니다. 입력 데이터가 불완전하거나 잘못되었습니다. 이는 업로드를 차단하지 않습니다. | 경고 |
| 자산 품질: {partName}는 {intersecting_tri_face_percent}%의 교차 삼각형 면이 있습니다 (점수: {score}). | 경고 |
Measure_UV_Bound
Measure_UV_Bound는 메시의 UV 정점 중 얼마나 많은 수가 0-1 텍스처 공간 밖에 있는지를 측정하는 검증 점검입니다. 점수를 보고하지만 업로드는 차단하지 않습니다.
| 오류 코드 | 심각도 |
|---|---|
| 자산 품질 점수는 {measureName}에 대해 계산할 수 없었습니다. 입력 데이터가 불완전하거나 잘못되었습니다. 이는 업로드를 차단하지 않습니다. | 경고 |
| 자산 품질: {partName}는 {uv_outside_bound_vert_percent}%의 UV 정점이 경계 밖에 있습니다 (점수: {score}). | 경고 |
Measure_Vertex_Similarity
Measure_Vertex_Similarity는 메시에서 근사 중복 정점의 비율을 측정하는 검증 점검입니다. 점수를 보고하지만 업로드는 차단하지 않습니다.
| 오류 코드 | 심각도 |
|---|---|
| 자산 품질 점수는 {measureName}에 대해 계산할 수 없었습니다. 입력 데이터가 불완전하거나 잘못되었습니다. 이는 업로드를 차단하지 않습니다. | 경고 |
| 자산 품질: {partName}는 {similar_vertex_percent}%의 유사한 정점을 가지고 있습니다 (점수: {score}). | 경고 |