Skip to content

t1k:playablelabs:base:networks

FieldValue
Modulebase
Version2.29.2
Effortmedium
Tools—

Keywords: network adapter size ceiling, packer ad network adapters, packer network ceilings, per-network cta api, super_html shim

/t1k:playablelabs:base:networks
<network id>

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.

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.

FieldMeaning
singleFiletrue = index.html; false = index.zip (flat layout)
noXhrnetwork forbids XMLHttpRequest in the ad (facebook, moloco)
externalPayloadpayload ships as its own archive member (snapchat, yandex); the page stays small
archiveLimitsvendor limits on archive contents: maxIndexHtmlKb, maxMembers, warnMembers
lazyLoadL2 sibling members; yandex only at 4ee4272
scripts[].deferOnengine 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 / audioGatewhen game_ready() starts the engine; audio muting the SDK drives (ironsource rows only)
maxSizeKb + measureMode + sizeSourcevendor ceiling, what it is measured on, the page it came from

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.

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() reads window.super_html; UA matching /android/i gives google_play_url (else appstore_url), anything else gives appstore_url (else google_play_url). The test is the negative on purpose: an iPad reports a Mac UA and must not reach Google Play.
  • Open method: __plaOpen assigns location.href only on real iOS/iPadOS (iPhone/iPad/iPod token, or Mac UA with maxTouchPoints > 1); Android, desktop and unknown UAs use window.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 .js sources (src/core/store-links.ts); the same URLs are reported as storeUrls.

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.

  1. Read the vendor’s CURRENT page; record url + retrieved date + quote in sizeSource if you set a ceiling. No page, no ceiling.
  2. Edit the SPECS row (data, not an if-chain); heads/config bodies go in channel-heads.ts.
  3. 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 need UPDATE_GOLDEN=1; explain every delta.

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

  • Source comments say 23 of 27 networks give unknown verdicts; the pack path passes budgetUnverified=false, so rows are pass/fail. Read sizeVerified per 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).
  • unity with no store url set is a console.error no-op, not a fallback.
  • tiktok and pangle both call openAppStore but are separate outputs the ingest expects.
  • Mintegral/Yandex CTA and start-up contracts differ from the MRAID family: do not copy a mraid row for them.
  • super_html.download(url) makes a game-supplied URL win over the configured appstore_url/google_play_url for that call, so a placeholder (https://apps.apple.com/) opens the store front page on applovin, unity and every mraid.open row. Mintegral’s install() ignores the URL, which hides the bug there.
  • Mintegral: the container-callback gate tests window.gameReady once at load; a container that defines it later is never told the game is ready. A container that defines it but never calls gameStart leaves the page black.
  • A single-file HTML packed with base122 boots only when decoded as UTF-8; an iso-8859-1 Content-Type header beats <meta charset>. Default packing is base64 (--blob-base122 is 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-smoke references/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.