Organizing Custom Tables

Where to organize

• On a phone, open the navigation drawer and tap TABLE EDITOR under Tools. On a tablet or desktop, select Custom Tables in the navigation rail, or in the Classic 6-Panel Layout (Desktop) click the Custom Tables icon button at the lower right.
• On a phone, choose the Category tab. On a tablet or desktop, choose the third icon in the left sidebar (Categories).
• Categories, icons, and translations are managed alongside your tables.

• Unlocking note:
• on Google Play, Amazon, and the Apple App Store, Custom Tables is an IAP; Itch.io and Microsoft Store include it with a higher‑priced purchase.

Meaning vs Event Focus

• Meaning Tables: give prompt words for you to interpret, and can chain to other tables.
• Event Focus Tables: decide what kind of event happens (e.g., NPC Action), often the first roll in an event workflow

Categories & icons

• Categories define icon, label, and sort behavior for table groups
• The app seeds built‑in categories from an asset file. You can restore the built-in categories with Reset Categories to Defaults in Table Settings. The categories you created are kept.
• Keep the built-in categories untouched. Add your own with the + button on the Category tab. They appear in the same list as the built-in ones, and the app has no control to reorder them.

Best practices

• Short display names; add detail in descriptions
• Swap in your preferred language. The app is available in English, Portuguese, Brazilian Portuguese, Spanish, Mexican Spanish, French, Italian, and German. Thank you, Retropunk, for the Portuguese support!

Tags and search

• Add tags to tables to improve search and grouping. An entry can carry tags only through a tags column in an imported CSV or through JSON.
• Use consistent tags for adventure arcs, biomes, factions, tones, etc.

Linking tables

• Set a link to another table or list for each entry in your table. from a specific result, immediately roll another table (or an Adventure List)
• Use Linked Tables on the Controls tab to roll one or more other Meaning Tables every time this table is rolled, unless the table uses weights. A list can be linked only from a single entry.
• Maxmium chained rolls are currently set to 10. Let me know if you think that should change.

Starter files

• Meaning templates/samples: JSON, CSV, TXT, PSV
• Event Focus templates/samples: JSON, CSV, TXT, PSV
• Categories template/sample
• Find them under the “Getting Started with Custom Tables” guide’s Starter downloads

Not supported yet

• You cannot build a weighted table by hand yet. You can import a Meaning Table CSV with result and weight columns, up to 100 rows. For tables you build by hand, use explicit ranges (1..N).

Next steps

• Get oriented and create your first tables: see “Getting Started with Custom Tables”
• Import/Export details: see “Importing & Exporting Custom Tables”
• JSON field reference: see “Custom Table Schema” and “Categories Schema”