Packs

Packs provide figures, cards, dice, decks, boards, backgrounds, translations, and game modes. The built-in core pack includes the standard playing pieces and the Chess and Blackjack modes.

Install and enable packs

Open Library from the home screen and use Import to install a .stnx pack. The Installed tab shows pack details and lets you export or remove an installation. Search by its name or identifier.

For a local or hosted world, open Game menu → Advanced options → Packs. Add an installed pack to the game, remove a pack, or reorder the active packs in the Game tab. Installing a pack makes it available on the device; enabling it makes it available to that world. Connected clients cannot change the host’s pack configuration from this dialog.

If a multiplayer server requests a missing pack, use its offered downloads or ask the host for the exact archive, then reconnect. The download must match the requested identifier.

Create a pack

Use the built-in editor or create the archive yourself. A pack is a ZIP archive with the .stnx extension. Put its contents directly at the archive root, without an extra enclosing folder. The core pack source is a complete example.

• pack.json
• Directoryfigures/

  • token.json
• Directorydecks/

  • starter.json
• Directoryboards/

  • board.json
• Directorybackgrounds/

  • felt.json
• Directorytextures/

  • Directoryfigures/

    • token.png
  • Directoryboards/

    • board.png
  • Directorybackgrounds/

    • felt.png
• Directorytranslations/

  • en.json
• Directorymodes/

  • example.json
• Directoryscripts/

  • example.luau

Only include the content your pack needs. Asset IDs are the definition filenames without .json; script references include their filename extension. Texture references are relative to textures/, while a mode’s preview path is relative to the archive root.

Identifiers and references

Setonix computes a pack identifier from the archive’s SHA-256 hash, encoded as URL-safe Base64. The core pack also has the reserved namespace core. Do not add an id field to pack.json to choose an identity.

References use namespace:item, for example core:cards or core:chess. Pack-local definitions can use local item names where the format resolves them in the containing pack. A new archive has a new identity, even when its display name and version are unchanged. Share the same exported file with every player.

Authoring reference

Pack editorCreate, install, and export a pack in the app.

Metadatapack.json fields and file types.

Figures and texturesSprite regions, card backs, variations, and dice.

DecksPlace groups of figures and boards.

Boards and backgroundsTiled boards and table surfaces.

Modes and scriptsStarting tables, teams, and Luau rules.

TranslationsLocalized content names and descriptions.