Skip to content
unreal · web · ui

Web content on 3D surfacesKBVEWebSurface

A game-agnostic Unreal Engine plugin that renders interactive web content onto world surfaces — flat panels, curved or holographic meshes, and drop-in terminal, kiosk, billboard and hologram actors — built for reuse across KBVE titles and external Fab distribution.

CEF is expensive

The plugin ships a per-surface frame-rate cap (30 fps default), offscreen pause, snapshot fallback at distance, and a UKBVEWebSurfacePool cap on concurrent live surfaces (8 by default).

  • Good for — marketplaces, social screens, admin terminals, billboards.
  • Not for — combat HUDs, per-NPC labels, hundreds of objects.
KBVEWebSurfacePlugin
UE 5.6+Engine
Win64 · Linux · MacPlatforms
MITLicense

What it gives you

Features

Flat panel

UKBVEWebSurfaceComponent wraps a UWidgetComponent with an embedded UMG WebBrowser.

Curved / holographic

UKBVEWebRenderSurfaceComponent pipes the browser through a render target onto an arbitrary mesh + material.

Drop-in actors

AKBVEWebTerminalActor (frame mesh, surface, auth hook), AKBVEWebKioskActor (15 fps, snapshot fallback), AKBVEWebBillboardActor (non-interactive, rotating URLs), AKBVEWebHologramActor (render-target variant) and the minimal AKBVEWebSurfaceActor.

Input

UKBVEWebInteractionComponent drives flat-surface input, UKBVEWebFocusComponent owns the focus lifecycle, and UKBVEWebTerminalPromptComponent raises a distance-based approach prompt.

Bridge

UKBVEWebBridge is bound into the browser with BindUObject. Pages call window.kbveBridge.dispatch(channel, payload) and the bridge re-broadcasts via OnMessage; Push sends the other way. KBVEWebChannels names the shared channels (terminal.ready, auth.refresh, market.purchase, ...).

Auth

IKBVEWebAuthProvider is the pluggable token source, with Anonymous and Static providers shipped.

Performance

Per-surface MaxFrameRate, bPauseWhenOffscreen, SnapshotDistance fallback, UKBVEWebLODManager distance/frustum LOD, and a UKBVEWebSurfacePool cap on live surfaces. UKBVEWebSurfaceSettings holds the URL allow/deny list and project defaults.

Backend

The default backend wraps Unreal's stock UWebBrowser (CEF). Alternate backends (Ultralight, WebUI) plug in via IKBVEWebBackend as separate plugins.

Fit & anti-fit

When to use it

Use cases

  • Marketplace / auction house
  • Account, guild, social screens
  • Admin and debug terminals
  • Patch notes, news boards
  • In-world interactive billboards and kiosks

Anti-use cases

  • Combat HUD, health bars, minimap — use Slate/UMG.
  • Per-NPC labels, shop signs, hundreds of world objects — too expensive per surface.

Questions

Frequently asked

What is the KBVEWebSurface plugin?

KBVEWebSurface is a game-agnostic Unreal Engine plugin that renders interactive web content onto world surfaces — flat panels, curved or holographic meshes, and drop-in terminal, kiosk, billboard and hologram actors — for reuse across KBVE titles and external Fab distribution.

How does input work on a web surface?

Flat surfaces take input through UKBVEWebInteractionComponent, a pre-configured WidgetInteractionComponent, with UKBVEWebFocusComponent handling the mouse cursor and GameAndUI focus. UKBVEWebInputRouter, the older UV-to-pixel helper, is deprecated and kept only for curved-mesh math.

When should you not use KBVEWebSurface?

Avoid it for combat HUDs, health bars, and minimaps — use Slate or UMG instead — and for per-NPC labels, shop signs, or hundreds of world objects, where a CEF surface per object is too expensive.

Discuss on the forum

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