Build from Source

Build from Source

Validate the engine-independent projects

dotnet restore HitTheKit.sln
dotnet test HitTheKit.sln --no-restore --configuration Release
./scripts/check-nuget-vulnerabilities.sh

Synchronize the Unity core

./scripts/sync-core-to-unity.sh

On Windows PowerShell:

./scripts/sync-core-to-unity.ps1

The generated HitTheKit.Core.dll is intentionally ignored by Git. Run the sync command after a clean checkout and whenever the core changes.

Optional macOS CoreMIDI plug-in

On Apple Silicon macOS:

./scripts/build-coremidi-plugin-macos-arm64.sh

The generated native plug-in is also ignored by Git. A missing or incompatible plug-in must fail safely to keyboard/simulated input.

Open Unity

Use Unity 6000.5.6f1 and open src/HitTheKit.Unity. Run EditMode and PlayMode tests from the Unity Test Runner before submitting a change.

Canonical technical guides

• Unity integration
• CoreMIDI plug-in build
• macOS packaging
• Windows packaging
• Release process

Public player binaries are not currently approved. Building locally does not change that distribution boundary.