Communitygithub.com

Bau-Layout-Prüfung

Prüft, ob generierte oder handgebaute Gebäude, Innenräume oder geschlossene Umgebungen (Häuser, Büros, Bunker, Schiffe, Tempel, Ruinen, Höhlen, Anlagen, Stationen) strukturell sinnvoll und begehbar sind – Lastwege, Wände mit Abschluss, Türen mit Ziel, Treppen mit Podesten und Kopffreiheit, keine verwaisten Räume, keine Wände in Öffnungen, ausreichend Ausgänge, kurze Sackgassen, Schleifen und zwei Wege nach oben für Kampf oder Flucht. Engine- und genreneutral; wird mit einem Raumgraphen-Prüfskript ausgeliefert. Verwenden bei der Überprüfung eines Gebäudes oder Layouts, das ein Agent oder Generator erstellt hat, vor der Annahme eines Prefabs oder beim Schreiben von Layoutregeln für ein Bausatzsystem.

Was ist Bau-Layout-Prüfung?

Diese Fähigkeit (Skill) prüft die strukturelle und begehbare Logik von Gebäuden, Innenräumen oder geschlossenen Umgebungen, die von KI-Agenten oder Generatoren erstellt wurden. Sie ist engine- und genreneutral, d.h. sie funktioniert unabhängig von der verwendeten Spiele-Engine oder dem Genre (mittelalterlich, Science-Fiction, Fantasy, Ruine, Höhle usw.). Der Skill ist für Entwickler von KI-Agenten, Level-Designern und Spieleentwickler gedacht, die sicherstellen möchten, dass ihre automatisch oder manuell erstellten Layouts realistisch, begehbar und spielbar sind. Die Prüfung erfolgt in drei aufeinander aufbauenden Durchgängen: Der erste Durchgang analysiert einen JSON-basierten Raumgraphen (Spaces und Links) auf grundlegende Regeln wie Erreichbarkeit, Fluchtwege, Sackgassen und Treppenmaße. Der zweite Durchgang führt geometrische Sonden in der Engine oder im Modellierungswerkzeug durch, um Kollisionen, Abstürze, Wandenden und Durchgänge zu prüfen. Der dritte Durchgang ist eine menschliche oder KI-gestützte Sichtprüfung auf Augenhöhe, die die Plausibilität jedes Raums und jeder Wand bewertet. Die Basis für alle Prüfungen ist ein "World Brief", der das Setting, die Bauweise, die Nutzung und die künstlerischen Regeln der Welt definiert. Der Skill stellt ein Python-Skript (layout_check.py) zur Verfügung, das den Raumgraphen analysiert und Blockierer, Funde, akzeptierte Bedingungen und Hinweise meldet.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TayHD/game-agent-skills/tree/HEAD/skills/building-layout-check

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Bau-Layout-Prüfung?

Modulare Bausätze machen es einfach, eine Wand an jeder Stelle des Rasters zu platzieren, und Generatoren und Agenten tun genau das: Wände, die mitten in einem Raum enden oder über ein Fenster verlaufen, Türen, die sich zu einer leeren Wand oder einem Abgrund öffnen, Räume, die niemand erreichen kann, Treppen, die zu einer Wand zeigen, Ein-Tür-Kästen und Korridore, die sich nie verzweigen. Dieser Skill ist die Prüfung, die sie erwischt. Er bewertet Layout und Struktur, nicht Ausführung oder Materialien.

Er funktioniert für jede Umgebung, Epoche und Kunstrichtung, weil er jeden Raum nach der eigenen Logik der Welt beurteilt, die einmal in einem Weltenbeschrieb (siehe unten) festgehalten wird: eine Steinburg danach, wie Maurer bauen und wie eine Garnison lebt, ein Raumschiff danach, wie seine Besatzung sich bewegt und was sein Rumpf trägt, eine Höhle danach, wie Wasser sie geformt hat und wie ihre Bewohner sie nutzen, ein Comic-Dorf nach den Regeln seines Stils. Moderne Bauvorschriften sind nur der Rückfall, wenn ein Projekt nichts sagt.

