How to use Lyutils & Lyoda

Lyutils

The website at Lyutils stores your game data locally so pages load quickly and you can buy from shipments, manage loadouts, and review guild TB history without opening the game client for every check.

Getting started — sign in & link your account

Lyutils uses a two-step account setup. Both steps are required before shop, loadouts, and most other tools work.

Step 1 — Sign in with Discord

1. 1
   Open the welcome page and click Continue with Discord.
2. 2
   Approve the Discord authorization. You are redirected back to Lyutils and signed in.

Step 2 — Link your SWGOH account

1. 1
   Go to Settings → Connection and click Link account, or open Profile → Connection directly.
2. 2
   Enter the email address tied to your SWGOH / EA account and submit.
3. 3
   Check your inbox for a one-time verification code, enter it on Connection, and confirm.
4. 4
   Click Fetch player data to pull your roster, currencies, and inventory into Lyutils.

To add an alt later, open Accounts and use New account (up to 3 SWGOH accounts per Discord login). After each account has been fetched at least once, Discord /change account can switch among them.

Navigation

After sign-in, the top bar is split into main sections:

• Player - Inventory, Loadouts, Shipments, Bronzium, Farm, Datacrons, Datacron planner, GAC locked roster, and Energy. The Player button opens this dropdown; pinned shortcuts can also appear in the top bar (see below).
• Territory Battle - current TB round. History on that page opens guild statistics.
• GAC — Grand Arena attack planner for the current (and past) match.
• Conquest — current Conquest event progress, sector feats, and keycards.
• Guide — this documentation.
• Refresh icon (circular arrow, top right) — re-fetches player data from the game without opening Settings. On Home, cards update progressively as each stage finishes. Available once your SWGoH account is linked.

Your Discord avatar and name appear on the right. The name next to the avatar is the active SWGOH player name once an account is linked. Use the dropdown for Profile, Accounts, Settings (SWGoH connection, Patreon, Lyoda channel), or Sign out. A red badge on the avatar means you have notifications such as Free energy (timed free energy ready to claim — opens Home).

Player menu layout (reorder and main bar)

On desktop, the navbar layout is: Lyutils | Player | divider | pin zone (dashed outline when empty) | divider | GAC, Territory Battle, Conquest, Guide. You customize Player page order and main-bar shortcuts directly in the navbar — there is no separate menu-order screen in Settings.

• Reorder in the dropdown — open the Player menu, click and hold a page link, drag a few pixels to start, then move it up or down among the other items. Release to drop. The new order saves automatically.
• Pin to the main bar — drag an item from the dropdown into the pin zone (between Player and GAC). Pinned pages appear as one-click links in the top bar.
• Reorder or unpin on the main bar — drag pinned links left/right within the pin zone, or drag them back into the dropdown to unpin.
• Mobile — all player pages stay inside the Player submenu; reorder, pinning, and drag-and-drop are desktop-only (from about 961px width).

Configure free-energy DMs and auto claim under Player → Energy (see Energy).

Home

The home page is your dashboard. If SWGOH is not linked yet, you will see a short onboarding card with a link to Connection.

Once set up, Home shows:

• A player snapshot - name, guild (with join date), galactic power, ally code, and last sync time.
• Quick links — tiles for player pages you have starred with the ☆ next to their title. Drag the grip on a tile to reorder; order is saved automatically. If nothing is starred, this section is hidden.
• Free energy — when a timed free-energy window is open and you have not claimed yet, Home shows a modal: Accept claims all free energy types, Dismiss hides the alert until the next window. Windows open 12h / 6h / 3h before your daily challenge reset (see the times under Player → Energy). After a Home refresh, the modal and avatar badge update if energy becomes claimable. You can also enable Lyoda DMs or auto claim per window on the Player → Energy page.
• Upcoming events — site-wide in-game schedule. Any linked player’s Home/Profile refresh that pulls game_event publishes it for everyone; you do not each need your own sync for the calendar.
• Arena ranks — Squad, Fleet, and Coliseum leaderboard positions when available.
• Grand Arena - division, skill rating, rank, current phase, opponent, and live scores when a round is active. Opponent name links to their swgoh.gg GAC history. To compare summary stats vs your current opponent in Discord, use /compare gac (see Lyoda commands).
• Territory War — current TW matchup summary when data is available.

