init

.github/ISSUE_TEMPLATE/1-crash-report.yml

@@ -0,0 +1,97 @@
+name: Crash / freeze report
+description: The game crashed, froze, or closed on its own.
+title: "[Crash] "
+labels: ["crash"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the report! Crashes are almost impossible to fix without logs, so please fill this in fully.
+
+        **Where to find your logs** (paste the path into the File Explorer address bar):
+        - Playing through **WheelWizard** (most people): `%APPDATA%\CT-MKWII\Recomp\UserData\Logs`
+        - Installed with the standalone setup exe: `%LOCALAPPDATA%\WiiCompiled\Logs`
+
+        Every run gets its own folder. Open the **newest** one and attach (drag & drop) `console.log` and any `crash_*.txt` file from it.
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: Before you continue
+      options:
+        - label: I'm on the latest release of WiiCompiled.
+          required: true
+        - label: I searched the existing issues and nobody has reported this crash yet.
+          required: true
+        - label: This is about the game runtime, not the WheelWizard app itself (WheelWizard problems go to their tracker - see the link on the "New issue" page).
+          required: true
+  - type: input
+    id: version
+    attributes:
+      label: WiiCompiled version
+      description: It's the very first line of `console.log` (the log you're attaching below) - it starts with `[runtime] WiiCompiled v…`.
+      placeholder: "e.g. v0.2.12"
+    validations:
+      required: true
+  - type: dropdown
+    id: when
+    attributes:
+      label: When does it crash?
+      options:
+        - During startup / before the menus
+        - In the menus
+        - When loading a race
+        - During a race (offline)
+        - During a race (online)
+        - After finishing a race / results screen
+        - Randomly / no clear pattern
+    validations:
+      required: true
+  - type: dropdown
+    id: repro
+    attributes:
+      label: How often does it happen?
+      options:
+        - Every time
+        - Most of the time
+        - Sometimes
+        - Happened only once so far
+    validations:
+      required: true
+  - type: textarea
+    id: doing
+    attributes:
+      label: What were you doing when it crashed?
+      description: Game mode, track, character/vehicle, how many players, anything you pressed right before. The more specific, the better.
+      placeholder: "e.g. Retro Rewind online room, playing SNES Mario Circuit 3, crashed right as I crossed the finish line…"
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: If you can make it crash on purpose, list the steps.
+      placeholder: |
+        1. Start the game
+        2. …
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: Drag & drop `console.log` and any `crash_*.txt` from your newest run folder here, or paste the tail end of them below.
+      render: text
+    validations:
+      required: true
+  - type: input
+    id: gpu
+    attributes:
+      label: GPU + driver version
+      placeholder: "e.g. RTX 3060, driver 560.94"
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Windows version
+      placeholder: "e.g. Windows 11 24H2"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/2-bug-report.yml