Drei Durchgänge, in dieser Reihenfolge, weil jeder günstiger ist als der nächste: der Raumgraph (ein Skript, Sekunden), die geometrischen Sonden (in der Engine oder im Modellierungswerkzeug, Minuten) und die Augenhöhen-Prüfung (eine Person oder ein neuer Prüf-Agent). Ein Gebäude besteht, wenn in keinem Durchgang ein Blockierer verbleibt.

Der Weltbeschrieb (vor der ersten Prüfung schreiben)

Ein kurzer Abschnitt in der Umgebungsdokumentation des Projekts, etwa eine halbe Seite, den jede Prüfung und jeder Prüfer liest. Ohne ihn greifen Prüfer auf ihre eigene Epoche und ihren eigenen Stil zurück und beanstanden die falschen Dinge.

  1. Umgebung und Epoche: wo und wann (z.B. „spätmittelalterliche Flussstadt“, „Orbitale Bergbaustation, 2300er“, „Nachflut-Ruinen eines 1970er-Vororts“, „Pilzvolk-Baue“).
  2. Wer hat es gebaut, womit: Die Technologie und Materialien der Erbauer und was diese ermöglichen: Spannweiten (Holz 4 bis 6 m, Steingewölbe, Stahlträger, gezüchtete Koralle), Wandstärke, wie Böden getragen werden, wie vertikale Fortbewegung funktioniert (Treppen, Leitern, Rampen, Aufzüge, Klettern, Fliegen, Teleport-Pads).
  3. Wofür ist es da und was ist damit passiert: Sein ursprünglicher Zweck, seine jetzige Nutzung (bewohnt, verlassen, von jemand anderem besetzt, Ruine) und die Ereignisse, die es verändert haben (Belagerung, Überschwemmung, Einsturz, Überwucherung). Schäden brauchen eine Ursache in dieser Welt.
  4. Die Regeln des Kunststils: realistisch, stilisiert, überzeichnet, Low-Poly oder spielzeugartig, und was er mit Proportionen (übergroße Türen, klobige Wände, schiefe Vertikalen) und Details macht. Eine stilisierte Welt kann echte Proportionen absichtlich verbiegen; der Beschrieb sagt, wie weit.
  5. Wer bewegt sich hindurch: Die Größe und Bewegungen des Spielers (Gehen, Ducken, Krabbeln, Klettern, Springen, Schwimmen, Fliegen), Begleiter, Kreaturen und Fahrzeuge, die passen müssen, und ob Räume erkundet, bebaut, durchkämpft oder durchflohen werden (dies setzt PROFILE).
  6. Bewusste Ausnahmen: Was diese Welt tut, was ein modernes Gebäude nicht täte, damit Prüfer es akzeptieren (unbewehrte Zinnen, Leitern statt Treppen, Ein-Eingang-Befestigungen, türlose Hütten, Wendeltreppen mit steilen Stufen, nur durch Klettern erreichbare Räume).

Regeln unten, die „sinnvoll“, „ein Baumeister“, „ein Designer“ oder „ein Grund“ sagen, bedeuten: sinnvoll für die Bauweise, den Zweck und den Stil in diesem Beschrieb.

Vom Projekt bereitgestellte Einstellungen

Jede Einstellung hat einen Standardwert für einen menschengroßen Spieler in Metern mit modernen Proportionen. Ein Projekt mit anderen Proportionen oder einer anderen Epoche (eine kleine Kreatur, ein Riese, ein Fahrzeug, steile mittelalterliche Treppen, eine andere Einheit) setzt die Zahlen aus seinem Weltbeschrieb, nicht die Methode. Im Skript stammen die Einstellungen aus dem "settings"-Objekt des Graphen, dann --profile und --site, dann --set NAME=WERT (später gewinnt); ein unbekannter Name ist ein Fehler, sodass ein Tippfehler nie stillschweigend durchgeht.

