UGC-Validierungssystem | Dokumentation

Das UGC-Validierungssystem ist Robloxs technischer Mechanismus, der überprüft, ob Avatar-Assets den Plattform-Spezifikationen entsprechen, bevor Sie sie in den Marketplace hochladen und veröffentlichen können. Dieser Prozess stellt sicher, dass Avatar-Körper, Kosmetik, Kleidung und Accessoires auf der Plattform konsistent funktionieren.

Das UGC-Validierungssystem läuft jedes Mal, wenn Sie:

Versuchen, ein Avatar-Asset über Studio in den Marketplace hochzuladen.
AvatarCreationService-APIs für die Erstellung von Avatar-Assets im Erlebnis aufrufen.

Während dieses Prozesses überprüft das UGC-Validierungssystem Ihr Asset, um zu sehen, ob es die Anforderungen in Validierungskategorien erfüllt, die spezifisch für seinen Asset-Typ sind. Für eine umfassende Liste dieser Anforderungen siehe Körperspezifikationen, Dynamische Kopfspezifikationen, Makeup-Spezifikationen, Starrzubehör-Spezifikationen und Layered-Zubehör-Spezifikationen.

Wenn ein Avatar-Asset die Validierung besteht, können Sie mit dem Upload-Prozess im Studio fortfahren, indem Sie die Upload-Gebühr zahlen, das Asset zur Moderation einreichen und es im Marketplace verkaufen, oder der Spieler kann fortfahren, um das Avatar-Asset zu kaufen, das er innerhalb eines Erlebnisses erstellt hat.

Wenn ein Avatar-Asset die Validierung nicht besteht, erhalten Sie oder der Spieler Fehlermeldungen mit Informationen dazu, warum das Avatar-Asset die Validierung nicht bestanden hat. Für Unterstützung bei der Fehlersuche bietet die UGC-Validierung Visualisierungstools mit Prüfungen, die assetspezifische visuelle Anleitungen bereitstellen, um Ihr Asset zu beheben oder zu verbessern, damit es die Validierung bestehen kann.

Assets, die Sie nicht für den Marketplace verwenden möchten, wie z.B. solche, die nur für den In-Game-Gebrauch bestimmt sind, müssen die Validierung nicht bestehen. Trotzdem kann der Validierungsprozess nützlich sein, um benutzerdefinierte Körper und Accessoires zu beheben und zu debuggen.

Validierungskategorien

Das UGC-Validierungssystem organisiert die Validierung in mehrere übergeordnete Kategorien. Für Informationen zu diesen Kategorien und einigen Bereichen, die sie validieren, überprüfen Sie die folgende Tabelle.

Kategorie	Was es validiert
Schema	Die Objekt-Hierarchie des Assets Ob Kindtypen, Tags und Attribute korrekt konfiguriert sind Ob das Asset irgendwelche verbotenen Skripte enthält
Mesh-Geometrie	Dreiecksbudgets Umfangsgrößen Gesamte Flächenbegrenzungen Ob das Asset im Ursprung zentriert ist und nicht zu dünn entlang einer bestimmten Achse Ob die Geometrie des Assets wasserdicht ist und keine N-Polygonen, Vertex-Farben oder Nullbereich-Dreiecke enthält
Textur / Materialien	Maximale Auflösung Gültige UV-Maps PBR-Texturvalidierung für SurfaceAppearance-Objekte Ob das Asset ungültige Vertex-Farben enthält
Rigging / Skinning	Körper und Layered-Zubehör müssen Skinning-Daten enthalten Starrzubehör darf keine Skinning-Daten enthalten Anzahl der Skin-Gewichte muss mit der Anzahl der Vertices übereinstimmen
Innere und äußere Käfige	Alle Körperteile müssen Käfige für die Ganzkörpervalidierung enthalten Käfige müssen wasserdicht sein Käfig-Mesh muss eng mit dem Render-Mesh übereinstimmen Render-Mesh muss innerhalb des äußeren Käfigs sein Käfig-UVs müssen mit Robloxs bereitgestellten Käfigvorlagen übereinstimmen
Anschlüsse	Alle Anschlüsse müssen eine korrekte Benennung für ihren Befestigungspunkt haben Positions- und Ausrichtungsprüfungen
Dynamischer Kopf	Mindestens 17 FACS-Posen Käfig-Landmarkenprojektion auf das Kopf-Mesh Gesichtsanimationserkennung: Landmarken müssen sich für Blinzeln, Mundöffnung und fröhliche/sad Gefühle bewegen
Sicherheit / Moderation	Validierung des Asset-Erstellers, verbotene Klassennamen, Proxy-Attribut-Anti-Spamming

