SC - WorldGate

Overview

SC - WorldGate is a premium GM-only tool for browsing other installed Foundry worlds and importing selected content into the current world.

It works through a generated snapshot. Instead of live-reading another world's database every time, WorldGate reads snapshot data that was generated inside that source world.

Supported content tabs:

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

The Compendiums tab only includes world compendium packs captured in the snapshot. System packs and module packs are not listed there.

Compatibility and Requirements

WorldGate currently supports:

• Foundry VTT v13 and v14
• GM workflow only
• source and target worlds installed on the same Foundry server
• source and target worlds using the same game system

Important behavior to know before you import:

• Source World only lists other installed worlds that share the current world's system ID.
• Import is blocked if the source snapshot was generated with a different system version than the current world.
• Import is also blocked if the snapshot does not include a comparable system version yet. In that case, open the source world and generate a fresh snapshot.

For the cleanest imports, install and activate the same supporting modules in the target world before importing. If the target world cannot interpret module-added data, Foundry may discard that data during import.

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.

After installing:

1. Enable SC - WorldGate in the world where you want to receive imported content.
2. Enable SC - WorldGate in every source world you want to browse.
3. Open each source world as a GM and generate a snapshot there.

Generate Source Snapshots

WorldGate needs a snapshot before another world can browse or import from it.

To prepare a source world:

1. Open that source world as a GM.
2. Open the WorldGate sidebar tab.
3. Click Generate Snapshot.
4. Repeat this whenever the source world changes and you want WorldGate to read the newer state.

The snapshot stores the data WorldGate needs for browsing and importing:

• folders
• world scenes, actors, items, journals, rollable tables, cards, and macros
• world compendium pack contents
• the source world's active module list
• the source world's system ID and system version

If a world shows No snapshot, this step has not been completed yet for that world.

Browse and Import Content

The main workflow happens in the WorldGate sidebar.

Tap to expand

Use the sidebar to choose a source world, browse tabs, filter entries, and build your import selection.

Basic workflow:

1. Open the WorldGate sidebar tab.
2. Choose a world in Source World.
3. Check the snapshot status shown below the selector.
4. Pick a tab such as Scenes, Actors, or Items.
5. Use the search field to filter by name, folder, or pack.
6. Select the entries you want to import.
7. Click Import Selected.

Selection helpers:

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

Snapshot status meanings:

• Snapshot: <date> means the world is ready to browse
• No snapshot means you need to open that world as a GM and click Generate Snapshot

Large imports show a Large Import confirmation before the import starts.

Conflict Handling

If WorldGate finds matching documents in the current world, it opens a conflict dialog before importing.

In WorldGate, Merge does not perform a field-by-field merge. It keeps the existing match and skips overwriting it.

Imported documents also store source-world reference data, which helps later imports match the same original document more reliably.

WorldGate also tries to preserve or repair related references where possible, including:

• folder placement
• scene token actor references
• scene journal note references
• imported journal page source references

Missing Modules and System Version Checks

If the source snapshot includes modules that are active in the source world but not active in the current world, WorldGate shows a warning panel before import.

Tap to expand

Module-added data can be missing or discarded if the receiving world does not have the same supporting modules active.

If those modules are already installed, WorldGate can open an activation dialog and reload Foundry for you.

Tap to expand

Installed missing modules can be activated directly from the dialog. Modules that are not installed are listed, but cannot be activated there.

WorldGate also checks snapshot system compatibility before import:

• System version mismatch means the source snapshot and the current world are not on the same system version
• System version could not be verified means the source snapshot needs to be regenerated before import can continue

When either warning appears, Import Selected stays disabled until the problem is resolved.

Module Settings

Open Configure Settings > Module Settings > SC - WorldGate to access WorldGate's settings and launcher entries.

The main configuration window can be opened in two places:

• the Configure WorldGate entry in Module Settings
• the sliders button in the WorldGate sidebar header

Tap to expand

The configuration window controls import behavior and which tabs appear in the sidebar.

Main configuration options:

These settings are world-level settings. The selected tab visibility is stored per world.

Batch size choices:

Folder placement modes:

Notes about WorldGate folder (WG - World Name):

• WorldGate creates a WG - World Name parent folder for that document type.
• Only three source folder levels fit below that parent folder.
• Starting from the fourth source folder layer, folders are not imported in this mode.

Separate launcher entries in Module Settings:

• Documentation opens this wiki page
• Support the developer opens the Patreon support page

Troubleshooting

A world does not appear in Source World

Check these conditions:

1. It must be another installed world on the same Foundry server.
2. It must use the same system as the current world.

If no installed world matches those requirements, WorldGate shows No compatible worlds were found.

The source world shows No snapshot

Open that source world as a GM, enable SC - WorldGate, and click Generate Snapshot once.

Import Selected is disabled

WorldGate disables import when the selected snapshot is not system-version compatible with the current world.

Read the warning panel in the sidebar:

• if it reports a system version mismatch, the source and target worlds are not on the same system version
• if it says the version could not be verified, regenerate the snapshot in the source world

Imported documents are missing data

The most common cause is a missing module in the target world.

Check the missing-modules warning and activate the same supporting modules before importing again when possible.

Imported folders are shallower than the source world

That is expected when Import folder placement is set to WorldGate folder (WG - World Name).

In that mode, only three source folder levels fit under the WorldGate parent folder.