modwright 0.1.1 → 0.1.3

package/knowledge/cyberpunk2077/rtti.game-systems.yaml

@@ -0,0 +1,224 @@
+game: cyberpunk2077
+topic: rtti.game-systems
+title: RTTI-confirmed game systems and entity/targeting classes ModWright's CET bridge probes touch
+facts:
+  - id: cp2077.rtti.scriptgameinstance-getxxx-system-getters
+    claim: "ScriptGameInstance (the class behind CET's `Game` table, per probes.lua's GLOBAL_GETTERS and
+      its Game.GetPlayer()/GetDynamicEntitySystem()/GetTransactionSystem() call sites) has 93
+      RTTI-listed functions named GetXxx that return a ref<System> handle. Every game subsystem a
+      script can reach starts from one of these. Full list, `GetXxx -> ReturnClass`:
+      GetAINavigationSystem->AINavigationSystem, GetAchievementSystem->gameAchievementSystem,
+      GetActivityLogSystem->gameActivityLogSystem,
+      GetAnimationSystem->worldAnimationSystemScriptInterface,
+      GetAttitudeSystem->gameCAttitudeManager, GetAudioSystem->gameGameAudioSystem,
+      GetAutoSaveSystem->gameAutoSaveSystem, GetBlackboardSystem->gameBlackboardSystem,
+      GetCameraSystem->gameCameraSystem,
+      GetCharacterCustomizationSystem->gameuiICharacterCustomizationSystem,
+      GetCombatQueriesSystem->gameICombatQueriesSystem, GetCommunitySystem->gameCommunitySystem,
+      GetCompanionSystem->gameCompanionSystem, GetContainerManager->gameContainerManager,
+      GetCooldownSystem->gameICooldownSystem, GetCoverManager->AISmartCoverManager,
+      GetDamageSystem->gameDamageSystem, GetDebugCheatsSystem->gameDebugCheatsSystem,
+      GetDebugDrawHistorySystem->gameIDebugDrawHistorySystem,
+      GetDebugPlayerBreadcrumbs->gameDebugPlayerBreadcrumbs,
+      GetDebugVisualizerSystem->gameDebugVisualizerSystem, GetDelaySystem->gameDelaySystem,
+      GetDeviceSystem->gameDeviceSystem, GetDynamicSpawnSystem->gameDynamicSpawnSystem,
+      GetEffectorSystem->gameEffectorSystem,
+      GetEntitySpawnerEventsBroadcaster->gameEntitySpawnerEventsBroadcasterImpl,
+      GetFxSystem->gameFxSystem, GetGameEffectSystem->gameEffectSystem,
+      GetGameFeatureManager->gameGameFeatureManager, GetGameRulesSystem->gameIGameRulesSystem,
+      GetGameTagSystem->gameGameTagSystem, GetGamepadLightController->gameuiGamepadLightController,
+      GetGameplayLogicPackageSystem->gameGameplayLogicPackageSystem,
+      GetGlobalTVSystem->gameuiGlobalTvSystem, GetGodModeSystem->gameGodModeSystem,
+      GetInfluenceMapSystem->gameinfluenceSystem, GetInteractionManager->gameinteractionsCManager,
+      GetInventoryManager->gameInventoryManager, GetJournalManager->gameJournalManager,
+      GetLevelAssignmentSystem->gameLevelAssignmentSystem, GetLocationManager->gameLocationManager,
+      GetLootManager->gameLootManager, GetMappinSystem->gamemappinsMappinSystem,
+      GetMinimapSystem->gameMinimapSystem, GetMountingFacility->gamemountingIMountingFacility,
+      GetNavigationSystem->worldNavigationScriptInterface,
+      GetObjectPoolSystem->gameObjectPoolSystem, GetOnlineSystem->gameIOnlineSystem,
+      GetPersistencySystem->gamePersistencySystem, GetPhoneManager->questPhoneManager,
+      GetPhotoModeSystem->gamePhotoModeSystem, GetPingSystem->gamePingSystem,
+      GetPlayerManagerSystem->gameIPlayerManager, GetPlayerSystem->cpPlayerSystem,
+      GetPoliceRadioSystem->gamePoliceRadioSystem, GetPrereqManager->gamePrereqManager,
+      GetPreventionSpawnSystem->gamePreventionSpawnSystem,
+      GetProjectileSystem->gameProjectileSystem, GetQuestsContentSystem->questQuestsContentSystem,
+      GetQuestsSystem->questQuestsSystem, GetRacingSystem->vehicleRacingSystem,
+      GetRazerChromaEffectsSystem->gameRazerChromaEffectsSystem,
+      GetReactionSystem->AIReactionSystem, GetRestrictMovementAreaManager->AIGuardAreaManager,
+      GetRuntimeInfo->worldRuntimeInfo, GetSafeAreaManager->AISafeAreaManager,
+      GetSceneSystem->scnISceneSystem,
+      GetScriptableSystemsContainer->gameScriptableSystemsContainer,
+      GetScriptsDebugOverlaySystem->gameScriptsDebugOverlaySystem,
+      GetSenseManager->senseCSenseManager, GetSettingsSystem->userSettingsUserSettings,
+      GetSpatialQueriesSystem->gameSpatialQueriesSystem, GetStatPoolsSystem->gameStatPoolsSystem,
+      GetStatsDataSystem->gameStatsDataSystem, GetStatsSystem->gameStatsSystem,
+      GetStatusEffectSystem->gameStatusEffectSystem, GetStimuliSystem->gameStimuliSystem,
+      GetSubtitleHandlerSystem->gameuiSubtitleHandlerSystem,
+      GetTargetingSystem->gametargetingTargetingSystem,
+      GetTelemetrySystem->gameTelemetryTelemetrySystem,
+      GetTeleportationFacility->gameTeleportationFacility, GetTimeSystem->gameTimeSystem,
+      GetTrafficSystem->worldTrafficScriptInterface, GetTransactionSystem->gameTransactionSystem,
+      GetTutorialManager->questTutorialManager,
+      GetUIObjectsLoaderSystem->gameuiIUIObjectsLoaderSystem, GetUISystem->gameuiGameSystemUI,
+      GetVehicleSystem->gameVehicleSystem, GetVisionModeSystem->gameVisionModeSystem,
+      GetWardrobeSystem->gameWardrobeSystem, GetWatchdogSystem->gameIWatchdogSystem,
+      GetWeatherSystem->worldWeatherScriptInterface, GetWorkspotSystem->gameWorkspotGameSystem. All
+      93 take no parameters besides the implicit `self` and return by value a `ref<System>` per the
+      type tag {\"a\": 26, \"c\": {\"b\": System}}."
+    status: inferred
+    source: 'rayshader/cp2077-nativedb classes.json, class entry {"b": "ScriptGameInstance"} (parent
+      null — it is the script-facing root), 107 functions total; the 93 above are every one whose
+      name starts with "Get" and whose "c" (return type) tag is {"a": 26, ...} (ref<T>). Read
+      2026-09-11 with python3 against the committed dump.'
+    tags:
+      - rtti
+      - scriptgameinstance
+      - game-table
+      - system-getter
+      - bridge
+    detail: "The bridge's working assumption (nowhere written down before this fact) is that CET's
+      `Game` global IS a ScriptGameInstance handle and `Game.GetXxx()` in Lua is a 1:1 call onto
+      this list — that is how probes.lua's existing calls (Game.GetPlayer(),
+      Game.GetDynamicEntitySystem(), Game.GetTransactionSystem()) already behave, and
+      GetGameTagSystem/GetTargetingSystem in this same list are exactly the systems fact 4 and the
+      entities.queries.yaml facts already use through that same `Game.` spelling. Checked
+      knowledge/cyberpunk2077/cet.sandbox.yaml for a fact about the `Game` global specifically: it
+      has none — it documents the mod sandbox's globals-whitelist mechanism in general
+      (cp2077.cet.mod-sandbox-has-no-global-table: `_G` absent, lookup must be by name) but never
+      states what `Game` itself resolves to. So this mapping rests on probes.lua's own
+      GLOBAL_GETTERS table and its three cited call sites, not on a dump entry naming \"Game\" —
+      RTTI reflects native classes only, and `Game` is CET's own scripting binding on top of
+      ScriptGameInstance, so no dump entry could name it directly. Note GetPlayerSystem returns
+      cpPlayerSystem, not a class named after the pattern used elsewhere in this list, and
+      GetTargetingSystem returns gametargetingTargetingSystem, not gameITargetingSystem — see fact
+      4."
+  - id: cp2077.rtti.playerpuppet-npcpuppet-gameobject-identity-parent-chain
+    claim: Both PlayerPuppet and NPCPuppet share the identical parent chain ScriptedPuppet -> gamePuppet
+      -> gamePuppetBase -> gameTimeDilatable -> gameObject -> entGameEntity -> entEntity ->
+      IScriptable -> ISerializable; they differ only in their own class, not in any ancestor.
+      entEntity's own chain is entEntity -> IScriptable -> ISerializable, and gameObject's is
+      gameObject -> entGameEntity -> entEntity -> IScriptable -> ISerializable. A probe written
+      against gameObject or entEntity methods therefore works unchanged on either puppet type.
+    status: inferred
+    source: "rayshader/cp2077-nativedb classes.json, walking each class entry's \"a\" (parent) field:
+      {\"b\": \"PlayerPuppet\", \"a\": \"ScriptedPuppet\"}, {\"b\": \"NPCPuppet\", \"a\":
+      \"ScriptedPuppet\"}, {\"b\": \"ScriptedPuppet\", \"a\": \"gamePuppet\"}, {\"b\":
+      \"gamePuppet\", \"a\": \"gamePuppetBase\"}, {\"b\": \"gamePuppetBase\", \"a\":
+      \"gameTimeDilatable\"}, {\"b\": \"gameTimeDilatable\", \"a\": \"gameObject\"}, {\"b\":
+      \"gameObject\", \"a\": \"entGameEntity\"}, {\"b\": \"entGameEntity\", \"a\": \"entEntity\"},
+      {\"b\": \"entEntity\", \"a\": \"IScriptable\"}, {\"b\": \"IScriptable\", \"a\":
+      \"ISerializable\"}, {\"b\": \"ISerializable\", \"a\": null}. Read 2026-09-11."
+    tags:
+      - rtti
+      - parent-chain
+      - playerpuppet
+      - npcpuppet
+      - gameobject
+      - ententity
+  - id: cp2077.rtti.ententity-gameobject-position-tag-identity-methods
+    claim: 'entEntity (RTTI functions, "self" param omitted): FindComponentByName(componentName: CName)
+      -> ref<entIComponent>, GetEntityID() -> entEntityID, GetWorldOrientation() -> Quaternion,
+      GetWorldPosition() -> Vector4. gameObject adds HasTag(tag: CName) -> Bool, IsPlayer() -> Bool,
+      IsNPC() -> Bool, IsPlayerControlled() -> Bool. GetClassName() -> CName is not redeclared on
+      either — it, IsA(className: CName) -> Bool and IsExactlyA(className: CName) -> Bool live
+      higher up, on IScriptable, and are inherited down the chain in the previous fact.'
+    status: inferred
+    source: "rayshader/cp2077-nativedb classes.json: class entEntity function entries
+      FindComponentByName, GetEntityID, GetWorldOrientation, GetWorldPosition; class gameObject (363
+      functions total) entries HasTag, IsPlayer, IsNPC, IsPlayerControlled; class IScriptable (5
+      functions) entries GetClassName, IsA, IsExactlyA, ToString, DetectScriptableCycles. Read
+      2026-09-11."
+    tags:
+      - rtti
+      - ententity
+      - gameobject
+      - position
+      - tag
+      - identity
+      - findcomponent
+    detail: GetWorldPosition/GetWorldOrientation and FindComponentByName are already relied on by the
+      CET bridge's `xyz`/`quat`/`componentPresent` helpers (attested there against a shipped CET
+      mod's own calls), so this fact is the RTTI confirmation of calls the bridge already makes
+      rather than a new one to try. HasTag/IsPlayer/IsNPC are not yet called anywhere in probes.lua.
+  - id: cp2077.rtti.targetingsystem-crosshair-and-distance-queries
+    claim: "gameITargetingSystem is an empty interface (0 functions); the concrete class is
+      gametargetingTargetingSystem (41 functions), which is what ScriptGameInstance's
+      GetTargetingSystem() actually returns — not gameITargetingSystem, correcting the class name
+      entities.queries.yaml's cp2077.entities.spatial-and-targeting-systems-exist-but-are- heavier
+      used loosely. The \"what is near the crosshair\" functions, full signatures (\"self\"
+      omitted): GetObjectClosestToCrosshair(instigator: wref<gameObject>, angleDistance:
+      EulerAngles, query: gameTargetSearchQuery) -> ref<gameObject>; GetTargetClosestByDistance(
+      instigator: wref<gameObject>, query: gameTargetSearchQuery, position: Vector4, targetPartInfo:
+      gametargetingTargetPartInfo) -> ref<gameObject>; GetTargetParts(instigator: wref<gameObject>,
+      query: gameTargetSearchQuery, parts: array<gametargetingTargetPartInfo>) -> Bool; also
+      GetLookAtObject(instigator: wref<gameObject>, withLOS: Bool, ignoreTranparent: Bool) ->
+      ref<gameObject> and GetTrackedTargetObject(instigator: wref<gameObject>) -> ref<gameObject> as
+      lighter alternatives that take no query struct at all."
+    status: inferred
+    source: 'rayshader/cp2077-nativedb classes.json: class gameITargetingSystem {"a": "gameIGameSystem",
+      "f": []}; class gametargetingTargetingSystem {"a": "gameITargetingSystem", ...} with the 41
+      functions enumerated above by name; ScriptGameInstance function entry {"a":
+      "GetTargetingSystem", "c": {"a": 26, "c": {"b": "gametargetingTargetingSystem"}}}. Read
+      2026-09-11.'
+    tags:
+      - rtti
+      - targetingsystem
+      - crosshair
+      - spatial-query
+      - gametargetsearchquery
+    related:
+      - cp2077.entities.spatial-and-targeting-systems-exist-but-are-heavier
+      - cp2077.entities.gameobject-getentitiesaroundobject-filter-constructors-exist
+    detail: "gameTargetSearchQuery's fields, checked directly against the dump: testedSet
+      (gameTargetingSet), searchFilter (gameTargetSearchFilter), includeSecondaryTargets (Bool),
+      ignoreInstigator (Bool), maxDistance (Float), filterObjectByDistance (Bool), queryTarget
+      (entEntityID), plus method SetComponentFilter(componentFilter:
+      gametargetingSystemScriptFilter) -> void. This matches entities.queries.yaml's
+      cp2077.entities.gameobject-getentitiesaroundobject-filter-constructors-exist field-for- field
+      — nothing to add there; see that fact for the TSF_* constructors that build searchFilter. None
+      of the four crosshair/distance/parts/lookAt calls above are attempted by probes.lua yet, and
+      none is attested from a CET mod or wiki page on disk — same unverified status as the rest of
+      the targeting surface."
+  - id: cp2077.rtti.gametagsystem-two-functions-already-documented
+    claim: gameGameTagSystem's two RTTI functions (GetAnyMatchingEntity, GetAllMatchingEntities) and
+      gameObject's native `tags`/HasTag are already fully recorded in
+      knowledge/cyberpunk2077/entities.queries.yaml's cp2077.entities.native-gametagsystem-
+      finds-entities-by-tag fact; this fact exists only so a reader of rtti.game-systems does not
+      miss that the tag system was already covered from the same dump.
+    status: inferred
+    source: knowledge/cyberpunk2077/entities.queries.yaml, fact
+      cp2077.entities.native-gametagsystem-finds-entities-by-tag (cites rayshader/cp2077-nativedb
+      classes.json class gameGameTagSystem directly).
+    tags:
+      - rtti
+      - gametagsystem
+      - hastag
+      - cross-reference
+    related:
+      - cp2077.entities.native-gametagsystem-finds-entities-by-tag
+  - id: cp2077.rtti.no-generic-component-enumeration-by-class-in-dump
+    claim: "No RTTI-listed function enumerates an entity's components by class or type. Searching every
+      function on entEntity, gameObject and entIComponent for \"Component\" in the name turns up
+      only lookup-by-name (FindComponentByName(componentName: CName) -> ref<entIComponent>, declared
+      identically on both entEntity and entIComponent) and a handful of gameObject methods that each
+      return one specific, hardcoded component type by its own dedicated getter —
+      GetUISlotComponent, GetSensesComponent, GetSourceShootComponent, GetSquadMemberComponent,
+      GetStatusEffectComponent, GetStimBroadcasterComponent, GetTargetShootComponent,
+      GetTargetTrackerComponent — plus OnRequestComponents, which is an event callback, not a query.
+      A probe wanting \"every component of class X on this entity\" has no RTTI call to reach for;
+      it would need to know the component's name up front for FindComponentByName, or be one of the
+      eight named kinds above."
+    status: inferred
+    source: 'rayshader/cp2077-nativedb classes.json: class entEntity functions filtered for substring
+      "Component" -> ["FindComponentByName"]; class gameObject (363 functions) filtered the same way
+      -> ["GetUISlotComponent", "OnRequestComponents", "GetSensesComponent",
+      "GetSourceShootComponent", "GetSquadMemberComponent", "GetStatusEffectComponent",
+      "GetStimBroadcasterComponent", "GetTargetShootComponent", "GetTargetTrackerComponent"]; class
+      entIComponent -> ["FindComponentByName"]. Read 2026-09-11 with the exact same query pattern
+      used for fact 3.'
+    tags:
+      - rtti
+      - component
+      - gotcha
+      - findcomponentbyname
+      - unattested

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modwright",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "A game-agnostic MCP server for game modding, with per-game surfaces.",
   "type": "module",
   "main": "dist/index.js",

