Installing And Loading Packages

Installing And Loading Packages

A package (or "pack") is what tells EmoTracker what to show for a specific game — the items grid, the map, the location logic, the autotracker script, etc. Before you can track a run you need to:

1. Install at least one package for the game you're playing
2. Load (activate) that package so the main window shows its layout

Both steps happen inside EmoTracker itself — you don't have to unzip files or touch folders.

Opening the Package Manager

The Package Manager is where you browse, install, update, and uninstall packages. There are two ways to open it:

• Click the gear / settings button in the main window → Application → Manage Packages
• Click the dedicated Package Manager button in the main window toolbar (if your current layout shows one)

Once the window is open, EmoTracker talks to the community package repositories and lists everything the community has published, grouped by game.

The Package Manager window

The window has three main parts:

• Search bar across the top — type any part of a pack name, author, or game title to filter the list. Matching is case-insensitive and delayed slightly so you can keep typing without stuttering.
• Filter sidebar on the left — three buttons that switch what the list shows:
  • All Packages — everything available from every repository
  • Installed Packages — only packs you already have installed
  • Installed Packages With Updates — only installed packs that have a newer version available
• Package list on the right — one card per game, with each package that supports that game listed inside it.

What each package row tells you

Each row in the list shows:

Element	What it means
Flag icons (left of the name)	Visual badges describing what the pack offers — see Flag icons below
Name	The pack's display name
Author	Who published the pack (shown in italics)
Download progress bar	Visible while a download is in progress
Status label	The pack's current state: Available, Installed, Update Available, Requires App Update, Download Error, or Dev
Action button	What you can do right now: Install, Update, or Uninstall

Packages that ship with variants (different pre-configured modes, e.g. "Item Tracker" vs "Map Tracker") list each variant on its own indented row below the main package.

Flag icons

The little icons next to a pack name are a quick summary of what it supports:

Icon	Meaning
⭐ Official	Shipped by the EmoTracker team (reserved for packs hosted on the official service)
♥ Featured	Community-recognized pack (also reserved for the official service)
🗺 Map	Includes a map tracker
📍 Pins	Supports pinned locations
💬 ChatHUD	Optimized for a streaming chat HUD overlay
🎯 AutoTracker	Includes an autotracker script that reads game memory
⚠ Unsafe	Uses potentially unsafe scripting functions — proceed at your own risk

Hover any icon in the actual window to see a tooltip naming it.

Status labels

The status label on each row tells you the pack's current state relative to your install. The color matches what you'd expect:

Status	Color	What it means
Available	White	Not installed; click Install to get it
Installed	Green	Already installed and up to date; click Uninstall to remove it
Update Available	Yellow	Installed, but a newer version exists; click Update to fetch it
Download Error	Red	The last attempt to download failed; check your network or the repository URL
Requires App Update	Light gray	The pack needs a newer version of EmoTracker than you have installed — the button says Upgrade First and is disabled until you update EmoTracker
Dev	Gray	A development copy you've placed locally (not managed by the Package Manager) — no action button is shown

Installing a package

1. Open the Package Manager (gear → Application → Manage Packages).
2. Find the pack you want — use the search bar or scroll through the list.
3. Click Install on its row.
4. EmoTracker downloads the pack zip and adds it to your local install folder. The status flips to Installed (green) when it's done.

That's it. The pack is now available to load in the next section.

Updating a package

1. Open the Package Manager.
2. Use the Installed Packages With Updates filter (or just scan for Update Available / yellow status rows).
3. Click Update on each row you want to upgrade. EmoTracker downloads the new version and replaces the old one.

Your existing save files may or may not be compatible with the new version — see Saving and Loading → What can invalidate a save file before updating a pack mid-run.

Uninstalling a package

1. Open the Package Manager.
2. Find the installed pack you want to remove.
3. Click Uninstall. The pack is removed and its status flips back to Available.

Uninstalling a pack also cleans up its user override folder, if any. If the pack you uninstall is currently active, EmoTracker clears the active pack.

Loading an installed package

Installing a pack doesn't automatically make it the one EmoTracker shows — you still need to load (activate) it. This is a separate menu because you often have several packs installed at once and only want to look at one at a time.

Via the Installed Packages menu

1. Click the gear / settings button in the main window.
2. Open the Installed Packages sub-menu at the top of the context menu.
3. You'll see installed packs grouped by game:
   • The top-level entries are games.
   • Each game expands to show the packs you have installed for that game, with the author shown in italics.
   • The currently loaded pack has an Active badge next to its name.
4. Click a pack name to load it. The main window instantly switches to show that pack's layout.

Picking a variant

If a pack ships with variants, each pack entry expands further to show its variants (e.g. Item Tracker, Standard Map Tracker, Keysanity Map Tracker, etc.). Click a variant instead of the main pack name to load that specific variant. The active variant also shows an Active badge.

Loading a different variant of the same pack is instant and doesn't require a reload — useful if, for example, you want to switch between an item-only view and a full map view for the same run.

Opening pack documentation

While a pack is loaded, press F1 (or use the gear menu → Application → Package Documentation) to open that pack's documentation URL, if the pack author provided one. This is usually the best place to learn pack-specific behaviors, keyboard conventions, and autotracker setup notes.

Repositories

The Package Manager pulls its list from a set of package repositories. By default EmoTracker ships with the community repository list, so there's nothing to configure for most users — the packs just appear.

If you want to subscribe to a repository that isn't in the community list (for example a pack author who hosts their own), you can add its URL as an Additional Repository in EmoTracker's settings. See Hosting a Package Repository if you're curious how that side of things works.

Troubleshooting

Symptom	What to check
Package Manager is empty or says "No package repositories are available"	EmoTracker couldn't download the community repository list. Check your internet connection and try reopening the window.
A pack shows Download Error	The repository entry's download URL is broken or unreachable. Try again later, or contact the pack author.
A pack shows Requires App Update	Your installed EmoTracker is older than the pack's minimum required version. Update EmoTracker first, then reopen the Package Manager.
Installed pack isn't in the gear menu	Make sure the installation finished successfully (status should be green Installed). If you just installed it, the menu populates the next time you open the gear button.
Pack loads but the map/autotracker doesn't work	Check the pack's own documentation with F1. Map and autotracker features are provided by the pack itself, not by EmoTracker.

See also

• Saving and Loading — how to save your progress, and what pack updates can do to old save files
• Map Locations — once a pack is loaded, how to interact with its map
• Item Types and Mouse Controls — how to interact with the items grid
• Keyboard Shortcuts — including F1 for pack documentation