docs(map): make omitted move_cost explicitly mean impassable

2026-09-20 18:03:46 +02:00
parent ee22f7548a
commit dd0b42b73b
2 changed files with 10 additions and 2 deletions
@@ -66,7 +66,12 @@ _NoDuplicateLoader.add_constructor(


 class TerrainType(BaseModel):
-    """What one square means for movement and sight lines."""
+    """What one square means for movement and sight lines.
+
+    ``move_cost``: positive int = passable; ``None`` -- explicit or omitted
+    (the field default) -- means IMPASSABLE. A passable terrain must always
+    declare its cost; omitting the field is never a silent walkable default.
+    """

    model_config = ConfigDict(frozen=True, extra="forbid")