SWEX Guide: Export Your Summoners War JSON

Every SWLens builder, calculator and account page reads one file: the JSON export of your account made by SWEX (Summoners War Exporter). This guide walks through the current SWEX on Steam, the upload to SWLens and the fixes for the errors people hit most.

SWEX is a free, open-source tool by Xzandro, used by the community since 2017. It is not made by or affiliated with SWLens — we read the file it produces.

SWEX 1.0Steam on WindowsFree & open sourceAbout 10 minutes, once
On this page9

SWEX in five steps

  1. Download SWEX from its GitHub releases page and run it as administrator.
  2. Click Start Proxy and choose Steam Mode.
  3. One time only: click Get & Install Cert (Steam) and import the certificate for the Local Computer.
  4. Launch Summoners War on Steam and log in — SWEX saves <wizard name>-<wizard id>.json in “Summoners War Exporter Files” on your Desktop.
  5. Log in to SWLens, click Import JSON and choose that file.

The detailed walkthrough below explains each step, what you should see and what to do when it doesn’t work.

What you need

Summoners War on Steam

The Steam version of the game on a Windows PC. SWEX’s Steam Mode is Windows only — no emulator needed.

SWEX 1.0 or newer

The latest release from GitHub: an installer or a portable .exe. macOS and Linux builds exist, but Steam Mode is Windows only.

Administrator rights

SWEX edits your hosts file while its proxy runs, so it needs to run as administrator — and installs a certificate once.

A SWLens account

Free to create. The upload links your game account and unlocks every tool that reads your box.

Export your JSON with SWEX

Download SWEX

Open the SWEX releases page on GitHub and download the latest release marked Latest (1.0.0 at the time of writing). For Windows there are two files:

  • Summoners-War-Exporter-Setup-1.0.0-win.exe — the installer;
  • Summoners-War-Exporter-Portable-1.0.0-win.exe — the portable version, which runs without installing.

Either works. The latest.yml and .blockmap files are update metadata — you don’t need them. Windows may show “Windows protected your PC” for a new download: click More info → Run anyway.

SWEX GitHub releases page with the Windows installer and portable downloads
SWEX GitHub releases page with the Windows installer and portable downloads

Run SWEX as administrator

Right-click SWEX and choose Run as administrator, then accept the User Account Control prompt. SWEX needs admin rights to start and stop its proxy: while the proxy runs it points the game’s servers to itself in your hosts file, and it removes that again when you stop it. If it can’t, its Logs show “Could not modify hosts file”.

Start the proxy in Steam Mode

Click Start Proxy. SWEX asks you to “Select a proxy mode”:

Steam Mode

For the Steam version of Summoners War on this PC. Choose this one and click Start.

Remote Mode

For a phone or an emulator that connects to SWEX over your network (set up as described in SWEX’s Help).

Your choice is saved as Settings → Proxy → Steam Mode, so next time Start Proxy goes straight to Steam Mode. Allow SWEX through Windows Firewall if asked.

Install the certificate (one time)

SWEX needs its own certificate trusted by Windows to read the game’s encrypted traffic. With the proxy running in Steam Mode:

  1. Click Get & Install Cert (Steam). SWEX writes the certificate to its files folder and opens the Windows Certificate Import Wizard.
  2. Choose Local Computer and click Next until the wizard finishes.
  3. Check that HTTPS mode is on in SWEX Settings (it is by default).

Manual install (fallback)

  1. In SWEX click Get Cert; it saves ca.pem in the cert folder inside your SWEX files folder.
  2. Press the Windows key, type mmc and press Enter.
  3. File → Add/Remove Snap-in → Certificates → Add → Computer account → Local computer → Finish → OK.
  4. Right-click Trusted Root Certification Authorities → All Tasks → Import, browse to ca.pem (set the file filter to “All Files”), then Next → Next → Finish.

The certificate lasts about a year, and SWEX warns you after 12 months. When it expires the game shows error H:2000: click Regenerate Cert in SWEX Settings and install the new one the same way.

Log into the game — SWEX saves your JSON

With the proxy running, launch Summoners War on Steam and log in. As your account loads, SWEX’s profile exporter saves the file and its Logs show “Saved profile data to …”. You’ll find it here:

