KartPad v0.3.0-preview.4

KartPad v0.3.0-preview.4

Preview 4 adds experimental custom Mii management and experimental direct Wii
Remote/Nunchuk support on macOS. It also includes the accepted three-dot-menu
lifecycle repair and clearer fallback handling for game images stored in the
KartPad Files folder.

Experimental Mii import and management

• Game Data & Saves → Manage Miis… lists the current Mii database on Mac,
  iPhone, and iPad.
• Import accepts a standard 74-byte .mii file. Removal keeps at least one Mii.
• Changes are staged, the active database is backed up, and the replacement is
  applied atomically on the next KartPad launch.
• After restarting, select the imported Mii through Mario Kart Wii's License
  Settings → Change Mii screen.
• KartPad cannot create a Mii because it does not include the Wii Menu or Mii
  Channel.

This path passes database-format, CRC, duplicate, capacity, staging, backup,
and integration tests. A real exported Mii still needs reporter confirmation
for in-game name and appearance.

Experimental Wii Remote and Nunchuk on macOS

• Controls → Experimental Wii Remote + Nunchuk enables direct Bluetooth
  pairing without a DolphinBar.
• The pairing flow recognizes original RVL-CNT-01 and Wii Remote Plus
  RVL-CNT-01-TR hardware, confirms the physical HID connection, and hands the
  controller to SDL.
• Controller Settings includes a Wii Remote + Nunchuk (Experimental)
  preset for Mario Kart Wii input.
• Closing the pairing window cancels discovery and restores normal SDL input
  state.

The direct pairing path is macOS-only and uses private Bluetooth interfaces.
It is intended for direct community testing, not Mac App Store distribution.
Actual pairing, Nunchuk input, disconnect/reconnect, and long-session behavior
remain open until tested with physical Wii hardware. The iPhone/iPad menu entry
explains that platform boundary and does not claim direct iOS pairing.

Menu and import improvements

• The three-dot button keeps its circular appearance and ellipsis through menu
  dismissal, background/foreground transitions, and mode changes.
• Controls and Display are grouped into clearer submenus while Multiplayer,
  FPS, Game Data & Saves, and Report a Problem remain easy to reach.
• KartPad-folder import distinguishes a directory-access failure from an empty
  folder, identifies signing-container changes, and offers Choose from
  Files… as an immediate fallback.

The exact pre-release iPad candidate was installed in place, preserved the
existing KartPad data tree byte-for-byte, launched both Original Mario Kart Wii
and Retro Rewind, retained the existing license, and remained running. Those
results do not replace reporter testing of the two new experimental features.

Installation and reports

The IPA is unsigned and must be re-signed before installation. Update in place
with the same bundle identifier and signing identity to preserve game data and
saves. On iPhone or iPad, use Report a Problem…; on Mac, use Save
Diagnostics Report…. Review the bounded report before sharing it.

Never upload game images, extracted game data, a complete NAND or app
container, Retro Rewind installations, saves, signing credentials, or device
identifiers.

Distribution boundary

The IPA contains ahead-of-time translated game logic but no disc image,
extracted courses, textures, audio, Retro Rewind pack, saves, Apple signing
identity, or provisioning profile. This is a free, unofficial community preview
with unresolved upstream and game-code redistribution rights. See
RIGHTS_AND_LICENSES.md before redistributing it or expanding its release
channel.

KartPad v0.3.0-preview.3

KartPad v0.3.0-preview.3

This import hotfix responds to a remaining iPad Files-provider failure reported
after Preview 2. It retains the Original Mario Kart Wii and Retro Rewind 6.12.4
dual-mode feature set and the A-button touch lock from Preview 2.

Game-data import

• The manual picker now asks iOS to provide KartPad with a local copy instead
  of depending on open-in-place access from each Files provider.
• The picker accepts generic files, data, disk images, and folders, then relies
  on KartPad's existing disc-header, revision, and extracted-tree validation.
