Communitygithub.com

POI-Design

Interessante Orte (Verbindungen, Städte, Anlagen, Stationen, Wracks, Lager, Ruinen, Höhlen) in einer Open-World-Spielumgebung jeder Art, Epoche oder jedes Genres entwerfen, bauen, kritisieren und ausliefern.

Was ist POI-Design?

Dieser Skill beschreibt eine umfassende Methodik für das Design von Points of Interest (POIs) in Open-World-Spielen. Er definiert einen strukturierten Prozess, der mit dem Zweck des Ortes in der Spielwelt beginnt, dessen Platzierung ohne Marker, eine detaillierte visuelle Beschreibung, eine flussorientierte Layout-Planung, Umgebungsstorytelling und eine systematische Qualitätskontrolle durch Benchmarks und Kritiken umfasst. Der Skill unterstützt verschiedene Plattformen (Claude Code, Cursor, Codex) und ist in Konfigurationsdateien wie `WORLD_BRIEF`, `POI_BRIEFS` und `POI_RUBRIC` integriert. Der Workflow erstreckt sich von der Planung über die schriftliche Beschreibung, das Layout und die Ausstattung bis hin zur Überprüfung. Dabei wird sichergestellt, dass jeder POI als realer Ort mit einer nachvollziehbaren Geschichte wahrgenommen wird, der sowohl für das Gameplay optimiert ist als auch eine erzählerische Tiefe bietet.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht POI-Design?

Ein Point of Interest ist fertig, wenn er als realer Ort wirkt, den jemand gebaut und genutzt hat, im Zustand, den seine Beschreibung vorgibt (in Betrieb, bewohnt, verlassen, verfallen oder nie gebaut, wie eine Höhle oder ein Hain), und er als gestaltete Karte funktioniert: Spieler und Kreaturen können hinein-, hindurch- und wieder hinausgelangen, Kämpfe haben Struktur, und die Belohnung ist das Risiko wert. Automatische Checks zu bestehen ist notwendig, aber niemals ausreichend. Dieser Skill ist die Methode für eine gesamte Anlage; die Zahlen stammen aus der Welt, der Spieleranzahl und den Kreaturen des Projekts.

Begleitskills: modular-environment-kit-production (die Teile, aus denen die Anlage gebaut ist, und ihre Ausführung), building-layout-check (jedes Gebäude innerhalb der Anlage und die Weltenbeschreibung, die dieser Skill erweitert) und project-knowledge-system (wo Standards, Entscheidungen und Erkenntnisse festgehalten werden). Dieser Skill wiederholt sie nicht, sondern verweist auf sie.

Vom Projekt bereitgestellte Einstellungen

EinstellungBedeutungStandard
WORLD_BRIEFSetting, Epoche, Baustil, wer sich durch die Welt bewegt (definiert in building-layout-check).Erforderlich vor dem ersten Standort.
WORLD_PLANDie Weltkarte mit jedem Standort, seiner Stufe, den Routen zwischen Standorten, Zonen und Wahrzeichen.Erforderlich vor dem Standort-Layout.
POI_BRIEFSEine visuelle Beschreibung pro Standort (Felder unten).Docs/Design/World/POIBriefs.json
POI_RUBRICDer Qualitätsstandard: die Self-Check-Gate-Zeilen, die Fragen der Kritiker, P0 und P1, die Flächenstandard-Blätter.Docs/Design/World/POIStandard.md
FLOW_RULESNummerierte, messbare Flussregeln und benannte Fehlermuster (Startersatz unten).Dieser Skill: Abschnitt Fluss
PLACEMENT_RULESWohin welche Art von Prop gehört, nach Zone, Anker und Zweck.Dieser Skill: Abschnitt Geschichte
PROP_LIBRARYDer genehmigte Prop- und Fahrzeugkatalog, eine Quelle pro Prop-Typ.Erforderlich; ein Standort platziert niemals einen nicht katalogisierten Prop.
PROP_POLICYOb lose Props für einen Standort modelliert werden dürfen.Nein: nur Struktur und an Gebäuden befestigte Teile; lose Props stammen aus PROP_LIBRARY; eine Lücke kommt auf eine Liste für den Besitzer.
VEHICLE_CLASSESFahrzeugtypen, die vorkommen dürfen und warum.Nur Nutzfahrzeuge (Arbeit, Service, Transport, Militär, Landwirtschaft); geringe Vielfalt.
KIT_CONTRACT, FINISH_SPEC, CORE_LIBRARYWie in modular-environment-kit-production.Standards dieser Skills
TIERSStandort-Stufen mit typischen Größenbändern und Gebäudeanzahlen.Punkt (Wrack, Lager, Höhleneingang, Schrein) 10-40 m, Außenposten 40-80 m, Station 60-150 m, Verbindung 80-220 m, Komplex 200-400 m in 2-4 Unterbereichen, Stadt 250-600 m in 4-6 Unterbereichen um einen Platz
PLAYER_COUNTSpieler pro Server und typische Truppgröße.Erforderlich; legt fest, wie viele Gruppen ein Standort beherbergen muss.
LARGE_AGENT_DIAMETERGrößte Kreatur oder Fahrzeug, die passieren muss (wie in building-layout-check); pro Größenklasse eine hinzufügen, falls es mehrere gibt.0 (keine)
PROFILE, SITEWie in building-layout-check; die meisten POIs sind contested.contested, building
CRITIC_TARGET, CAMERA_RANGEDie ausgelieferten Spiele, mit denen die Kritiker die Standorte namentlich vergleichen; funktionierende Kameradistanzen.In der Weltenbeschreibung genannt; 2-5 m erste Person
CRITIC_MODELModell und Denkaufwand für jeden POI-Kritiker.Das stärkste verfügbare Modell mit hohem Denkaufwand
STUDIO, STAMPSDie Überprüfungsoberfläche, die der Besitzer betrachtet; wo Stempel und Markierungen aufgezeichnet werden und wer stempeln darf.Eine private Überprüfungsseite mit Standbildern, Laufzettel, Plan und Urteilen; Leitstempel, Besitzermarkierungen
RULES_LEDGERWo jede aus einem Fehler entstandene Regel mit Datum und Ursache aufgezeichnet wird.Das Projekt-Entscheidungsprotokoll plus das Änderungsprotokoll von POI_RUBRIC
DCC, ENGINEModellierungswerkzeug und Engine.Projektentscheidung

