{"id":35,"date":"2025-06-30T14:59:27","date_gmt":"2025-06-30T14:59:27","guid":{"rendered":"https:\/\/blogs.scummvm.org\/prime\/?p=35"},"modified":"2025-06-30T15:01:54","modified_gmt":"2025-06-30T15:01:54","slug":"week-4-sword25-teenagent-and-ngi","status":"publish","type":"post","link":"https:\/\/blogs.scummvm.org\/prime\/2025\/06\/30\/week-4-sword25-teenagent-and-ngi\/","title":{"rendered":"Week 4: Sword25, TeenAgent and NGI"},"content":{"rendered":"

This week, I focused on bringing keymapper support to three engines: Sword25<\/strong>, Teenagent<\/strong>, and NGI<\/strong>. Each had its own quirks, but none were too complex\u2014so I was able to make steady progress across the board.<\/p>\n

\n

Sword25<\/h3>\n

The Sword25 engine uses script-driven input handling. That made things straightforward\u2014no refactoring needed.<\/p>\n

My job here was mostly investigative: figure out what each key does and document it for the keymapper. Since input behavior was defined in scripts, I didn\u2019t need to touch much engine-level code. The entire process was smooth and quick.<\/p>\n

\n

Teenagent<\/h3>\n

Teenagent was also fairly simple. It involved defining a few custom actions for specific keys and setting up mouse input. The engine doesn\u2019t have complex input modes or conditionally processed input, so once I identified the key behaviors, wiring up the keymapper didn\u2019t take long.<\/p>\n

\n

NGI<\/h3>\n

The NGI engine was the most challenging of the three this week. While it didn\u2019t introduce any new types of problems, it did<\/em> have more keys and more complexity around where<\/em> input is processed.<\/p>\n

One big issue: keys pressed during menus, modals, or intros weren\u2019t processed through the same input flow as in-game actions. That meant keymapper actions would either:<\/p>\n

    \n
  • \n

    Be ignored in certain contexts, or worse\u2026<\/p>\n<\/li>\n

  • \n

    Be interpreted in places they shouldn’t be<\/p>\n<\/li>\n<\/ul>\n

    To fix this, I had to carefully trace the engine\u2019s input handling paths and add logic to enable or disable the keymapper<\/strong> at the right times. Most of my time on NGI was spent understanding those flows and placing the toggles precisely.<\/p>\n

    Once that was in place, implementing custom actions and mapping key behaviors was straightforward.<\/p>\n

    \n

    Wrap-Up<\/h3>\n

    This week, I:<\/p>\n

      \n
    • Implemented keymapper support for Sword25<\/strong>, Teenagent<\/strong>, and NGI<\/strong><\/li>\n
    • Got the NGI keymapper PR merged<\/li>\n
    • Got the keymapper action label normalization PR merged<\/li>\n<\/ul>\n

      Next week, I\u2019ll continue this momentum and explore new engines.<\/p>\n

      \n","protected":false},"excerpt":{"rendered":"

      This week, I focused on bringing keymapper support to three engines: Sword25, Teenagent, and NGI. Each had its own quirks, but none were too complex\u2014so I was able to make steady progress across the board. Sword25 The Sword25 engine uses script-driven input handling. That made things straightforward\u2014no refactoring needed. My job here was mostly investigative: […]<\/p>\n","protected":false},"author":28,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[],"class_list":["post-35","post","type-post","status-publish","format-standard","hentry","category-week-4"],"_links":{"self":[{"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/posts\/35","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/users\/28"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/comments?post=35"}],"version-history":[{"count":6,"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/posts\/35\/revisions"}],"predecessor-version":[{"id":41,"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/posts\/35\/revisions\/41"}],"wp:attachment":[{"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/media?parent=35"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/categories?post=35"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.scummvm.org\/prime\/wp-json\/wp\/v2\/tags?post=35"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}