Vérification d'agencement de bâtiments
Les kits modulaires permettent de placer un mur n'importe où sur la grille, et les générateurs et agents font exactement cela : des murs qui se terminent au milieu d'une pièce ou traversent une fenêtre, des portes qui s'ouvrent sur un mur ou un vide, des pièces inaccessibles, des escaliers qui arrivent face à un mur, des boîtes à une seule porte et des couloirs qui ne bifurquent jamais. Cette compétence est la vérification qui les rattrape. Elle juge l'agencement et la structure, pas la finition ni les matériaux.
Elle fonctionne pour tout cadre, époque et style artistique, car elle juge chaque espace selon la logique propre du monde, écrite une fois dans un brief monde (ci-dessous) : un donjon en pierre selon la façon dont les maçons construisent et dont une garnison vit, un vaisseau spatial selon la façon dont son équipage se déplace et ce que sa coque transporte, une grotte selon la façon dont l'eau l'a creusée et dont ses habitants l'utilisent, un village de dessin animé selon les règles de son style. Les codes de construction modernes ne sont que le recours par défaut lorsqu'un projet ne dit rien.
Trois passes, dans l'ordre, car chacune est moins coûteuse que la suivante : le graphe spatial (un script, quelques secondes), les sondes géométriques (dans le moteur ou l'outil de modélisation, quelques minutes), et la revue à hauteur d'œil (une personne ou un agent critique frais). Un bâtiment est validé lorsqu'aucun blocage ne subsiste dans aucune passe.
Le brief monde (à écrire avant la première vérification)
Une courte section dans la documentation d'environnement du projet, environ une demi-page, que chaque vérificateur et chaque relecteur lit. Sans cela, les relecteurs se rabattent sur leur propre époque et style et signalent les mauvaises choses.
- Cadre et période : où et quand (par exemple « ville fluviale médiévale tardive », « station minière orbitale, années 2300 », « ruines d'une banlieue des années 1970 après une inondation », « terriers de champignons anthropomorphes »).
- Qui l'a construit, avec quoi : la technologie et les matériaux des constructeurs, et ce que cela permet : portées (bois de 4 à 6 m, voûtes en pierre, fermes en acier, corail cultivé), épaisseur des murs, comment les planchers sont soutenus, comment le déplacement vertical fonctionne (escaliers, échelles, rampes, ascenseurs, escalade, vol, téléporteurs).
- À quoi il sert, et ce qui lui est arrivé : son objectif d'origine, son utilisation actuelle (habité, abandonné, occupé par quelqu'un d'autre, en ruine) et les événements qui l'ont changé (siège, inondation, effondrement, végétation envahissante). Les dégâts doivent avoir une cause dans ce monde.
- Les règles du style artistique : réaliste, stylisé, exagéré, low-poly ou jouet, et ce qu'il fait aux proportions (portes surdimensionnées, murs trapus, verticales bancales) et aux détails. Un monde stylisé peut délibérément tordre les proportions réelles ; le brief indique jusqu'où.
- Qui s'y déplace : la taille du joueur et ses déplacements (marche, accroupi, rampement, escalade, saut, nage, vol), les compagnons, créatures et véhicules qui doivent passer, et si les espaces sont explorés, construits, combattus ou traversés en fuite (cela définit
PROFILE). - Exceptions délibérées : ce que ce monde fait qu'un bâtiment moderne ne ferait pas, pour que les relecteurs l'acceptent (créneaux non gardés, échelles au lieu d'escaliers, fortifications à une seule entrée, huttes sans porte, escaliers en colimaçon avec des marches raides, pièces accessibles uniquement par escalade).
Les règles ci-dessous qui disent « sensé », « un constructeur », « un concepteur » ou « une raison » signifient : sensé pour les constructeurs, l'objectif et le style de ce brief.
Paramètres fournis par le projet
Chaque paramètre a une valeur par défaut pour un joueur à échelle humaine, en mètres, avec des proportions modernes. Un projet avec d'autres proportions ou une autre période (une petite créature, un géant, un véhicule, des escaliers médiévaux raides, une unité différente) définit les nombres à partir de son brief monde, pas de la méthode. Dans le script, les paramètres proviennent de l'objet "settings" du graphe, puis de --profile et --site, puis de --set NAME=VALUE (le dernier gagne) ; un nom inconnu est une erreur, donc une faute de frappe ne passe jamais silencieusement.
Type de site et règles désactivées. Certaines règles proviennent de la façon dont les bâtiments sont conçus pour les personnes (sorties par surface au sol, boucles intérieures, pas d'entonnoir unique, part des pièces sans issue, couloirs qui bifurquent). Une grotte, une ruine ou un espace naturel ne les doit pas pour l'exploration, donc avec SITE natural ou ruin et PROFILE explore elles sont signalées comme des notes ; dans contested elles s'appliquent partout, car les combats et les poursuites en ont besoin où qu'ils se produisent. Toute règle peut également être désactivée par le brief monde avec RULES_OFF (par exemple une forteresse avec une seule porte par conception : RULES_OFF=exits,funnel), ou acceptée pour un espace dans la liste accepted du graphe.
| Paramètre | Défaut | Signification | Utilisé par |
|---|---|---|---|
WORLD_BRIEF | aucun (moderne, réaliste, échelle humaine supposée, et le rapport doit le dire) | La demi-page ci-dessus. | Toutes les passes |
PROFILE | explore | explore (exploration, histoire, construction, survie sans combats intérieurs) ou contested (les joueurs combattent, poursuivent ou fuient ici). contested active les règles marquées (C). | Script |
SITE | building | building, vessel (vaisseaux, stations, véhicules : traités comme un bâtiment), natural (grottes, canyons, bosquets, glace, récifs) ou ruin. | Script |
RULES_OFF | aucun | Liste séparée par des virgules des identifiants de règles signalées comme notes uniquement. | Script |
PLAYER_RADIUS | 0.40 | La moitié de la largeur de la capsule de marche. | Script |
CROUCH_HEIGHT | 1.10 | Hauteur libre nécessaire dans les espaces de reptation, passages étroits, nages, échelles, escalades, trappes et fenêtres. | Script |
MIN_HEADROOM | 2.10 | Hauteur libre au-dessus de toute surface praticable qui n'est pas un espace de reptation. | Script |
MIN_DOOR_WIDTH | 0.90 | Largeur libre d'une porte, ouverture, escalier, rampe ou ascenseur. | Script |
MIN_CORRIDOR_WIDTH | 1.20 | Largeur libre d'un couloir ou passage. | Script |
MIN_SPIRAL_WIDTH | 0.70 | Largeur libre d'un escalier marqué "spiral": true. | Script |
MIN_CLIMB_WIDTH | 0.60 | Largeur libre d'une échelle, escalade, trappe ou nage. | Script |
LARGE_AGENT_DIAMETER | 0 (aucun) | Diamètre de la plus grande créature ou véhicule qui doit passer ; les routes marquées large_route sont au moins 1,5 fois plus larges. | Script |
STAIR_RISER_MIN, STAIR_RISER_MAX | 0.10, 0.20 | Plage de hauteur de marche. Un monde médiéval ou exigü augmente le maximum. | Script |
STAIR_TREAD_MIN, STAIR_TREAD_MAX | 0.22, 0.40 | Plage de giron. | Script |
STAIR_PACE_MIN, STAIR_PACE_MAX | 0.55, 0.70 | La règle de foulée : deux fois la hauteur de marche plus le giron. Elle tient à travers les périodes et détecte les escaliers raides pour leur giron. Non appliquée aux colimaçons. | Script |
MAX_RISERS_PER_FLIGHT | 16 | Un palier au moins aussi souvent (non appliqué aux colimaçons). | Script |
STEP_HEIGHT | 0.45 | La plus haute marche que le personnage escalade sans escalier ; une porte ou ouverture avec un step plus grand est un blocage. | Script |
GUARD_DROP | 1.00 | Un espace praticable avec un edge_drop supérieur à cela nécessite "guarded": true (rambarde, parapet, mur, ou quoi que ce soit que ce monde utilise), ou une condition acceptée disant que le vide est délibéré et se lit comme tel. | Script, sonde |
TUBE_LENGTH | 15 | Couloir ou passage le plus long sans embranchement. | Script |
DEAD_END_DEPTH | explore 20, contested 10 | Impasse la plus profonde à partir de sa dernière jonction, en mètres. | Script |
EXIT_SPACING, VERTICAL_SPACING | 10, 15 | Les sorties plus proches que cela sur une même face comptent une fois ; deux routes verticales doivent être au moins aussi éloignées. | Script |
MAX_ROOM_OPENINGS | 4 | (C) Nombre maximal d'ouvertures dans une pièce ou salle. | Script |
MIN_SPACE_AREA | 1.0 | Plus petit espace utilisable. | Script |
GUARD_HEIGHT | 1.00 à 1.10 | Hauteur d'une protection là où elle est nécessaire. | Sonde |
LAYOUT_SOURCE | les données d'agencement du projet | D'où vient le plan : une recette ou un manifeste, un export de niveau, ou un plan dessiné à la main. | Entrée de la passe 1 |
Sorties par surface au sol (tous les étages intérieurs praticables ensemble). Les sorties plus proches que EXIT_SPACING sur la même face comptent une fois ; une fenêtre par laquelle un joueur peut grimper compte pour moitié ; une chute à sens unique vers l'extérieur est une échappatoire, listée mais non comptée.
| Surface au sol | explore | contested |
|---|---|---|
| Moins de 100 m² | 1 | 2, sur 2 faces |
| 100 à 400 m² | 2, sur 2 faces | 3, sur au moins 2 faces |
| Plus de 400 m² | 3, sur au moins 2 faces | 4, sur au moins 3 faces |
Passe 1 : le graphe spatial (script)
Décrivez le lieu comme des espaces et des liens en JSON (format et tous les champs dans templates/space_graph.example.json) et exécutez :
python3 -I scripts/layout_check.py <graph.json> [--profile explore|contested] [--site building|natural|ruin|vessel] [--set NAME=VALUE ...] [--json out.json]
- Un espace est un endroit où un joueur peut se tenir et qui se lit comme un seul lieu. Types :
exterior(le monde extérieur, exactement un),room,chamber(pièces naturelles ou irrégulières),corridor,passage(couloirs naturels),landing,stair(une cage d'escalier),roof,deck,yard,void(scellé). Les pièces, chambres, couloirs, passages, paliers, toits et ponts comptent pour les impasses ; les pièces et chambres comptent pour les ouvertures et la part d'impasses. Donnez à chacun un identifiant, un étage, une surface, et si possible : position (x, y), longueur et largeur (couloirs et passages), hauteur libre,edge_dropetguarded,crawl,anchor(l'espace principal),sealed. - Un lien est tout passage entre deux espaces. Types :
door,opening,stair,ramp,lift,ladder,hatch,climb,swim,squeeze(passage en rampant),window(une fenêtre par laquelle un joueur grimpe) etdrop(à sens unique, de a vers b). Donnez-lui sa largeur libre et sa hauteur libre si connues,faceet x, y pour les liens vers l'extérieur,steppour un changement de niveau à une porte, et riser, tread, risers etspiralpour les escaliers. Modélisez chaque volée d'escalier comme un lien d'escalier entre les espaces qu'elle relie ; tout lien nondropentre deux étages compte comme une route verticale.
Identifiants de règles, utilisés dans les rapports, accepted et 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. Une entrée accepted est {"rule": "...", "space": "..."} (ou "link"), ou juste une règle et une raison de l'accepter partout.
Le script rapporte BLOCKER, FINDING, ACCEPTED, NOTE (y compris ce qu'il n'a pas pu vérifier à partir des données fournies) et OK :
- Accessibilité (
reach,return) : chaque espace non scellé accessible depuis l'extérieur avec les déplacements du graphe, et un chemin de retour depuis chacun (les chutes sont à sens unique). - Sorties (
exits) : nombre, faces et espacement par rapport au tableau. - Impasses (
dead_end,dead_share) : espaces avec une seule entrée, profondeur de la chaîne depuis la dernière jonction, et (C) la part de pièces sans issue. - Boucles (
loop) : au moins une boucle intérieure là où le lieu fait plus de 400 m² ou plus de deux espaces de profondeur. - Entonnoir (
funnel) : routes séparées (ne partageant aucun espace) de l'extérieur vers l'ancre, ou vers la pièce la plus profonde si aucune n'est marquée ; une route est un blocage en (C) au-dessus de 100 m² et une constatation au-dessus de 400 m². - Routes verticales (
vertical) : routes de chaque étage vers l'étage d'entrée, montantes ou descendantes ; deux, espacées d'au moinsVERTICAL_SPACING, sur les étages de plus de 200 m², ou de plus de 100 m² en (C). - Tailles et niveaux (
door_width,corridor_width,large_width,headroom,small,step) : largeurs et hauteurs libres par type de lien, espaces plus étroits que le joueur, pas de marche sans escalier. - Escaliers (
stair) : hauteur de marche, giron, foulée et longueur de volée ; hauteurs de marche mélangées dans un même bâtiment. - Bords (
guard) : chutes non protégées au-dessus deGUARD_DROP. - Tubes et ouvertures (
tube,openings) : couloirs de plus deTUBE_LENGTHsans embranchement ; (C) pièces avec trop d'ouvertures.
Passe 2 : sondes géométriques (dans le moteur ou l'outil de modélisation)
Le graphe ne peut pas voir la géométrie. Exécutez ces sondes sur le bâtiment assemblé avec les outils du projet ; chacune doit produire un nombre ou une liste, pas une capture d'écran.
| Sonde | Mesure | Échoue quand |
|---|---|---|
| Inondation de marche | Une capsule de la taille du joueur marche depuis chaque porte extérieure avec gravité, traitant les murs comme solides (une construction de maillage de navigation est acceptable). | Un espace que le graphe appelle accessible n'est pas atteint, ou la marche atteint un endroit que le graphe n'a pas (un trou, le dessus d'un mur, un toit sans chemin). |
| Support | Pour chaque sol, toit, escalier, poutre et mur supérieur : l'élément en dessous dans son empreinte. | Quelque chose ne repose sur rien (plus d'1 cm d'air), une colonne ou un mur au-dessus atterrit sur une portée de sol sans poutre ou mur en dessous, ou un porte-à-faux dépasse environ un tiers de sa portée arrière sans étai ou contreventement visible. |
| Extrémités de murs | Chaque extrémité de chaque mur et cloison. | Une extrémité ne touche rien (et n'est pas une extrémité libre finie), se trouve à l'intérieur d'une porte ou d'une fenêtre, ou s'arrête à moins de la largeur du joueur d'un mur. |
| Ouvertures | Hauteur du sol des deux côtés de chaque porte, un rayon à travers chaque fenêtre. | Une porte s'ouvre sur un mur, un vide, un vide scellé ou une marche plus haute que STEP_HEIGHT ; une fenêtre est bloquée dans le mètre derrière elle par un mur, une dalle de sol, un escalier ou un grand accessoire ; un sol ou un mur intérieur traverse une fenêtre sur la façade. |
| Dégagement | Capsule balayée le long de chaque route, zones de débattement de porte, paliers d'escalier. | La hauteur libre ou la largeur tombe en dessous des paramètres ; un accessoire, une colonne ou une cloison se tient dans le chemin d'une porte, sur un palier ou dans la largeur libre d'un couloir. |
| Bords | Chaque bord praticable et sa chute. | Une chute de plus de GUARD_DROP n'a pas de protection et n'est pas marquée comme délibérée. |
| Chevauchement | Intersections mur-dans-mur, mur-dans-sol et accessoire-dans-mur. | Toute intersection de plus de quelques millimètres qu'un joueur peut voir. |
Passe 3 : revue à hauteur d'œil
Un relecteur frais (personne ou agent critique qui n'a pas vu la construction) la parcourt à hauteur d'œil et examine un plan et une coupe de chaque étage. On leur donne le brief monde, le but du bâtiment (« une maison de ferme pour deux familles », « un bunker de recherche inondé », « un temple effondré », « un pont d'équipage sur un cargo ») et les conditions acceptées (impasses délibérées, portes verrouillées, sections effondrées, espaces de reptation), et ils répondent :
- Chaque mur a-t-il une raison ? Il enferme une pièce, porte quelque chose, protège un bord, masque une vue, ou (dans une ruine) il est ce qu'il en reste. Un mur qui ne fait rien de cela est supprimé.
- Chaque pièce a-t-elle un but et une entrée qui lui convient ? Une salle d'eau depuis un couloir, pas depuis la cuisine à travers une chambre ; un débarras près de ce qu'il stocke ; un poste de garde là où il peut voir ce qu'il garde ; un sas entre pression et
…
[la suite a été tronquée pour la traduction]