Prinzipien

  1. Zweck zuerst. Jeder Standort hat eine Aufgabe in der Welt und eine Aufgabe im Spiel; jedes Gebäude, jeder Hof, jede Straße und jeder Prop dient einer von beiden.
  2. Layout hält. Sobald ein Standort ausgeliefert ist, behalten spätere Kunst-Durchgänge seine Gassen, Zugänge, Sichtachsen und Markierungen bei; deren Änderung öffnet ihn neu.
  3. Wiederverwendung vor Modellierung. Standorte werden aus geprüften Kit-Teilen und katalogisierten Props zusammengesetzt; nichts wird in der Engine von Hand gebaut.
  4. Beweise vor Behauptungen. Das Gate misst; Kritiker beurteilen, was das Gate nicht kann; Renderings und Laufzettel sind die Beweise.
  5. Gut ist fertig. P0s blockieren; alles andere ist eine Abhakliste.
  6. Macht es Sinn? Füge nichts hinzu, verschiebe nichts und biege nichts zurecht, nur um eine Gate-Zeile, einen Kritiker oder eine Regel zu erfüllen. Wenn eine Regel diesen Standort schlechter macht, frage den Leiter nach einer Ausnahme mit Begründung und dokumentiere sie.

1. Der Platz des Standorts in der Welt

Was WORLD_BRIEF für POIs hinzufügen muss. Über die halbe Seite hinaus, die building-layout-check verlangt, gibt die Beschreibung an: wie Spieler navigieren (Karte, Kompass, Wahrzeichen; ob es überhaupt Markierungen gibt), die Bedrohungsliste mit ihren Größenklassen und was jede erklimmen, betreten oder zerstören kann, PLAYER_COUNT und wie sich Gruppen treffen, die Belohnungsökonomie (was ist knapp, was kostet Sterben) sowie das Alter der Welt, das Klima und die Geschichte seit dem Bau der Standorte, was festlegt, wie weit Abnutzung und Überwucherung fortgeschritten sind.

