Pick only the Nookara blocks you need

The Nookara extension has grown to over 500 blocks. You can now add a small Nookara Login extension and only the add-ons your project uses.

The extensions

Adding them in TurboWarp or PenguinMod

1. Click Add Extension, then Custom Extension.
2. Paste the Nookara Login URL from the table and turn on Run without sandbox.
3. Do the same for each add-on you want. Sign in once with the Nookara Login blocks and every add-on is signed in.

Moving a saved project

The project converter takes a project using the old extension and gives you a copy that uses the new ones, with only the add-ons it needs. It runs in your browser and nothing gets uploaded. Keep your original until you've tried the copy.

Making your own add-on

Add-ons reach the sign-in through the runtime. There's nothing on window, and your add-on should look it up each time because Nookara Login may load after it.

const nookara = Scratch.vm.runtime.ext_ikelenenookaralogin?.api;
if (!nookara || nookara.version !== 1) throw new Error('Add the Nookara Login extension');

const token = nookara.getToken();                  // null when signed out
const data = await nookara.http('/currency/balance');
nookara.requireScope(8192);                        // throws with a helpful message
nookara.on('login', () => { /* signed in */ });
nookara.on('message', frame => { /* every Nookara socket frame */ });

• Reading: getToken, getUser, getUsername, getScopes, getDisabledScopes, getAccount, isAuthenticated, isConnected.
• Requests: http returns the JSON, cmd also throws on errors and sets the latest operation result, request does that for the chat routes with scope checks.
• Socket: ensureSocket, send, and on with message, binary, connect, disconnect, login or logout. on returns a function that stops listening.

Treat the token like a password: only send it to Nookara. The add-on uses the permissions of the app the person signed in with, so an add-on can't ask for more than that app did.

Questions