Desktop\Summoners War Exporter Files\<wizard name>-<wizard id>.json
  • The file is overwritten each time you log in, so it is always your latest box.
  • Change the folder with Settings → Files Path → Change.
  • Want history? Turn on the profile exporter’s Timestamped copy in separate folder option.

Upload your JSON to SWLens

Log in to SWLens first — uploads are linked to your account. Then click Import JSON wherever you see it and choose your <wizard name>-<wizard id>.json file (one .json file at a time; there is no drag and drop):

Top bar
The Import JSON button next to the file chip (shown until a file is loaded). The chip shows your loaded file’s name, “No JSON loaded” or “Not logged in”.
Account menu
Click your avatar → Import JSON. Use this to re-import once a file is loaded.
Empty pages
The home dashboard (“No account data yet”), My Monsters, the tools and Rune Lens all offer Import JSON until a file is loaded.
Builders
Step 1 of every builder: “Import JSON — Import your SWEX account file to get started.”
Narrow windows & phones
Open the menu (☰) and tap Import JSON; on phones, More → Import JSON.

What happens next

  1. SWLens checks that the file is a SWEX profile export and which game account it belongs to.
  2. Your first upload links that game account to your SWLens account.
  3. The file is saved to your account (and on this device), so every device you log in from loads it.
  4. The Import Successful window confirms “Account linked & data imported” or “Data updated successfully”. On the first link it adds +2 welcome tokens and a Cairos token — each welcome token unlocks one builder run, the Cairos token one Cairos Workshop run.
  5. You land on the home dashboard with your account loaded.

Re-upload as often as you like. Exporting again and importing the same file name updates your data in place; your newest upload always wins, and your profile’s JSON history lists your recent uploads.

What your JSON unlocks

It also powers the home dashboard, your profile’s game statistics, the Artifact Calculator, the Speed Tune Calculator’s monster picker, the “owned only” filters in the Bestiary, and View my profile in RTA Lens.

Uploading from the SWLens desktop client

The SWLens Client uses the same file and the same account storage: click the gold Import JSON badge in the client’s header (“Import SWEX JSON”) or the Import JSON tile on the Account tab (“Upload a SWEX JSON file”) and choose your file. An upload from either the client or the website shows up in the other, and the client loads your newest upload when you sign in — its header shows “● synced …” once it has your data.

  • The client doesn’t capture game data itself; SWEX does. It leaves the SWEX window alone when it attaches to the game, so both can run side by side.
  • Account linking and welcome tokens work exactly as on the website.
SWLens desktop client Account tab with the Import JSON tile, welcome tokens and linked wizards
SWLens desktop client Account tab with the Import JSON tile, welcome tokens and linked wizards

Linked game accounts

Free and Basic: one game account

Your first upload links one Summoners War account. Files from a different game account are refused with “Import Failed — Account mismatch detected”.

Premium: two game accounts

Importing a second account offers Link Second Wizard. Then switch between them from the account menu or your profile. If Premium ends, the second slot is removed.

Need to change a linked account? There is no self-service reset. On your profile, use Request JSON change / wizard unlock: choose the slot, explain why (at least 10 characters) and optionally name the new account. The SWLens team reviews it; once a slot is unlinked you get an email, and your next upload links the new account. Welcome tokens are given once per game account, even on a new SWLens account.

Request a JSON or wizard change window on the SWLens profile page
Request a JSON or wizard change window on the SWLens profile page

Troubleshooting

In SWEX

No JSON file appears after logging in

Make sure SWEX runs as administrator, the proxy was started in Steam Mode before you launched the game, the profile exporter is enabled and HTTPS mode is on. If your Desktop folder is synced by OneDrive, SWEX may be unable to write there: point Settings → Files Path to a folder outside OneDrive.

The game shows error H:2000 or can’t connect

The certificate has expired or isn’t installed. Click Regenerate Cert in SWEX Settings, then install it again with Get & Install Cert (Steam) (or the manual steps above).

“Could not modify hosts file” in the Logs

SWEX isn’t running as administrator, or security software blocked it. Restart SWEX with Run as administrator; a firewall, VPN or extra antivirus can also interfere.