Star a page from its title bar on Shipments, Farm, Loadouts, Inventory, or Profile to add it to Quick links. Use the navbar Full sync on Home to refresh player data (roster, inventory, energy, events, and related snapshots).

Inventory

Player → Inventory shows a read-only overview of what Lyutils last synced from your account:

• Currencies — premium, common, and event currencies with quantities.
• Materials — gear pieces, relic materials, and similar items.

The footer shows Last synced with the timestamp of your most recent player data fetch. Use the navbar refresh button, the navbar Full sync control, or Profile → Connection → Fetch player data to update.

Loadouts

Player → Loadouts lets you save mod setups from the game and equip them later in one action.

Create a loadout

• Click the + New loadout card.
• Give it a name. Saving with an existing name replaces that loadout.
• Either toggle Include all characters with mods, or search and select any number of specific characters (no character-count limit on the website). Discord /create_loadout still allows at most 5 toon names.
• Optional: enable Refresh game data to pull the latest mods before capturing.
• Confirm to save. Lyutils reads currently equipped mods from the game for the selected characters.

Practical example: raids

• Create a base loadout with mods for all your characters.
• Log into the game and mod Tarkin and Scorch.
• On Lyutils (or with the Lyoda bot), create a new loadout that contains only these two characters' mods.
• Log into the game and complete the Tarkin–Scorch raid battle.
• Mod Jedi Master Mace Windu, Depa Billaba, and Temple Guard.
• On Lyutils (or with the Lyoda bot), create a new loadout that contains only these three characters' mods.
• Log into the game and complete the JMMW, Depa, TG raid battle.
• Restore your base loadout using Lyutils or Lyoda.

Manage loadouts

• Drag the handle on a card to reorder loadouts.
• Edit (pencil) — change name, character selection, or refresh data.
• Delete (trash) — remove the saved loadout.
• Equip — preview mod moves, then confirm to apply the loadout in-game. Equipping can take a moment; the page shows progress.
• Each card shows how many characters are in the loadout. For specific selections, up to four portraits appear; if there are more, a +N badge shows the rest (for example +2).

Shipments

Player → Shipments mirrors your in-game shipment stores. You can browse, search, filter, and buy items directly from the browser.

Refreshing shop data

Shipment data is cached so the page loads fast. You control when to pull fresh data from SWGOH:

• Use the navbar Full sync button to refresh shipments with the rest of your player data.
• Lyutils fetches the latest shipments from the game. This may ask for email verification if your session expired.
• Under the title you will see Last synced with a time stamp. Labels like (cached) or (expired) explain whether the data is still valid.
• When the in-game shop has rotated, a yellow warning appears - use the refresh button to load current items.
• Refreshing also converts leftover 7-star character shards and ship blueprints into Shard Shop currency, same as opening the Shard Store in the game. The same conversion runs immediately whenever an action credits character or ship shards (shipment buys, Bronzium, farm, Galactic War, challenges, and quest claims).
• Next refresh shows when the active tab's store is scheduled to rotate in the game.

Shipment tabs

Each tab corresponds to a shipment store (Featured, Weekly, Cantina, Galactic War, Guild Events, Mod store, etc.). Your available currency for the active tab is shown at the top of the item grid.

Search

• Use the search box above the items. It searches across all tabs.
• Type at least 3 characters to start filtering by item name.
• While searching, matching items from all tabs can appear together so you do not have to hunt tab by tab.
• If nothing matches, you will see No items match your search.

Crystal filter

• Next to the search box is a crystal icon toggle.
• Dimmed / grayscale icon — crystal-cost items are shown (filter off).
• Full-color icon — crystal-cost items are hidden on the active tab (filter on).
• The filter applies to the current shipment tab and during search across tabs. Your preference is saved to your account.

