Communitygithub.com

poi-design

Projete, construa, critique e finalize pontos de interesse (fortificações, cidades, instalações, estações, destroços, acampamentos, ruínas, cavernas) em um jogo de mundo aberto de qualquer ambientação, período, estilo ou gênero.

O que é poi-design?

Esta skill estabelece um método completo para o design de pontos de interesse (POIs) em jogos de mundo aberto, garantindo que cada local pareça um lugar real, construído e utilizado, ao mesmo tempo que funciona como um mapa de jogo projetado. Ela começa definindo o propósito do site no mundo e no jogo, a descoberta sem marcadores (usando marcos naturais, estradas e silhuetas) e a leitura à distância. O processo abrange desde um briefing visual por site, layout baseado em ruas e terreno, até regras detalhadas de fluxo de combate com verificações de gargalos, loops, cobertura e linhas de visão. A skill também aborda a narrativa ambiental, a colocação de saques, regras de fornecimento de adereços e veículos, montagem a partir de peças de kit aprovadas e uma 'barra de acabamento' para controle de qualidade. Um componente crítico é o ciclo de crítica cega calibrada, onde os sites são revisados por olhos humanos e voos aéreos para garantir que atendam aos padrões do estúdio, com correções de falhas registradas como regras. A skill suporta várias plataformas (Claude Code, Cursor, Codex) e enfatiza a reutilização em vez de modelagem manual, evidências sobre alegações e a regra final 'faz sentido?', evitando seguir regras cegamente em detrimento da qualidade do site.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Design de POI (Ponto de Interesse)

Um ponto de interesse é finalizado quando se lê como um lugar real que alguém construiu e usou, no estado que seu briefing determina (funcionando, ocupado, abandonado, arruinado ou nunca construído, como uma caverna ou bosque), e funciona como um mapa projetado: jogadores e criaturas podem entrar, atravessar e sair dele, os combates têm forma, e a recompensa vale o risco. Passar em verificações automáticas é necessário e nunca suficiente. Esta skill é o método para um local inteiro; os números vêm do mundo do projeto, da contagem de jogadores e das criaturas.

Skills complementares: modular-environment-kit-production (as peças com as quais o local é construído e seu acabamento), building-layout-check (cada edifício dentro do local e o briefing mundial que esta skill estende) e project-knowledge-system (onde o padrão, as decisões e as lições são armazenados). Esta skill não os repete; ela aponta para eles.

Configurações fornecidas pelo projeto

ConfiguraçãoSignificadoPadrão
WORLD_BRIEFAmbientação, período, construtores, estilo de arte, quem se move pelo mundo (definido em building-layout-check).Obrigatório antes do primeiro local.
WORLD_PLANO mapa mundial com cada local, seu nível, as rotas entre locais, zonas e pontos de referência.Obrigatório antes do layout do local.
POI_BRIEFSUm briefing visual por local (campos abaixo).Docs/Design/World/POIBriefs.json
POI_RUBRICO padrão de qualidade: as linhas da verificação automática, as perguntas dos críticos, P0 e P1, as fichas de padrão de área.Docs/Design/World/POIStandard.md
FLOW_RULESRegras de fluxo numeradas e mensuráveis e padrões de falha nomeados (conjunto inicial abaixo).Seção de fluxo desta skill
PLACEMENT_RULESOnde cada tipo de adereço vai, por zona, âncora e propósito.Seção de história desta skill
PROP_LIBRARYO catálogo aprovado de adereços e veículos, uma fonte por tipo de adereço.Obrigatório; um local nunca coloca um adereço não catalogado.
PROP_POLICYSe adereços soltos podem ser modelados para um local.Não: estrutura e peças fixadas em edifícios apenas; adereços soltos vêm de PROP_LIBRARY; uma lacuna vai para uma lista para o proprietário.
VEHICLE_CLASSESTipos de veículos que podem aparecer e por quê.Utilitário apenas (trabalho, serviço, transporte, militar, agrícola); baixa variedade.
KIT_CONTRACT, FINISH_SPEC, CORE_LIBRARYComo em modular-environment-kit-production.Padrões dessas skills
TIERSNíveis de local com faixas de tamanho típicas e contagens de edifícios.Ponto (um destroço, acampamento, entrada de caverna, santuário) 10-40 m, posto avançado 40-80 m, estação 60-150 m, fortificação 80-220 m, complexo 200-400 m em 2-4 subáreas, cidade 250-600 m em 4-6 subáreas ao redor de uma praça
PLAYER_COUNTJogadores por servidor e um tamanho típico de esquadrão.Obrigatório; define quantos grupos um local deve comportar.
LARGE_AGENT_DIAMETERMaior criatura ou veículo que deve passar (como em building-layout-check); adicione um por classe de tamanho se houver vários.0 (nenhum)
PROFILE, SITEComo em building-layout-check; a maioria dos POIs é contested.contested, building
CRITIC_TARGET, CAMERA_RANGEOs jogos finalizados cujos locais os críticos comparam pelo nome; distâncias de câmera de trabalho.Nomeado no briefing mundial; 2-5 m em primeira pessoa
CRITIC_MODELModelo e esforço de raciocínio para cada crítico de POI.O modelo mais forte disponível com alto esforço de raciocínio
STUDIO, STAMPSA superfície de revisão que o proprietário observa; onde carimbos e sinalizações são registrados e quem pode carimbar.Uma página de revisão privada com fotos, folha de caminhada, planta e vereditos; carimbos de líder, sinalizações de proprietário
RULES_LEDGEROnde cada regra nascida de uma falha é registrada com sua data e causa.O registro de decisões do projeto mais o registro de alterações de POI_RUBRIC
DCC, ENGINEFerramenta de modelagem e motor gráfico.Escolha do projeto