• Import from KartPad Folder checks .wbfs and .iso extensions before
  provider directory/package metadata, fixing disc images misreported as
  packages.
• Temporary picker copies are removed after KartPad validates and privately
  stages the game data. Files placed directly in the KartPad folder are never
  removed.

After installing, use Import from KartPad Folder for a supported PAL
RMCP01 revision 0 .wbfs or .iso already in On My iPhone or iPad ->
KartPad. The manual picker is also supported, but iOS may need enough temporary
free storage to copy a 4.7 GB ISO before KartPad imports it.

Validation boundary

The focused import contracts, repository tests, property-list checks, complete
dual-mode Objective-C++ device build, deterministic packaging, and unsigned IPA
audit pass before publication. Reporter confirmation on the exact affected
iPad and Files provider remains requested.

Installation

The IPA is unsigned and must be re-signed before installation. Update in place
with the same bundle identifier and signing identity to preserve KartPad game
data and saves.

Distribution boundary

The IPA contains ahead-of-time translated game logic but no disc image,
extracted courses, textures, audio, Retro Rewind pack, saves, Apple signing
identity, or provisioning profile. This is a free, unofficial community preview
with unresolved upstream and game-code redistribution rights. See
RIGHTS_AND_LICENSES.md before redistributing or expanding its release channel.

Do not upload game images, extracted game data, Retro Rewind installations,
saves, signing credentials, or device containers when requesting support.

KartPad v0.3.0-preview.2

KartPad v0.3.0-preview.2

This hotfix addresses the two first-launch and touch-control reports filed
against the public previews. It retains the Original Mario Kart Wii and Retro
Rewind 6.12.4 dual-mode feature set from Preview 1.

Game-data import

• Declares iOS open-in-place support to match KartPad's document picker mode.
• Creates the app's Files-visible Documents directory before first-launch UI.
• Keeps the broad picker type from Preview 3, then validates the selected
  .wbfs, .iso, or extracted DATA folder inside KartPad.

After installing, choose Choose WBFS, ISO, or DATA Folder and select your
own supported PAL RMCP01 revision 0 image. You do not need to create a
KartPad folder manually. The optional Import from KartPad Folder path is
available under On My iPhone or iPad -> KartPad.

Touch acceleration lock

• Hold A for one second. It turns cyan and remains pressed after you lift your
  finger.
• Tap A once to unlock it.
• Opening touch settings, hiding controls, backgrounding the app, or removing
  the overlay clears the lock so stale acceleration cannot survive lifecycle
  changes.

Validation boundary

The import and lock regression contracts pass, both iOS property lists pass
plutil, and the complete dual-mode Objective-C++ device target compiles. The
unsigned IPA is audited separately before publication. Reporter confirmation
on their exact iPad/File-provider combinations remains requested.

Installation

The IPA is unsigned and must be re-signed before installation. Update in place
with the same bundle identifier and signing identity to preserve KartPad game
data and saves.

Distribution boundary

The IPA contains ahead-of-time translated game logic but no disc image,
extracted courses, textures, audio, Retro Rewind pack, saves, Apple signing
identity, or provisioning profile. This is a free, unofficial community preview
with unresolved upstream and game-code redistribution rights. See
RIGHTS_AND_LICENSES.md before redistributing or expanding its release channel.

Do not upload game images, extracted game data, Retro Rewind installations,
saves, signing credentials, or device containers when requesting support.

KartPad v0.3.0-preview.1

KartPad v0.3.0-preview.1

Retro Rewind is now a major, first-class part of KartPad. This preview opens
with a dual-mode launcher for Original Mario Kart Wii or Retro Rewind and adds
the complete official-pack installation flow tested on a physical iPad.

Retro Rewind

• Choose Original Mario Kart Wii or Retro Rewind from the new opening screen.
• Download the official version-locked Retro Rewind 6.12.4 full pack directly
  through KartPad.
• Verify the pack's exact size and SHA-256 identity before installation.
• Install atomically so an interrupted or invalid install cannot replace the
  last working game data.
