Jabbertoon link formats
Jabbertoon's pages read instructions from the part of a link after the # sign, which the browser never sends to a server. A link can carry a whole cartoon, a world or a game, which opens in the editor as a copy of your own, or a move or a character of your own, as a share code; it can also open a shipped move or one of the cast in 3D by name. The links of the first studio, the block editor and the character maker, which retired, still open there. This is the public edition of the link reference.
1. The rules
- Fragments only. Everything after
#stays in the browser: it is never sent to jabbertoon.com, so nothing a person makes is uploaded by sharing it. A link has keys joined by&:#p=wag&ch=dog. Values are written withencodeURIComponentwhere they need it (share codes never do). - Nothing changes until all of it is right. An unknown key, an unknown value, a damaged share code or a key given twice shows a message, opens nothing, and the page keeps working. Names are looked up as the editor's own names only:
#ch=__proto__or#ch=constructorare unknown values, not tricks. - A link is applied once. Each is taken off the address once it has opened, so a reload does not open it again.
- A link never destroys anyone's work. A world, a cartoon or a game from a link opens as a copy of your own, beside what this browser keeps: nothing kept is replaced. A character or a move from a link joins the world open on the screen.
- Move names in
#p=and#move=are the last part of a move's pack id (c4c:beh:wave_helloiswave_hello).
2. The editor, /editor/
| link | what it does |
|---|---|
#v=1&w=<code> | open that world (a cartoon, a world or a game) as a copy of your own, beside what this browser keeps |
#cartoon, #world, #game | open the ๐ฌ Cartoon, ๐ World or ๐ฎ Game tab |
#studio | open the ๐จ Forge, the one builder (the site's Make a character) |
#build=<code> | open that build in the Forge: the builder's steps (what an AI writes) or a whole build (its ๐ link) |
#build=<code>&export | open that build in the Forge with โฌ Export showing: a 3D printer's file (STL, 3MF), blueprints (SVG), glTF, Minecraft (.schem, .nbt, .mcstructure) (the AI door's export_link) |
#game=<code> | open that game in ๐ฎ Game's maker as one of your own: the game maker's steps (what an AI writes) or a whole game |
#move | a new move, in the Forge's move maker |
#move=<move> or #move=<code> | that move in the move maker: a ready move by its name, or a move's steps or blocks as a code |
#c=<code> | a move code (a block program of kind "behaviour"): it opens in the move maker; a character code: the character joins the world open here (&for=A gives that character the new look); a cartoon, a scene or a project code: the cartoon opens here, made a world of your own (ยง3) |
#ch=<id> | that one of the cast in 3D joins the world: young_woman, young_man, woman, man, older_woman, older_man, dog, cat, fox, horse, gull, bear2, fox2, rabbit2, raccoon2, cat2; or a ready character by its old name (person, kid, dog, cat, bird, monster: its 3D one) |
#p=<move>&ch=<id> | that move on that character's row, at the start (a move page's Use it in a cartoon) |
#clear | opens "Clear my things from this browser?" (it asks before it removes anything) |
&from=ai | with a cartoon's, a move's, a build's or a game's link (#c=): the editor says it was written with an AI helper. Any other value of from is refused. The editor's own link (/cartoon/#v=1&w=) takes v and w only and has no from |
3. The old pages' links: /studio/, /blocks/, /create/
The three retired pages send a visitor on to the editor with the link they came with. What each old link does now:
| old link | what it does now |
|---|---|
/studio/#c=<code> | a cartoon, a scene or a project code: the cartoon opens in the editor, made a world of your own, its cast as they looked and stood, each line when it was said; what a world has no place for yet is said, never dropped silently. A character's or a move's code opens as /editor/#c= does (ยง2) |
/studio/#ch=<template>, /create/#ch=<template> | that ready character joins the world, as one of the cast in 3D |
/studio/#p=<move>&ch=<template> | that move on that character's row |
/studio/#clear | the editor's "Clear my things from this browser?" |
/blocks/#c=<code>, /blocks/#p=<move> | that move in the Forge's move maker (a bare /blocks/ opens a new move) |
/create/#c=<character code> | that character joins the world (a bare /create/ opens the Forge) |
the rest (#ch= with &slot=, #p= alone, #look=, ?look=, #my=) | opens nothing, and says so: "This was made in the first studio, which has retired, and it could not be opened here. Make it again here, or ask an AI helper to write it again." |
A cartoon made in the first studio and kept in that browser is offered in the editor's Open, and opens here the same way. Its cartoon files (its projects, version 2, and the first cartoon files, format 1) open here too.
4. Share codes
A share code holds one of:
- a block program:
{"v": 1, "kind": "behaviour", "scripts": [...]}(a move), or of kind"scene"or"cartoon"; the format is the block language spec. Every code the block editor ever wrote stays valid; - a cartoon project:
{"format": "jabbertoon-project", "version": 2, ...}(docs/PROJECT_FORMAT.md), as the first studio's cartoon links carried it (ยง3), or a cartoon pack ({"pack": 1, "type": "cartoon", "content": {...}}); - a character:
{"type": "character", "name": "...", "content": {...}}, wherecontentis a character pack's content (the pack format, "character"). It is checked in full before anything changes; - a world:
{"v": 1, "kind": "world", ...}(docs/WORLD_FORMAT.md), or a world pack ({"pack": 1, "type": "world", "content": {...}}).
Two formats open in the editor, which reads both:
- "1." codes, which the tools write:
1.+ the raw DEFLATE of the JSON's UTF-8 bytes in base64url +.+ the CRC-32 of those UTF-8 bytes (the same number aszlib.crc32), as 4 bytes big-endian, in base64url. base64url isA-Z a-z 0-9 - _with the=padding left off. A code damaged in copying is caught by its checksum and changes nothing ("This link was damaged in copying."). A "1." code opens only when it unpacks to at most 1 MB of JSON, and never when the JSON holds a key named__proto__,constructororprototype; - older codes (no prefix): the JSON's UTF-8 bytes in base64url. They open forever. The tools still write one for a move that uses
__proto__,constructororprototypeas a setting's or a variable's name (the block language allows them, a "1." code cannot carry them), so every move the move maker accepts has a link.
The tools write the canonical JSON (keys sorted, no spaces, numbers in their shortest form; the same rule as a pack's content_hash), so the same program always gives the same code; a code made from any other JSON opens just the same. A "1." code is much shorter: a character of your own with 40 parts is 8,532 letters as an older code and 1,089 as a "1." code; a ready-made character in its look, as the first studio's "Copy a link to a character" made it, about 1,600 to 2,800 (the older code took 12,000 to 28,700).
Making a "1." code in JavaScript (a browser with CompressionStream('deflate-raw'): Chrome and Edge 103, Firefox 113 and Safari 16.4 or later; or Node 20.12, 21.2 and later):
const bytes = new TextEncoder().encode(JSON.stringify(program)); // any JSON opens
const raw = new Blob([bytes]).stream().pipeThrough(new CompressionStream('deflate-raw'));
const packed = new Uint8Array(await new Response(raw).arrayBuffer());
let crc = -1;
for (const b of bytes) { crc ^= b; for (let k = 0; k < 8; k++) crc = (crc >>> 1) ^ (0xedb88320 & -(crc & 1)); }
crc = ~crc >>> 0;
const b64 = (u8) => { let s = ''; for (const b of u8) s += String.fromCharCode(b); return btoa(s).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, ''); };
const code = '1.' + b64(packed) + '.' + b64(new Uint8Array([crc >>> 24, (crc >>> 16) & 255, (crc >>> 8) & 255, crc & 255]));
const link = 'https://jabbertoon.com/editor/#c=' + code;In Python:
import base64, json, zlib
data = json.dumps(program, separators=(",", ":"), ensure_ascii=False).encode("utf-8") # any JSON opens
pack = zlib.compressobj(9, zlib.DEFLATED, -15) # -15: raw DEFLATE, no zlib header
b64 = lambda b: base64.urlsafe_b64encode(b).decode().rstrip("=")
code = "1." + b64(pack.compress(data) + pack.flush()) + "." + b64(zlib.crc32(data).to_bytes(4, "big"))
link = "https://jabbertoon.com/editor/#c=" + codeReading one: split at the dots; put the = padding back on each part, turn - into + and _ into /, and decode base64; inflate the first part as raw DEFLATE (Python: zlib.decompress(packed, -15)), check its CRC-32 against the second part, then read UTF-8 and JSON. An older code: base64 back to UTF-8, then JSON.
An older code is still the simplest to write by hand:
code = base64.urlsafe_b64encode(json.dumps(program, separators=(",", ":")).encode("utf-8")).decode().rstrip("=")One of the cast in 3D is best linked by name (#ch=dog); a character of your own travels in its code.
What a link does not carry
A cartoon's link carries its name, its lines (the words its characters say), its moves and its characters (the cast in 3D and what was built in the Forge). It never carries a drawing, a photo or a recording: Save as a file keeps those.
5. Examples to copy
The editor's own:
- Grump, the dog, joins the world:
https://jabbertoon.com/editor/#ch=dog - Grump waves hello, from the start:
https://jabbertoon.com/editor/#p=wave_hello&ch=dog - "Wave hello" in the Forge's move maker:
https://jabbertoon.com/editor/#move=wave_hello - A new move:
https://jabbertoon.com/editor/#move - The ๐จ Forge:
https://jabbertoon.com/editor/#studio
The old pages' links, as they were made (each opens in the editor, or says in one line that the first studio retired):
- The first studio with the dog in slot B (it says the studio retired):
https://jabbertoon.com/studio/#ch=dog&slot=B - The first studio with character A doing "Sad" in line 1 (it says the studio retired):
https://jabbertoon.com/studio/#p=sadidle - The first studio with the shape characters in the Crayon look (it says the studio retired):
https://jabbertoon.com/studio/#look=crayon - The block editor with "Happy wag" (it opens in the move maker):
https://jabbertoon.com/blocks/#p=wag&ch=cat - A move, "Little hop" (
{"kind":"behaviour","name":"Little hop","scripts":[{"body":[{"amp":40,"every":0.6,"op":"hop"}]}],"v":1}), in the first studio (it opens in the move maker):https://jabbertoon.com/studio/#c=eyJraW5kIjoiYmVoYXZpb3VyIiwibmFtZSI6IkxpdHRsZSBob3AiLCJzY3JpcHRzIjpbeyJib2R5IjpbeyJhbXAiOjQwLCJldmVyeSI6MC42LCJvcCI6ImhvcCJ9XX1dLCJ2IjoxfQ - The same move in the block editor:
https://jabbertoon.com/blocks/#c=eyJraW5kIjoiYmVoYXZpb3VyIiwibmFtZSI6IkxpdHRsZSBob3AiLCJzY3JpcHRzIjpbeyJib2R5IjpbeyJhbXAiOjQwLCJldmVyeSI6MC42LCJvcCI6ImhvcCJ9XX1dLCJ2IjoxfQ - The same move as a "1." code, the format the tools write now (ยง4), in the block editor:
https://jabbertoon.com/blocks/#c=1.HctLCoAgFIXhrcQZSxREg7uGdhANrC4k5QM1IcS9Z80OH-fPOJXZQVj5kEnZ20PASM2VJhXjxc1hXbWweeViAM0Zq92ff0jtQEMnwIl9pa4dBeqd8EVlKYtAAvXlBQ.YGU_Mg - A character of its own, "Blobby", a round pink body with a face and no legs (it joins the world):
https://jabbertoon.com/studio/#c=eyJjb250ZW50Ijp7ImZvb3RwcmludCI6NjAsImhlaWdodCI6MTIwLCJraW5kIjoiY3VzdG9tIiwibGVncyI6MCwibG9vayI6Im91dGxpbmVkIiwidHJlZSI6eyJjaGlsZHJlbiI6W3siY2hpbGRyZW4iOlt7ImZhY2UiOnsiYnJvd3MiOnRydWUsImV5ZVIiOjksImV5ZVgiOjIyLCJleWVZIjotMTQsIm1vdXRoSCI6MTQsIm1vdXRoVyI6NDAsIm1vdXRoWSI6MTh9LCJpZCI6ImhlYWQiLCJwb3MiOnsieCI6MCwieSI6LTEwfSwicm9sZSI6ImhlYWQifV0sImZpbGwiOiIjZmY3YWI2IiwiaWQiOiJib2R5IiwicG9zIjp7IngiOjAsInkiOi02MH0sInJvbGUiOiJ0b3JzbyIsInNoYXBlIjp7ImgiOjEyMCwidHlwZSI6ImVsbGlwc2UiLCJ3IjoxMjB9fV0sImlkIjoicm9vdCIsInJvbGUiOiJyb290In19LCJuYW1lIjoiQmxvYmJ5IiwidHlwZSI6ImNoYXJhY3RlciJ9&slot=B - Blobby again, as a "1." code:
https://jabbertoon.com/studio/#c=1.bZBBT8QgEIX_y3jFZNtsqnL05NmLGuOB0ulCljIN0KxNw393wJqYzd7eYx7fG9hAk0_oE8gNRqI0B1tMdxBg0J4M66Zlc7Z-AAl6iYkmEODwFEHywBGdeUBLctbjwKMUEAtOG-uGgB7k55UZla6JPtCFKSksKABXfAX5VMU7yLat6gPkfXMUMHGBeeFl_vQbyCPXV82h5jELsGVFg6psMROTN_iuS66FcuBEIMfNv5n8JWC0zrG_G8cH1Xd8rSJ6GtZbiO4fIlGIxKFo1FwfY_afSmvxgM7ZOSInLnWQS12lB_5mPt451WXmejUV_-yo70v7ztFGBaUTBsg_.K6y-fw - A whole cartoon, "Hello, Mittens": Rex the dog and Mittens the cat say hello in the park, two lines (the cartoon program
{"v":1,"kind":"cartoon","name":"Hello, Mittens",...}as a "1." code), in the first studio (it opens in the editor, made a world):https://jabbertoon.com/studio/#c=1.hVE9a8MwEP0rzs1aCpm0lGTq0qVLh1LKVT5sY1snLMWOMf7vvVNxMSEli9A73sfpaQGHMYFd4KRHR1UEezTQMbc6SNSHDhOBhZIrWA147BW90VXR-ZHKYdqpXpuUyEdYZdQ2vsyEITF7-OO8UNexKTaqAbFyJAELBByy_ze6thr4kg16wpKnbBnd0IQk1A_hcDn_XqjGseHLoGFHZwXbCUf6qjVI_Dnk10mEgalmASdZeYGeWf1rDGHeaBH1mugqnd1seriR38-t7gaes-LfBCn7ULyjT0XiQuqYn_fKTyM75j_cN6g5Xv0cedpaFJw7XFU0gn1afwA.-YBR4w - The same cartoon, marked as written with an AI helper:
https://jabbertoon.com/studio/#c=1.hVE9a8MwEP0rzs1aCpm0lGTq0qVLh1LKVT5sY1snLMWOMf7vvVNxMSEli9A73sfpaQGHMYFd4KRHR1UEezTQMbc6SNSHDhOBhZIrWA147BW90VXR-ZHKYdqpXpuUyEdYZdQ2vsyEITF7-OO8UNexKTaqAbFyJAELBByy_ze6thr4kg16wpKnbBnd0IQk1A_hcDn_XqjGseHLoGFHZwXbCUf6qjVI_Dnk10mEgalmASdZeYGeWf1rDGHeaBH1mugqnd1seriR38-t7gaes-LfBCn7ULyjT0XiQuqYn_fKTyM75j_cN6g5Xv0cedpaFJw7XFU0gn1afwA.-YBR4w&from=ai
6. What a link never does
It never uploads anything, never makes an account, never asks for a name or an age, and never keeps anything outside this browser. A character or a move that arrives by a link is kept only in this browser, until "Clear my things from this browser" removes it.