reverseport 0.0.0-stage → 1.2.0

package/port/knowledge/maps/godot-unreal.json

@@ -0,0 +1,48 @@
+{
+  "from": "godot",
+  "to": "unreal",
+  "title": "Godot 4 (GDScript) → Unreal Engine 5 (C++ / Blueprint)",
+  "conventions": [
+    "A GDScript on a scene root usually becomes an Actor class (AMyThing : public AActor, or ACharacter/APawn for controllable bodies); reusable behaviour on child nodes becomes UActorComponent/USceneComponent classes. Each class is a .h + .cpp pair inside Source/<Module>/.",
+    "Godot scenes (.tscn) become Blueprint classes deriving from the C++ class, or levels (.umap). ReversePort writes a scene spec (JSON) with converted transforms; build the Blueprint in the editor from it.",
+    "Coordinates: Unreal is left-handed, Z-up, X-forward, centimeters. From Godot: (x, y, z) m → (-z, x, y) × 100 cm. Use port_convert for positions and rotations.",
+    "Godot's Camera3D fov is vertical; Unreal's FieldOfView is horizontal: hfov = 2·atan(tan(vfov/2)·aspect). port_convert {fov} does this.",
+    "Every exposed property needs UPROPERTY(...), every bound/blueprint-callable function UFUNCTION(...), and the class GENERATED_BODY(); include \"<Name>.generated.h\" last in the header.",
+    "Unreal ticks are frame-rate based by default; move fixed-step logic into Tick with DeltaTime or enable physics substepping."
+  ],
+  "entries": [
+    { "id": "script-class", "topic": "structure", "from": "extends Node3D / class_name X", "to": "UCLASS() class AX : public AActor { GENERATED_BODY() … };", "pattern": "^extends\\s", "notes": "CharacterBody3D → ACharacter; RigidBody3D → AActor with a simulating UStaticMeshComponent root; Area3D → AActor with UBoxComponent/USphereComponent (overlap)." },
+    { "id": "ready", "topic": "lifecycle", "from": "_ready()", "to": "virtual void BeginPlay() override; (call Super::BeginPlay())", "pattern": "\\bfunc\\s+_ready\\b", "notes": "Component creation belongs in the constructor with CreateDefaultSubobject<T>(TEXT(\"Name\"))." },
+    { "id": "process", "topic": "lifecycle", "from": "_process(delta)", "to": "virtual void Tick(float DeltaTime) override; with PrimaryActorTick.bCanEverTick = true in the constructor", "pattern": "\\bfunc\\s+_process\\b" },
+    { "id": "physics-process", "topic": "lifecycle", "from": "_physics_process(delta)", "to": "Tick(DeltaTime) (TG_PrePhysics tick group) or physics substepping", "pattern": "\\bfunc\\s+_physics_process\\b" },
+    { "id": "input", "topic": "input", "from": "Input.is_action_pressed / _input(event) / InputMap actions", "to": "Enhanced Input: UInputAction + UInputMappingContext; bind in SetupPlayerInputComponent with BindAction(Action, ETriggerEvent::Triggered, this, &AX::Move)", "pattern": "Input\\.(is_action|get_axis|get_vector)|func\\s+_(unhandled_)?input\\b" },
+    { "id": "export", "topic": "inspector", "from": "@export var speed := 6.0", "to": "UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = \"X\") float Speed = 600.f;", "pattern": "@export", "notes": "Remember the unit change: speeds and distances in meters become centimeters (×100)." },
+    { "id": "get-node", "topic": "scene tree", "from": "get_node(\"Path\") / $Path", "to": "UPROPERTY component pointers created in the constructor, FindComponentByClass<T>(), or GetComponents", "pattern": "(get_node\\(|\\$[A-Za-z\"%])", "leftover": "\\bget_node\\(" },
+    { "id": "signal", "topic": "events", "from": "signal hit(damage) / hit.emit(d) / hit.connect(f)", "to": "DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnHit, int32, Damage); UPROPERTY(BlueprintAssignable) FOnHit OnHit; OnHit.Broadcast(d); OnHit.AddDynamic(this, &AX::HandleHit) (handler must be a UFUNCTION)", "pattern": "^signal\\s|\\.emit\\(|emit_signal\\(|\\.connect\\(" },
+    { "id": "preload", "topic": "resources", "from": "preload(\"res://x.tscn\")", "to": "UPROPERTY(EditDefaultsOnly) TSubclassOf<AActor> XClass; (set in the Blueprint) or TSoftClassPtr for async loading", "pattern": "\\bpreload\\(" },
+    { "id": "instantiate", "topic": "scene tree", "from": "scene.instantiate() + add_child()", "to": "GetWorld()->SpawnActor<AActor>(XClass, Location, Rotation, SpawnParams)", "pattern": "\\.instantiate\\(" },
+    { "id": "queue-free", "topic": "scene tree", "from": "queue_free()", "to": "Destroy() for actors, DestroyComponent() for components", "pattern": "\\bqueue_free\\(?", "leftover": "queue_free" },
+    { "id": "timer", "topic": "async", "from": "await get_tree().create_timer(t).timeout / Timer node", "to": "GetWorldTimerManager().SetTimer(Handle, this, &AX::OnTimer, Seconds, false);", "pattern": "create_timer\\(|\\bTimer\\b" },
+    { "id": "tween", "topic": "animation", "from": "create_tween()", "to": "Timeline component (Blueprint), FMath::FInterpTo in Tick, or a latent action", "pattern": "create_tween\\(" },
+    { "id": "character-body", "topic": "physics", "from": "CharacterBody3D + move_and_slide()", "to": "ACharacter + UCharacterMovementComponent; AddMovementInput(Direction, Scale), Jump()", "pattern": "move_and_slide\\(|CharacterBody3D" },
+    { "id": "rigid-body", "topic": "physics", "from": "RigidBody3D.apply_central_impulse(v)", "to": "UPrimitiveComponent::SetSimulatePhysics(true); AddImpulse(V) (cm·kg/s — scale ×100)", "pattern": "RigidBody3D|apply_(central_)?(impulse|force)\\(" },
+    { "id": "area", "topic": "physics", "from": "Area3D.body_entered(body)", "to": "UBoxComponent with SetGenerateOverlapEvents(true); OnComponentBeginOverlap.AddDynamic(this, &AX::OnOverlap)", "pattern": "Area3D|body_entered|area_entered" },
+    { "id": "raycast", "topic": "physics", "from": "RayCast3D / intersect_ray", "to": "GetWorld()->LineTraceSingleByChannel(Hit, Start, End, ECC_Visibility, Params)", "pattern": "RayCast3D|intersect_ray" },
+    { "id": "camera", "topic": "rendering", "from": "Camera3D", "to": "UCameraComponent (often on a USpringArmComponent); FieldOfView is horizontal", "pattern": "Camera3D" },
+    { "id": "lights", "topic": "rendering", "from": "DirectionalLight3D / OmniLight3D / SpotLight3D", "to": "ADirectionalLight / APointLight / ASpotLight (or the components)", "pattern": "(Directional|Omni|Spot)Light3D" },
+    { "id": "mesh", "topic": "rendering", "from": "MeshInstance3D", "to": "UStaticMeshComponent (USkeletalMeshComponent when skinned)", "pattern": "MeshInstance3D" },
+    { "id": "animation", "topic": "animation", "from": "AnimationPlayer / AnimationTree", "to": "Animation Blueprint (state machine), UAnimMontage via PlayAnimMontage, Sequencer for cutscenes", "pattern": "AnimationPlayer|AnimationTree" },
+    { "id": "audio", "topic": "audio", "from": "AudioStreamPlayer3D", "to": "UAudioComponent with attenuation, or UGameplayStatics::PlaySoundAtLocation", "pattern": "AudioStreamPlayer" },
+    { "id": "ui", "topic": "ui", "from": "Control / Label / CanvasLayer", "to": "UMG: UUserWidget (Widget Blueprint), UTextBlock, UButton; CreateWidget + AddToViewport", "pattern": "\\b(Control|Label|Button|CanvasLayer)\\b" },
+    { "id": "autoload", "topic": "architecture", "from": "Autoload singleton", "to": "UGameInstanceSubsystem (or the GameInstance / GameMode / GameState as fits)", "pattern": "^\\[autoload\\]" },
+    { "id": "change-scene", "topic": "architecture", "from": "change_scene_to_file(\"res://x.tscn\")", "to": "UGameplayStatics::OpenLevel(this, FName(\"X\"))", "pattern": "change_scene_to_(file|packed)\\(" },
+    { "id": "groups", "topic": "architecture", "from": "add_to_group / get_nodes_in_group", "to": "Actor Tags (Tags.Add, ActorHasTag) + UGameplayStatics::GetAllActorsWithTag, or Gameplay Tags", "pattern": "(add_to_group|get_nodes_in_group|is_in_group)\\(" },
+    { "id": "resource", "topic": "data", "from": "custom Resource (.tres)", "to": "UDataAsset / UPrimaryDataAsset, or a DataTable row struct", "pattern": "extends\\s+Resource" },
+    { "id": "print", "topic": "debug", "from": "print()", "to": "UE_LOG(LogTemp, Log, TEXT(\"…\")); GEngine->AddOnScreenDebugMessage for on-screen", "pattern": "\\bprint\\(", "leftover": "^\\s*print\\(" },
+    { "id": "math", "topic": "math", "from": "lerp, clamp, deg_to_rad, randf_range", "to": "FMath::Lerp, FMath::Clamp, FMath::DegreesToRadians, FMath::FRandRange", "pattern": "\\b(lerp|clamp|deg_to_rad|randf_range|randi_range)\\(" },
+    { "id": "vectors", "topic": "math", "from": "Vector3, Basis, Quaternion, Transform3D", "to": "FVector (double in UE5), FMatrix/FRotator, FQuat, FTransform", "pattern": "\\b(Vector3|Basis|Quaternion|Transform3D)\\b" },
+    { "id": "time-scale", "topic": "time", "from": "Engine.time_scale", "to": "UGameplayStatics::SetGlobalTimeDilation(this, Value)", "pattern": "Engine\\.time_scale" },
+    { "id": "shader", "topic": "rendering", "from": ".gdshader", "to": "Material Editor graph (Custom HLSL node for code)", "pattern": "shader_type\\s" },
+    { "id": "collections", "topic": "language", "from": "Array, Dictionary, String", "to": "TArray<T>, TMap<K, V>, FString / FName / FText", "pattern": "\\bArray\\b|\\bDictionary\\b" }
+  ]
+}