Standorttyp und ausgeschaltete Regeln. Einige Regeln stammen daher, wie Gebäude für Menschen entworfen werden (Ausgänge nach Grundfläche, innere Schleifen, kein einzelner Trichter, der Anteil von Sackgassenräumen, sich verzweigende Korridore). Eine Höhle, eine Ruine oder ein natürlicher Raum schuldet sie nicht für die Erkundung, daher werden sie mit SITE natural oder ruin und PROFILE explore als Hinweise gemeldet; in contested gelten sie überall, weil Kämpfe und Verfolgungsjagden sie brauchen, wo immer sie stattfinden. Jede Regel kann auch vom Weltbeschrieb mit RULES_OFF ausgeschaltet werden (z.B. eine Festung mit einem Tor von Natur aus: RULES_OFF=exits,funnel), oder für einen Raum in der accepted-Liste des Graphen akzeptiert werden.

EinstellungStandardBedeutungVerwendet von
WORLD_BRIEFkeine (modern, realistisch, menschengroß angenommen, und der Bericht sollte dies angeben)Die obige halbe Seite.Alle Durchgänge
PROFILEexploreexplore (Erkundung, Geschichte, Bauen, Überleben ohne Kämpfe in Innenräumen) oder contested (Spieler kämpfen, verfolgen oder fliehen hier). contested schaltet die mit (C) markierten Regeln ein.Skript
SITEbuildingbuilding, vessel (Schiffe, Stationen, Fahrzeuge: wie ein Gebäude behandelt), natural (Höhlen, Schluchten, Haine, Eis, Riffe) oder ruin.Skript
RULES_OFFkeineKomma-getrennte Liste von Regel-IDs, die nur als Hinweise gemeldet werden.Skript
PLAYER_RADIUS0,40Halbe Breite der Gehkapsel.Skript
CROUCH_HEIGHT1,10Kopffreiheit, die in Kriechbereichen, Engstellen, Schwimmbereichen, Leitern, Kletterstellen, Luken und Fenstern benötigt wird.Skript
MIN_HEADROOM2,10Lichte Höhe über jeder begehbaren Fläche, die kein Kriechbereich ist.Skript
MIN_DOOR_WIDTH0,90Lichte Breite einer Tür, Öffnung, Treppe, Rampe oder eines Aufzugs.Skript
MIN_CORRIDOR_WIDTH1,20Lichte Breite eines Korridors oder Durchgangs.Skript
MIN_SPIRAL_WIDTH0,70Lichte Breite einer als "spiral": true markierten Treppe.Skript
MIN_CLIMB_WIDTH0,60Lichte Breite einer Leiter, Kletterstelle, Luke oder eines Schwimmbereichs.Skript
LARGE_AGENT_DIAMETER0 (keine)Durchmesser der größten Kreatur oder des größten Fahrzeugs, das passieren muss; als large_route markierte Routen sind mindestens 1,5-mal so breit.Skript
STAIR_RISER_MIN, STAIR_RISER_MAX0,10, 0,20Bereich der Stufenhöhe. Eine mittelalterliche oder beengte Welt erhöht das Maximum.Skript
STAIR_TREAD_MIN, STAIR_TREAD_MAX0,22, 0,40Bereich der Auftrittsbreite.Skript
STAIR_PACE_MIN, STAIR_PACE_MAX0,55, 0,70Die Schrittregel: zweimal die Stufenhöhe plus die Auftrittsbreite. Sie gilt epochenübergreifend und erwischt Treppen, die für ihre Auftrittsbreite zu steil sind. Nicht auf Wendeltreppen angewendet.Skript
MAX_RISERS_PER_FLIGHT16Ein Podest mindestens so oft (nicht auf Wendeltreppen angewendet).Skript
STEP_HEIGHT0,45Die höchste Stufe, die die Figur ohne Treppe ersteigt; eine Tür oder Öffnung mit einem größeren step ist ein Blockierer.Skript
GUARD_DROP1,00Ein begehbarer Raum mit einem edge_drop größer als dieser benötigt "guarded": true (Geländer, Brüstung, Wand oder was diese Welt verwendet), oder eine akzeptierte Bedingung, die besagt, dass der Abgrund beabsichtigt ist und als solcher wahrgenommen wird.Skript, Sonde
TUBE_LENGTH15Längster Korridor oder Durchgang ohne Abzweigung.Skript
DEAD_END_DEPTHexplore 20, contested 10Tiefste Sackgasse von ihrer letzten Abzweigung, in Metern.Skript
EXIT_SPACING, VERTICAL_SPACING10, 15Ausgänge näher als dies an einer Seite zählen einmal; zwei vertikale Routen müssen mindestens so weit voneinander entfernt sein.Skript
MAX_ROOM_OPENINGS4(C) Meisten Öffnungen in einen Raum oder eine Kammer.Skript
MIN_SPACE_AREA1,0Kleinste nutzbare Fläche.Skript
GUARD_HEIGHT1,00 bis 1,10Höhe einer Brüstung, wo eine benötigt wird.Sonde
LAYOUT_SOURCEdie Layoutdaten des ProjektsWoher der Plan kommt: ein Rezept oder Manifest, ein Level-Export oder ein handgezeichneter Plan.Durchgang 1 Eingabe

