Item/location description in the client

schemas/Manual.items.schema.json

@@ -116,6 +116,10 @@
                     "description": "(Optional) A string to sort the items by. If not provided, items will always be sorted by name.",
                     "type": "string"
                 },
+                "description": {
+                    "description": "(Optional) A short description of the item to be displayed in the client",
+                    "type": "string"
+                },
                 "_comment": {"$ref": "#/definitions/comment"}
             },
             "required": ["name"]

schemas/Manual.locations.schema.json

@@ -104,6 +104,10 @@
                     "description": "(Optional) A string to sort the locations by. If not provided, locations will always be sorted by name.",
                     "type": "string"
                 },
+                "description": {
+                    "description": "(Optional) A short description of the location to be displayed in the client in the Manual and Tracker tabs",
+                    "type": "string"
+                },
                 "_comment": {"$ref": "#/definitions/comment"}
             },
             "required": ["name"]

src/Items.py

@@ -9,6 +9,7 @@
 
 item_id_to_name: dict[int, str] = {}
 item_name_to_item: dict[str, dict] = {}
+item_name_to_description: dict[str, str] = {}
 item_name_groups: dict[str, str] = {}
 advancement_item_names: set[str] = set()
 lastItemId = -1
@@ -38,7 +39,7 @@
     count += 1
 
 for item in item_table:
-    item_name = item.get("name", f"Unnamed Item {item['id']}")
+    item_name: str = item.get("name", f"Unnamed Item {item['id']}")
     item_id_to_name[item["id"]] = item_name
     item_name_to_item[item_name] = item
 
@@ -60,6 +61,9 @@
             item_name_groups[group_name] = []
         item_name_groups[group_name].append(item_name)
 
+    if item.get("description"):
+        item_name_to_description[item_name] = item["description"]
+
 item_id_to_name[None] = "__Victory__"
 item_name_to_id = {name: id for id, name in item_id_to_name.items()}
 

src/Locations.py

@@ -46,11 +46,12 @@
 
 location_id_to_name: dict[int, str] = {}
 location_name_to_location: dict[str, dict[str, Any]] = {}
+location_name_to_description: dict[str, str] = {}
 location_name_groups: dict[str, list[str]] = {}
 event_name_to_event: dict[str, dict[str, Any]] = {}
 
 for loc in location_table:
-    loc_name = loc.get("name", f"Unnamed Location {loc['id']}")
+    loc_name: str = loc.get("name", f"Unnamed Location {loc['id']}")
     location_id_to_name[loc["id"]] = loc_name
     location_name_to_location[loc_name] = loc
 
@@ -59,6 +60,8 @@
             location_name_groups[c] = []
         location_name_groups[c].append(loc_name)
 
+    if loc.get("description"):
+        location_name_to_description[loc_name] = loc["description"]
 
 # location_id_to_name[None] = "__Manual Game Complete__"
 location_name_to_id = {name: id for id, name in location_id_to_name.items()}

src/Meta.py

@@ -28,8 +28,14 @@ def set_world_description(base_doc: str) -> str:
     return base_doc
 
 
-def set_world_webworld(web: WebWorld) -> WebWorld:
+def set_world_webworld(web: ManualWeb) -> ManualWeb:
     from .Options import make_options_group
+    from .Locations import  location_name_to_description
+    from .Items import  item_name_to_description
+
+    web.location_descriptions = location_name_to_description
+    web.item_descriptions = item_name_to_description
+
     if meta_table.get("docs", {}).get("web", {}):
         Web_Config = meta_table["docs"]["web"]
 

src/__init__.py

@@ -10,7 +10,7 @@
 from .Data import item_table, location_table, event_table, region_table, category_table
 from .Game import game_name, filler_item_name, starting_items
 from .Meta import world_description, world_webworld
-from .Locations import location_id_to_name, location_name_to_id, location_name_to_location, location_name_groups, victory_names, event_name_to_event
+from .Locations import location_id_to_name, location_name_to_id, location_name_to_location, location_name_groups, victory_names, event_name_to_event, location_name_to_description
 from .Items import item_id_to_name, item_name_to_id, item_name_to_item, item_name_groups
 from .DataValidation import runGenerationDataValidation, runPreFillDataValidation
 
@@ -71,6 +71,7 @@ class ManualWorld(World):
 
     # UT (the universal-est of trackers) can now generate without a YAML
     ut_can_gen_without_yaml = True
+    location_id_to_alias: dict[int, str] = {location_name_to_id[name]: desc for name, desc in location_name_to_description.items()}
 
     origin_region_name = "Manual"
 
@@ -417,6 +418,7 @@ def fill_slot_data(self):
 
         # slot_data["DeathLink"] = bool(self.multiworld.death_link[self.player].value)
         common_options = set(PerGameCommonOptions.type_hints.keys())
+        common_options |= set(["generate_region_diagram", "start_inventory_from_pool"])
         for option_key, _ in self.options_dataclass.type_hints.items():
             if option_key in common_options:
                 continue
@@ -570,7 +572,7 @@ def __init__(self, display_name: str, script_name: Optional[str] = None, func: O
         self.version = version
 
 def add_client_to_launcher() -> None:
-    version = 2026_04_04 # YYYYMMDD
+    version = 2026_04_07 # YYYYMMDD
     found = False
 
     if "manual" not in icon_paths: