Add linux config to template folder

Now setting the environment variable before should work

.github/workflows/master-build.yml

@@ -12,8 +12,9 @@ jobs:
     steps:
     - name: Install dependencies
       run: |
+        export DEBIAN_FRONTEND=noninteractive
         apt-get update
-        apt install -y git make wget
+        apt-get install -y git make wget nodejs
         
     - name: Set git safe directory
       run: |

.github/workflows/pr-build-check.yml

@@ -12,8 +12,9 @@ jobs:
     steps:
     - name: Install dependencies
       run: |
+        export DEBIAN_FRONTEND=noninteractive
         apt-get update
-        apt install -y git make wget
+        apt-get install -y git make wget nodejs
         
     - name: Set git safe directory
       run: |

.vscode/configurations/linux-docker/c_cpp_properties.json

@@ -0,0 +1,41 @@
+{
+    "configurations": [
+        {
+            "name": "Docker PS2SDK (Linux)",
+            "includePath": [
+                "${workspaceFolder}/**",
+                "~/ps2dev-intellisense/ps2sdk/common/include/**",
+                "~/ps2dev-intellisense/ps2sdk/ee/include/**",
+                "~/ps2dev-intellisense/ps2sdk/iop/include/**",
+                "~/ps2dev-intellisense/ps2sdk/ports/include/**",
+                "~/ps2dev-intellisense/ee/include/**",
+                "~/ps2dev-intellisense/ee/lib/gcc/mips64r5900el-ps2-elf/11.3.0/include/**",
+                "~/ps2dev-intellisense/ee/lib/gcc/mips64r5900el-ps2-elf/11.3.0/include-fixed/**",
+                "~/ps2dev-intellisense/ee/lib/gcc/mips64r5900el-ps2-elf/11.3.0/install-tools/include/**",
+                "~/ps2dev-intellisense/ee/lib/gcc/mips64r5900el-ps2-elf/11.3.0/plugin/include/**",
+                "~/ps2dev-intellisense/ee/mips64r5900el-ps2-elf/include/**",
+                "~/ps2dev-intellisense/ee/mips64r5900el-ps2-elf/sys-include/**",
+                "~/ps2dev-intellisense/gsKit/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-elf/11.3.0/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-elf/11.3.0/install-tools/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-elf/11.3.0/plugin/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-elf/11.3.0/include-fixed/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-irx/11.3.0/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-irx/11.3.0/install-tools/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-irx/11.3.0/plugin/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-irx/11.3.0/include-fixed/**"
+            ],
+            "defines": [
+                "_EE",
+                "_IOP",
+                "__SPU__",
+                "INTELLISENSE"
+            ],
+            "cppStandard": "c++20",
+            "compilerPath": "", // Should be empty
+            "intelliSenseMode": "linux-gcc-x86",
+            "configurationProvider": "ms-vscode.cpptools"
+        }
+    ],
+    "version": 4
+}

.vscode/configurations/linux-docker/settings.json

@@ -0,0 +1,14 @@
+{
+    "buildDirectory": "demo",
+    "C_Cpp.default.intelliSenseMode": "gcc-x86",
+    "files.associations": {
+        "*.vcl": "asm-collection",
+        "*.i": "asm-collection",
+        "*.vsm": "asm-collection",
+        "*.vclpp": "asm-collection",
+        "*.hpp": "cpp",
+        "*.cpp": "cpp",
+        "*.h": "c",
+        "*.c": "c"
+    }
+}

.vscode/configurations/linux-docker/tasks.json