Favorites tab

• If any of your Farm item cards appear in the current shop, a ★ Favorites tab is shown.
• It lists only those favorited items that are buyable right now, across all shipment types.
• Add items on Farm with New farm, then check Shipments' Favorites tab during refreshes.

Buying items

• Click Buy on an affordable item. A confirmation dialog shows the cost before anything is spent.
• Purchased items are marked with a check. Locked or already-bought items cannot be bought again until the store refreshes.
• Some tabs offer Spend all — this spends your currency on eligible fleet and character shards in that store in one go, with a confirmation step.

Spend all

Spend all is available on these shipment tabs:

• Cantina Battle — buys affordable fleet and character shard offers. Ship shards first, then character shards. Gear and other items are skipped.
• Galactic War — buys affordable fleet and character shard offers. Ship shards first, then character shards. Gear and other items are skipped.
• Squad Arena — buys affordable fleet and character shard offers. Ship shards first, then character shards. Gear and other items are skipped.
• Guild Events — spends Mk I Guild Event Tokens on character and ship shards that cost exactly 400 tokens each. Ship shards are bought first, then character shards. Gear, Mk II/Mk III tokens, and shards with other prices are skipped.

Farm

Player → Farm is your farming hub. Keep the characters, ships, gear, materials, and mod shop filters you care about on one page, then search for campaign nodes and current shipment offers — and buy or simulate from the results.

The header shows your main energy pools (normal, ship, cantina, mod — and conquest when that event is active). If your SWGOH account is linked, tap an energy badge to buy a refill with crystals when purchases remain today.

Add a New farm card

Click the dashed New farm card. A dialog opens with three tabs:

Material

1. 1
   Open the Material tab.
2. 2
   Search by name. Optional chips filter All, Gear, Material, Relic material, or CQ material.
3. 3
   The table shows name, how many you own, and type. Select a row, then Add.

Toon

1. 1
   Open the Toon tab.
2. 2
   Type a character or ship name in Search. Use the Character / Ship chips to narrow the list.
3. 3
   Click Select on the row you want, then Add.

Mod

1. 1
   Open the Mod tab to create a mod shop filter that lives on Farm.
2. 2
   Give it a name (also useful for the Lyoda /buy_mods command).
3. 3
   Optionally pick shapes and sets. Leave a group empty to allow any value.
4. 4
   Choose primary and secondary stats. A mod matches if its primary is one of yours and it has at least one selected secondary.
5. 5
   Optional: add stat filters (stat, operator, value). All of them must match. Then Add.

Manage cards

• Search (magnifier) — find farm locations and shop offers for that item, or matching mods for a mod filter.
• Edit (pencil) — replace an item target, or change a mod filter's criteria.
• Delete (trash) — remove the card from Farm after confirmation.
• Drag handle — reorder cards; the order is saved automatically.

Search item cards (toon & materials)

• Click Search on an item card. Lyutils refreshes lean player data and shipments when needed, then opens the Result panel.
• Campaign cards — location title and a battle / simulate control (energy cost on the button). Linked accounts can simulate battles and refresh hard-node attempts when capped.
• Shop cards — titled by shipment (for example Guild Activity). Identical offers in the same shipment are grouped on one card with separate amount + buy rows.
• Use the crystal icon in the Result header to hide crystal-cost offers. Mixed cards keep non-crystal rows visible.
• Buy asks for confirmation (shipment name in the title, currency icon + price together). Purchased rows are marked Already purchased.
• Result currency badges show balances used by the offers; energy stays in the Farm header.

Search mod filter cards

• Click Search on a mod filter card. Matching mods from the current mod shop appear in a separate Result panel.
• Buy one mod at a time, or Buy all when two or more matches are available.
• Already-purchased mods are skipped. If search fails, open Shipments → Mods and use navbar Full sync.

Quick links

Click the ☆ next to the Farm title to add Farm to your home page Quick links.

Profile