• Check Retro Rewind's official version feed before launch and request a
  compatible KartPad update when the ahead-of-time content profile changes.
• Launch the installed pack only after its version and critical files pass the
  current build's integrity checks.

Accepted on physical iPad

• The full official pack downloaded, verified, and installed without a crash.
• Retro Rewind launched successfully and reached a playable single-player
  match.
• The 0.3.0 build installs in place without removing existing KartPad data.
• The dual-mode chooser uses the full iPad width, and Multiplayer guidance has
  a visible Back action.

KartPad interface polish

• Replaced remaining SunPad product wording with KartPad.
• Removed obsolete experimental performance and 60 FPS menu rows.
• Moved Report a Problem into the visible main menu and linked it to KartPad's
  GitHub issue tracker.
• Fixed the three-dot menu icon disappearing briefly after dismissal.
• Reframed Multiplayer around Retro Rewind, since Nintendo's original WFC
  service is no longer available.

Online status

KartPad's online-capable graph passes login, matchmaking, a complete two-player
race, results, ratings, and lobby return against a compatible isolated WFC
service. Retro WFC, the public online service used by Retro Rewind, is currently
in maintenance and expected to remain unavailable for a period of time. Live
public online play therefore cannot be accepted until that external service
returns. This does not block Retro Rewind installation, launch, or offline play.

Installation

The IPA is unsigned and must be re-signed before installation. Supply your own
legally obtained supported PAL RMCP01 revision 0 WBFS/ISO on first launch.
Updating in place with the same bundle identifier and signing identity is the
safest way to preserve installed game data and saves.

Distribution boundary

The IPA contains ahead-of-time translated game logic but no disc image,
extracted courses, textures, audio, Retro Rewind pack, saves, Apple signing
identity, or provisioning profile. This is a free, unofficial community preview
with unresolved upstream and game-code redistribution rights. See
RIGHTS_AND_LICENSES.md before redistributing or expanding its release channel.

Do not upload game images, extracted game data, Retro Rewind installations,
saves, signing credentials, or device containers when requesting support.

KartPad v0.2.0-preview.3

KartPad v0.2.0-preview.3

This maintenance preview fixes the iPhone and iPad first-launch picker so a
supported WBFS/ISO remains selectable when a Files provider or another
installed app assigns it a different file type.

Fixed

• The game-data picker now accepts generic files and folders before KartPad
  performs its own validation. This prevents supported .iso and .wbfs
  files from appearing visible but unselectable.
• KartPad still validates the selected extension, Wii disc header, RMCP01
  region, revision, and extracted game data before activation.

Included

• The complete Preview 2 iPhone/iPad feature set: touch controls, motion
  steering, controller support, private game-data import, saves, local
  multiplayer, and the Metal runtime.
• A full ARM64 app containing the ahead-of-time translated retail executable
  graph.
• Installation guidance, provenance, rights information, and exact third-party
  license notices inside the downloadable unsigned IPA.

Distribution boundary

The IPA contains translated game logic but no disc image, extracted courses,
textures, audio, saves, Apple signing identity, or provisioning profile. This
is a free, unofficial community preview with unresolved upstream and game-code
redistribution rights. See RIGHTS_AND_LICENSES.md before redistributing or
expanding its release channel.

Known limitations

• The IPA must be re-signed before installation.
• Only supported PAL RMCP01 revision 0 game data is accepted.
• Online multiplayer passes the local Mac-to-iPad-Simulator flow, but public
  service, external-client, resilience, and physical-device acceptance remain
  open.
• Stable performance is not yet accepted across every track or device.
• Retro Rewind content is not included.

Do not upload game images, extracted game data, saves, signing credentials, or
device containers when requesting support.

KartPad v0.2.0-preview.2

KartPad v0.2.0-preview.2

This is KartPad's first downloadable unsigned IPA for iPhone and iPad. The IPA
must be re-signed before installation and still requires the user's own legally
obtained supported PAL RMCP01 revision 0 WBFS/ISO on first launch.