Visualisierungsprüfungen

Das UGC-Validierungssystem umfasst optionale Visualisierungstools mit Prüfungen, die Ihnen helfen, Avatar-Assets zu identifizieren, zu verstehen, zu diagnostizieren und zu reparieren, die noch nicht bereit sind, im Marketplace zu sein. Wenn aktiv, bieten die Visualisierungsprüfungen Informationen zu Validierungsfehlern für nicht konforme Assets und Qualitätsbewertungen für konforme Assets, die verbessert werden könnten.

Rote Symbole geben Informationen zu den Bereichen, die die Validierung nicht bestehen, und gelbe Warnungen zeigen Verbesserungsbereiche an.

Wenn Sie einen Fehler oder eine Warnung auswählen, werden visuelle Elemente im Ansichtsfenster angezeigt, die Ihnen helfen, den Fehler oder die Warnung zu verstehen.

Um auf die Visualisierungstools des UGC-Validierungssystems zuzugreifen, müssen Sie zuerst die Beta-Funktion aktivieren. Um die optionalen Visualisierungsprüfungen zu aktivieren und zu verwenden:

Navigieren Sie im Studio zu Datei > Beta-Funktionen.
Aktivieren Sie UGC-Validierung visualisieren.
Starten Sie das Studio neu, klicken Sie dann im Mezzanin auf das Plus-Symbol, um einen benutzerdefinierten Tab hinzuzufügen. Ein neuer Tab wird angezeigt.
Klicken Sie in Ihrem benutzerdefinierten Tab auf die Schaltfläche Tools hinzufügen. Das Pop-up-Fenster Tools hinzufügen wird angezeigt.
Aktivieren Sie UGC-Validierung, um es Ihrer Werkzeugleiste hinzuzufügen, und schließen Sie das Fenster.
Navigieren Sie zurück zu Ihrem benutzerdefinierten Tab und wählen Sie die Schaltfläche UGC-Validierung, um das Plugin auszuführen. Ein Fenster der UGC-Validierung wird angezeigt.
Wählen Sie im Fenster Explorer einen Charakterkörper, einen dynamischen Kopf, ein starrzubehör oder ein Layered-Zubehör aus, navigieren Sie dann zurück zum Fenster der UGC-Validierung und klicken Sie auf die Schaltfläche Validierung ausführen. Ein Pop-up-Fenster wird angezeigt.
Im Pop-up-Fenster:
1. Bestätigen Sie den Asset-Typ des Avatar-Assets, das Sie ausgewählt haben. Wenn Sie beispielsweise ein Enum.AccessoryType.Pants Layered-Zubehör ausgewählt haben, verwenden Sie das Dropdown-Menü, um PantsAccessory auszuwählen.
2. Klicken Sie auf die Schaltfläche Validierung ausführen.

Der Validierungsdienst läuft im Hintergrund und berichtet die Ergebnisse im Fenster UGC-Validierung als Kombination von Fehlern und/oder Warnungen, abhängig vom Zustand Ihres Assets. Für Informationen zu jeder visuellen Validierungsprüfung überprüfen Sie die folgenden Unterabschnitte.

Measure_Cage_Distance_Head

Measure_Cage_Distance_Head ist eine Validierungsprüfung, die bewertet, wie eng der äußere Käfig des Avatar-Kopfs das Kopfmuster umschließt und überprüft, dass der Käfig weder zu weit vom Muster entfernt schwebt noch darin versinkt.

