Shattered Codex

Wiki

Modules/SC - WorldGate

SC - WorldGate

Foundry v13-v14System Any systemPremium

SC - WorldGate

Overview

SC - WorldGate is a premium GM-only utility for moving content between worlds that live on the same Foundry server.

Instead of opening another world directly and exporting documents one by one, WorldGate lets you:

  • browse other installed worlds that use the same game system
  • read a snapshot of their content from a dedicated sidebar tab
  • select the documents you want
  • import them into the current world with conflict handling

Supported browser tabs:

  • Scenes
  • Actors
  • Items
  • Journals
  • Rollable Tables
  • Cards
  • Macros
  • Compendiums

The Compendiums tab is limited to world compendium packs captured in the snapshot. System and module compendiums are not shown there.

Installation

This module is premium.

Install access is handled through the Shattered Codex Download Hub.

See How to Download Premium Modules from the Download Hub for the full access and installation flow.

This release is still in development, so install details and delivery flow may still change before the public release build settles.

After installing:

  1. Enable SC - WorldGate in the world where you want to browse or import content.
  2. If you plan to import from other local worlds, enable SC - WorldGate in those source worlds too.
  3. Open each source world once as a GM and generate a fresh snapshot there.

Requirements

  • Foundry VTT v13 or v14
  • GM access in the current world
  • source and target worlds installed on the same Foundry server
  • source and target worlds using the same game system

For the cleanest imports, any module that adds custom data in the source world should also be installed and active in the target world before you import.

Generate a Snapshot

WorldGate reads other worlds through a generated snapshot instead of opening their database live every time.

To prepare a source world:

  1. Open that world as a GM.
  2. Open the WorldGate sidebar tab.
  3. Click Generate Snapshot.

That snapshot can include:

  • folders
  • world scenes, actors, items, journals, tables, cards, and macros
  • world compendium entries
  • source-world metadata such as active modules and comparable system version data

If a world shows No snapshot in the source selector, that world still needs this step.

Browse and Import Content

The sidebar tab is the main workflow surface.

WorldGate sidebar browsing world items

The browser groups compatible content by tab, shows snapshot status for the selected world, and lets you filter entries before importing them.

Basic workflow:

  1. Open the WorldGate sidebar tab.
  2. Choose a compatible world in Source World.
  3. Pick a tab such as Scenes, Actors, or Items.
  4. Filter by name, folder, or pack.
  5. Select the entries you want.
  6. Click Import Selected.

Selection helpers available in the sidebar:

  • Select All
  • Deselect All
  • Select Visible
  • Deselect Visible

If WorldGate detects matching documents in the current world, it asks how to handle those conflicts:

  • Merge keeps existing matching documents and imports only missing ones
  • Replace updates matching documents with the source data
  • Duplicate imports a new copy with a unique name

WorldGate also preserves important references when possible, including folder placement, scene token actor links, scene journal note references, and imported journal page source references.

Missing Modules

When the source world used modules that are not active in the current world, WorldGate surfaces a warning before you import.

WorldGate warning for modules not active in the current world

This warning is there for a reason: module-provided fields may be discarded during import if the receiving world cannot interpret them.

From that warning panel, you can review the missing modules and open the activation flow:

WorldGate activate missing modules dialog

If those modules are already installed, WorldGate can activate them and reload Foundry before you continue importing.

This matters because some documents depend on module-added structures. Importing without the same modules active can still work, but parts of the document may arrive incomplete.

WorldGate also blocks imports when it can confirm that the source snapshot was generated under a different system version than the current world.

Module Settings

The configuration app lives under Game Settings -> Module Settings -> SC - WorldGate.

WorldGate configuration window

The configuration app controls import batching, folder placement, and which content tabs are exposed in the sidebar.

Main settings:

SettingWhat it controls
Import batch sizeHow many documents are sent to Foundry per import batch
Import folder placementWhere imported documents land in the target world's folder tree
Enabled content tabsWhich browser tabs appear in the sidebar
DocumentationOpens this wiki page
Support the developerOpens the Patreon page

Batch size options:

ValueWhen to use it
25Smoother progress feedback with more round-trips
50Balanced default and recommended setting
100Faster imports with fewer progress refreshes
300Fastest batching with the least progress feedback

Folder placement modes:

ModeWhat it does
Preserve source structureRebuilds the source folder hierarchy as closely as possible in the current world.
WorldGate folder (WG - World Name)Places imports under a WorldGate-scoped parent folder for that source world.
Root (no folders)Imports documents at the root level without creating or preserving folders.

When you use WorldGate folder (WG - World Name), imported folders are scoped under a WorldGate parent folder and deep source hierarchies are trimmed after the supported depth limit.

Notes and Limits

  • Only compatible worlds that share the current system appear in the Source World list.
  • Snapshot data is read-only; if the source world changes, generate a new snapshot to refresh what WorldGate can browse.
  • The browser is designed for GM workflows only.
  • If an import finishes with missing data, the first thing to check is whether the target world had the same supporting modules active.