Deployment

Dependencies

Windows Standalone

OPTIONAL: If using XInput or Direct Input, the DirectX End-user Runtimes (June 2010)from Microsoft may need to be installed. You should include this runtime in your game installer. This is not necessary if only using Raw Input or Unity input.

If XInput is enabled, Rewired can use any of these versions of XInput if they are installed on the system:

XInput_1_4.dll
XInput_1_3.dll
XInput_1_2.dll
XInput_1_1.dll
XInput_9_1_0.dll

Windows Vista, Windows 7, Windows 8, and Windows 10 all come with a version of XInput pre-installed.

If using Direct Input, the Visual C++ Redistributable for Visual Studio 2015, 2017, and 2019 must be installed.

SDL2

If you are using SDL2 as the input source (optional) on any platforms, you must include the appropriate SDL2 libraries in your build package, unless you know the target operating system already provides this library (eg: SteamOS). The library you include and the location in your package in which to place it depends on the target platform and architecture. Failure to include the SDL2 libraries will result in an error being logged and input falling back to Unity input as the source.

The latest libraries for Windows and OSX can be obtained at the SDL2 website.

Windows:

No special steps are required for Unity 5.x+.

Direct Input on Unity 4.x:
The free version of Unity 4.x does not support native plugins. A native plugin is required to use Direct Input (optional) as the primary input source on the Windows Standalone platform. If you want to use Direct Input, you will need to manually copy the DLL from Assets/Plugins/x86/Rewired_DirectInput.dll file into the root folder of your project (above the Assets folder). After you make a build, you will need to copy the appropriate Rewired_DirectInput.dll file for your chosen architecture (x86 or x64) into a folder called Plugins inside the build folder. This is a hack to get around the Unity 4.x native plugin limitation. Unity 5.x+ does not require this hack.

OSX: The SDL2 website does not include an SDL2 bundle, which is the format that Unity requires if you are to include a native OSX library in the Unity project's Plugins folder. You will either have to build the bundle manually, or use the bundle included with Rewired.

Linux: To include SDL in the game build, you must place the libSDL2-2.0.so.0 file in same location as the executable game file. Placing the library in the data folder in Plugins, Plugins/x86, Plugins/x86_64 or Mono or its sub-directories will not work. For 32-bit builds, you must copy the library in the Plugins/x86 folder and for 64-bit builds, copy the library in the Plugins/x86_64 folder.

Rewired includes pre-built SDL2 libraries for each platform, but they must be installed manually through the menu option:

  • Window -> Rewired -> Setup -> Install Libraries -> SDL2

For Linux, after installing the libraries above, you can copy the libSDL2-2.0.so.0 file from the Assets/Plugins/x86 or Assets/Plugins/x86_64 folder. Unity will automatically copy the Windows and OSX libraries on build to the right locations.

NOTE: Unity 4.x free does not officially allow you to include native libraries while Unity 5+ does. There are workarounds available for Unity 4.x that involve placing the library in the root folder of your editor project and manually copying the library to your final game build. The exact procedure depends on your target platform. There are resources available by searching the Unity forums. Or contact support for more information.

 


Build Minimum OS Version Requirements

 

Windows Standalone  
Raw Input Unity base requirements
Direct Input Windows 10 version 1803 (Build 17134)
Windows Gaming Input Windows 10 version 1809 (Build 17763)
   
Windows Universal  
Native Windows 10 version 1709 (Build 16299)
   
MacOS  
Native Unity base requirements
Game Controller Framework MacOS 10.11
   
Linux  
Native Ubuntu 12.04