Princípios

  1. Propósito primeiro. Cada local tem um trabalho no mundo e um trabalho no jogo; cada edifício, pátio, estrada e adereço serve a um deles.
  2. Layout é soberano. Depois que um local é finalizado, passes de arte posteriores mantêm seus corredores, entradas, pontos de vantagem e pontos de referência; alterar qualquer um deles o reabre.
  3. Reutilização antes da modelagem. Os locais são montados a partir de peças de kit aprovadas e adereços catalogados; nada é construído à mão no motor gráfico.
  4. Evidências sobre alegações. A verificação automática mede; os críticos julgam o que a verificação não pode; renderizações e folhas de caminhada são as evidências.
  5. Bom é suficiente. P0s bloqueiam; todo o resto é uma lista de pendências.
  6. Faz sentido? Nunca adicione, mova ou dobre algo apenas para satisfazer uma linha de verificação, um crítico ou uma regra. Se uma regra piorar este local, peça ao líder uma exceção com a razão e registre-a.

1. O lugar do local no mundo

O que WORLD_BRIEF deve adicionar para POIs. Além da meia página que building-layout-check solicita, o briefing declara: como os jogadores navegam (mapa, bússola, pontos de referência; se existem marcadores), o elenco de ameaças com suas classes de tamanho e o que cada uma pode escalar, entrar ou quebrar, PLAYER_COUNT e como os grupos se encontram, a economia de recompensas (o que é escasso, o que custa morrer), e a idade do mundo, clima e história desde que os locais foram construídos, o que define até onde o desgaste e o crescimento excessivo chegaram.

Quais regras se aplicam. Defina PROFILE e SITE por local como em building-layout-check. As regras de fluxo, cobertura e vantagem na seção 4 são para locais contested, onde jogadores ou criaturas lutam, perseguem ou fogem. Um local explore (um santuário tranquilo, uma ruína de história) mantém alcance, encontrabilidade, história e acabamento, e relata as regras de combate como notas. Um local natural (uma caverna, um desfiladeiro, um bosque) não deve rede de ruas, perímetro, serviços ou nivelamento, mas ainda deve entradas e saídas, uma rota legível, um ponto de referência ou leitura de entrada, becos sem saída rasos onde ocorrem combates e rotas para grandes criaturas que formam um loop. Uma ruína deve o que sobreviveu de sua lógica original, e seus danos seguem uma causa. Locais de nível Ponto (um único destroço, acampamento ou entrada de caverna) precisam de duas abordagens, uma razão para parar, cobertura perto da recompensa e uma leitura à distância; as contagens em escala de local (entradas, corte mínimo, três loops) começam no nível posto avançado.