package/port/knowledge/maps/unity-godot.json

@@ -0,0 +1,52 @@
+{
+  "from": "unity",
+  "to": "godot",
+  "title": "Unity (C#) → Godot 4 (GDScript)",
+  "conventions": [
+    "A MonoBehaviour becomes a GDScript attached to a node. The GameObject's components decide the node type: Rigidbody → RigidBody3D, CharacterController → CharacterBody3D, Collider with isTrigger → Area3D, plain → Node3D; colliders become CollisionShape3D children, MeshFilter+MeshRenderer a MeshInstance3D child.",
+    "Prefabs become .tscn scenes; scene files (.unity) become .tscn scenes too. port_scene writes the .tscn with converted transforms; open it in Godot and attach meshes/materials.",
+    "Coordinates: mirror Z (position (x, y, -z), quaternion (-x, -y, z, w)); Unity's +Z forward becomes Godot's -Z forward. Use port_convert.",
+    "Unity Euler angles are degrees, Godot rotation is radians (rotation_degrees exists for degrees).",
+    "Keep the port in C# instead (Godot .NET) when the code is large and idiomatic C#: target godot-csharp and only the engine API calls change.",
+    "Assets: copy textures, audio and models (FBX/glTF) into the Godot project; Godot imports them itself. Unity-only formats (.mat, .controller, .anim) must be rebuilt."
+  ],
+  "entries": [
+    { "id": "monobehaviour", "topic": "structure", "from": "public class X : MonoBehaviour", "to": "extends Node3D (or the node type the GameObject needs) + class_name X", "pattern": ":\\s*MonoBehaviour" },
+    { "id": "awake-start", "topic": "lifecycle", "from": "Awake() / Start()", "to": "_ready() (use _enter_tree() for very early setup)", "pattern": "\\b(void\\s+)?(Awake|Start)\\s*\\(\\s*\\)" },
+    { "id": "update", "topic": "lifecycle", "from": "Update() with Time.deltaTime", "to": "_process(delta)", "pattern": "\\bvoid\\s+Update\\s*\\(" , "leftover": "Time\\.deltaTime"},
+    { "id": "fixed-update", "topic": "lifecycle", "from": "FixedUpdate() with Time.fixedDeltaTime", "to": "_physics_process(delta) (60 Hz default vs Unity 50 Hz)", "pattern": "\\bvoid\\s+FixedUpdate\\s*\\(" },
+    { "id": "late-update", "topic": "lifecycle", "from": "LateUpdate()", "to": "_process with a higher process_priority on this node (runs later), or call_deferred", "pattern": "\\bvoid\\s+LateUpdate\\s*\\(" },
+    { "id": "on-destroy", "topic": "lifecycle", "from": "OnDestroy() / OnDisable()", "to": "_exit_tree() / NOTIFICATION_PREDELETE in _notification", "pattern": "\\bvoid\\s+On(Destroy|Disable|Enable)\\s*\\(" },
+    { "id": "serialize-field", "topic": "inspector", "from": "[SerializeField] private float speed = 6f; / public fields", "to": "@export var speed: float = 6.0", "pattern": "\\[SerializeField\\]|^\\s*public\\s+(float|int|bool|string|Vector3|GameObject|Transform)\\s+\\w+" },
+    { "id": "get-component", "topic": "scene tree", "from": "GetComponent<T>() / GetComponentInChildren<T>()", "to": "the node itself (components are nodes): $Child, get_node(\"Child\") as T, or find_children(\"*\", \"T\")", "pattern": "GetComponent(InChildren|InParent)?<", "leftover": "GetComponent" },
+    { "id": "find", "topic": "scene tree", "from": "GameObject.Find(\"X\") / transform.Find(\"X\")", "to": "get_node(\"X\") / get_tree().root.find_child(\"X\", true, false)", "pattern": "\\.Find\\(\"" },
+    { "id": "instantiate", "topic": "scene tree", "from": "Instantiate(prefab, pos, rot, parent)", "to": "var n = scene.instantiate(); parent.add_child(n); n.global_transform = …", "pattern": "\\bInstantiate\\(", "leftover": "\\bInstantiate\\(" },
+    { "id": "destroy", "topic": "scene tree", "from": "Destroy(gameObject) / Destroy(obj, t)", "to": "queue_free() / get_tree().create_timer(t).timeout.connect(queue_free)", "pattern": "\\bDestroy\\(", "leftover": "\\bDestroy\\(" },
+    { "id": "set-active", "topic": "scene tree", "from": "gameObject.SetActive(false)", "to": "visible = false plus process_mode = PROCESS_MODE_DISABLED (or remove_child)", "pattern": "SetActive\\(" },
+    { "id": "prefab-field", "topic": "resources", "from": "public GameObject bulletPrefab;", "to": "@export var bullet_scene: PackedScene (or const BULLET = preload(\"res://bullet.tscn\"))", "pattern": "public\\s+GameObject\\s+\\w+" },
+    { "id": "resources-load", "topic": "resources", "from": "Resources.Load<T>(\"x\") / Addressables", "to": "load(\"res://x.tres\") / ResourceLoader.load_threaded_request", "pattern": "Resources\\.Load|Addressables\\." },
+    { "id": "coroutine", "topic": "async", "from": "StartCoroutine(F()) with yield return new WaitForSeconds(t)", "to": "async func with await get_tree().create_timer(t).timeout", "pattern": "StartCoroutine\\(|IEnumerator|WaitForSeconds", "leftover": "WaitForSeconds|StartCoroutine" },
+    { "id": "events", "topic": "events", "from": "event Action<int> Hit / UnityEvent", "to": "signal hit(damage: int); hit.emit(d); hit.connect(f)", "pattern": "\\bevent\\s+Action|UnityEvent", "leftover": "\\?\\.Invoke\\(" },
+    { "id": "input-legacy", "topic": "input", "from": "Input.GetButtonDown(\"Fire1\") / Input.GetAxis(\"Horizontal\") / GetKey", "to": "Input.is_action_just_pressed(\"fire\") / Input.get_axis(\"move_left\", \"move_right\") (define actions in Project Settings → Input Map)", "pattern": "Input\\.Get(Button|Axis|Key|Mouse)", "leftover": "Input\\.Get(Button|Axis|Key)" },
+    { "id": "input-system", "topic": "input", "from": "Input System (InputAction, PlayerInput)", "to": "Input Map actions + Input.is_action_* / _unhandled_input(event)", "pattern": "InputAction|PlayerInput" },
+    { "id": "rigidbody", "topic": "physics", "from": "Rigidbody.AddForce(v, ForceMode.Impulse) / velocity", "to": "RigidBody3D.apply_central_impulse(v) / linear_velocity", "pattern": "AddForce\\(|Rigidbody\\b|\\.velocity\\b|linearVelocity" },
+    { "id": "character-controller", "topic": "physics", "from": "CharacterController.Move(motion) / isGrounded", "to": "CharacterBody3D: velocity = …; move_and_slide(); is_on_floor()", "pattern": "CharacterController|\\.Move\\(|isGrounded" },
+    { "id": "triggers", "topic": "physics", "from": "OnTriggerEnter(Collider other) / OnCollisionEnter(Collision c)", "to": "Area3D body_entered(body) signal / RigidBody3D body_entered with contact_monitor = true", "pattern": "On(Trigger|Collision)(Enter|Exit|Stay)" },
+    { "id": "raycast", "topic": "physics", "from": "Physics.Raycast(origin, dir, out hit, dist)", "to": "get_world_3d().direct_space_state.intersect_ray(PhysicsRayQueryParameters3D.create(from, to)) or a RayCast3D node", "pattern": "Physics\\.Raycast" },
+    { "id": "tags", "topic": "architecture", "from": "CompareTag(\"Enemy\") / FindGameObjectsWithTag", "to": "is_in_group(\"enemies\") / get_tree().get_nodes_in_group(\"enemies\")", "pattern": "CompareTag\\(|WithTag\\(|\\.tag\\b", "leftover": "CompareTag" },
+    { "id": "singleton", "topic": "architecture", "from": "static Instance + DontDestroyOnLoad", "to": "Autoload (Project Settings → Globals) accessed by name", "pattern": "DontDestroyOnLoad|static\\s+\\w+\\s+Instance" },
+    { "id": "scene-load", "topic": "architecture", "from": "SceneManager.LoadScene(\"x\")", "to": "get_tree().change_scene_to_file(\"res://x.tscn\")", "pattern": "SceneManager\\.LoadScene" },
+    { "id": "scriptable-object", "topic": "data", "from": "ScriptableObject assets", "to": "custom Resource (extends Resource, class_name) saved as .tres", "pattern": "ScriptableObject" },
+    { "id": "transform", "topic": "transform", "from": "transform.position / localPosition / rotation / eulerAngles", "to": "global_position / position / global_basis / rotation_degrees (mind the Z mirror)", "pattern": "transform\\.(position|localPosition|rotation|localRotation|eulerAngles)" },
+    { "id": "forward", "topic": "transform", "from": "transform.forward (+Z)", "to": "-global_basis.z (Godot forward is -Z)", "pattern": "transform\\.forward|Vector3\\.forward" },
+    { "id": "quaternion", "topic": "math", "from": "Quaternion.Euler(x, y, z) (degrees)", "to": "Basis.from_euler(Vector3(deg_to_rad(x), …)) / Quaternion.from_euler (radians)", "pattern": "Quaternion\\.Euler" },
+    { "id": "debug-log", "topic": "debug", "from": "Debug.Log / LogWarning / LogError", "to": "print() / push_warning() / push_error()", "pattern": "Debug\\.Log", "leftover": "Debug\\.Log" },
+    { "id": "mathf", "topic": "math", "from": "Mathf.Lerp, Mathf.Clamp, Random.Range", "to": "lerp, clamp, randf_range / randi_range (inclusive max)", "pattern": "Mathf\\.|Random\\.Range", "leftover": "Mathf\\." },
+    { "id": "time", "topic": "time", "from": "Time.timeScale, Time.time", "to": "Engine.time_scale, Time.get_ticks_msec() / 1000.0", "pattern": "Time\\.(timeScale|time\\b|unscaledTime)" },
+    { "id": "animator", "topic": "animation", "from": "Animator.Play / SetTrigger / SetFloat", "to": "AnimationPlayer.play() / AnimationTree with parameters/… conditions", "pattern": "Animator\\b|SetTrigger|SetFloat|SetBool" },
+    { "id": "audio-source", "topic": "audio", "from": "AudioSource.Play / PlayOneShot", "to": "AudioStreamPlayer(3D).play()", "pattern": "AudioSource" },
+    { "id": "ugui", "topic": "ui", "from": "Canvas, TextMeshProUGUI, Button.onClick", "to": "Control nodes: Label, Button.pressed signal, CanvasLayer", "pattern": "TextMeshPro|\\bCanvas\\b|onClick|UnityEngine\\.UI" },
+    { "id": "collections", "topic": "language", "from": "List<T>, Dictionary<K,V>", "to": "Array[T], Dictionary (typed dictionaries in Godot 4.4+)", "pattern": "List<|Dictionary<" },
+    { "id": "properties", "topic": "language", "from": "C# properties { get; set; }", "to": "var x: int: set = _set_x, get = _get_x (or plain vars)", "pattern": "\\{\\s*get;" }
+  ]
+}