Fehlercode	Schweregrad
Die Qualitätsbewertung kann aufgrund fehlerhafter oder unvollständiger Eingabedaten nicht ordnungsgemäß berechnet werden. Bitte überprüfen Sie Ihr Modell oder melden Sie einen Fehler.	Blockiert die Validierung
Der Kopfkäfig schneidet in das Kopf-Mesh. {negativeSDFPercent}% der Kopfkäfig-Vertices befinden sich im Kopf-Mesh.	Blockiert die Validierung
Der Kopfkäfig ist zu weit vom Kopf-Mesh entfernt. Der maximale Abstand zwischen Kopfkäfig und Mesh beträgt {max_sdf}, was über dem zulässigen Schwellenwert von {max_sdf_threshold} liegt.	Blockiert die Validierung
Asset-Qualitätswarnung: Der Abstand des Kopfkäfigs hat die Punktzahl {score}. Der maximale Abstand zwischen Kopfkäfig und Mesh beträgt {max_distance}, {negative_sdf_percent}% der Kopfkäfig-Vertices befinden sich im Kopf-Mesh.	Warnung

Measure_Cage_Mesh_Distance

Measure_Cage_Mesh_Distance ist eine Validierungsprüfung, die bewertet, wie eng der äußere Käfig der Layered-Kleidung dem gerenderten Mesh folgt und markiert, wenn ein Käfig zu weit wegdriftet oder in das Mesh gedrückt wird.

Fehlercode	Schweregrad
Die Qualitätsbewertung kann aufgrund fehlerhafter oder unvollständiger Eingabedaten nicht ordnungsgemäß berechnet werden. Bitte überprüfen Sie Ihr Modell oder melden Sie einen Fehler.	Blockiert die Validierung
Der äußere Käfig schneidet in das Render-Mesh. {negativeSDFPercent}% der äußeren Käfig-Vertices befinden sich im Render-Mesh.	Blockiert die Validierung
Der äußere Käfig ist zu weit vom Render-Mesh entfernt. Der maximale Abstand zwischen äußerem Käfig und Mesh beträgt {max_sdf}, was über dem zulässigen Schwellenwert {max_sdf_threshold} liegt.	Blockiert die Validierung
Asset-Qualitätswarnung: Die Punktzahl für den Käfig-zu-Mesh-Abstand beträgt {score}. Der maximale Abstand zwischen äußerem Käfig und Mesh beträgt {max_distance}, {negative_sdf_percent}% der äußeren Käfig-Vertices befinden sich im Render-Mesh.	Warnung

Measure_Cage_Mesh_Distance_Avatar

Measure_Cage_Mesh_Distance_Avatar ist eine Validierungsprüfung, die bewertet, wie eng der vollständige äußere Käfig dem Körper-Mesh folgt, und markiert, wenn ein Käfig zu weit von der Oberfläche schwebt oder in sie eindringt.

Fehlercode	Schweregrad
Die Qualitätsbewertung kann aufgrund fehlerhafter oder unvollständiger Eingabedaten nicht ordnungsgemäß berechnet werden. Bitte überprüfen Sie Ihr Modell oder melden Sie einen Fehler.	Blockiert die Validierung
Der Körperkäfig schneidet in das Körper-Mesh. {negativeSDFPercent}% der Körperkäfig-Vertices befinden sich im Körper-Mesh.	Blockiert die Validierung
Der Körperkäfig ist zu weit vom Körper-Mesh entfernt. Der maximale Abstand zwischen Körperkäfig und Mesh beträgt {max_sdf}, was über dem zulässigen Schwellenwert {max_sdf_threshold} liegt.	Blockiert die Validierung
Asset-Qualitätswarnung: Die Punktzahl des Körperkäfig-Abstands beträgt {score}. Der maximale Abstand zwischen Körperkäfig und Mesh beträgt {max_distance}, {negative_sdf_percent}% der Körperkäfig-Vertices befinden sich im Körper-Mesh.	Warnung

Measure_Cage_Relevancy

Measure_Cage_Relevancy ist eine Validierungsprüfung, die bewertet, wie viel von dem äußeren Käfig, den Sie verschoben haben, tatsächlich über dem Zubehör sitzt, sodass die Käfigbearbeitungen dort bleiben, wo sie für das Kleidungsstück benötigt werden.