Ausgänge nach Grundfläche (alle begehbaren Innenetagen zusammen). Ausgänge näher als EXIT_SPACING auf derselben Seite zählen einmal; ein Fenster, durch das ein Spieler klettern kann, zählt als halber Ausgang; ein einseitiger Abgrund nach draußen ist ein Notausstieg, aufgeführt aber nicht gezählt.

Grundflächeexplorecontested
Unter 100 m²12, auf 2 Seiten
100 bis 400 m²2, auf 2 Seiten3, auf mindestens 2 Seiten
Über 400 m²3, auf mindestens 2 Seiten4, auf mindestens 3 Seiten

Durchgang 1: der Raumgraph (Skript)

Beschreiben Sie den Ort als Räume und Verbindungen in JSON (Format und jedes Feld in templates/space_graph.example.json) und führen Sie aus:

python3 -I scripts/layout_check.py <graph.json> [--profile explore|contested] [--site building|natural|ruin|vessel] [--set NAME=WERT ...] [--json out.json]
  • Ein Raum ist überall dort, wo ein Spieler stehen kann und was sich wie ein Ort anfühlt. Arten: exterior (die Außenwelt, genau einer), room, chamber (natürliche oder unregelmäßige Räume), corridor, passage (natürliche Korridore), landing, stair (ein Treppenhausraum), roof, deck, yard, void (versiegelt). Räume, Kammern, Korridore, Durchgänge, Podeste, Dächer und Decks zählen für Sackgassen; Räume und Kammern zählen für Öffnungen und den Sackgassenanteil. Geben Sie jedem eine ID, eine Etage, eine Fläche und, wo möglich: Position (x, y), Länge und Breite (Korridore und Durchgänge), Kopffreiheit, edge_drop und guarded, crawl, anchor (der Hauptraum), sealed.
  • Eine Verbindung ist jeder Weg zwischen zwei Räumen. Arten: door, opening, stair, ramp, lift, ladder, hatch, climb, swim, squeeze (Durchkriechen), window (eines, durch das ein Spieler klettert) und drop (einseitig, von a nach b). Geben Sie ihr die lichte Breite und Kopffreiheit, wo bekannt, face und x, y für Verbindungen nach draußen, step für einen Niveauwechsel an einer Tür, und riser, tread, risers und spiral für Treppen. Modellieren Sie jeden Treppenlauf als eine Treppenverbindung zwischen den Räumen, die er verbindet; jede Nicht-Drop-Verbindung zwischen zwei Etagen zählt als vertikale Route.

Regel-IDs, verwendet in Berichten, accepted und RULES_OFF: reach, return, sealed, exits, dead_end, dead_share, loop, funnel, vertical, door_width, corridor_width, large_width, headroom, step, guard, stair, tube, small, openings. Ein accepted-Eintrag ist {"rule": "...", "space": "..."} (oder "link"), oder nur eine Regel und ein Grund, sie überall zu akzeptieren.