Welche Regeln gelten. Setze PROFILE und SITE pro Standort wie in building-layout-check. Die Fluss-, Deckungs- und Sichtachsenregeln in Abschnitt 4 gelten für contested Standorte, wo Spieler oder Kreaturen kämpfen, jagen oder fliehen. Ein explore Standort (ein ruhiger Schrein, eine geschichtsträchtige Ruine) behält Erreichbarkeit, Auffindbarkeit, Geschichte und Ausführung bei und meldet die Kampfregeln als Notizen. Ein natural Standort (eine Höhle, eine Schlucht, ein Hain) schuldet kein Straßennetz, keine Umzäunung, keine Versorgung oder Nivellierung, aber immer noch Ein- und Ausgänge, eine lesbare Route, ein Wahrzeichen oder einen Eingangsleseeindruck, flache Sackgassen für Kämpfe und Routen für große Kreaturen, die sich schließen. Eine ruin schuldet, was von ihrer ursprünglichen Logik überlebt hat, und ihr Schaden folgt einer Ursache. Standorte der Stufe Punkt (ein einzelnes Wrack, Lager oder Höhlenmund) benötigen zwei Zugänge, einen Grund zum Anhalten, Deckung in der Nähe der Belohnung und einen Leseeindruck aus der Ferne; die standortweiten Zählungen (Zugänge, min cut, drei Schleifen) beginnen auf der Stufe Außenposten.

Schreibe diese Zeilen für jeden Standort in WORLD_PLAN, bevor jemand einen Plan zeichnet.

  • Rolle: wofür es gebaut wurde (Fracht bewegen, bewachen und beherbergen, studieren, leben und handeln, abbauen, anbeten) und was es jetzt ist (verlassen, von jemand anderem besetzt, verfallen, zurückerobert).
  • Stufe und Größe: aus TIERS. Ein Standort wächst nur so weit wie seine Unterbereiche und der Platz es benötigen, niemals durch Auseinanderziehen von Gebäuden. Hochstufige Standorte sind selten, mittelstufige häufig, und jede Region enthält einen Standort, für den es sich lohnt, sie zu durchqueren.
  • Bedrohung: wer und was ihn hält (Fraktionen, Kreaturen, Gefahren), wie dies mit PLAYER_COUNT skaliert und ob große Kreaturen sein Kerngebiet erreichen können. Wo große Kreaturen eine Rolle spielen, behalten sie den Vorteil: Der Standort gibt den Spielern Möglichkeiten, den Kontakt abzubrechen, keine Zufluchtsorte, wo ein Trupp sie farmt.
  • Belohnung: was hier gefunden wird, was sonst nirgendwo zu finden ist, und sein Wert im Verhältnis zu Nachbarstandorten. Belohnung folgt Risiko.
  • Gelände-, Geschichts- und Spielgründe: je eine Zeile. Ein Standort ohne Geländegrund wirkt hingeworfen; einer ohne Spielgrund wird von Spielern übersprungen.
  • Entdeckung ohne Markierungen: Spieler finden und erkennen den Standort allein durch die Welt. Verwende ein Wahrzeichen, das räumt, was den Standort verdeckt (Baumkronen, Dächer, Dünen, ein Kamm), lesbar ab etwa 300 m (typisch: ein Mast, Kran, Turm, Tank, Schornstein, Turmspitze, Rumpf); Straßen, Stromleitungen, Pipelines und Zäune, die dorthin führen; Wege, Rauch, Licht bei Nacht, Geräusche; Zeichen in der eigenen Sprache der Welt. Verlasse dich niemals auf ein Kartensymbol, einen Welt-Marker oder eine HUD-Markierung.
  • Abstände und Zugänge: typische kleinere Standorte 500-800 m voneinander entfernt, Hauptstandorte 1 km oder mehr; zwei oder drei Satelliten (Außenposten, Kontrollpunkte, Lager) auf den Zugängen eines Komplexes, etwa 200-600 m entfernt; eine Deckungslinie (Zaun, Graben, Mauer, Wracklinie) über offenes Gelände von etwa 150 m zwischen Standorten; ein gedeckter Umgehungsweg 50-150 m außerhalb jedes großen Standorts, damit der kürzeste Weg zwischen Nachbarn niemals durch einen Ankerhof führt.
  • Distanz-Lesbarkeit: wie der Standort aus 300 m, 100 m und am Tor aussieht: eine Silhouette, dann seine Funktion, dann seine Eingänge.

2. Die visuelle Beschreibung (eine pro Standort, in POI_BRIEFS)

Felder: id, name, stufe, typ, größe, zugangsseite, gelände, das gebäudeprogramm (Kit, Rolle, Grundfläche, Stockwerke, Höhe für jedes), das hero-element, das layout in einem absatz, sein zustand und sein zustand, und eine stimmungszeile. Konzeptbilder, die aus der Beschreibung erstellt werden, sind Stimmung, nicht Spezifikation: Sie fügen niemals Gebäude hinzu, verschmelzen oder verschieben sie, und der Plan bleibt die Wahrheit. Generiere jedes Konzept in einem festen Licht, einer Jahreszeit, einem Farbgrad und einer Kamerasprache (eine Luftaufnahme von der Zugangsseite, einen Aufsichtsplan, eine Augenhöhenansicht vom Zugang, die Hero-Nahaufnahme).