Fehlercode	Schweregrad
Die Qualitätsbewertung kann aufgrund fehlerhafter oder unvollständiger Eingabedaten nicht ordnungsgemäß berechnet werden. Bitte überprüfen Sie Ihr Modell oder melden Sie einen Fehler.	Blockiert die Validierung
Die {outer_cage_face_irrelevant_percent}% der modifizierten äußeren Käfig-Vertices decken das Zubehör nicht ab. Stellen Sie sicher, dass Sie den äußeren Käfig nur dort bewegen, wo es nötig ist.	Blockiert die Validierung
Asset-Qualitätswarnung: Die Punktzahl der Käfig-Relevanz beträgt {score}. {irrelevant_percent}% der modifizierten äußeren Käfig-Vertices decken das Zubehör nicht ab.	Warnung

Measure_Cage_UV

Measure_Cage_UV ist eine Validierungsprüfung, die überprüft, ob die inneren und äußeren Käfig-UVs mit der Vorlage für Layered-Kleidung übereinstimmen; UVs, die nicht mit der Vorlage für Layered-Kleidung übereinstimmen, beeinträchtigen, wie das Asset über den Körper gewickelt wird.

Fehlercode	Schweregrad
Die Qualitätsbewertung kann aufgrund fehlerhafter oder unvollständiger Eingabedaten nicht ordnungsgemäß berechnet werden. Bitte überprüfen Sie Ihr Modell oder melden Sie einen Fehler.	Blockiert die Validierung
Es gibt {incorrect_uv_count} UV-Werte im Käfig {cage_name}, die falsch sind oder nicht zur Vorlage gehören. Bitte korrigieren Sie die UV des Käfigs.	Blockiert die Validierung
Asset-Qualitätswarnung: Die Käfig-UV-Punktzahl beträgt {score} für {cage_name}. Falsche UV-Anzahl: {incorrect_uv_count}.	Warnung

Measure_Cage_UV_Avatar

Measure_Cage_UV_Avatar ist eine Validierungsprüfung, die überprüft, ob jedes Körperteil einen Käfig hat, der seine UVs mit der Standardvorlage beibehält; falsche Käfig-UVs verzerren, wie Layered-Kleidung über den Körper gewickelt wird.

Fehlercode	Schweregrad
Die Qualitätsbewertung kann aufgrund fehlerhafter oder unvollständiger Eingabedaten nicht ordnungsgemäß berechnet werden. Bitte überprüfen Sie Ihr Modell oder melden Sie einen Fehler.	Blockiert die Validierung
Es gibt {incorrect_uv_count} UV-Werte im Käfig {cage_name}, die falsch sind oder nicht zur Vorlage gehören. Bitte korrigieren Sie die UV des Käfigs.	Blockiert die Validierung
Asset-Qualitätswarnung: Die Käfig-UV-Punktzahl beträgt {score} für {cage_name}. Falsche UV-Anzahl: {incorrect_uv_count}.	Warnung

Measure_Degen_Triangles

Measure_Degen_Triangles ist eine Validierungsprüfung, die jedes Mesh-Teil auf degenerierte Dreiecke (Flächen mit null oder nahezu null Fläche) bewertet; degenerierte Dreiecke fügen keine Oberfläche hinzu und können das Rendering beeinträchtigen.

Fehlercode	Schweregrad
Asset-Qualität: {partName} hat {degenerate_triangle_percent}% degenerierte Dreiecke (Punktzahl: {score}).	Warnung
Die Asset-Qualitätsbewertung für {measureName} konnte nicht berechnet werden, da die Eingabedaten unvollständig oder ungültig waren. Dies blockiert nicht Ihren Upload.	Warnung

Measure_Dynamic_Head

Measure_Dynamic_Head ist eine Validierungsprüfung, die überprüft, ob ein dynamischer Kopf animierbar ist. Animierbare dynamische Köpfe haben einen Kopfkäfig, FACS-Daten, ausgerichtete Landmarken und können ihre Augen schließen, ihren Mund öffnen und Emotionen ausdrücken.

