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.
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.