3. Gelände und Straßen zuerst

Lege den Standort zuerst mit den Straßen an, dann platziere die Gebäude, dann die Freiflächen, dann die Props.

  • Nivellierung: Podeste und Höfe sind flache Terrassen (typischer Quergefälle 3 % oder weniger), die durch Rampen (typischerweise 10 % oder weniger, mit Podesten) und Treppen verbunden sind; Terrassenkanten sind Stützmauern oder bepflanzte Böschungen, die nicht steiler als etwa 1:2 sind. Zwei oder mehr Verbindungen zwischen den Terrassen; niemals eine einzige ummauerte Rampe. Kein Gebäude steht auf rohem Hang; Gelände scheint niemals durch eine harte Oberfläche.
  • Straßen: ein verbundenes Netz mit einer Hierarchie (Hauptstraße vom Tor, Seitenstraßen, Gassen, Alleen); jede Fahrt endet an einer Kreuzung, einem Tor oder einem Wendehammer; Weltstraßen enden an einem Tor und kreuzen niemals den Standort; keine Straße kreuzt ein Gebäude oder eine gestaltete Freifläche; Gebäude haben einen Bürgersteig und einen Abstand zur Fahrbahn. Biege niemals eine Straße nur, um eine Sichtlinie zu unterbrechen.
  • Wasserkanten innerhalb des Standorts sind gebaut (Kaimauer, Uferbefestigung, Slipanlage); ans Meer angeschlossenes Wasser liegt auf Meereshöhe.
  • Umzäunungen gehören zur Rolle: Mauern und Türme an einer Basis, niedrige Mauern und Hecken in einer Stadt, ein Sicherheitszaun mit Pförtnerhaus an einer Anlage. Der gleiche Zaun an jedem Standort ist ein Fehler. Tore lesen sich als Tore, auf einer geraden Kante, die länger als ihr Rahmen ist.

4. Fluss (der Starter FLOW_RULES)

Führe den Standortplan als Raumgraph durch building-layout-check für jedes Gebäude aus und messe diese am gesamten Standort. Die Zahlen sind typische Startwerte; kalibriere sie an den ersten Standorten, die ausgeliefert werden.

Zugänge und Rotation

  • 3-5 Zugänge für eine Verbindung, 4-8 für einen Komplex oder eine Stadt, höchstens etwa 8; auf mindestens 3 Seiten (2 für einen Außenposten oder eine Station); keine Seite trägt mehr als die Hälfte. Informelle Zugänge (ein Durchbruch, ein Durchlass, ein Kletterweg) haben einen Preis: Lärm, Bücken, Wasser.
  • Kein Standpunkt sieht mehr als die Hälfte der Zugänge oder mehr als 2 innerhalb von 60 m.
  • Min cut (die wenigsten Öffnungen, die den Anker von außen versiegeln) mindestens 3 für eine Verbindung oder größer, 2 für kleine Standorte; zwischen Unterbereichen mindestens 2. Verbundene Parzellen teilen eine echte Naht, niemals zwei sich berührende Ecken.
  • Mindestens 3 Rotationslinien verlassen einen großen Standort in Richtung verschiedener Nachbarn und Zugänge.

Engpässe, Schleifen und Sackgassen

  • Spieler-Engpässe 1,2-3 m breit, Gassen 4-8 m, Routen für große Kreaturen mindestens das 1,5-fache von LARGE_AGENT_DIAMETER (und ihre Schleifen sind Schleifen, niemals eine Sackgasse); jeder Engpass hat eine Umgehung, die nicht mehr als das Doppelte der direkten Route beträgt; höchstens ein Engpass pro Gasse ins Kerngebiet.
  • Mindestens drei unabhängige Schleifen quer durch den Standort und eine Schleife durch das Innere jedes Gebäudes mit einer Fläche von über etwa 400 m2.
  • Außensackgassen höchstens 15 m tief und keine Tasche über 20 x 20 m; innen einen Raum tief. Gassen setzen sich fort: Keine endet an einer leeren Wand oder einem Zaun.

