# bakustarver/rpgmakermlinux-cicpoffs architecture

> Architecture diagram of the GitHub repository bakustarver/rpgmakermlinux-cicpoffs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bakustarver/rpgmakermlinux-cicpoffs
- Repository: https://github.com/bakustarver/rpgmakermlinux-cicpoffs

## Overview

This repository is a Linux launcher and porting runtime for Windows-made games, with documented support for RPG Maker families and several other engines. The principal workflow is selecting a game and runtime, preparing a local Linux-compatible port, then launching it. The supplied tree and excerpts chiefly expose the RPG Maker XP compatibility layer and the bundled NW.js/RPG Maker MV runtime, not the launcher's main shell workflow; links between these areas are therefore left unclaimed. Major README capabilities such as NW.js selection and Pixi updates are represented, but their launcher-side implementation is unsampled.

Main entry points: [`Kawariki-patches/preload.rb`](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/preload.rb) (Patch Preloader), [`nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_managers.js`](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_managers.js) (Game Managers), [`nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/main.js`](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/main.js) (MV Boot Entry), [`nwjs/nwjs/packagefiles/package.json`](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/package.json) (NW.js Package)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_compat["XP Compatibility"]
  node_preload["Patch Preloader<br/>[preload.rb]"]
  node_patches["Patch Definitions<br/>[patches.rb]"]
  node_portbase["Game Ports<br/>[0.rb]"]
  node_textsystem["Advanced Text"]
  node_compatlibs["Win32 Emulation<br/>[Win32API.rb]"]
  node_gameplayports["Gameplay Ports"]
end

subgraph group_mv["MV Runtime"]
  node_entry["MV Boot Entry<br/>[main.js]"]
  node_managers["Game Managers<br/>[rpg_managers.js]"]
  node_objects["Game Objects<br/>[rpg_objects.js]"]
  node_rendering["Pixi Rendering<br/>[pixi-tilemap.js]"]
end

subgraph group_nwjs["NW.js Runtime"]
  node_runtime["NW.js Package<br/>[package.json]"]
  node_nwpatches["NW.js Patches<br/>[menu.js]"]
  node_plugin["Game Plugins<br/>[Clipboard_llule.js]"]
end

subgraph group_tyrano["Tyrano Runtime"]
  node_tyrano["Tyrano Engine<br/>[kag.js]"]
  node_translation["Translation Plugin<br/>[main.js]"]
  node_tyranolibs["Tyrano Libraries<br/>[libs.js]"]
end

node_user(("Game User"))
node_launcher["Linux Launcher"]
node_game["Windows Game"]

node_user -->|"starts game"| node_launcher
node_launcher -->|"prepares and launches"| node_game
node_runtime -->|"loads game"| node_entry
node_entry -->|"starts scene manager"| node_managers
node_managers -.-> node_objects
node_managers -->|"loads images"| node_rendering
node_preload -->|"loads patches"| node_patches
node_preload -.-> node_portbase
node_preload -.-> node_compatlibs
node_tyrano -->|"provides translation hook"| node_translation

click node_preload "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/preload.rb"
click node_patches "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/patches.rb"
click node_portbase "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/ports/0.rb"
click node_textsystem "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/ports/Advanced-Text-System-.rb"
click node_compatlibs "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/libs/Win32API.rb"
click node_gameplayports "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/ports/debug/savebitmanwin32api.rb"
click node_runtime "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/package.json"
click node_nwpatches "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/packagefiles/jspatches/menu.js"
click node_plugin "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/plugins/Clipboard_llule.js"
click node_entry "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/main.js"
click node_managers "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_managers.js"
click node_objects "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_objects.js"
click node_rendering "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/libs/pixi-tilemap.js"
click node_tyrano "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/packagefiles/tyranobuilder/tyranoeng/tyrano/plugins/kag/kag.js"
click node_translation "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/packagefiles/tyranobuilder/pathches/tf/main.js"
click node_tyranolibs "https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/packagefiles/tyranobuilder/tyranoeng/tyrano/libs.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_preload,node_patches,node_portbase,node_textsystem,node_compatlibs,node_gameplayports,node_user toneBlue
class node_entry,node_managers,node_objects,node_rendering toneAmber
class node_runtime,node_nwpatches,node_plugin toneMint
class node_tyrano,node_translation,node_tyranolibs toneRose
class node_launcher,node_game toneIndigo
```

## Components

### XP Compatibility

- [Patch Preloader](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/preload.rb): `Kawariki-patches/preload.rb`
- [Patch Definitions](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/patches.rb): `Kawariki-patches/patches.rb`
- [Game Ports](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/ports/0.rb): `Kawariki-patches/ports/0.rb`
- [Advanced Text](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/ports/Advanced-Text-System-.rb): `Kawariki-patches/ports/Advanced-Text-System-.rb`
- [Win32 Emulation](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/libs/Win32API.rb): `Kawariki-patches/libs/Win32API.rb`
- [Gameplay Ports](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/Kawariki-patches/ports/debug/savebitmanwin32api.rb): `Kawariki-patches/ports/debug/savebitmanwin32api.rb`

### MV Runtime

- [MV Boot Entry](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/main.js): `nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/main.js`
- [Game Managers](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_managers.js): `nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_managers.js`
- [Game Objects](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_objects.js): `nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_objects.js`
- [Pixi Rendering](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/libs/pixi-tilemap.js): `nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/libs/pixi-tilemap.js`

### NW.js Runtime

- [NW.js Package](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/package.json): `nwjs/nwjs/packagefiles/package.json`
- [NW.js Patches](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/packagefiles/jspatches/menu.js): `nwjs/packagefiles/jspatches/menu.js`
- [Game Plugins](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/nwjs/packagefiles/plugins/Clipboard_llule.js): `nwjs/nwjs/packagefiles/plugins/Clipboard_llule.js`

### Tyrano Runtime

- [Tyrano Engine](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/packagefiles/tyranobuilder/tyranoeng/tyrano/plugins/kag/kag.js): `nwjs/packagefiles/tyranobuilder/tyranoeng/tyrano/plugins/kag/kag.js`
- [Translation Plugin](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/packagefiles/tyranobuilder/pathches/tf/main.js): `nwjs/packagefiles/tyranobuilder/pathches/tf/main.js`
- [Tyrano Libraries](https://github.com/bakustarver/rpgmakermlinux-cicpoffs/blob/main/nwjs/packagefiles/tyranobuilder/tyranoeng/tyrano/libs.js): `nwjs/packagefiles/tyranobuilder/tyranoeng/tyrano/libs.js`

### Other components

- **Game User**
- **Linux Launcher**
- **Windows Game**

## Connections

- Game User → Linux Launcher: starts game (evidence: `README.md`)
- Linux Launcher → Windows Game: prepares and launches (evidence: `README.md`)
- NW.js Package → MV Boot Entry: loads game (evidence: `nwjs/nwjs/packagefiles/package.json`)
- MV Boot Entry → Game Managers: starts scene manager (evidence: `nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/main.js`)
- Game Managers → Game Objects
- Game Managers → Pixi Rendering: loads images (evidence: `nwjs/nwjs/packagefiles/rpgmaker-mv-pixi5/js/rpg_managers.js`)
- Patch Preloader → Patch Definitions: loads patches (evidence: `Kawariki-patches/preload.rb`)
- Patch Preloader → Game Ports
- Patch Preloader → Win32 Emulation
- Tyrano Engine → Translation Plugin: provides translation hook (evidence: `nwjs/packagefiles/tyranobuilder/pathches/tf/main.js`)
