Dire ce que le tag apporte, place assise et interactions

Une chaise importee sur laquelle personne ne s'assoit ne manque pas d'une
place assise : elle est rangee sous le mauvais tag.

Sur les 2434 prefabs du jeu, 58 seulement nomment un NestedPrefabToSpawn, et
aucun canape, tabouret ou banc n'en nomme. Ce qui rend un objet utilisable,
c'est son tag de catalogue, par deux champs distincts de l'entree de tag dans
BuildModeCatalogTags.setting :

  NestedPrefabToSpawn   le gabarit de slot, sur 13 tags. Il contient le Seat,
                        le ButtLocator et les locators de pieds, donc rien de
                        l'animation n'est a ecrire.
  InteractionGroup      ce qu'un Para peut faire avec, sur 47 tags.

Les tags heritent, et c'est pour ca qu'Armchairs assoit un Para via Seating
sans rien declarer lui-meme.

Le selecteur dit desormais ce que le tag choisi apporte, juste sous le choix,
et la checklist le repete. C'est une information et jamais une faute : la
plupart des objets sont des decorations, et c'est voulu.

Ce que ca ne couvre pas, et il faut le dire : la nourriture n'est pas un objet
qu'on pose. FoodBreadRound porte Tag: s0, aucun tag, et le tag Food ne porte
rien. Un mesh de nourriture exporte ne devient donc pas mangeable. Les lits
sont l'autre trou : ils accrochent leurs places a un enfant porteur d'un
ItemNestedPrefabSpawner plutot qu'au tag.

Tests : 313 headless, 264 UI, traductions completes.

Author: infinition

CHANGELOG.md

@@ -9,7 +9,7 @@ Every entry below was driven by something measured in the game's own data
 rather than assumed. Paralives is in early access, so the game build a finding
 was measured on is recorded with it.
 
-## [0.23.0]
+## [0.24.0]
 
 ### Added
 
@@ -38,9 +38,20 @@ was measured on is recorded with it.
   holds a Seat, a ButtLocator, a FeetFront and a FeetEnter, so nothing about
   the animation has to be authored.
 
-  The picker now says which template the chosen tag brings, right under the
-  choice, and the checklist repeats it. It is information rather than a fault,
-  since most items are decoration and are meant to be.
+  Interactions are the tag's other field, `InteractionGroup`, on 47 tags: what
+  a Para may do with a computer, a fridge, a range, a sink. Tags inherit, which
+  is why `Armchairs` seats a Para through `Seating` without declaring anything
+  itself.
+
+  The picker now says what the chosen tag brings, right under the choice, and
+  the checklist repeats it. It is information rather than a fault, since most
+  items are decoration and are meant to be.
+
+  What this does not cover: food is not a placeable item. `FoodBreadRound`
+  carries `Tag: s0`, no tag at all, and the `Food` tag carries nothing, so a
+  food mesh cannot be made edible by exporting it. Beds are the other gap: they
+  hang their slots off a child object carrying an `ItemNestedPrefabSpawner`
+  rather than off the tag.
 
 ## [0.22.0]
 

paraforge/blender_manifest.toml

@@ -1,7 +1,7 @@
 schema_version = "1.0.0"
 
 id = "paraforge"
-version = "0.23.0"
+version = "0.24.0"
 name = "ParaForge"
 tagline = "Convert and export Paralives Build Mode assets in one click"
 maintainer = "infinition"

paraforge/catalog.py

@@ -1821,3 +1821,85 @@ def tags_with_slots():
         entry = BY_GUID.get(guid)
         out.append((guid, entry[0] if entry else guid, template))
     return sorted(out, key=lambda row: row[1])