Escreva estas linhas para cada local em WORLD_PLAN antes de alguém desenhar uma planta.

  • Função: para que foi construído (mover carga, proteger e abrigar, estudar, viver e comercializar, extrair, adorar) e o que é agora (abandonado, ocupado por outra pessoa, arruinado, recuperado).
  • Nível e tamanho: de TIERS. Um local cresce apenas até onde suas subáreas e praça precisam, nunca espalhando edifícios. Locais de alto nível são poucos, de nível médio muitos, e cada região contém um local que vale a pena cruzá-la para alcançar.
  • Ameaça: quem e o que o detém (facções, criaturas, perigos), como isso escala com PLAYER_COUNT, e se grandes criaturas podem alcançar seu núcleo. Onde grandes criaturas importam, elas mantêm a vantagem: o local dá aos jogadores maneiras de quebrar o contato, não refúgios onde um esquadrão as explora.
  • Recompensa: o que é encontrado aqui que não é encontrado em nenhum outro lugar, e seu valor em relação aos vizinhos. Recompensa segue risco.
  • Razões de terreno, história e jogo: uma linha cada. Um local sem razão de terreno parece jogado; um sem razão de jogo é ignorado pelos jogadores.
  • Descoberta sem marcadores: os jogadores encontram e reconhecem o local apenas através do mundo. Use um ponto de referência que limpe o que quer que esconda o local (dossel, telhados, dunas, uma crista), legível a cerca de 300 m (típico: um mastro, guindaste, torre, tanque, chaminé, casco); estradas, linhas de energia, tubulações e cercas que levam a ele; trilhas, fumaça, luz à noite, som; sinais na própria língua do mundo. Nunca confie em um ícone de mapa, marcador mundial ou chamada de HUD.
  • Espaçamento e abordagens: locais menores típicos a 500-800 m de distância, maiores a 1 km ou mais; dois ou três satélites (postos avançados, pontos de verificação, acampamentos) nas abordagens de um complexo, cerca de 200-600 m para fora; uma linha de cobertura (cerca, vala, muro, linha de destroços) em terreno aberto por cerca de 150 m entre locais; um desvio coberto a 50-150 m fora de todo local grande para que o caminho mais curto entre vizinhos nunca passe por um pátio âncora.
  • Leitura à distância: a aparência do local a 300 m, 100 m e no portão: uma silhueta, depois sua função, depois suas entradas.

2. O briefing visual (um por local, em POI_BRIEFS)

Campos: id, nome, nível, tipo, tamanho, lado de acesso, terreno, o programa de construção (kit, função, pegada, andares, altura para cada um), o elemento heroico, o layout em um parágrafo, seu estado e condição, e uma linha de clima. Imagens conceituais feitas a partir do briefing são clima, não especificação: elas nunca adicionam, mesclam ou movem edifícios, e a planta continua sendo a verdade. Gere cada conceito em uma luz, estação, nível e linguagem de câmera fixos (uma aérea do lado de acesso, uma planta superior, uma vista à altura dos olhos da abordagem, o heroico em close-up).

3. Terreno e ruas primeiro

Organize o local primeiro pelas ruas, depois coloque os edifícios, depois o espaço aberto, depois os adereços.

  • Nivelamento: plataformas e pátios são terraços planos (declive transversal típico de 3% ou menos) unidos por rampas (típico 10% ou menos, com patamares) e escadas; bordas de terraço são muros de contenção ou taludes plantados com inclinação não superior a cerca de 1:2. Duas ou mais ligações entre terraços; nunca uma única rampa murada. Nenhum edifício fica em declive bruto; o terreno nunca aparece através de uma superfície dura.
  • Ruas: uma rede conectada com uma hierarquia (rua principal do portão, ruas laterais, vielas, becos); toda via termina em uma junção, um portão ou uma cabeceira de retorno; estradas mundiais terminam em um portão e nunca cruzam o local; nenhuma estrada cruza um edifício ou um espaço aberto projetado; os edifícios mantêm uma calçada e recuo da via. Nunca dobre uma estrada apenas para quebrar uma linha de visão.
  • Bordas d'água dentro do local são construídas (parede de cais, enrocamento, rampa de lançamento); a água unida ao mar fica ao nível do mar.
  • Perímetros pertencem à função: muros e torres em uma base, muros baixos e sebes em uma cidade, uma cerca de segurança com uma guarita em uma instalação. A mesma cerca em todos os locais é uma falha. Portões se leem como portões, em uma borda reta mais longa que seu batente.