package/port/knowledge/maps/unity-unreal.json

@@ -0,0 +1,33 @@
+{
+  "from": "unity",
+  "to": "unreal",
+  "title": "Unity (C#) → Unreal Engine 5 (C++ / Blueprint)",
+  "conventions": [
+    "MonoBehaviours on a GameObject become an Actor class (or ActorComponents for reusable behaviour); prefabs become Blueprint classes, scenes become levels.",
+    "Coordinates: both left-handed. Unity (x right, y up, z forward, m) → Unreal (x forward, y right, z up, cm): (x, y, z) → (z, x, y) × 100. Use port_convert.",
+    "Unity Camera.fieldOfView is vertical, Unreal FieldOfView horizontal: convert with port_convert {fov, aspect}.",
+    "Unreal reflection: UCLASS/UPROPERTY/UFUNCTION/GENERATED_BODY on everything the editor, Blueprints or delegates touch."
+  ],
+  "entries": [
+    { "id": "monobehaviour", "topic": "structure", "from": "class X : MonoBehaviour", "to": "UCLASS() class AX : public AActor (or UXComponent : public UActorComponent)", "pattern": ":\\s*MonoBehaviour" },
+    { "id": "awake-start", "topic": "lifecycle", "from": "Awake() / Start()", "to": "constructor (components) + BeginPlay()", "pattern": "\\b(Awake|Start)\\s*\\(\\s*\\)" },
+    { "id": "update", "topic": "lifecycle", "from": "Update() / FixedUpdate()", "to": "Tick(float DeltaTime) (enable PrimaryActorTick.bCanEverTick)", "pattern": "\\b(Fixed)?Update\\s*\\(" },
+    { "id": "serialize-field", "topic": "inspector", "from": "[SerializeField] float speed", "to": "UPROPERTY(EditAnywhere) float Speed (cm/s: ×100)", "pattern": "\\[SerializeField\\]" },
+    { "id": "get-component", "topic": "structure", "from": "GetComponent<T>()", "to": "FindComponentByClass<T>() / UPROPERTY component pointers", "pattern": "GetComponent<" },
+    { "id": "instantiate", "topic": "structure", "from": "Instantiate(prefab)", "to": "GetWorld()->SpawnActor<AActor>(Class, Transform)", "pattern": "\\bInstantiate\\(" },
+    { "id": "destroy", "topic": "structure", "from": "Destroy(gameObject)", "to": "Destroy() / SetLifeSpan(seconds)", "pattern": "\\bDestroy\\(" },
+    { "id": "coroutine", "topic": "async", "from": "StartCoroutine + WaitForSeconds", "to": "FTimerHandle + GetWorldTimerManager().SetTimer, or latent Delay in Blueprint", "pattern": "StartCoroutine|WaitForSeconds" },
+    { "id": "events", "topic": "events", "from": "event Action<T> / UnityEvent", "to": "DECLARE_DYNAMIC_MULTICAST_DELEGATE_*; Broadcast(); AddDynamic()", "pattern": "\\bevent\\s+Action|UnityEvent" },
+    { "id": "input", "topic": "input", "from": "Input.GetAxis / Input System actions", "to": "Enhanced Input (UInputAction + UInputMappingContext)", "pattern": "Input\\.Get|InputAction" },
+    { "id": "rigidbody", "topic": "physics", "from": "Rigidbody.AddForce", "to": "UPrimitiveComponent::AddForce / AddImpulse with SetSimulatePhysics(true)", "pattern": "AddForce\\(|Rigidbody" },
+    { "id": "character-controller", "topic": "physics", "from": "CharacterController", "to": "ACharacter + UCharacterMovementComponent", "pattern": "CharacterController" },
+    { "id": "triggers", "topic": "physics", "from": "OnTriggerEnter", "to": "OnComponentBeginOverlap.AddDynamic", "pattern": "OnTrigger(Enter|Exit)" },
+    { "id": "raycast", "topic": "physics", "from": "Physics.Raycast", "to": "GetWorld()->LineTraceSingleByChannel", "pattern": "Physics\\.Raycast" },
+    { "id": "tags", "topic": "architecture", "from": "CompareTag", "to": "ActorHasTag / Gameplay Tags", "pattern": "CompareTag\\(" },
+    { "id": "scene-load", "topic": "architecture", "from": "SceneManager.LoadScene", "to": "UGameplayStatics::OpenLevel", "pattern": "SceneManager\\.LoadScene" },
+    { "id": "scriptable-object", "topic": "data", "from": "ScriptableObject", "to": "UDataAsset / DataTable", "pattern": "ScriptableObject" },
+    { "id": "debug-log", "topic": "debug", "from": "Debug.Log", "to": "UE_LOG(LogTemp, Log, TEXT(\"…\"))", "pattern": "Debug\\.Log", "leftover": "Debug\\.Log" },
+    { "id": "mathf", "topic": "math", "from": "Mathf.*", "to": "FMath::*", "pattern": "Mathf\\.", "leftover": "Mathf\\." },
+    { "id": "ui", "topic": "ui", "from": "uGUI / TextMeshPro", "to": "UMG widgets (UUserWidget, UTextBlock)", "pattern": "TextMeshPro|UnityEngine\\.UI" }
+  ]
+}