Included

• The K-circuit iPhone/iPad app icon and current Apple integration from main.
• A full ARM64 app containing the ahead-of-time translated 29,065-function
  retail executable graph.
• Touch controls, motion steering, controller support, private game-data
  import, saves, local multiplayer, and the current Metal runtime.
• The Personal IPA Builder, compatibility profile, deterministic cache, and
  local-build workflow introduced in Preview 1.
• Rights, installation, provenance, and exact third-party license notices
  included with the downloadable artifact.

Distribution boundary

The IPA contains translated game logic but no disc image, extracted courses,
textures, audio, saves, Apple signing identity, or provisioning profile. This
is a free, unofficial community preview with unresolved upstream and game-code
redistribution rights. See RIGHTS_AND_LICENSES.md before redistributing or
expanding its release channel.

Known limitations

• Local Apple signing remains the user's responsibility.
• Only one exact verified PAL RMCP01 revision 0 WBFS container is currently
  accepted. Other container variants, regions, and revisions fail closed until
  separately validated.
• Online multiplayer passes the local Mac-to-iPad-Simulator flow, but public
  service, external-client, resilience, and physical-device acceptance remain
  open.
• Stable performance is not yet accepted across every track or device.
• Retro Rewind content is not included.

Do not upload game images, extracted game data, saves, signing credentials, or
device containers when requesting support.

KartPad Personal IPA Builder v0.2.0-preview.1

KartPad Personal IPA Builder v0.2.0-preview.1

This is a source-code release. It does not include a downloadable IPA or
playable app.

The included profile-driven Personal IPA Builder can create a private unsigned
KartPad IPA on an Apple Silicon Mac. KartPad remains an ahead-of-time static
recompilation project: the user's supported game executable is translated
locally before Apple signing, and the personalized result must not be
redistributed.

Included

• A stable build-user-ipa.sh command for dependency bootstrap, environment
  checks, image inspection, and local unsigned IPA creation.
• A versioned PAL RMCP01 revision 0 compatibility profile separating exact
  container hashes from extracted executable identity and translation layout.
• Cache invalidation across input, profile, pipeline, and source changes, with
  disc extraction reused safely across ordinary code changes.
• Atomic extraction/runtime staging, strict DOL/REL verification, deterministic
  IPA packaging, content-safe provenance, private-path redaction, and tests for
  unsupported inputs and forbidden package content.
• A real 29,065-function ARM64 device build and two byte-identical local IPA
  packages passed the release validation. Those private packages are not
  release assets and must not be redistributed.

Compatibility

The preview accepts one exact verified WBFS image for PAL RMCP01 revision 0.
The profile format is ready for additional WBFS/ISO variants. A new container
can share this profile only after its extracted DOL and REL are proven
identical; a different game revision or region requires a separately validated
translation profile.

Known limitations

• Local Apple signing remains the user's responsibility.
• The initial dependency and full static-recompilation build are substantial.
• Online multiplayer is almost done but remains pending end-to-end testing; it
  is not claimed as working in this preview.
• Retro Rewind content is not included.

Use your own legally obtained supported image. Never upload or redistribute a
generated translation directory, app bundle, personalized IPA, game image,
extracted game data, save, certificate, or provisioning profile.

KartPad v0.1.0

First public release

KartPad’s first public source release brings the native Apple Silicon Mac, iPhone, and iPad work together around a static-recompiled ARM64 runtime, Metal rendering, mobile game-data import, touch controls, controller support, saves, local multiplayer, and reproducible Apple build tooling.

Online multiplayer is nearly complete, but it is not supported yet. The Apple transport, Retro Rewind product path, local test routing, and Mii database groundwork are in place; end-to-end matchmaking, race, resilience, and physical-device testing are still pending.

This release contains source only. It does not include Mario Kart Wii, a disc image, extracted Nintendo assets, generated game code, saves, signing material, or a playable IPA. Build from your own legally obtained supported RMCP01 revision 0 image by following the README.