t1k:playablelabs:base:networks
| Field | Value |
|---|---|
| Module | base |
| Version | 2.29.2 |
| Effort | medium |
| Tools | — |
Keywords: network adapter size ceiling, packer ad network adapters, packer network ceilings, per-network cta api, super_html shim
How to invoke
Section titled “How to invoke”/t1k:playablelabs:base:networks<network id>Packer ad-network adapters
Section titled “Packer ad-network adapters”What the packer does differently per ad network: container, size ceiling, start gate, CTA call, head/config
fragments. The data lives in src/adapters/networks.ts (SPECS -> ADAPTERS), with orientation/zip variants in
src/adapters/channels.ts. Flags and exit codes: t1k-playablelabs-base-pack. Cocos authoring side (calling
the CTA from game code, MRAID routing inside the game) is t1k-cocos-playable-sdk-core; this skill only covers
what the packer wraps around the game.
New behaviour on a network row must not change the cocos-3.8 host output: t1k-playablelabs-base-change-proof.
Registry
Section titled “Registry”ADAPTERS is built from SPECS: 27 ids at 4ee4272 (AppLovin, Meta/Facebook, Google Ads, ironSource classic +
ironsource2025, Mintegral, Unity Ads, Pangle, Moloco, Vungle, Snapchat, Chartboost, Yandex, TikTok, Liftoff,
Bigo, Kwai, Nefta, GDT, InMobi, News Break, Appier, Adikteev, AdColony, Tapjoy, Remerge, and common).
Full per-network table (container, gate, ceiling, flags, CTA): references/network-table.md.
List the live ids from the build you have: the Networks: line of the CLI USAGE (bun dist/cli.js --bogus).
Variant rows: a network selection emits its variants too (google_portrait/_landscape, gdt_*, pangle_*,
facebook_zip, nefta_zip). inmobi_zip is row-level default-off and never rides a network selection.
--network all expands to every id except defaultOff; today only ironsource (legacy dapi; the PlayableLabs
ingester maps ironsource and ironsource2025 to the same network and picks the primary html by zip member
order, so emitting both is a nondeterministic collision). --network ironsource still packs it. The
default --network is common.
Per-network constraints (fields on Spec)
Section titled “Per-network constraints (fields on Spec)”| Field | Meaning |
|---|---|
singleFile | true = index.html; false = index.zip (flat layout) |
noXhr | network forbids XMLHttpRequest in the ad (facebook, moloco) |
externalPayload | payload ships as its own archive member (snapchat, yandex); the page stays small |
archiveLimits | vendor limits on archive contents: maxIndexHtmlKb, maxMembers, warnMembers |
lazyLoad | L2 sibling members; yandex only at 4ee4272 |
scripts[].deferOn | engine hosts whose head emits defer on that <script src>. Google’s exit API (ExitApi) is deferred on web and none only, so the H5 validator counts the deferred tag; cocos-3.8 output is unchanged (at 8f7dc9d) |
startGate / audioGate | when game_ready() starts the engine; audio muting the SDK drives (ironsource rows only) |
maxSizeKb + measureMode + sizeSource | vendor ceiling, what it is measured on, the page it came from |
Size ceilings: sourced vs unknown
Section titled “Size ceilings: sourced vs unknown”Only four networks carry a ceiling, each read off a vendor page with url, date and quote in sizeSource:
facebook 4882 KB raw (open conflict, see below), google 4882 KB raw (512 files max), snapchat 4882 KB raw, yandex 3072 KB raw (index.html
<= 500 KB, <= 20 files). The other 23 publish none and the table never guesses one.
Meta/Facebook is an open conflict, not a settled ceiling. developers.facebook.com states a single HTML of 2 MB and
a zip of 5 MB; the Business help page states 5 MB; the packer ships facebook at 4882 KB. Which source is
authoritative, and whether the zip variant is the default, is unresolved (optimize-gate/references/evidence.md
open questions; base-engine-hosts/references/compat-ledger.md § Networks). Do not quote 4882 KB as the Meta ceiling
until that is resolved; for a Meta check pass the vendor number yourself. sizeVerified is DERIVED
(sizeSource !== undefined), never stored. Archive sub-limit breaches are REPORTED in
emitted[].verdict.archiveBreach, not gated, apart from the packer-owned index.html overflow.
The studio gate is --budget-kb (default 5120), applied to every network and overriding vendor ceilings
(studio decision 2026-09-22, comment in cli.ts). For a vendor-accurate check pass the vendor number yourself.
CTA call and store choice
Section titled “CTA call and store choice”The CTA is window.__PLA_CTA__, assembled by ctaShim() = CTA_PRELUDE + the row’s cta string. Each row
calls its network API when present (see the table) and otherwise __plaWarn(name) + __plaOpen(__plaStoreUrl()).
Games never call a network SDK; they call window.super_html.download().
- Store choice:
__plaStoreUrl()readswindow.super_html; UA matching/android/igivesgoogle_play_url(elseappstore_url), anything else givesappstore_url(elsegoogle_play_url). The test is the negative on purpose: an iPad reports a Mac UA and must not reach Google Play. - Open method:
__plaOpenassignslocation.hrefonly on real iOS/iPadOS (iPhone/iPad/iPod token, or Mac UA withmaxTouchPoints > 1); Android, desktop and unknown UAs usewindow.open(u, "_blank"). - Store URLs for ingest: the unity artefact carries
<!-- url -->comments with the first Play and App Store URLs found in the build’s.jssources (src/core/store-links.ts); the same URLs are reported asstoreUrls.
window.super_html compat shim (src/adapters/compat.ts, renderSuperHtmlCompat)
Section titled “window.super_html compat shim (src/adapters/compat.ts, renderSuperHtmlCompat)”Existing studio games call the super-html v5.4.0 global, so every artefact provides it on top of __PLA_CTA__:
download(url?), game_ready(), game_end(), is_audio(), is_hide_download(), appstore_url,
google_play_url. Dropping any member silently breaks the install button (no error). hideDownload is true for
networks that draw their own CTA chrome. The shim merges both ways: it survives a wholesale
window.super_html = {...} assignment by the game.
Adding or changing a network row
Section titled “Adding or changing a network row”- Read the vendor’s CURRENT page; record url + retrieved date + quote in
sizeSourceif you set a ceiling. No page, no ceiling. - Edit the
SPECSrow (data, not an if-chain); heads/config bodies go inchannel-heads.ts. - Run the packer tests (
bun test --max-concurrency=4, one suite at a time) and the engine-matrix proof (t1k-playablelabs-base-change-proof). Golden files may needUPDATE_GOLDEN=1; explain every delta.
Verified against
Section titled “Verified against”PlaybleEngine@4ee4272 (2026-10-04): src/adapters/networks.ts (SPECS, CTA_PRELUDE, defaultAllNetworkIds,
build), src/adapters/channels.ts (VARIANTS, channelsFor), src/adapters/compat.ts,
src/core/store-links.ts, src/cli.ts (budget/mode block around the verdict).
Hard rules
Section titled “Hard rules”- Source comments say 23 of 27 networks give
unknownverdicts; the pack path passesbudgetUnverified=false, so rows arepass/fail. ReadsizeVerifiedper row for “is a vendor ceiling behind this”. - A build under 5120 KB can still exceed Google/Snapchat 4882 KB or Yandex 3072 KB and bounce on upload. The Meta 4882 KB figure is an open conflict (see Size ceilings).
unitywith no store url set is a console.error no-op, not a fallback.tiktokandpangleboth callopenAppStorebut are separate outputs the ingest expects.- Mintegral/Yandex CTA and start-up contracts differ from the MRAID family: do not copy a
mraidrow for them. super_html.download(url)makes a game-supplied URL win over the configuredappstore_url/google_play_urlfor that call, so a placeholder (https://apps.apple.com/) opens the store front page onapplovin,unityand everymraid.openrow. Mintegral’sinstall()ignores the URL, which hides the bug there.- Mintegral: the container-callback gate tests
window.gameReadyonce at load; a container that defines it later is never told the game is ready. A container that defines it but never callsgameStartleaves the page black. - A single-file HTML packed with base122 boots only when decoded as UTF-8; an
iso-8859-1Content-Typeheader beats<meta charset>. Default packing is base64 (--blob-base122is the opt-in). - None of these turn a smoke row red (it supplies its own store URLs): run
scripts/audit-build.cjs(t1k-playablelabs-base-smokereferences/build-audit.md). - AppLovin on iOS: a playable opened at device volume 0 can stay silent for good (the host stubs
AudioBufferSourceNode.start); detection and the restore fix:references/applovin-ios-volume0-audio-mute.md.