Fehlercode	Schweregrad
Die Qualitätsbewertung kann aufgrund fehlerhafter oder unvollständiger Eingabedaten nicht ordnungsgemäß berechnet werden. Bitte überprüfen Sie Ihr Modell oder melden Sie einen Fehler.	Blockiert die Validierung
Dynamische Köpfe im Marketplace müssen korrekt eingezäunt sein, sodass die Augen- und Mund-Vertices auf dem Käfig mit den Mesh-Vertices übereinstimmen. Bitte verbessern Sie Ihre Käfigmontage und deren Ausrichtung zum Mesh.	Blockiert die Validierung
Kann den Lächel-Ausdruck für den dynamischen Kopf nicht erkennen. Bitte passen Sie die Käfig-Landmarken für den Mund an, damit sie dort übereinstimmen, wo der Mund auf dem Kopf ist, und stellen Sie sicher, dass er einen Lächel-Ausdruck zeigen kann.	Blockiert die Validierung
Kann den Ausdruck des linken Auges schließen für den dynamischen Kopf nicht erkennen. Bitte passen Sie die Käfig-Landmarken für das linke Auge an, damit sie dort übereinstimmen, wo das linke Auge auf dem Kopf ist, und stellen Sie sicher, dass es geschlossen werden kann.	Blockiert die Validierung
Dynamische Köpfe im Marketplace haben keine Kopfkäfige. Bitte erstellen Sie einen Kopfkäfig für den dynamischen Kopf.	Blockiert die Validierung
Kann den Mund-öffnen-Ausdruck für den dynamischen Kopf nicht erkennen. Bitte passen Sie die Käfig-Landmarken für den Mund an, damit sie dort übereinstimmen, wo der Mund auf dem Kopf ist, und stellen Sie sicher, dass er geöffnet werden kann.	Blockiert die Validierung
Dynamische Köpfe im Marketplace müssen animiert sein, aber dieser Kopf hat keine FACS-Daten.	Blockiert die Validierung
Kann den Ausdruck des rechten Auges schließen für den dynamischen Kopf nicht erkennen. Bitte passen Sie die Käfig-Landmarken für das rechte Auge an, damit sie dort übereinstimmen, wo das rechte Auge auf dem Kopf ist, und stellen Sie sicher, dass es geschlossen werden kann.	Blockiert die Validierung
Kann den Ausdruck des Stirnrunzelns für den dynamischen Kopf nicht erkennen. Bitte passen Sie die Käfig-Landmarken für den Mund an, damit sie dort übereinstimmen, wo der Mund auf dem Kopf ist, und stellen Sie sicher, dass er einen Stirnrunzel-Ausdruck zeigen kann.	Blockiert die Validierung
Asset-Qualitätswarnung: Die Punktzahl des dynamischen Kopfes beträgt {score}.	Warnung

Measure_Joint_Number

Measure_Joint_Number ist eine Validierungsprüfung, die die Gelenkstruktur des Körpers überprüft die die erwartete Konfiguration. Die Gelenkstruktur des Körper-Rigs umfasst die Gelenkanzahl in den linken und rechten Händen für Hochpräzisions- Rigs.

Fehlercode	Schweregrad
Asset-Qualität: Gelenkkonfiguration hat die Punktzahl {score} (Gelenke: {joint_number}, linke Hand: {left_hand_joint_number}, rechte Hand: {right_hand_joint_number}).	Warnung
Die Asset-Qualitätsbewertung für {measureName} konnte nicht berechnet werden, da die Eingabedaten unvollständig oder ungültig waren. Dies blockiert nicht Ihren Upload.	Warnung

Measure_Mesh_Manifold

Measure_Mesh_Manifold ist eine Validierungsprüfung, die jedes Mesh-Teil auf manifold-Integrität bewertet und Löcher, nicht-manifold Kanten und ähnliche topologische Probleme in der Geometrie festhält.

Fehlercode	Schweregrad
Asset-Qualität: {partName} hat Probleme mit dem Mesh-Manifold (Punktzahl: {score}).	Warnung
Die Asset-Qualitätsbewertung für {measureName} konnte nicht berechnet werden, da die Eingabedaten unvollständig oder ungültig waren. Dies blockiert nicht Ihren Upload.	Warnung

Measure_Mesh_Outside_OuterCage

Measure_Mesh_Outside_OuterCage ist eine Validierungsprüfung, die bewertet, wie viel von einem Zubehör-Render-Mesh zwischen seinen Käfigen bleibt; ein Mesh, das außerhalb des äußeren Käfigs herausragt, deformiert sich schlecht, wenn es getragen wird.