@@ -0,0 +1,91 @@
+name: In-game bug report
+description: Something looks, sounds, or behaves wrong (graphics, audio, input, online) - but the game doesn't crash.
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Where to find your logs** (paste the path into the File Explorer address bar):
+        - Playing through **WheelWizard** (most people): `%APPDATA%\CT-MKWII\Recomp\UserData\Logs`
+        - Installed with the standalone setup exe: `%LOCALAPPDATA%\WiiCompiled\Logs`
+
+        Every run gets its own folder. Open the **newest** one and attach `console.log`.
+
+        For visual bugs, a screenshot or short clip helps enormously.
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: Before you continue
+      options:
+        - label: I'm on the latest release of WiiCompiled.
+          required: true
+        - label: I searched the existing issues and nobody has reported this yet.
+          required: true
+        - label: The problem does NOT also happen on Dolphin or a real Wii (if it does, it's a game/mod issue, not a WiiCompiled issue).
+          required: true
+  - type: input
+    id: version
+    attributes:
+      label: WiiCompiled version
+      description: It's the very first line of `console.log` (see the log locations above) - it starts with `[runtime] WiiCompiled v…`.
+      placeholder: "e.g. v0.2.12"
+    validations:
+      required: true
+  - type: dropdown
+    id: category
+    attributes:
+      label: What kind of bug is it?
+      options:
+        - Graphics / visual glitch
+        - Audio
+        - Input / controllers
+        - Online / matchmaking
+        - Gameplay behaves differently than on Wii/Dolphin
+        - Save data / settings
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: what
+    attributes:
+      label: What happens?
+      description: Describe the bug and what you expected instead.
+      placeholder: "e.g. The flag textures near the start line flicker on Coconut Mall…"
+    validations:
+      required: true
+  - type: textarea
+    id: doing
+    attributes:
+      label: What were you doing? / How to reproduce
+      description: Game mode, track, and exact steps if you can reproduce it.
+      placeholder: |
+        1. Start a VS race on …
+        2. …
+    validations:
+      required: true
+  - type: textarea
+    id: media
+    attributes:
+      label: Screenshot / video
+      description: Drag & drop images or clips here (very helpful for visual bugs).
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: Attach `console.log` from your newest run folder, or paste the relevant part below.
+      render: text
+  - type: input
+    id: gpu
+    attributes:
+      label: GPU + driver version
+      placeholder: "e.g. RTX 3060, driver 560.94"
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Windows version
+      placeholder: "e.g. Windows 11 24H2"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/3-install-problem.yml

@@ -0,0 +1,75 @@
+name: Install / update problem
+description: Installing or updating WiiCompiled through WheelWizard fails, or the game won't launch at all after installing.
+title: "[Install] "
+labels: ["setup"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Where to find the setup log** (same place whether you installed through WheelWizard or the setup exe):
+        - Press `Win+R`, type `%TEMP%` and press Enter, then find `WiiCompiled-setup.log` and attach it below.
+
+        If the install finished but the game won't start, also grab `console.log` from the newest folder in:
+        - WheelWizard: `%APPDATA%\CT-MKWII\Recomp\UserData\Logs`
+        - Standalone setup exe: `%LOCALAPPDATA%\WiiCompiled\Logs`
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: Before you continue
+      options:
+        - label: I'm on the latest version (latest WheelWizard, or the latest `MarioKartWiiCompiled-Setup.exe` from the Releases page).
+          required: true
+        - label: I searched the existing issues and nobody has reported this yet.
+          required: true
+        - label: I have a legally obtained copy of the game and it works in Dolphin.
+          required: true
+  - type: dropdown
+    id: stage
+    attributes:
+      label: Where does it go wrong?
+      options:
+        - Starting the install from WheelWizard
+        - Selecting the game file (ISO/WBFS/RVZ rejected)
+        - During compilation / translation
+        - Install finishes but the game won't launch
+        - Updating an existing install
+        - Other
+    validations:
+      required: true
+  - type: dropdown
+    id: installtype
+    attributes:
+      label: How did you install?
+      options:
+        - Through WheelWizard
+        - Downloaded the setup exe myself
+        - Not sure
+    validations:
+      required: true
+  - type: textarea
+    id: what
+    attributes:
+      label: What happens?
+      description: The exact error message (copy the full text or screenshot it) and what you were doing when it appeared.
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Setup log
+      description: Drag & drop `%TEMP%\WiiCompiled-setup.log` here, or paste the tail end of it below.
+      render: text
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Windows version
+      placeholder: "e.g. Windows 11 24H2"
+    validations:
+      required: true
+  - type: input
+    id: av
+    attributes:
+      label: Antivirus (if any besides Windows Defender)
+      placeholder: "e.g. Avast, none"

.github/ISSUE_TEMPLATE/4-performance.yml

@@ -0,0 +1,79 @@
+name: Performance problem
+description: Low FPS, stutters, or the game runs worse than expected.
+title: "[Perf] "
+labels: ["performance"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Where to find your logs** (paste the path into the File Explorer address bar):
+        - Playing through **WheelWizard** (most people): `%APPDATA%\CT-MKWII\Recomp\UserData\Logs`
+        - Installed with the standalone setup exe: `%LOCALAPPDATA%\WiiCompiled\Logs`
+
+        Every run gets its own folder. Open the **newest** one and attach `console.log`.
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: Before you continue
+      options:
+        - label: I'm on the latest release of WiiCompiled.
+          required: true
+        - label: I searched the existing issues and nobody has reported this yet.
+          required: true
+        - label: I checked that nothing else was hogging the GPU/CPU (recording software, browser video, etc.).
+          required: true
+  - type: input
+    id: version
+    attributes:
+      label: WiiCompiled version
+      description: It's the very first line of `console.log` (see the log locations above) - it starts with `[runtime] WiiCompiled v…`.
+      placeholder: "e.g. v0.2.12"
+    validations:
+      required: true
+  - type: dropdown
+    id: pattern
+    attributes:
+      label: What does the problem look like?
+      options:
+        - Constant low FPS everywhere
+        - Stutters / hitches (mostly smooth, brief freezes)
+        - Only certain tracks or situations are slow
+        - Got worse after an update
+        - Slow only while recording/streaming the game window
+    validations:
+      required: true
+  - type: textarea
+    id: doing
+    attributes:
+      label: When does it happen?
+      description: Which tracks/modes, offline or online, how many players, and roughly what FPS you see.
+      placeholder: "e.g. Drops to ~40 FPS on Rainbow Road with 12 players online, fine offline…"
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: Attach `console.log` from your newest run folder.
+      render: text
+  - type: input
+    id: gpu
+    attributes:
+      label: GPU + driver version
+      placeholder: "e.g. RTX 3060, driver 560.94"
+    validations:
+      required: true
+  - type: input
+    id: cpu
+    attributes:
+      label: CPU
+      placeholder: "e.g. Ryzen 5 5600"
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Windows version
+      placeholder: "e.g. Windows 11 24H2"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/5-feature-request.yml

@@ -0,0 +1,26 @@
+name: Feature request
+description: Suggest an improvement or new feature.
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: Before you continue
+      options:
+        - label: I searched the existing issues and nobody has suggested this yet.
+          required: true
+        - label: This is about WiiCompiled itself, not WheelWizard or Retro Rewind content.
+          required: true
+  - type: textarea
+    id: idea
+    attributes:
+      label: What would you like to see?
+      description: Describe the feature and the problem it solves for you.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Workarounds you've tried
+      description: Anything you currently do instead, if applicable.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: WheelWizard problem (launcher UI, mod downloads, Mii/save management)
+    url: https://github.com/TeamWheelWizard/WheelWizard/issues
+    about: If the problem is in the WheelWizard app itself rather than the game runtime, report it there instead.
+  - name: Retro Rewind / track questions
+    url: https://wiki.tockdom.com/wiki/Retro_Rewind
+    about: Questions about Retro Rewind content (tracks, unlocks, online events) that also happen on Dolphin or console belong with the Retro Rewind project, not here.

.github/workflows/build.yml

@@ -0,0 +1,36 @@
+name: Build
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: build-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  translator:
+    name: Translator (build + test)
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Restore
+        run: dotnet restore translator/Translator.sln
+
+      - name: Build
+        run: dotnet build translator/Translator.sln -c Release --no-restore
+
+      - name: Test
+        run: dotnet test translator/Translator.sln -c Release --no-build --verbosity normal