Open Profile from your avatar dropdown in the top-right corner. It shows a public-profile style card for the active SWGOH account and refreshes when you open the page (no game login required for that fetch).

Sections include identity, Grand Arena (league, division, skill rating, rank), roster ratings, mods, relics, and datacrons. GAC league/division and rank also pull from your latest authenticated sync when available, so they match the home GAC card more closely.

Profile is not in the Player menu; open it from the avatar dropdown. To switch which character this page describes, use Accounts.

Accounts

Open Accounts from your avatar dropdown in the top-right corner. One Discord login can hold up to 3 SWGOH accounts (main plus alts). Farm cards, loadouts, energy settings, and roster data are stored per account. The navbar name next to your Discord avatar is always the active player.

Accounts is not in the Player menu; open it from the avatar dropdown.

Website

Each linked account is a card (player name, guild, ally code). The current one has a green Active label.

• Switch - click a card. Lyutils runs a full player sync for that account (modal title: Switching to <player name>).
• New account - dashed card when you have fewer than 3. Same email + OTP flow as the first link, using the alt's SWGOH / EA email.
• Remove - unlinks that SWGOH account from your Discord login. Loadouts, GAC plans, and farm settings stay in the database so another Lyutils user (or you later) can pick them up by linking the same game email. JSON player cache files on disk are deleted and rebuilt on the next sync. Does not delete the in-game account.

A SWGOH / EA email can be linked to only one Discord login at a time. While it stays linked, nobody else can add that game account as an alt or as their main account. The previous owner also cannot take it back as a main account until the current owner uses Remove. After Remove, the same email can be linked again.

To re-authenticate, disconnect, or check last sync time for the active account, use Settings → Connection. Use Connection to finish email/OTP linking or fetch player data.

Discord

After an account has been fetched on the website at least once (so it has a player name), it appears in Lyoda.

• /change account with player (autocomplete) switches the active SWGOH account on Lyutils.
• The current account is marked with ✓ and listed first.
• This only switches. It does not full-sync. The next bot command (for example /inventory or /me) uses the newly selected account.

Add or fetch alts on the website first. An alt that is linked but never fetched will not show up in the autocomplete.

Energy

Open Player → Energy in the navbar (or the Energy item in the Player dropdown). These are your time windows when free energy is available to claim. Columns follow your daily challenge reset (12h / 6h / 3h before reset), shown in local site time. Each toggle saves per window.

• Send Lyoda DM - when that window opens and energy is claimable, Lyoda sends you a Discord DM with Claim / Dismiss. Claim claims all free energy types; Dismiss hides the alert for that window.
• Auto claim - when that window opens and energy is claimable, Lyutils claims free energy automatically. Discord is not required for this path. Timing depends on More / Less below. Claiming energy breaks your current in-game connection.
• If both are on for the same window, energy is claimed automatically and Lyoda DMs a short “claimed” result - no Claim / Dismiss buttons.
• More shows extra options per window: Delay (min) (0 to 115) and Repeat on every (weekdays). Delay 0 still waits about 10 seconds. If no days are selected, that window never fires.
• Less hides Delay and Repeat on every. The saved values stay, but they are ignored: Auto claim / Lyoda DM run every day, with the short ~10 second delay (not your saved minutes). Click More again to reuse the saved delay and weekdays.
• Needs a linked SWGoH account and reasonably fresh player sync so Lyutils knows when a window is open.

Manual Claim free energy is still available on Home (Accept) and via /claim free_energy in Discord.

Settings

Open Settings from your avatar dropdown in the top-right corner. The left sidebar switches between Connection, Patreon, and (for officers) Lyoda. See Patreon / Supporter for how membership unlocks work.

Connection

• SWGoH account status — shows whether your game account is linked.
• Last synced — timestamp of your most recent player data fetch (when linked).
• Re-authenticate — clears stored login credentials and restarts the email/OTP flow when your game session expires.
• Disconnect — removes stored auth data (email, auth ID, session cookies) from Lyutils. Synced player data stays on the account until you link again.
• Link account (when not linked) — opens the Connection page for the email + OTP setup flow.

