WYVRN SDK Integration: Adding Haptics and Chroma Lighting to Your Game

Chenshuo Li · 2026-10-13 · WYVRN Ecosystem

A step-by-step guide to adding Razer lighting and haptic effects to your game with the WYVRN SDK. Get it running in Unreal, Unity or C++ with minimal code and time, no Razer hardware needed.

WYVRN SDK Integration at a Glance

New video

How the WYVRN SDK Works

For AAA Studios

For Indie Studios

The Three SDK Calls and What They Trigger

• Changing an existing effect: If you want an existing event to look or feel different, only the configuration and effect need to change. The game code stays the same. For partnered titles, the updated effect can be delivered through the Razer software without a game patch.
• Adding an effect to a new game moment: If the game does not already send an event for that moment, you need to add a new SetEventName call and define the effect linked to it. Because the game code changes, this requires a game update.

WYVRN SDK Integration Process: From Interest to Game Release

Before You Start: Razer Apps, SDK Download and Testing Without Hardware

Engine Integration: Unreal, Unity and C++

1. At startup, call InitSDK with an AppInfo struct. 0 means success; any other value means Synapse 4 or the Chroma App is missing or misconfigured. After a successful init, wait about 100 ms before the next SDK call. The SDK needs that time to open its connection to Synapse, and events sent earlier are lost.
2. Wherever gameplay should trigger an effect, call SetEventName with the event name.
3. At shutdown, call UnInitSDK.

• Title: the name shown in Synapse and the Chroma App
• Description
• Author_Name
• Author_Contact
• Category: 1 for a utility, 2 for a game[

Unreal Engine

#include "WyvrnSDKPluginBPLibrary.h"

void UMyGameInstance::Init()
{
    Super::Init();

    FWyvrnSDKAppInfoType AppInfo;
    AppInfo.Title          = TEXT("My Game");
    AppInfo.Description    = TEXT("A game using Razer WYVRN SDK");
    AppInfo.Author_Name    = TEXT("My Studio");
    AppInfo.Author_Contact = TEXT("https://mystudio.example");
    AppInfo.Category       = 2; // 2 = game

    const int32 Result = UWyvrnSDKPluginBPLibrary::WyvrnSDKInitSDK(AppInfo);
    if (Result != 0)
    {
        UE_LOG(LogTemp, Warning,
            TEXT("WYVRN init failed (%d). Check Synapse 4 and the Chroma App."), Result);
        return;
    }

    // Give the SDK 100 ms to connect to Synapse before sending events.
    // bWyvrnReady is a bool member declared in your Game Instance header.
    FTimerHandle Handle;
    GetTimerManager().SetTimer(Handle, [this]() { bWyvrnReady = true; }, 0.1f, false);
}

void UMyGameInstance::SendWyvrnEvent(const FString& EventName)
{
    if (bWyvrnReady)
    {
        UWyvrnSDKPluginBPLibrary::SetEventName(EventName);
    }
}

void UMyGameInstance::Shutdown()
{
    if (bWyvrnReady)
    {
        UWyvrnSDKPluginBPLibrary::WyvrnSDKUnInit();
    }
    Super::Shutdown();
}

Unity

using System.Collections;
using UnityEngine;
using WyvrnSDK;

public class WyvrnManager : MonoBehaviour
{
    private bool _ready = false;

    void Awake() => DontDestroyOnLoad(gameObject);

    void Start() => StartCoroutine(InitWyvrn());

    IEnumerator InitWyvrn()
    {
        if (!WyvrnAPI.IsWyvrnSDKAvailable())
        {
            Debug.LogWarning("WYVRN DLL not found. Are Synapse 4 and the Chroma App installed?");
            yield break;
        }

        var appInfo = new APPINFOTYPE
        {
            Title = "My Game",
            Description = "A game using Razer WYVRN SDK",
            Author_Name = "My Studio",
            Author_Contact = "https://mystudio.example",
            Category = 2 // 2 = game
        };

        int result = WyvrnAPI.CoreInitSDK(ref appInfo);
        if (result != RazerErrors.RZRESULT_SUCCESS)
        {
            Debug.LogWarning($"WYVRN init failed: {result}");
            yield break;
        }

        // Give the SDK 100 ms to connect to Synapse before sending events.
        yield return new WaitForSeconds(0.1f);
        _ready = true;
    }

    public void SendEvent(string eventName)
    {
        if (_ready) WyvrnAPI.CoreSetEventName(eventName);
    }

    void OnApplicationQuit()
    {
        if (_ready) WyvrnAPI.CoreUnInit();
    }
}

Native C++

#include "Razer/WyvrnAPI.h"
using namespace WyvrnSDK;

APPINFOTYPE appInfo = {};
// Fill Title, Description, Author_Name, Author_Contact, Category (2 = game)

if (WyvrnAPI::CoreInitSDK(&appInfo) == 0)   // 0 = success
{
    // Wait about 100 ms before the first event.
    WyvrnAPI::CoreSetEventName(L"Jump");      // wide string in the UNICODE build
}

WyvrnAPI::CoreUnInit();                       // at shutdown

Sending Gameplay Events: Naming, One-Shot and On/Off Events

• Names should be unique and readable. WeaponReload, not Effect3. The WYVRN team designs effects from your event list, so a name that says what happens in the game gets a better first proposal.
• Send the event on the frame the action happens. Players notice even a short delay between what they see and what they feel.

Testing and Troubleshooting

Effect Design, Review and Release

Small Work for Your Studio, Big Change for Your Players

Chenshuo Li, Immersive Experience Designer