+
+# What a Para can do with an item is decided by its catalogue tag too, through
+# a second field: InteractionGroup. 47 tags carry one, against 13 that carry a
+# slot template, and the two are separate. Chairs carries both. Armchairs
+# carries only the template and still seats a Para, because a tag inherits from
+# its parents and Seating carries the interactions.
+#
+# Read out of Main.mod/Settings/BuildModeCatalogTags.setting.
+
+INTERACTION_TAGS = {
+    "604085153922562519": "Baths",
+    "4628778472043362227": "Bedding",
+    "6444879227766942280": "Bookshelves",
+    "3400317259593598351": "CeilingFans",
+    "9105849566942677340": "Chairs",
+    "1616462328011360211": "Closets",
+    "7985540924855390150": "Computers",
+    "7447449227539394204": "Couches",
+    "8461709061774362586": "CountersAndCabinets",
+    "4647535654631335830": "Doors",
+    "5234230757320379395": "Dressers",
+    "4924269558178068359": "Fireplaces",
+    "460710503665464322": "FloorLamps",
+    "3591542995555286041": "Flowers",
+    "642202484693579278": "Frames",
+    "3108863021855919330": "Fridges",
+    "2779062035506052039": "Lighting",
+    "3090969998361602773": "Mailboxes",
+    "5676720021332220820": "Microwaves",
+    "3265636272264671824": "Mirrors",
+    "4076339812397061500": "Ranges",
+    "8535178522425522383": "Rugs",
+    "1577919339783889004": "Seating",
+    "2067641458504236188": "Showers",
+    "108320156183816049": "Sinks",
+    "6014339009269246888": "TVs",
+    "8901024204529792639": "TableLamps",
+    "3379229577763952217": "Toilets",
+    "8001521036836752277": "Trash",
+    "8372779771154572480": "Trash",
+    "3701994551219430330": "Trees",
+    "8634782218500074114": "_BedAdultModel",
+    "4575609469802988211": "_BedCrib",
+    "5855831541297902823": "_BuildableSandCastle",
+    "4369724328259993374": "_CityJournalDispenser",
+    "8243536152945723335": "_CityTrafficCone",
+    "758181910550224109": "_DrawablePaper",
+    "5564997046115680029": "_EducativeBook",
+    "4530928373772042014": "_EducativeToy",
+    "5615717779103809048": "_FlowerBushsAndPlanters",
+    "2285893339648069873": "_Guitar",
+    "9009564337597788863": "_HighChair",
+    "2616680388127829501": "_PlayableHopscotch",
+    "6333900641183854484": "_PlayablePlush",
+    "4741678931641170149": "_SittableBench",
+    "523991108259902175": "_ToddlersToy",
+    "6713782805470202312": "_Well",
+}
+
+
+def _up(guid, table):
+    """Walk a tag and its ancestors, returning the first hit in table."""
+    seen = set()
+    current = guid
+    while current and current not in seen:
+        seen.add(current)
+        if current in table:
+            return table[current]
+        entry = BY_GUID.get(current)
+        if entry is None:
+            return ""
+        current = entry[1]
+    return ""
+
+
+def interaction_source(guid):
+    """The tag that brings the interactions, which may be an ancestor."""
+    return _up(guid, INTERACTION_TAGS)
+
+
+def has_interactions(guid):
+    return bool(interaction_source(guid))

paraforge/i18n.py

@@ -430,15 +430,18 @@ def pick(french, english):
     "Used by a Para": "Utilisé par un Para",
     "A tag typed by hand, so this cannot be checked":
         "Un tag saisi à la main, donc invérifiable ici",
-    "The tag attaches {0}, so a Para can use it":
-        "Le tag attache {0}, un Para peut donc s'en servir",
-    "The tag attaches {0}, which is a sound rather than a place to sit":
-        "Le tag attache {0}, qui est un son et non une place assise",
-    "Decoration: this tag attaches nothing, so a Para will walk past it. "
-    "Seating lives under Chairs, Armchairs, OfficeChairs, Couches or Benches":
-        "Décoration : ce tag n'attache rien, un Para passera donc à côté. "
-        "Les assises sont sous Chairs, Armchairs, OfficeChairs, Couches ou "
-        "Benches",
+    "This tag brings ": "Ce tag apporte ",
+    "a place to sit, from {0}": "une place assise, depuis {0}",
+    "{0}, which is a sound rather than a place":
+        "{0}, qui est un son et non une place",
+    "interactions, from the {0} tag": "des interactions, depuis le tag {0}",
+    "Decoration: this tag brings neither a place to sit nor an interaction, "
+    "so a Para will walk past it. Seating lives under Chairs, Armchairs, "
+    "OfficeChairs, Couches or Benches":
+        "Décoration : ce tag n'apporte ni place assise ni interaction, un Para "
+        "passera donc à côté. Les assises sont sous Chairs, Armchairs, "
+        "OfficeChairs, Couches ou Benches",
+    "Interactions from ": "Interactions depuis ",
     "A Para can use it: ": "Un Para peut s'en servir : ",
     "Attaches ": "Attache ",
     "Decoration, no Para uses it": "Décoration, aucun Para ne s'en sert",

paraforge/ui.py

@@ -112,11 +112,14 @@ def _draw_target(self, context, layout, settings):
             # template the game attaches, so a chair filed under the wrong one
             # is furniture nobody sits on.
             template = catalog.slot_template(settings.catalog_tag)