After linking, use Profile → Connection or the navbar refresh / Full sync to fetch player data. Player menu layout (pinning and reorder) is done in the navbar itself — see Player menu layout.

Lyoda

Visible to officers (and site staff/superusers). Set the Discord channel ID where Lyoda should post guild event notifications. This is guild-wide, not a personal free-energy DM setting — personal free-energy DMs use Player → Energy.

SWGoH linking

First-time linking and OTP verification happen on Profile → Connection (also reachable via Settings → Connection → Link account when not linked). Ongoing account management — status, last sync, re-authenticate, disconnect — lives under Settings → Connection.

• Link SWGoH account — email + OTP flow for first-time setup.
• Fetch player data — on the Connection page after linking; downloads roster, inventory, arena info, GAC state, and related data.
• Re-authenticate — from Settings → Connection when your game session expires.
• Disconnect — from Settings → Connection; clears stored auth credentials.

Datacrons

Open Player → Datacrons to browse the datacrons on your active SWGOH account. They are grouped by set. Focused datacrons (FDC) appear in a separate row above regular ones when both exist.

• Each card shows the usual GAC-style chrome (frame, level dots, ability icons).
• You can give a datacron a custom display name on this page; the planner and Discord plan image use the same name when assigned.
• Use the navbar refresh / Fetch player data so owned datacrons stay current before planning or assigning.

Datacron planner

Open Player → Datacron planner to plan which team needs which Lv3 / Lv6 / Lv9 mechanics and stats for an active set, then match those rows to datacrons you own. Plans are saved per SWGOH account and set. Expired sets move to Archive (read-only).

• Active / Archive - Active lists current sets; Archive is for past sets you already planned. Archive rows cannot be edited.
• Set chips - switch between sets in the current view. The set bar shows the set icon, name, and expiry time when known.
• Last fetched - at the bottom of the page, when datacron roster data is available.

Planning table

• Add row - adds an empty planner line for the selected set. Changes auto-save.
• Drag handle - reorder rows; order is part of the saved plan (and of Discord / share snapshots).
• Team - free-text label (for example a squad name).
• Prio - High / Med / Low priority for that line.
• Type - DS or LS. Narrows which owned datacrons appear when you assign a DC.
• Lv3 / Lv6 / Lv9 - pick mechanics for that tier from the set catalog (searchable). Lv6 can hold multiple picks when the set allows it. Clear removes the choice.
• Stats - multi-select primary stats relevant to the set.
• DC → Assign - opens a picker of owned datacrons that match the row filters (type, mechanics, stats). Assigned DCs show the usual icon chrome; clear or change the row requirements if the assigned DC no longer matches.
• Actions - checkmark toggles confirmed (green row highlight, like a GAC win mark). The X deletes the row after confirmation.

Sharing

Use Share under the table to send a copy of the current set's rows to another player or your guild. Recipients import on their own Datacron planner; your live plan is not edited when you share.

• With player - enter ally code or player name (autocomplete). Creates an incoming share for that Lyutils user. Sharing to another of your own linked alts copies the plan onto that account immediately.
• With guild - posts a guild share for guildmates who use Lyutils with the same guild id (requires linked account and synced guild data).
• Incoming shares - listed at the top of the planner. Import applies the snapshot; if that set already has rows, choose Append or Replace. Dismiss hides the share without importing.
• Navbar badge - avatar dropdown shows Shared datacron plans with a count and links to the planner when you have pending shares.

From Discord, /datacron plan posts the same table as an image (see Lyoda commands).

Territory Battle

Territory Battle in the main navbar opens the current guild TB page. Both the live map and the statistics page require a linked SWGOH account and guild membership.

GAC Planner

Open GAC from the main navbar. The planner shows opponent defenses for the current Grand Arena match and lets you build counter teams zone by zone. Use the navbar Full sync to pull the latest map status and defenses when a GAC is active (same planner steps as the old Sync GAC control).