Vertikales Spiel und Sichtlinien

  • Höchstens drei Etagenebenen pro Bereich. Jeder erreichbare Boden, jedes Dach und jeder Aussichtspunkt hat zwei Aufgänge, die etwa 15 m voneinander entfernt oder auf gegenüberliegenden Seiten liegen; nimm an, dass kletternde Feinde Dächer erreichen, wenn das Spiel sie hat.
  • Jede Sichtachse wird deklariert und gemessen: mindestens zwei Gegenwinkel von verschiedenen Gassen, eine vergleichbare Sichtachse auf einer anderen Gasse 60-120 m entfernt, und keine Sichtachse, die mehr als etwa 40 % des begehbaren Kerngebietsbodens sieht.
  • Ein Sichtlinienbruch alle 30-60 m; lange offene Linien (über etwa 100 m) nur auf ein oder zwei deklarierten Achsen mit einem Grund (der Hauptzugang, ein Exerzierplatz, ein Kai, eine Startbahn).

Deckung und Kampfräume

  • Deckung alle 8-15 m entlang jeder Route; kein Punkt in einem benannten offenen Bereich weiter als 15 m von Deckung, die 1,0 m oder höher ist. Niedrige Deckung 1,0-1,25 m, hohe 1,75 m oder mehr; etwa 60 % der Streckendeckung niedrig; hohe Deckung an Gassenenden, Türen und Ecken. Deckung passt zu ihrem Ort: Straßenmobiliar auf Plätzen, Fracht in Höfen.
  • Betretbare Gebäude haben zwei oder mehr Türen auf verschiedenen Seiten; Anker haben mehr, eine große. Sackgassenräume sind nur absichtliche Beuteräume.
  • Größere Kampfräume für den größten Feind und für die Gruppenstärke: Ein Hof, den eine große Kreatur betreten kann, hat zwei große Ausgänge; ein Standort beherbergt zwei Gruppen, die von verschiedenen Seiten ankommen, ohne dass eine die andere bewacht; er liest sich und belohnt immer noch einen einzelnen Spieler, wenn er leer ist.
  • Set-Pieces (ein eingestürzter Kran, ein aufgebrochener Tresor, ein gestrandetes Fahrzeug, eine überflutete Halle) liegen an einer Gasse, haben zwei Ein- und Ausgänge und sind vom Zugang aus sichtbar.
  • Benannte Unterbereiche, die jeder auf einen Blick erkennen kann ("der Tanklager", "das blaue Lagerhaus"); an jeder Kreuzung sind zwei Wege ohne Umkehren sichtbar.

Zu benennende Fehlermuster in Überprüfungen: Kissing Corners, Front-Door-Funnel, der Moat, Dead-End-Yard, One-Door-Box, Stair Trap, God Roof, die Tube, Shooting Gallery, Guess Map, Stub Lane, Sole Crossing, Fishbowl, Through-Road Magnet, Blank Back, Edge Loot, Fence Maze, Creature Cul-de-Sac, Overwatched Neighbour, Single-Plane Anchor. Jeder Kritikerfund benennt sein Muster und seine Behebung.

5. Geschichte durch die Umgebung

  • Die Aufgabe demonstrieren: der Anker im Herzen; die Rolle jedes Gebäudes passt zu seiner Position (Ladetüren zu Höfen, Wachhäuschen an Toren, Treibstoff bei Fahrzeugen); sichtbare Dienstleistungen (Strom, Wasser, Treibstoff, Abfall, Kommunikation, wo die Rolle sie benötigt).
  • Freiflächen sind gestaltet: Innenhöfe, Arbeits- und Lagerhöfe, Laderampen, Parkplätze, Raucherunterstände, Mülltonnengehege, Vordächer, Generatorfundamente, jeder dort, wo ihn ein echter Standort hinstellt. Ein Standort, der sich beengt liest, fällt durch, selbst wenn die Dichtreihen bestehen.
  • Was geschah hier: Jeder Hof erzählt eine kleine Geschichte mit seinen Props (unterbrochenes Entladen, ein Kontrollpunkt, eine Reparatur...), die durch Anordnung und Zustand und die Wahl der Props vermittelt wird.
  • Die Geschichte ist der Geschichte untergeordnet: Erzähle nicht mehr, als nötig ist, um den Standort einprägsam zu machen. Lasse Fragen offen.

Individual skills in this repo

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

building-layout-check

Check that a generated or hand-built building, interior or enclosed environment (houses, offices, bunkers, ships, temples, ruins, caves, compounds, stations) is structurally sensible and properly walkable - load paths, walls that start and end at something, doors that lead somewhere, stairs with landings and headroom, no orphan rooms, no walls dropped into openings, enough exits, shallow dead ends, loops and two ways up where people fight or flee. Engine- and genre-neutral; ships a space-graph checker script. Use when reviewing a building or layout an agent or generator produced, before accepting a prefab, or when writing layout rules for a kit.

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.

Verwandte Skills