Optional resource packs - Facebetter Docs

The SDK ships a core runtime pack resource.fbd (~7 MB) for 2D beauty, makeup, filters, and 2D stickers. Some capabilities need an optional pack. These files are not inside the iOS / Android / Web SDK. Download them at integrate time and register each one with AddResourcePack / addResourcePack before the matching setter.

Pack	Size	Required before
`resource_3d.fbd`	~9 MB	`Set3DSticker` / `set3DSticker`
`resource_body.fbd`	~8.5 MB	Pose-based `SetBodyReshape` (not `LegStretch` / `TorsoLong`)

3D stickers and body reshape require Pro+. Free can try them with a watermark. See Plans & Features.

Download them from the GitHub Release (also mirrored on the download page).

How lookup works

The engine searches the core pack plus every extra pack you add. Files are keyed by their inner relative path. Keep inner paths unique across packs — give each capability its own prefix (tddfa/…, body/…). If two packs contain the same path, the last AddResourcePack wins. Register each .fbd with a separate call. Do not concatenate pack files.

Desktop (Windows / Linux / C++)

Place resource_3d.fbd and/or resource_body.fbd next to resource.fbd. The engine loads those siblings automatically. You can still call AddResourcePack explicitly.

engine->AddResourcePack("resource/resource_3d.fbd");
engine->Set3DSticker("assets/stickers/3d/oculos.fbd");
engine->Clear3DSticker();

engine->AddResourcePack("resource/resource_body.fbd");
engine->SetBodyReshape(BodyReshape::WaistSlim, 0.4f);

iOS / macOS / Android / Flutter / Web

The mobile and Web SDKs do not embed these optional packs. Copy or fetch each file in your app, then call addResourcePack (path or bytes).

const pack3d = new Uint8Array(
  await (await fetch('/resource_3d.fbd')).arrayBuffer()
);
engine.addResourcePack(pack3d);
engine.set3DSticker('/stickers/3d/oculos.fbd');

const packBody = new Uint8Array(
  await (await fetch('/resource_body.fbd')).arrayBuffer()
);
engine.addResourcePack(packBody);
engine.setBodyReshape(BodyReshape.WaistSlim, 0.4);

2D stickers still use setSticker only. addResourcePack is for capability models, not sticker assets.

Call addResourcePack once per extra pack after the engine is created (Web: after init()). Later 3D stickers or body-reshape calls reuse the same pack.

​How lookup works

​Desktop (Windows / Linux / C++)

​iOS / macOS / Android / Flutter / Web

How lookup works

Desktop (Windows / Linux / C++)

iOS / macOS / Android / Flutter / Web