Das Skript meldet BLOCKIERER, FUND, AKZEPTIERT, HINWEIS (einschließlich dessen, was es aus den gegebenen Daten nicht prüfen konnte) und OK:

  • Erreichbarkeit (reach, return): jeder nicht versiegelte Raum von außen erreichbar mit den Bewegungen im Graphen, und ein Rückweg von jedem (Drops sind einseitig).
  • Ausgänge (exits): Anzahl, Seiten und Abstand gegen die Tabelle.
  • Sackgassen (dead_end, dead_share): Räume mit einem Weg hinein, die Kettenlänge von der letzten Abzweigung und (C) der Anteil der Sackgassenräume.
  • Schleifen (loop): mindestens eine innere Schleife, wenn der Ort über 400 m² oder mehr als zwei Räume tief ist.
  • Trichter (funnel): getrennte Routen (die sich keinen Raum teilen) von außen zum Anker oder zum tiefsten Raum, wenn keiner markiert ist; eine Route ist ein Blockierer in (C) über 100 m² und ein Fund über 400 m².
  • Vertikale Routen (vertical): Routen von jeder Etage zur Eintrittsetage, nach oben oder unten; zwei, mindestens VERTICAL_SPACING voneinander entfernt, auf Etagen über 200 m², oder über 100 m² in (C).
  • Größen und Niveaus (door_width, corridor_width, large_width, headroom, small, step): Breiten und Kopffreiheit nach Verbindungsart, Räume schmaler als der Spieler, Stufen ohne Treppe.
  • Treppen (stair): Stufenhöhe, Auftrittsbreite, Schrittmaß und Lauflänge; gemischte Stufenhöhen in einem Gebäude.
  • Kanten (guard): unbewehrte Abgründe über GUARD_DROP.
  • Schläuche und Öffnungen (tube, openings): Korridore über TUBE_LENGTH ohne Abzweigung; (C) Räume mit zu vielen Öffnungen.

Durchgang 2: geometrische Sonden (in der Engine oder im Modellierungswerkzeug)

Der Graph kann keine Geometrie sehen. Führen Sie diese am zusammengebauten Gebäude mit den projekteigenen Werkzeugen aus; jede muss eine Zahl oder eine Liste erzeugen, keinen Screenshot.

SondeMisstSchlägt fehl, wenn
GehflutEine Kapsel in Spielergröße geht von jeder Außentür mit Schwerkraft und behandelt Wände als fest (ein NavMesh-Build ist akzeptabel).Ein Raum, den der Graph als erreichbar bezeichnet, wird nicht erreicht, oder die Gehfläche erreicht einen Ort, den der Graph nicht hat (eine Lücke, eine Wandkrone, ein Dach ohne Route).
StützeFür jeden Boden, jedes Dach, jede Treppe, jeden Balken und jede obere Wand: das darunterliegende Element in seiner Grundfläche.Etwas ruht auf nichts (mehr als 1 cm Luft), eine Säule oder Wand landet auf einer Bodenspannweite ohne Balken oder Wand darunter, oder ein Kragarm überschreitet etwa ein Drittel seiner Rücklaufspannweite ohne sichtbare Konsole oder Strebe.
WandendenJedes Ende jeder Wand und Trennwand.Ein Ende berührt nichts (und ist kein fertiges freies Ende), landet in einer Tür- oder Fensteröffnung oder endet weniger als die Spielerbreite vor einer Wand.
ÖffnungenBodenhöhe auf beiden Seiten jeder Tür, ein Strahl durch jedes Fenster.Eine Tür öffnet sich zu einer Wand, einem Abgrund, einem versiegelten Hohlraum oder einer Stufe höher als STEP_HEIGHT; ein Fenster ist innerhalb von 1 m dahinter durch eine Wand, Bodenplatte, Treppe oder hohe Stütze blockiert; ein Boden oder eine Innenwand kreuzt ein Fenster an der Fassade.
FreiraumGeschwungene Kapsel entlang jeder Route, Türschwenkbereiche, Treppenpodeste.Kopffreiheit oder Breite fällt unter die Einstellungen; eine Stütze, Säule oder Trennwand steht in einer Türbahn, auf einem Podest oder in der lichten Breite eines Korridors.
KantenJede begehbare Kante und ihr Absturz.Ein Absturz über GUARD_DROP hat keine Brüstung und ist nicht als beabsichtigt markiert.
ÜberlappungWand-in-Wand-, Wand-in-Boden- und Stütze-in-Wand-Überschneidungen.Jede Überschneidung über ein paar Millimeter, die ein Spieler sehen kann.