package/scaffolds/baldursgate3/new-project.yaml

@@ -19,10 +19,13 @@ inputs:
     name: version
     prompt: Initial version (semver-ish, major.minor.revision).
     default: "0.1.0"
+    # Interpolated raw into modwright.json; the same guard the Stardew scaffold carries.
+    pattern: "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)(?:\\.(?:0|[1-9][0-9]*))?(?:-(?:[a-zA-Z0-9]+[-.]?)+)?$"
   - type: string
     name: author
-    prompt: Author name.
+    prompt: Author name (no double quotes or backslashes — it is written into modwright.json as-is).
     default: "Unknown"
+    pattern: '^[^"\\\x00-\x1f]+$'
   # A project can keep its
   # LSLib divine path as a toolchain override in modwright.json; a fresh
   # project on the same machine needs the same line or its first build

package/scaffolds/cyberpunk2077/new-project.yaml

@@ -29,10 +29,13 @@ inputs:
     name: version
     prompt: Initial version (semver-ish, major.minor.revision).
     default: "0.1.0"
+    # Interpolated raw into modwright.json; the same guard the Stardew scaffold carries.
+    pattern: "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)(?:\\.(?:0|[1-9][0-9]*))?(?:-(?:[a-zA-Z0-9]+[-.]?)+)?$"
   - type: string
     name: author
-    prompt: Author name.
+    prompt: Author name (no double quotes or backslashes — it is written into modwright.json as-is).
     default: "Unknown"
+    pattern: '^[^"\\\x00-\x1f]+$'
   # Observed in practice (2026-09-12): the WolvenKit CLI override had to be
   # added to a fresh project by hand because the locator does not find a CLI
   # installed outside the usual places. The path is machine-specific and