@@ -0,0 +1,119 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Build & run",
+            "dependsOrder": "sequence",
+            "dependsOn": [
+                "1. Copy source code to docker volume",
+                "2. Compile via docker container",
+                "3. Copy binaries to host",
+                "4. Run PCSX2"
+            ],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        },
+        {
+            "type": "shell",
+            "label": "1. Copy source code to docker volume",
+            "command": "docker exec -t tyra-compiler sh -c 'rsync -ac --delete --exclude \".git\" --exclude \"docs\" --exclude \".vscode\" --exclude \"tools\" --exclude \"obj\" --exclude \"bin\" /host/ /src/'"
+        },
+        {
+            "type": "shell",
+            "label": "2. Compile via docker container",
+            "command": "docker exec -t tyra-compiler sh -c 'cd ${config:buildDirectory} && make build-engine all'",
+            "problemMatcher": {
+                "base": "$gcc",
+                "fileLocation": [
+                    "autoDetect"
+                ]
+            }
+        },
+        {
+            "type": "shell",
+            "label": "3. Copy binaries to host",
+            "command": "docker exec -t tyra-compiler sh -c 'rsync -zac --include=\"*/\" --include=\"bin/**\" --exclude=\"*\" /src/ /host/'"
+        },
+        {
+            "type": "shell",
+            "label": "4. Run PCSX2",
+            "options": {
+                "cwd": "${config:buildDirectory}"
+            },
+            "command": "./run.sh"
+        },
+        {
+            "type": "shell",
+            "label": "Convert WAV to ADPCM",
+            "dependsOn": [
+                "1. Copy source code to docker volume"
+            ],
+            "command": "docker exec -t tyra-compiler sh -c 'adpenc ${input:wav2adpcmSource} ${input:wav2adpcmTarget} && rsync -zac /src/${input:wav2adpcmTarget} /host/${input:wav2adpcmTarget}'"
+        },
+        {
+            "type": "shell",
+            "label": "Cleanup",
+            "command": "docker exec -t tyra-compiler sh -c 'rm -rf /src/*'"
+        },
+        {
+            "type": "shell",
+            "label": "Send to PS2",
+            "command": "docker exec -t tyra-compiler sh -c 'cd ${config:buildDirectory}/bin && killall -v ps2client || true && ps2client -h ${input:ps2Ip} reset && ps2client -h ${input:ps2Ip} reset && ps2client -h ${input:ps2Ip} execee host:$(find . -maxdepth 1 -type f -name \"*.elf\")'"
+        },
+        {
+            "type": "shell",
+            "label": "Open PS2 output logger",
+            "command": "docker stop ps2-logs || true && docker run -t --rm --name=ps2-logs -p ${input:local2Ip}:18194:18194/udp h4570/tyra sh -c 'ps2client -h ${input:ps2Ip} listen'",
+            "runOptions": {
+                "instanceLimit": 1
+            },
+            "presentation": {
+                "reveal": "always",
+                "panel": "new"
+            }
+        },
+        {
+            "type": "shell",
+            "label": "Start docker container",
+            "command": "docker compose up -d"
+        },
+        {
+            "type": "shell",
+            "label": "Stop docker container",
+            "command": "docker compose down"
+        },
+        {
+            "type": "shell",
+            "label": "[Debug] Copy obj directory to host",
+            "command": "docker exec -t tyra-compiler sh -c 'rsync -zac --include=\"*/\" --include=\"obj/**\" --exclude=\"*\" /src/ /host/'"
+        }
+    ],
+    "inputs": [
+        {
+            "id": "wav2adpcmSource",
+            "description": "Source file path (ex. ):",
+            "default": "demo/res/sound.wav",
+            "type": "promptString"
+        },
+        {
+            "id": "wav2adpcmTarget",
+            "description": "Target file path (ex. ):",
+            "default": "demo/res/sound.adpcm",
+            "type": "promptString"
+        },
+        {
+            "id": "ps2Ip",
+            "description": "PS2link ip address:",
+            "default": "192.168.1.200",
+            "type": "promptString"
+        },
+        {
+            "id": "local2Ip",
+            "description": "Local ip address:",
+            "default": "192.168.1.245",
+            "type": "promptString"
+        }
+    ]
+}

Dockerfile

@@ -31,8 +31,7 @@ RUN make
 # Download VCL
 RUN mkdir -p /temp/vcl
 WORKDIR "/temp/vcl"
-RUN wget http://apgcglz.cluster028.hosting.ovh.net/tyra/vcl.zip
+RUN wget https://github.com/h4570/tyra/raw/master/assets/vcl
-RUN unzip vcl.zip
 
 # ------------------------------------------------------------------------------
 

README.MD