4. Fluxo (as FLOW_RULES iniciais)

Execute a planta do local como um grafo espacial através de building-layout-check para cada edifício e meça estes no local inteiro. Os números são pontos de partida típicos; calibre-os nos primeiros locais finalizados.

Entradas e rotação

  • 3-5 entradas para uma fortificação, 4-8 para um complexo ou cidade, no máximo cerca de 8; em pelo menos 3 lados (2 para um posto avançado ou estação); nenhum lado carrega mais da metade. Entradas informais (uma brecha, um bueiro, uma escalada) têm um custo: barulho, uma posição agachada, água.
  • Nenhum ponto de parada vê mais da metade das entradas, ou mais de 2 dentro de 60 m.
  • Corte mínimo (o menor número de aberturas que selam a âncora do exterior) de pelo menos 3 para uma fortificação ou maior, 2 para locais pequenos; entre subáreas pelo menos 2. Parcelas ligadas compartilham uma costura real, nunca dois cantos se tocando.
  • Pelo menos 3 linhas de rotação saem de um local grande em direção a diferentes vizinhos e entradas.

Gargalos, loops e becos sem saída

  • Gargalos de jogador com 1,2-3 m de largura, corredores com 4-8 m, rotas para grandes criaturas com pelo menos 1,5 vezes LARGE_AGENT_DIAMETER (e seus loops são loops, nunca um beco sem saída); todo gargalo tem um desvio de no máximo o dobro da rota direta; no máximo um gargalo por corredor para o núcleo.
  • Pelo menos três loops independentes em todo o local e um loop através do interior de qualquer edifício com mais de cerca de 400 m².
  • Becos sem saída externos com no máximo 15 m de profundidade e nenhum bolsão com mais de 20 x 20 m; em ambientes internos, com a profundidade de uma sala. Os corredores continuam: nenhum termina em uma parede ou cerca em branco.

Jogo vertical e linhas de visão

  • No máximo três planos de piso por área. Cada piso, telhado e poleiro acessível tem duas subidas, com cerca de 15 m de distância ou em lados opostos; presuma que criaturas escaladoras alcançam telhados se o jogo as tiver.
  • Cada ponto de vantagem é declarado e medido: pelo menos dois contra-ângulos de corredores diferentes, um ponto de vantagem comparável em outro corredor a 60-120 m de distância, e nenhum ponto de vantagem que veja mais de cerca de 40% do solo caminhável do núcleo.
  • Uma quebra de linha de visão a cada 30-60 m; linhas abertas longas (mais de cerca de 100 m) apenas em um ou dois eixos declarados com uma razão (a abordagem principal, um campo de parada, um cais, uma pista).

Cobertura e espaços de combate

  • Cobertura a cada 8-15 m ao longo de cada rota; nenhum ponto em uma área aberta nomeada a mais de 15 m de cobertura com 1,0 m ou mais de altura. Cobertura baixa 1,0-1,25 m, alta 1,75 m ou mais; cerca de 60% da cobertura da rota é baixa; cobertura alta nas extremidades dos corredores, portas e cantos. A cobertura se adequa ao seu lugar: mobiliário urbano em praças, carga em pátios.
  • Edifícios entráveis têm duas ou mais portas em lados diferentes; âncoras mais, uma grande. Salas sem saída são apenas salas de saque deliberadas.
  • Dimensione os espaços de combate para o maior inimigo e para a contagem do grupo: um pátio que uma grande criatura pode entrar tem duas saídas grandes; um local comporta dois grupos chegando de lados diferentes sem que um acampe o outro; ainda se lê e recompensa um único jogador quando vazio.
  • Cenas (um guindaste colapsado, um cofre violado, um veículo encalhado, um salão inundado) ficam em um corredor, têm duas entradas e saídas e são vistas da abordagem.
  • Subáreas nomeadas que todos podem chamar de relance ("

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.

Habilidades Relacionadas