Get & Install Cert (Steam) does nothing

Click Get Cert once to create the certificate folder, then try again — or use the manual install steps.

“Windows protected your PC” warning

Windows shows this for new downloads. Click More info, then Run anyway. SWEX is open source — you can read its code on GitHub.

In SWLens

“Invalid JSON file. Please upload a valid SWEX export.”

The file is JSON but not a SWEX profile export. Choose the <wizard name>-<wizard id>.json file from your SWEX files folder, not a log, CSV or plugin file. In the desktop client the same problem reads “Invalid SWEX JSON — missing wizard_info / unit_list.”

Nothing happens after choosing the file

The file isn’t valid JSON (for example a partial download or a renamed file). Export it again from SWEX and upload the fresh file.

“Import Failed — Account mismatch detected”

Your SWLens account is linked to a different game account. Upload that account’s file, link a second account with Premium, or send a change request from your profile.

There is no Import JSON button in the top bar

Once a file is loaded the button moves into the account menu (click your avatar). On phones it is under More.

“Please import your JSON data first”

A builder or tool needs your account file: import it, then run the optimiser again.

Desktop client: “Your session expired” or “Could not reach the wizard validator”

Sign in again, or check your connection and retry. If it says “Cloud save failed”, the file is still loaded on this device — import it again later to sync it.

Video guides

Prefer video? These community walkthroughs cover setting up SWEX with Steam (menus may differ slightly from SWEX 1.0):

English — by Seiishizo

Français — by MaxandCS7only

Frequently asked questions

What is SWEX?

SWEX (Summoners War Exporter) is a free, open-source desktop app by Xzandro. While it runs, it reads the account data Summoners War receives when you log in and saves it as a JSON file: your monsters, runes, artifacts and account details. SWLens reads that file; SWEX is not made by SWLens.

Where does SWEX save the JSON file?

In the SWEX files folder — by default “Summoners War Exporter Files” on your Desktop — named <wizard name>-<wizard id>.json. It is overwritten every time you log into the game with the proxy running. You can change the folder in SWEX Settings → Files Path.

Does SWEX work with the Steam version?

Yes. On Windows, click Start Proxy and choose Steam Mode, install the certificate once with “Get & Install Cert (Steam)”, then launch the game on Steam. No emulator is needed. Steam Mode is Windows only.

Can I use SWEX with an emulator or a phone?

Yes: choose Remote Mode instead of Steam Mode when you start the proxy, and set up the device to use it as described in SWEX’s own Help. This guide covers the Steam method, which is the simplest.

Is SWEX safe to use?

SWEX is open source and only reads the data your game receives — it can’t change your account or play for you. Its own Help describes the ban risk as low but not zero, so use it at your own discretion. SWLens never asks for your game login: it only reads the JSON file you upload.

How do I upload my JSON to SWLens?

Log in to SWLens and click Import JSON — in the web app’s top bar, in the account menu, on any builder’s first step, or under More on phones; in the desktop client use the gold Import JSON badge or the Account tab. Choose your <wizard name>-<wizard id>.json file. Your first upload links your game account and adds 2 welcome tokens and a Cairos token.

How often should I upload a new JSON?

Whenever your runes, artifacts or monsters change — most players export before each optimisation session. Re-uploads are unlimited for your linked account, and every device you use loads your newest upload.

Can I use more than one Summoners War account?

Free and Basic accounts link one game account. Premium can link a second one and switch between them; your saved builds and locked runes stay, and each account shows its own. To change a linked account, send a request from your SWLens profile.

Why does SWLens say “Invalid JSON file”?

The file is valid JSON but not a SWEX profile export (it has no wizard_info or unit_list). Upload the <wizard name>-<wizard id>.json file from the SWEX files folder, not a log, CSV or plugin file.

The game shows error H:2000 after I start the proxy. What now?

Your SWEX certificate has expired (it lasts about a year). In SWEX Settings click Regenerate Cert, then install the new certificate again with Get & Install Cert (Steam).

Got your JSON?

Import it into SWLens and every builder, calculator and account page fills in with your own monsters and runes.