Board Game Shelf Calculator

⚙ Settings

☁ Cloud sync code

Set a secret code here once, then use the ☁⬆ Save / ☁⬇ Load buttons to sync between devices. Use the same code on each device. ⚠ It's like a password — anyone who knows it can read/overwrite your data, so use 🎲 Generate for a strong one.

Each cloud save keeps the one before it — ↩ Load previous cloud save

🎯 BGG account

🔒 All of these are stored only on this device and sent only to BGG. Your BGG password is never saved — type it in the import dialog only when loading a private collection.

🔑 API key

Required since BGG's Oct 2025 "XML APIcalypse" for search & box dimension lookups (loading your own collection still works with just the session cookie). Register an application at boardgamegeek.com/applications, click Tokens, then copy the token (a long code like e3f8c3ff-…) and paste just the token below — not the word "Bearer".

🌍 Edition languages of interest

Your owned edition's flag (from your BGG collection) is always shown on the list and profile. Below, pick which other edition languages to also flag — as a flag, a discreet +, or hide (e.g. show Ukrainian as a flag, Russian as + or hidden). These also drive the language filter above the games table.

📏 Default gap between games (mm)

Prefills the "gap between games" field in Packing Results and Moving House, and is used by the Layout Editor 3D/2D views.

🌐 BGG collection XML URLs

Open these in a browser and save the pages, then import them in 📐 Fix Dimensions → XML. Uses the username from the My Games → Live API tab.

🗑 Reset collection

Wipe all games, shelves and saved layouts and start fresh. This can't be undone — make a 💾 Backup or ☁⬆ Save first.

✏️ Edit shelf / box

For tapered plastic totes that flare wider at the top — the packer lets games rest higher where it opens out. Leave blank for a straight box.

Inner usable size = outer − 2×wall per axis. With no top dims, plastic totes taper to ~88% usable bottom footprint.

🎨 Layout colour

🏠 New room

Columns = floor positions, levels = how high boxes stack. The bottom row is the floor. Too few slots for the layouts you tick? The grid grows to fit.

📏 Edit box

For tapered plastic totes that flare wider at the top. Leave blank for a straight box. The packer uses this — a game too wide for the floor can rest higher up where the tote opens out.

Wall is removed from all six faces — inner usable size = outer − 2×wall on each axis (e.g. a 100 mm wall takes 200 mm off W, D and H). Gap between games is set once for the whole layout in the Gap (mm) field at the top.

🎲 Game profile