@@ -68,6 +68,8 @@ Decision was simple - I need to create an engine which will handle 3D file loadi
 * 07 - [Code](https://github.com/h4570/tyra/tree/master/tutorials/07-lighting) - Static lightmap and dynamic directional lights
 * 08 - [Code](https://github.com/h4570/tyra/tree/master/tutorials/08-skybox-debug) - Skybox and debug rendering
 * 09 - [Code](https://github.com/h4570/tyra/tree/master/tutorials/09-manual-mode) - Manual rendering (a'la OpenGL)
+* 10 - [Code](https://github.com/h4570/tyra/tree/master/tutorials/10-sprite-sheet) - Sprite sheet (font)
+* 11 - [Code](https://github.com/h4570/tyra/tree/master/tutorials/11-texture-region-repeat) - Texture repeating
 * Demo game - [Code](https://github.com/h4570/tyra/tree/master/demo)
 ---
 
@@ -141,7 +143,7 @@ Distributed under the Apache License 2.0 License. See `LICENSE` for more informa
 Without these guys, Tyra would not happen:
 * [Dr Henry Fortuna](http://ps2-edu.tensioncore.com/index.html) - for code sources, PS2 academy tutorials
 * Whole [PS2DEV](https://github.com/ps2dev) team, and specially to [Rick Gaiser](https://github.com/rickgaiser), [fjtrujy](https://github.com/fjtrujy) - for a lot of good tips!
-* [Wellington Carvalho](https://github.com/Wellinator), [André Guilheme](https://github.com/Wolf3s), [Matías Israelson](https://github.com/israpps) - for testing, contributing to Tyra and sharing cool ideas!
+* [Wellington Carvalho](https://github.com/Wellinator), [André Guilheme](https://github.com/Wolf3s), [Matías Israelson](https://github.com/israpps), [Guido Diego Quispe Robles](https://github.com/israpps) - for testing, contributing to Tyra and sharing cool ideas!
 * [Leonardo Ono](https://github.com/leonardo-ono) - for software renderer example (with clipping!)
 * [Lukasz D.K.](https://github.com/lukaszdk) - for huge archive of PS2 stuff
 * [Guilherme Lampert](https://github.com/glampert) - for code sources
@@ -150,7 +152,7 @@ Without these guys, Tyra would not happen:
 * And so many other guys. Thanks!
 
 Project Link: [https://github.com/h4570/tyra](https://github.com/h4570/tyra)  
-Sandro Sobczyński - sandro.sobczynski@gmail.com  
+Sandro Sobczyński - sandro.sobczynski@gmail.com (<a href="https://hasto.pl">hasto.pl</a>)  
 [![LinkedIn][linkedin-shield]](https://linkedin.com/in/sandro-sobczyński-28820b15a)  
   
 <br />

demo/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../linux-pcsx2.sh

docker-compose.yml

@@ -11,4 +11,4 @@ services:
     container_name: tyra-compiler
     volumes:
       - tyra-volume:/src
-      - ./:/host
+      - ./:/host:z

docs/install/README.MD

@@ -6,7 +6,7 @@
 1. Git
 2. VSCode
 3. Docker with PowerShell as a default terminal
-4. [PCSX2](https://github.com/h4570/tyra/blob/master/docs/install/pcsx2.md#)
+4. [Configured PCSX2](https://github.com/h4570/tyra/blob/master/docs/install/pcsx2.md#)
 
 ---
 

docs/install/pcsx2.md

@@ -1,15 +1,9 @@
-## Install & configure PCSX2
+## PCSX2 preparation
 
-- Download & install PCSX2 (1.6+ version) from https://pcsx2.net/
+- Download PCSX2 from https://pcsx2.net/
+- Install
 - Extract bios files from https://romsmania.cc/bios/pcsx2-playstation-2-bios-3 to `%UserProfile%\Documents\PCSX2\bios`
-- Close `PCSX2` if you have opened!
+- Map pad to your keyboard, for example:
-- Open `%UserProfile%\Documents\PCSX2\inis\PCSX2_vm.ini` in notepad
-
-```
-HostFs=enabled
-```
-
-- Open PCSX2 and map pad to your keyboard, for example:
 
 ```
 WASD = Left joy
@@ -18,4 +12,14 @@ Space = X
 Circle = C
 ```
 
-- Enable **"EE timing hack"** in PCSX2 hacks!
+### For PCSX2 1.6.X
+- Close `PCSX2` if you have opened!
+- Open `%UserProfile%\Documents\PCSX2\inis\PCSX2_vm.ini` in notepad and change HostFs option:
+
+```
+HostFs=enabled
+```
+
+### For PCSX2 1.7.X
+- Open `PCSX2` 
+- Go to Settings -> Emulation -> Enable `Host file system`

engine/src/renderer/3d/pipeline/dynamic/core/dynpip_renderer.cpp

@@ -189,6 +189,8 @@ void DynPipRenderer::addBufferDataToPacket(DynPipBag** bags, const u32& count) {
 
 void DynPipRenderer::sendPacket() {
   dma_channel_wait(DMA_CHANNEL_VIF1, 0);
+  dma_channel_wait(DMA_CHANNEL_GIF, 0);  // Wait for texture. Issue #182.
+
   // dma_wait_fast(); // This have no impact on performance
   dma_channel_send_packet2(currentPacket, DMA_CHANNEL_VIF1, true);
 

engine/src/renderer/3d/pipeline/minecraft/programs/mcpip_programs_manager.cpp

@@ -168,6 +168,8 @@ void BlockizerProgramsManager::sendPacket(McpipProgram* program) {
   packet2_utils_vu_add_end_tag(currentPacket);
 
   dma_channel_wait(DMA_CHANNEL_VIF1, 0);
+  dma_channel_wait(DMA_CHANNEL_GIF, 0);  // Wait for texture. Issue #182.
+
   // dma_wait_fast(); // This have no impact on performance
 
   dma_channel_send_packet2(currentPacket, DMA_CHANNEL_VIF1, true);

engine/src/renderer/3d/pipeline/static/core/stapip_qbuffer_renderer.cpp

@@ -365,6 +365,8 @@ void StaPipQBufferRenderer::sendPacket() {
               "Packet is too big. Internal error");
 
   dma_channel_wait(DMA_CHANNEL_VIF1, 0);
+  dma_channel_wait(DMA_CHANNEL_GIF, 0);  // Wait for texture. Issue #182.
+
   // dma_wait_fast(); // This have no impact on performance
 
   dma_channel_send_packet2(currentPacket, DMA_CHANNEL_VIF1, true);

engine/src/renderer/core/texture/renderer_core_texture_sender.cpp

@@ -58,9 +58,19 @@ texbuffer_t* RendererCoreTextureSender::allocateTextureCore(
   auto* result = new texbuffer_t;
   const auto* core = t_texture->core;
 
-  int coreWidth = core->width <= 64 ? 64 : core->width;
+  switch (core->psm) {
+    case GS_PSM_8:
+    case GS_PSM_4:
+    case GS_PSM_8H:
+    case GS_PSM_4HL:
+    case GS_PSM_4HH:
+      result->width = -128 & (core->width + 127);
+      break;
+    default:
+      result->width = -64 & (core->width + 63);
+      break;
+  }
 
-  result->width = coreWidth;
   result->psm = core->psm;
   result->info.components = core->components;
 

linux-pcsx2.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+
+get_target_elf_name() {
+    if [ -f "./Makefile" ]; then
+        grep -oP '\S+\.elf' Makefile | head -n 1
+    else
+        echo ""
+    fi
+}
+
+find_pcsx2() {
+    if [ -n "$CUSTOM_PCSX2_PATH" ]; then
+        echo "$CUSTOM_PCSX2_PATH"
+        return 0
+    fi
+
+    # Check flatpak
+    if command -v flatpak >/dev/null 2>&1 && flatpak list | grep -q "net.pcsx2.PCSX2"; then
+        echo "flatpak run net.pcsx2.PCSX2"
+        return 0
+    fi
+
+    # Check if pcsx2-qt is in PATH
+    if command -v pcsx2-qt >/dev/null 2>&1; then
+        echo "pcsx2-qt"
+        return 0
+    fi
+
+    # Check if pcsx2 is in PATH
+    if command -v pcsx2 >/dev/null 2>&1; then
+        echo "pcsx2"
+        return 0
+    fi
+
+    echo "Error: PCSX2 not found! Please install it, put it in PATH, or specify CUSTOM_PCSX2_PATH in this script." >&2
+    exit 1
+}
+
+run_pcsx2() {
+    local pcsx2_cmd
+    pcsx2_cmd=$(find_pcsx2)
+
+    local elf_name
+    elf_name=$(get_target_elf_name)
+    if [ -z "$elf_name" ]; then
+        echo "Error: Could not find target ELF name in Makefile!" >&2
+        exit 1
+    fi
+
+    local target_file
+    target_file="$(pwd)/bin/$elf_name"
+
+    if [ ! -f "$target_file" ]; then
+        echo "Error: ELF file not found at $target_file. Did you build the project?" >&2
+        exit 1
+    fi
+
+    # Kill existing PCSX2 instances
+    if [[ "$pcsx2_cmd" == *"flatpak"* ]]; then
+        pkill -f "net.pcsx2.PCSX2" >/dev/null 2>&1 || true
+        pkill -f "pcsx2-qt" >/dev/null 2>&1 || true
+    else
+        local bin_name
+        bin_name=$(basename "$pcsx2_cmd")
+        pkill "$bin_name" >/dev/null 2>&1 || true
+    fi
+
+    echo "Running PCSX2: $pcsx2_cmd -elf $target_file"
+    
+    # Run PCSX2 in the background
+    $pcsx2_cmd -elf "$target_file" &
+}
+
+run_pcsx2

template/.vscode/configurations/linux-docker/c_cpp_properties.json

@@ -0,0 +1,41 @@
+{
+    "configurations": [
+        {
+            "name": "Docker PS2SDK (Linux)",
+            "includePath": [
+                "${workspaceFolder}/**",
+                "~/ps2dev-intellisense/ps2sdk/common/include/**",
+                "~/ps2dev-intellisense/ps2sdk/ee/include/**",
+                "~/ps2dev-intellisense/ps2sdk/iop/include/**",
+                "~/ps2dev-intellisense/ps2sdk/ports/include/**",
+                "~/ps2dev-intellisense/ee/include/**",
+                "~/ps2dev-intellisense/ee/lib/gcc/mips64r5900el-ps2-elf/11.3.0/include/**",
+                "~/ps2dev-intellisense/ee/lib/gcc/mips64r5900el-ps2-elf/11.3.0/include-fixed/**",
+                "~/ps2dev-intellisense/ee/lib/gcc/mips64r5900el-ps2-elf/11.3.0/install-tools/include/**",
+                "~/ps2dev-intellisense/ee/lib/gcc/mips64r5900el-ps2-elf/11.3.0/plugin/include/**",
+                "~/ps2dev-intellisense/ee/mips64r5900el-ps2-elf/include/**",
+                "~/ps2dev-intellisense/ee/mips64r5900el-ps2-elf/sys-include/**",
+                "~/ps2dev-intellisense/gsKit/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-elf/11.3.0/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-elf/11.3.0/install-tools/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-elf/11.3.0/plugin/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-elf/11.3.0/include-fixed/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-irx/11.3.0/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-irx/11.3.0/install-tools/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-irx/11.3.0/plugin/include/**",
+                "~/ps2dev-intellisense/iop/lib/gcc/mipsel-ps2-irx/11.3.0/include-fixed/**"
+            ],
+            "defines": [
+                "_EE",
+                "_IOP",
+                "__SPU__",
+                "INTELLISENSE"
+            ],
+            "cppStandard": "c++20",
+            "compilerPath": "", // Should be empty
+            "intelliSenseMode": "linux-gcc-x86",
+            "configurationProvider": "ms-vscode.cpptools"
+        }
+    ],
+    "version": 4
+}

template/.vscode/configurations/linux-docker/settings.json

@@ -0,0 +1,14 @@
+{
+    "buildDirectory": "./",
+    "C_Cpp.default.intelliSenseMode": "gcc-x86",
+    "files.associations": {
+        "*.vcl": "asm-collection",
+        "*.i": "asm-collection",
+        "*.vsm": "asm-collection",
+        "*.vclpp": "asm-collection",
+        "*.hpp": "cpp",
+        "*.cpp": "cpp",
+        "*.h": "c",
+        "*.c": "c"
+    }
+}

template/.vscode/configurations/linux-docker/tasks.json

@@ -0,0 +1,130 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Build & run",
+            "dependsOrder": "sequence",
+            "dependsOn": [
+                "1. Copy source code to docker volume",
+                "2. Compile via docker container",
+                "3. Copy binaries to host",
+                "4. Run PCSX2"
+            ],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        },
+        {
+            "type": "shell",
+            "label": "1. Copy source code to docker volume",
+            "command": "docker exec -t tyra-game-compiler sh -c 'rsync -ac --delete --exclude=\".git\" --exclude=\".vscode\" --exclude=\"*obj*/**\" --exclude=\"*bin*/**\" /host/ /src/'"
+        },
+        {
+            "type": "shell",
+            "label": "2. Compile via docker container",
+            "command": "docker exec -t tyra-game-compiler sh -c 'cd ${config:buildDirectory} && make'",
+            "problemMatcher": {
+                "base": "$gcc",
+                "fileLocation": [
+                    "autoDetect"
+                ]
+            }
+        },
+        {
+            "type": "shell",
+            "label": "3. Copy binaries to host",
+            "command": "docker exec -t tyra-game-compiler sh -c 'rsync -zac --include=\"*/\" --include=\"*bin*/**\" --exclude=\"*\" /src/ /host/'"
+        },
+        {
+            "type": "shell",
+            "label": "4. Run PCSX2",
+            "options": {
+                "cwd": "${config:buildDirectory}"
+            },
+            "command": "./run.ps1"
+        },
+        {
+            "type": "shell",
+            "label": "Convert WAV to ADPCM",
+            "dependsOn": [
+                "1. Copy source code to docker volume"
+            ],
+            "command": "docker exec -t tyra-game-compiler sh -c 'adpenc ${input:wav2adpcmSource} ${input:wav2adpcmTarget} && rsync -zac /src/${input:wav2adpcmTarget} /host/${input:wav2adpcmTarget}'"
+        },
+        {
+            "type": "shell",
+            "label": "Cleanup",
+            "command": "docker exec -t tyra-game-compiler sh -c 'rm -rf /src/*'"
+        },
+        {
+            "type": "shell",
+            "label": "Update Tyra",
+            "command": "docker exec -t tyra-game-compiler sh -c 'rm -rf /tyra && mkdir -p /tyra && git clone https://github.com/h4570/tyra.git /tyra && cd /tyra && git checkout ${input:tyraBranch} && cd engine && make'"
+        },
+        {
+            "type": "shell",
+            "label": "Send to PS2",
+            "command": "docker exec -t tyra-game-compiler sh -c 'cd ${config:buildDirectory}/bin && killall -v ps2client || true && ps2client -h ${input:ps2Ip} reset && ps2client -h ${input:ps2Ip} reset && ps2client -h ${input:ps2Ip} execee host:$(find . -maxdepth 1 -type f -name \"*.elf\")'"
+        },
+        {
+            "type": "shell",
+            "label": "Open PS2 output logger",
+            "command": "docker stop ps2-logs || true && docker run -t --rm --name=ps2-logs -p ${input:local2Ip}:18194:18194/udp h4570/tyra sh -c 'ps2client -h ${input:ps2Ip} listen'",
+            "runOptions": {
+                "instanceLimit": 1
+            },
+            "presentation": {
+                "reveal": "always",
+                "panel": "new"
+            }
+        },
+        {
+            "type": "shell",
+            "label": "Start docker container",
+            "command": "docker compose up -d"
+        },
+        {
+            "type": "shell",
+            "label": "Stop docker container",
+            "command": "docker compose down"
+        },
+        {
+            "type": "shell",
+            "label": "[Debug] Copy obj directory to host",
+            "command": "docker exec -t tyra-game-compiler sh -c 'rsync -zac --include=\"*/\" --include=\"obj/**\" --exclude=\"*\" /src/ /host/'"
+        }
+    ],
+    "inputs": [
+        {
+            "id": "wav2adpcmSource",
+            "description": "Source file path (ex. ):",
+            "default": "res/sound.wav",
+            "type": "promptString"
+        },
+        {
+            "id": "wav2adpcmTarget",
+            "description": "Target file path (ex. ):",
+            "default": "res/sound.adpcm",
+            "type": "promptString"
+        },
+        {
+            "id": "ps2Ip",
+            "description": "PS2link ip address:",
+            "default": "192.168.1.200",
+            "type": "promptString"
+        },
+        {
+            "id": "local2Ip",
+            "description": "Local ip address:",
+            "default": "192.168.1.245",
+            "type": "promptString"
+        },
+        {
+            "id": "tyraBranch",
+            "description": "Tyra branch:",
+            "default": "master",
+            "type": "promptString"
+        }
+    ]
+}

template/linux-pcsx2.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+# =======================
+CUSTOM_PCSX2_PATH="" # e.g. "/usr/bin/pcsx2" or "flatpak run net.pcsx2.PCSX2"
+# =======================
+
+get_target_elf_name() {
+    if [ -f "./Makefile" ]; then
+        grep -oP '\S+\.elf' Makefile | head -n 1
+    else
+        echo ""
+    fi
+}
+
+find_pcsx2() {
+    if [ -n "$CUSTOM_PCSX2_PATH" ]; then
+        echo "$CUSTOM_PCSX2_PATH"
+        return 0
+    fi
+
+    # Check flatpak
+    if command -v flatpak >/dev/null 2>&1 && flatpak list | grep -q "net.pcsx2.PCSX2"; then
+        echo "flatpak run net.pcsx2.PCSX2"
+        return 0
+    fi
+
+    # Check if pcsx2-qt is in PATH
+    if command -v pcsx2-qt >/dev/null 2>&1; then
+        echo "pcsx2-qt"
+        return 0
+    fi
+
+    # Check if pcsx2 is in PATH
+    if command -v pcsx2 >/dev/null 2>&1; then
+        echo "pcsx2"
+        return 0
+    fi
+
+    echo "Error: PCSX2 not found! Please install it, put it in PATH, or specify CUSTOM_PCSX2_PATH in this script." >&2
+    exit 1
+}
+
+run_pcsx2() {
+    local pcsx2_cmd
+    pcsx2_cmd=$(find_pcsx2)
+
+    local elf_name
+    elf_name=$(get_target_elf_name)
+    if [ -z "$elf_name" ]; then
+        echo "Error: Could not find target ELF name in Makefile!" >&2
+        exit 1
+    fi
+
+    local target_file
+    target_file="$(pwd)/bin/$elf_name"
+
+    if [ ! -f "$target_file" ]; then
+        echo "Error: ELF file not found at $target_file. Did you build the project?" >&2
+        exit 1
+    fi
+
+    # Kill existing PCSX2 instances
+    if [[ "$pcsx2_cmd" == *"flatpak"* ]]; then
+        pkill -f "net.pcsx2.PCSX2" >/dev/null 2>&1 || true
+        pkill -f "pcsx2-qt" >/dev/null 2>&1 || true
+    else
+        local bin_name
+        bin_name=$(basename "$pcsx2_cmd")
+        pkill "$bin_name" >/dev/null 2>&1 || true
+    fi
+
+    echo "Running PCSX2: $pcsx2_cmd -elf $target_file"
+    
+    # Run PCSX2 in the background
+    $pcsx2_cmd -elf "$target_file" &
+}
+
+run_pcsx2

template/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+./linux-pcsx2.sh

tutorials/01-hello/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/02-sprite/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/03-minecraft/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/04-de_dust2/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/05-animation/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/06-audio/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/07-lighting/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/08-skybox-debug/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/09-manual-mode/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/10-sprite-sheet/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh

tutorials/11-texture-region-repeat/run.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+cd "$SCRIPT_DIR" || exit 1
+../../linux-pcsx2.sh