Durchgang 3: Augenhöhen-Prüfung

Ein neuer Prüfer (Person oder Kritik-Agent, der den Bau nicht gesehen hat) geht ihn auf Augenhöhe ab und betrachtet einen Plan und einen Schnitt jeder Etage. Ihm werden der Weltbeschrieb, der Zweck des Gebäudes („ein Zweifamilienhaus“, „ein überfluteter Forschungsbunker“, „ein eingestürzter Tempel“, „ein Besatzungsdeck eines Frachters“) und die akzeptierten Bedingungen (bewusste Sackgassen, abgeschlossene Türen, eingestürzte Abschnitte, Kriechbereiche) gegeben, und er beantwortet:

  1. Hat jede Wand einen Grund? Sie umschließt einen Raum, trägt etwas, schützt eine Kante, schirmt eine Sicht ab oder (in einer Ruine) ist das, was von einer dieser Funktionen übrig ist. Eine Wand, die nichts davon tut, wird entfernt.
  2. Hat jeder Raum einen Zweck und einen Zugang, der dazu passt? Ein Waschraum von einem Durchgang aus, nicht von der Küche durch ein Schlafzimmer; ein Lagerraum in der Nähe dessen, was er lagert; ein Wachposten, wo er das Bewachte sehen kann; eine Luftschleuse zwischen Druck und ...

… [für die Übersetzung gekürzt]

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

creature-animation-pipeline

Author and ship a full bespoke animation set for a creature (dinosaur, beast, large biped or quadruped) with AI agents - biomechanics and mass first, rig profile and joint caps, key frames first, clip order and mirrors, a per-species animation studio for review, blind calibrated critics, the owner's stamp lock with a no-regression champion take, every clip wired, a species speed curve and the feel-bug rules. Use when starting a new species, authoring or fixing creature clips, setting up the review studio, critics or stamps, or deciding whether a creature clip is done.

first-person-weapon-animation

Build bespoke first-person and third-person weapon animation for an Unreal shooter - gun-space rig, measured hold poses, gun-first action authoring with key frames first, reload anatomy, modular weapon families with per-weapon profiles, procedural layers with stated interpolation, export and install with round-trip checks, a per-weapon review surface, calibrated blind critics, owner stamps and a no-regression champion take. Use when authoring hold poses, reloads or other weapon actions, installing weapon animation, tuning or debugging first-person feel, or reviewing weapon animation.

human-character-animation

Build bespoke third-person human character animation for a multiplayer Unreal shooter (NPC bodies and the player's third-person body) - rig and retargeting hygiene, vetting clip drops, locomotion with motion matching, turn-in-place, layered upper body and aim offsets, third-person weapon read, cover, hit reactions and deaths, a review studio, calibrated blind critics with measured checks, owner stamps with a champion take, key frames first and the blending law. Use when authoring, importing, wiring or reviewing human character clips, setting up a human animation review loop, or fixing a human body feel bug.

poi-design

Design, build, critique and ship points of interest (compounds, towns, facilities, stations, wrecks, camps, ruins, caves) in an open-world game of any setting, period, style or genre - the site's purpose in the world, how it is found without markers and read from a distance, a visual brief per site, flow sized for the game's players and largest enemies, story told through the environment, loot placement, prop and vehicle sourcing rules, assembly from passed kit pieces, a finish bar, blind calibrated critics with eye-height and aerial reviews, owner or lead stamps, fault-to-rule fixes and the "does it make sense?" rule. Use when planning a POI, writing its brief, laying it out or dressing it, reviewing one, or setting up a POI critic loop.

Verwandte Skills