Skip to content
unreal · backend · supabase

Supabase account layerKBVESupabase

A drop-in Supabase account layer for KBVE games on Unreal Engine 5 — GoTrue auth, JWT storage with auto-refresh, PostgREST helpers, storage, edge functions, and a realtime chat client, all Blueprint-friendly.

Blueprint-friendly

Every public method is a BlueprintCallable UFUNCTION and delegates are BlueprintAssignable, so auth, database, storage, and chat wire up in Blueprints as well as C++.

  • Depends on — KBVEROWS, for the ROWSupabase bridge module.
  • Config — via Project Settings.
KBVESupabasePlugin
UE 5.4+Engine
Win64 · Linux · MacPlatforms
KBVELicense

What it gives you

Features

Auth

Email/password, anonymous sign-in, magic-link OTP (email + SMS), password recovery, and full OAuth (Google/GitHub/Discord/Twitch/Apple/Azure) via PKCE and an RFC 8252 loopback flow.

Session management

Refresh-token timer (RefreshLeadSeconds before expiry), persistent per-project disk session, and automatic refresh + retry on HTTP 401.

JWT

Client-side claims decode with kbve_username hoisted from user/app metadata to match the kbve.com GoTrue Custom Access Token hook.

Storage

UKBVESupabaseStorage for upload, download, list, sign URL, remove, move, copy, and public URL helpers.

Database (PostgREST)

DbSelect / DbInsert / DbUpdate / DbDelete / DbUpsert / DbRpc plus raw RestRequest.

Edge Functions

InvokeFunction(name, body) against /functions/v1/.

Chat

UKBVESupabaseChat WebSocket client for the KBVE irc-gateway (chat.kbve.com/ws) with JWT-on-upgrade and backoff reconnect.

ROWS link

The ROWSupabase module's USupabaseRowsBridgeSubsystem hands a Supabase sign-in to ROWS and mints a ROWS UserSessionGUID.

Blueprint-friendly

All public methods are BlueprintCallable, delegates BlueprintAssignable, configured via Project Settings.

Get started

Usage

MyClass.cpp
#include "KBVESupabaseSubsystem.h"

UKBVESupabaseSubsystem* Sb = GetGameInstance()->GetSubsystem<UKBVESupabaseSubsystem>();
Sb->OnSignedIn.AddDynamic(this, &UMyClass::HandleSignedIn);
Sb->OnAuthError.AddDynamic(this, &UMyClass::HandleAuthError);

Sb->SignInWithPassword(TEXT("[email protected]"), TEXT("hunter2"));

Questions

Frequently asked

What does the KBVESupabase plugin do?

KBVESupabase is a drop-in Supabase account layer for Unreal Engine 5 games, providing GoTrue authentication, JWT storage with automatic refresh, PostgREST database helpers, storage, edge function invocation, and a realtime chat client.

What authentication methods does KBVESupabase support?

It supports email and password sign-in and sign-up, anonymous sign-in, magic-link OTP over email and SMS, password recovery, and full OAuth for Google, GitHub, Discord, Twitch, Apple, and Azure via PKCE with an RFC 8252 loopback flow, falling back to a raw-socket loopback and then a custom URL scheme deep link (default kbve://auth/callback) when the loopback cannot listen.

Is KBVESupabase usable from Blueprints?

Yes. Every public method is a BlueprintCallable UFUNCTION and delegates are BlueprintAssignable, so auth, database, storage, and chat can be wired up entirely in Blueprints as well as C++.

Discuss on the forum

Questions, fixes and notes on this page live in the KBVE forum.