• Attack / Def tabs — Attack is where you plan counters against the opponent; Def shows your own saved defenses.
• Season / Week / Round — each GAC week is its own tournament instance (same idea as swgoh.gg /gac-history/O…/round/ links). Pick a past week/round to browse archived boards. Current is the live setup/attack match; Archived is read-only history. The round dropdown only lists rounds that were archived — if you never opened the planner during round 1, that round may be missing. Plans and win/loss marks are saved per season / week / round. Changing week resets round to 1.
• Full sync (navbar) — during an active GAC, also refreshes map status, saved defenses, locked roster, and related planner data. Outside GAC windows it only runs the normal full player sync. On the Def tab it asks for confirmation first, because it overwrites planned defenses with what is currently in the game (use Set def first if you want to keep website changes).
• Set def — on the Current match only, sends Def tab changes to the game after you confirm. Requires a linked SWGOH account and a locked GAC roster (open the planner once after joining so the join snapshot loads).
• Scout — Premium Tier 3 tab that loads the opponent's recent GAC history from swgoh.gg (defense and offense tables).
• Planner settings (gear) — GAC Insight toggles swgoh.gg Insight-style counter links from counter rows; DC included in search adds defense datacron filters when Insight is on.
• Add units (+) — opens a search modal. Pick characters (or ships for fleet zones) into your counter. Save closes the modal and keeps the selection.
• Suggested characters — after you pick a unit, empty search prefers shared factions (for example affiliation) so related allies show up first. Partners that have affinity with your selected units are highlighted in gold and always appear in the list, even when they do not share a faction. Affinity grows when you mark a counter as a win (green check); clearing a green row or removing the check reduces those scores.
• Win / loss marks — ✓ and ✕ on a filled counter. ✓ needs at least 2 units (affinity is scored from that lineup); ✕ needs at least 1. Changing units on a green row updates affinity to the new team. A loss can open a retry row underneath for another attempt.
• Defense casualties on loss — after marking a loss (✕), click opponent defense portraits on the right to mark which characters died. They appear faded; the retry row below keeps survivors in the same slots and leaves dead slots empty. Faded styling remains on locked zones; editing requires unlocking.
• Clear — empties that counter. Affinity is only reduced if the row was marked green.
• Zone lock — on cleared territories (or any zone in an archived round), a padlock appears in the zone header. Locked zones hide planning controls; unlock to edit counters again.
• Fleets — you must pick a capital ship first; after that, other capital ships are blocked so the lineup stays valid.
• 3v3 / 5v5 - the header shows the current season format and is not switchable; live match data fills that board.

Conquest

Conquest in the main navbar shows your current Conquest event: overall keycard score, optional end reward crate, and per-sector feat progress (including Global).

• Each sector lists feats, mini bosses, and bosses with progress bars and keycard rewards.
• There is no separate refresh button on this page — use the navbar refresh (Fetch player data), then reload Conquest.
• From Discord, /conquest lean-syncs Conquest progress and posts the same card as an image.

Lyoda Discord bot

Lyoda is a Discord bot for SWGOH guilds. It talks to the same Lyutils backend as the website, so your loadouts, shop, and inventory stay in sync. Commands marked with 🔥 in Discord will break your current in game session.

Before you use bot commands

1. 1
   Sign in on Lyutils with Discord — same Discord account you use in the server. Open Lyutils
2. 2
   In Discord, run /authenticate. If Discord is not linked yet, the bot sends you the Lyutils login link — complete step 1 first.
3. 3
   Follow the bot prompts: enter your SWGOH email, then the verification code if emailed.

Slash commands

All commands are typed as /command in Discord. Parameters below match what you see in the slash command picker.

GAC opponent compare

/compare gac is Discord-only (there is no separate web page). It needs an active GAC setup or attack with an assigned opponent - the same matchup shown on the Home Grand Arena card. Use /compare ally when you want to compare against someone else.

Datacron plan image

/datacron plan reads the plan saved on Lyutils for the active SWGOH account. It does not edit rows or share plans; use the website for planning and sharing.

Common bot messages