+            source = catalog.interaction_source(settings.catalog_tag)
             hint = column.row()
             hint.scale_y = 0.7
             if catalog.seats_a_para(settings.catalog_tag):
                 hint.label(text=_("A Para can use it: ") + template,
                            icon="OUTLINER_OB_ARMATURE")
+            elif source:
+                hint.label(text=_("Interactions from ") + source, icon="PLAY")
             elif template:
                 hint.label(text=_("Attaches ") + template, icon="SOUND")
             else:

paraforge/validate.py

@@ -231,16 +231,23 @@ def _check_facing(settings, report):
 def _check_usable(settings, report):
     """Whether a Para will ever do anything with the item.
 
-    A chair carries no seat of its own. Nothing in its prefab says where to
-    sit, and the 29 shipped chairs that do carry a NestedPrefabToSpawn are the
-    exception. What makes an item usable is its catalogue tag: the tag entry in
-    BuildModeCatalogTags.setting carries the template, and the game attaches it
-    to everything filed under that tag.
-
-    So an imported chair filed under the wrong tag is furniture nobody sits on,
-    and the Para walks to another chair instead. That is not something the
-    export can fix, only the tag can, which is why this reads as information
-    next to the choice rather than as a fault.
+    A chair carries no seat of its own. Of the game's 2434 prefabs only 58 name
+    a NestedPrefabToSpawn, and no couch, stool or bench names one. What makes
+    an item usable is its catalogue tag, through two separate fields on the tag
+    entry in BuildModeCatalogTags.setting:
+
+        NestedPrefabToSpawn   the slot template, on 13 tags. It holds the Seat,
+                              the ButtLocator and the foot locators, so nothing
+                              about the animation has to be authored.
+        InteractionGroup      what a Para may do with it, on 47 tags.
+
+    Tags inherit, so Armchairs seats a Para through Seating without declaring
+    anything itself.
+
+    An imported chair filed under the wrong tag is furniture nobody sits on,
+    and the Para walks to another chair instead. The export cannot fix that,
+    only the tag can, which is why this reads as information next to the choice
+    rather than as a fault: most items are decoration and are meant to be.
     """
     tag = settings.catalog_tag
     if tag == spec.CUSTOM_TAG:
@@ -249,20 +256,26 @@ def _check_usable(settings, report):
         return
 
     template = catalog.slot_template(tag)
+    source = catalog.interaction_source(tag)
+    parts = []
+
     if catalog.seats_a_para(tag):
+        parts.append(_("a place to sit, from {0}", template))
+    elif template:
+        parts.append(_("{0}, which is a sound rather than a place", template))
+
+    if source:
+        parts.append(_("interactions, from the {0} tag", source))
+
+    if parts:
         report.add("usable", _("Used by a Para"), OK,
-                   _("The tag attaches {0}, so a Para can use it", template))
-        return
-    if template:
-        report.add("usable", _("Used by a Para"), OK,
-                   _("The tag attaches {0}, which is a sound rather than a "
-                     "place to sit", template))
+                   _("This tag brings ") + ", ".join(parts))
         return
 
     report.add("usable", _("Used by a Para"), OK,
-               _("Decoration: this tag attaches nothing, so a Para will walk "
-                 "past it. Seating lives under Chairs, Armchairs, "
-                 "OfficeChairs, Couches or Benches"))
+               _("Decoration: this tag brings neither a place to sit nor an "
+                 "interaction, so a Para will walk past it. Seating lives "
+                 "under Chairs, Armchairs, OfficeChairs, Couches or Benches"))
 
 
 def _check_asset_name(objects, settings, report):

tests/test_headless.py

@@ -1426,6 +1426,20 @@ def test_usable_by_a_para():
           "13 tags attach something, out of the game's 298",
           str(len(cat.tags_with_slots())))
 
+    # Interactions are the tag's other field, and tags inherit, which is why
+    # an armchair seats a Para without declaring anything itself.
+    check(cat.interaction_source(cat.BY_NAME["Chairs"]) == "Chairs",
+          "a tag can carry its own interactions")
+    check(cat.interaction_source(cat.BY_NAME["Armchairs"]) == "Seating",
+          "or inherit them from a parent tag",
+          cat.interaction_source(cat.BY_NAME["Armchairs"]))
+    check(cat.has_interactions(cat.BY_NAME["Computers"]),
+          "a computer has interactions and no seat")
+    check(not cat.has_interactions(cat.BY_NAME["Build"]),
+          "and the root Build tag has neither")
+    check(not cat.has_interactions(cat.BY_NAME["Food"]),
+          "nor does Food, which is not a placeable item at all")
+
     fresh_scene()
     make_cube()
     settings = props.settings(bpy.context)