Fehlercode	Schweregrad
Die Qualitätsbewertung kann aufgrund fehlerhafter oder unvollständiger Eingabedaten nicht ordnungsgemäß berechnet werden. Bitte überprüfen Sie Ihr Modell oder melden Sie einen Fehler.	Blockiert die Validierung
{mesh_outside_outer_cage_percent}% der Mesh-Vertices für das Zubehör befinden sich außerhalb seines äußeren Käfigs. Nehmen Sie Anpassungen vor, um mehr vom Zubehör zwischen den Käfigen zu platzieren.	Blockiert die Validierung
Asset-Qualitätswarnung: Die Punktzahl für den Mesh-Inhalt beträgt {score}. {mesh_outside_outer_cage_percent}% der Mesh-Vertices befinden sich außerhalb des äußeren Käfigs.	Warnung

Measure_Texture_Complexity

Measure_Texture_Complexity ist eine Validierungsprüfung, die jede Textur auf visuelle Komplexität bewertet und flache oder nahezu leere Texturen markiert, die nur wenig Detail zum Asset hinzufügen.

Fehlercode	Schweregrad
Die Asset-Qualitätsbewertung für {measureName} konnte nicht berechnet werden, da die Eingabedaten unvollständig oder ungültig waren. Dies blockiert nicht Ihren Upload.	Warnung
Asset-Qualität: Textur {textureName} hat eine geringe Komplexität (Punktzahl: {score}).	Warnung

Measure_Texture_Resolution

Measure_Texture_Resolution ist eine Validierungsprüfung, die jede Textur anhand ihrer Pixel-Dimensionen bewertet und eine Auflösung belohnt, die hoch genug ist, um das Asset scharf am Körper zu halten.

Fehlercode	Schweregrad
Die Asset-Qualitätsbewertung für {measureName} konnte nicht berechnet werden, da die Eingabedaten unvollständig oder ungültig waren. Dies blockiert nicht Ihren Upload.	Warnung
Asset-Qualität: Textur {textureName} hat eine Auflösung von {texture_width}x{texture_height} (Punktzahl: {score}).	Warnung

Measure_Triangle_Intersection

Measure_Triangle_Intersection ist eine Validierungsprüfung, die jedes Mesh-Teil auf selbstschneidende Dreiecke bewertet, bei denen Flächen durch einander hindurchgehen und eine unordentliche, überlappende Geometrie erzeugen.

Fehlercode	Schweregrad
Die Asset-Qualitätsbewertung für {measureName} konnte nicht berechnet werden, da die Eingabedaten unvollständig oder ungültig waren. Dies blockiert nicht Ihren Upload.	Warnung
Asset-Qualität: {partName} hat {intersecting_tri_face_percent}% sich schneidende Dreiecksflächen (Punktzahl: {score}).	Warnung

Measure_UV_Bound

Measure_UV_Bound ist eine Validierungsprüfung, die misst, wie viele UV-Vertices eines Mesh außerhalb des 0-1 Texturesspaces fallen; sie gibt eine Punktzahl aus, blockiert jedoch niemals den Upload.

Fehlercode	Schweregrad
Die Asset-Qualitätsbewertung für {measureName} konnte nicht berechnet werden, da die Eingabedaten unvollständig oder ungültig waren. Dies blockiert nicht Ihren Upload.	Warnung
Asset-Qualität: {partName} hat {uv_outside_bound_vert_percent}% UV-Vertices außerhalb der Grenzen (Punktzahl: {score}).	Warnung

Measure_Vertex_Similarity

Measure_Vertex_Similarity ist eine Validierungsprüfung, die den Anteil ähnlicher (nahezu doppelter) Vertices in einem Mesh misst; sie gibt eine Punktzahl aus, blockiert jedoch niemals den Upload.

Fehlercode	Schweregrad
Die Asset-Qualitätsbewertung für {measureName} konnte nicht berechnet werden, da die Eingabedaten unvollständig oder ungültig waren. Dies blockiert nicht Ihren Upload.	Warnung
Asset-Qualität: {partName} hat {similar_vertex_percent}% ähnliche Vertices (Punktzahl: {score}).	Warnung