Merge phase 23 example pack.

Co-authored-by: Cursor <cursoragent@cursor.com>

src/HSchool.Server/mods/example/README.md

@@ -0,0 +1,36 @@
+# Example pack
+
+A tiny fixture, not content. It sits next to `core` and is **off until the player ticks it**.
+Vanilla play does not change without that tick.
+
+## Layout
+
+```
+example/
+  pack.jsonc                 # version + requires: ["core"]
+  localizations/{ru,en}.jsonc
+  defs/traits/traits.jsonc   # two traits
+  defs/namesets/example.jsonc
+  defs/rooms/store.jsonc     # one placeable room
+  defs/things/chair.jsonc    # last-wins: same defName as core
+  patches/principals-office.jsonc
+  README.md                  # this file
+```
+
+The pack name is the `example` key in the locale files, not a field in `pack.jsonc`.
+
+## How to add something
+
+1. New type: a JSONC file under `defs/<kind>/`. The folder chooses the kind (`traits`, `rooms`, …);
+   the object needs a `defName`.
+2. Label: the same `defName` (or the pack id) in both locale files. Missing keys load, but the UI
+   shows the raw id and the loader warns.
+3. Edit a core type without copying it: a file in `patches/` with `target` and `add` / `replace` /
+   `remove`. Patches run after inheritance, in pack order.
+4. Same `defName` as `core` (or an earlier pack): the later file wins and the log warns. That is
+   what `defs/things/chair.jsonc` is for — a sample of last-wins, not a better chair.
+5. Default map: only `maps/default.jsonc` replaces the layout, last file wins. This pack does not
+   ship one, so a school with the pack still uses core's yard.
+
+There is no `maps/` folder here on purpose. A layout that uses `ExampleStore` is a create-dialog
+map, not a second default school.

src/HSchool.Server/mods/example/defs/namesets/example.jsonc

@@ -0,0 +1,17 @@
+{
+  "defName": "ExampleNames",
+  "patronymicRule": "slavic",
+  "defaultGivenDeclension": "hard",
+  "defaultSurnameDeclension": "ov",
+  "nativeLanguages": ["RussianLanguage"],
+  "relatedLanguageChance": 0,
+  "maleGiven": [
+    { "form": "Иван" },
+  ],
+  "femaleGiven": [
+    { "form": "Анна", "declension": "a" },
+  ],
+  "surnames": [
+    { "male": "Тестов", "female": "Тестова" },
+  ],
+}

src/HSchool.Server/mods/example/defs/rooms/store.jsonc

@@ -0,0 +1,7 @@
+{
+  "defName": "ExampleStore",
+  "slots": [
+    { "key": "lockers", "thing": "Locker", "count": 4 },
+  ],
+  "travelMinutes": 0.5,
+}

src/HSchool.Server/mods/example/defs/things/chair.jsonc

@@ -0,0 +1,2 @@
+// Same defName as core: the last pack wins and the loader warns. Chat is already a core action.
+{ "defName": "Chair", "actions": ["Sit", "Chat"] }

src/HSchool.Server/mods/example/defs/traits/traits.jsonc

@@ -0,0 +1,14 @@
+[
+  {
+    "defName": "ExampleEarlyRiser",
+    "weight": 1,
+    "incompatible": ["ExampleNightOwl"],
+    "commuteMinutes": 2,
+  },
+  {
+    "defName": "ExampleNightOwl",
+    "weight": 1,
+    "incompatible": ["ExampleEarlyRiser"],
+    "commuteMinutes": -2,
+  },
+]

src/HSchool.Server/mods/example/localizations/en.jsonc

@@ -0,0 +1,7 @@
+{
+  "example": "Example pack",
+  "ExampleEarlyRiser": "Early riser",
+  "ExampleNightOwl": "Night owl",
+  "ExampleNames": "Example names",
+  "ExampleStore": "Storeroom",
+}

src/HSchool.Server/mods/example/localizations/ru.jsonc

@@ -0,0 +1,7 @@
+{
+  "example": "Пример мода",
+  "ExampleEarlyRiser": "Ранняя пташка",
+  "ExampleNightOwl": "Сова",
+  "ExampleNames": "Примерные имена",
+  "ExampleStore": "Кладовая",
+}

src/HSchool.Server/mods/example/pack.jsonc

@@ -0,0 +1,4 @@
+{
+  "version": "1.0",
+  "requires": ["core"],
+}

src/HSchool.Server/mods/example/patches/principals-office.jsonc

@@ -0,0 +1,6 @@
+{
+  "target": "PrincipalsOffice",
+  "ops": [
+    { "op": "add", "path": "/slots/-", "value": { "key": "exampleLocker", "thing": "Locker" } },
+  ],
+}