Fribbels Epic 7 Gear Optimizer

This is a tool for organizing gear and optimizing gear and unit builds for Epic 7. Gearing units can be time consuming and it's not easy to find optimal combinations of gear within the game, so I made this to help make the gearing process easier.

Come join the Fribbels E7 Optimizer Discord server for announcements, troubleshooting, or ideas and suggestions! https://discord.gg/rDmB4Un7qg

Please see the Getting Started section for instructions on how to use the optimizer.

Features include:

Automatically import gear and heroes from the game
Filter gear optimizer with main stats/sub stats/sets/etc
Automatic data updates for new heroes
Hero bonus stats for imprints/artifacts/EEs
Gear substat efficiency scoring
Reforged stat prediction & editing
Color coded results sorting
Substat modification optimization

Here's what it looks like currently:

Requirements

64-bit Windows or MacOS
Java 8+, 64-Bit installed (Please download if you don't yet have it: https://java.com/en/download/manual.jsp. For Windows, use the 'Windows Offline (64-bit)' installer)

Check out the step-by-step video guide on how to install the app: https://www.youtube.com/watch?v=bDjP5eiOfK0

Fribbels Epic 7 Gear Optimizer

Optimizer Tab

Here I'll go through the different parts of the optimizer tab, using a tank Ruele build as an example. There are a bunch of panels with options for filtering the gear that I'll walk through in detail.

Settings panel

This panel tracks settings for the other panels to use.

Hero: Select the hero you want to optimize for from the drop down.
- Start: Click to start to optimization request.
- Filter: Once an optimization is complete, click to filter the results by the stats on the filter panels.
- Cancel: Interrupts and cancels an ongoing optimization request.
- Load settings: Loads the optimization settings from the last search for this hero.
- Reset settings: Sets all optimization settings to their default values.
Stats: Preview the hero's current stats on the left vs the new stats on the right.
Options: Change options for optimizing your hero
- Use reforged stats: Predict the reforged stats on +15 level 85 gear to use in the search.
- Use substat mods: Run the optimization using substat modification stones. Each hero's optimization settings must first be selected on the heroes tab before this can be used.
- Only maxed gear: When checked, only use +15 gear that cannot be further upgraded/reforged.
- Locked items: When checked, locked items will be used in the optimization. When unchecked, locked items are ignored.
- Equipped items: When checked, equipped items will be used in the optimization. When unchecked, equipped items are ignored EXCEPT for the unit's own equipped items.
- Keep current: When checked, the unit will be forced to use the gear that it currently has, and the optimizer will only try to optimize the gear slots that the unit has unequipped.
- Exclude Equipped: Select the heroes whose gear you want to be ignored in the optimization search. Add finished heroes to this list so other heroes can't steal their gear. Only works when 'Equipped items' is checked.

Stat filters

This panel defines the stats to filter your optimization results by. The left boxes are the minimum (inclusive) and the right boxes are the maximum (inclusive). In this example, we're looking for a build with:

At least 20,000 HP
At least 2,400 def
Between 180 and 200 speed

The filter will apply on your optimization results after you click Submit. Once the results have been generated, you can apply more restrictive filters by changing the numbers here, then clicking the Filter button. This will narrow down your results without having to do another search.

Rating filters

This panel is similar to the primary stats panel, but applies for calculated stats. These stats you won't see in-game but are various ratings that can help decide between different builds.

HpS -- Health * Speed rating. Useful for optimizing units where you want a combination of speed and pure health.
Ehp -- Effective HP, calculated by: HP * (Defense/300 + 1). EHP is a measure of how much damage your unit can take before dying and is useful for rating the tankiness of units.
EhpS -- Effective HP * Speed rating. Useful for optimizing units where you want a combination of speed and hp/def for tankiness.
Dmg -- Average damage, calculated by: Attack * Crit Chance * Crit Damage. Measures how much damage your unit will deal on average. Note that this takes crit chance into account, so lowering your crit chance impacts the Dmg rating because you'll crit less often, which lowers your average output.
DmgS -- DPS rating, calculated by: Attack * Crit Chance * Crit Damage * Speed. This measures how fast your unit can dish out damage.
Mcd -- Max Crit Damage, calculated by: Attack * Crit Damage. This does not take into account Crit Chance, as opposed to Dmg, and assumes your unit is at 100% Crit Chance. Useful for measuring damage of units like CDom that only need 50% Crit Chance, or PVE units that only need 85% with elemental advantage.
McdS -- Max DPS rating, calculated by Attack * Crit Damage * Speed. Similar to DmgS, just without Crit Chance.
- DmgH -- Bruiser rating, calculated by Health * Crit Damage. Useful for health scaling bruisers.
CP -- This is the CP you would see on the unit's stat page ingame, but doesn't take skill enhances into account. Useful for optimizing unused characters with leftover gear for world boss.

Substat priority filter

This is probably the most useful filter but please read before using it. Using this wrong can exclude good results from the search.

Assign a priority to each substat type from -1 to 3. This will go through every gear, and calculates the # of max rolls of each stat. The # of rolls is then multiplied by the stat priority you chose. It adds up all the stat scores for a gear, and sorts your gear by their highest substat score.

In this example we're mostly looking for a fast and tanky Ruele so we assign:

HP and Def a high rating of 3, since those are the highest priority stats
Speed a slightly lower rating of 2
And Res a rating of 1, as it's a nice-to-have stat and can still be useful for her
We don't particularly care about Attack/Crit Chance/Crit Damage/Effectiveness, so we leave those at 0

Then, we set the Top % slider to 30%. This will take all your weapons, score them based on the priority defined above, then only considers the Top 30% of the scores for optimization. Then it does the same for helmets, armors, etc, and then the optimizer generates permutations based on those Top 30% gears.

The Top % slider must be set to something other than 100% for this filter to work, otherwise you're just using the Top 100% of your gears and nothing is being filtered. Worth noting that this rating is a heuristic so it doesn't always produce optimal results if your percent is set too low. I find that 30-50% is a good range to work with, because 50% filters out most of the irrelevant gears (like dps stats on a tank build, or vice versa). Below 30%, the filter gets very sensitive and you might not have enough gears to produce optimal results, so the results can be missing some permutations when some useful gears get filtered out. Try playing around with different Top % values.

An example priority filter for a DPS unit like Arby could be something like this, where you only want damage stats:

Or for a tanky Champion Zerato, where you want a mix of tankiness, damage, and effectiveness, but NOT resistance, you can set resistance to -1 to decrease the gear rating if it has resist substats:

Choosing a good priority filter makes the optimization a lot easier since you won't have to consider irrelevant or low-rolled gears.

Main stat and set filters

This one's fairly straightforward, we're looking for:

Necklaces with Health % OR Defense %
Rings with Health % OR Defense %
Boots with Speed
Speed set
Resist set OR immunity set

If we don't care about sets as much for a tanky/damage ML Ken or something, this allows for broken sets as well. Here we only care that he has an immunity set, and no preference for any other sets, so they're left blank.

Optimization Results

Here you can see all the results from the optimization, sort by stat, and equip/lock the results.

The top row shows your currently equipped gear stats
Each column is color coded based on the min/max ranges of the stat on each page
You can use the arrows at the bottom to navigate between multiple pages of results
Select All/Deselect All modifies the little checkbox on each gear, or alternatively you can click individual boxes
Equip Selected will equip those checked gears onto the hero (while unequipping anything they were holding before)
Lock Selected will mark those checked gears as locked, which affects later optimizations that have "Locked Items" unchecked in settings.
Clicking on the pencil/hammer icons will allow you to edit/reforge item stats.

Gear Tab

Here you can find a table of all your gears, and sort/filter them. The icons at the bottom enable filters for set and gear slot, and the X clears the filters.

Gear score

The Score column is a stat I made up which is similar to WSS, with the difference that it takes flat stats into consideration while WSS ignores them. The calculation is:

Score = Attack %
+ Defense %
+ Hp %
+ Effectiveness
+ Effect Resistance
+ Speed * (8/4)
+ Crit Damage * (8/7)
+ Crit Chance * (8/5)
+ Flat Attack * 3.46 / 39
+ Flat Defense * 4.99 / 31
+ Flat Hp * 3.09 / 174

It's used as a measure of how well your gear rolled, scaled by the max roll for 85 gear (using max of 4, not 5 for speed). I found the average rolls for flat stats and compared it to the average stats of a base 5* unit at max level, and used that as a measure of how well the flat stats rolled. (For example, average roll flat def is 31, while the average flat def roll is worth 4.99% def on the average unit)

The other scores on this page are defined as:

dScore - DPS Score. This is the Score formula but only counting Attack/%, Crit Chance, Crit Damage, and Speed
sScore - Support Score. This is the Score formula but only counting Hp/%, Defense/%, Effect Resist, and Speed
cScore - Combat Score. This is the Score formula excluding Effectiveness and Effect Resist

You can edit existing gears or add new gears with the Equip / Edit Item button, and filling in the relevant fields on this page.

Heroes Tab

Here you can add new heroes and manage existing ones. The second grid saves a history of your past builds. The bottom shows your currently selected builds on the hero.

Adding bonus stats

The Add Bonus Stats button lets you add artifact/imprint/exclusive equipment stats to the hero for optimization.

Substat modification options

The Add Substat Mods button lets you customize the hero's settings when optimizing with substat mods enabled.

The substat selections menu allows you to drag substats from the Don't change column to either Wanted or Unwanted. Unwanted substats will be converted into Wanted substats, which the Don't change ones will not be modified or selected for in the results.

Options
- Limit rolls - Choose the maximum number of rolls to replace. For example, limit rolls = 1 would only replace base stats that didn't get enhanced. It is generally not a good idea to replace more than 2 rolls, and the higher this number is, the more permutations will be generated.
- Mod grade - Choose whether to use Greater or Lesser gem stats.
- Roll quality - Choose the modified substat's roll value, from min roll to max roll. The actual value ingame will be random. Values will be rounded to the nearest whole number.
- Wanted stats - Choose whether wanted stats should be allowed to be replaced with wanted stats when optimizing. For example, when allowed, a min speed roll could be replaced by a max speed roll. When not allowed, the speed will be left unmodified.
Tips for using substat mods
- Each substat change is considered as a new item, so you will have to increase your Top % and wait longer for good results
- Selecting fewer "wanted substats" and "unwanted substats" will make the optimization faster because it generates less permutations
- Searching multiple billion permutations is not uncommon when substats mods are enabled. Locking items and using the hero priority filter/etc can help reduce the search space
- The optimizer is only meant to show modification possibilities, but its not always a good idea to modify certain items for a specific build. Choose wisely
- Each substat change is considered an upgrade, and can be filtered for with the "Upg" filter, if you only want to modify 1-2 items for example**

Importer tab

This tab lets you do various things with importing/exporting files.

Save or Load all optimizer data

Once you make changes to your items/heroes, the changes should be saved before you close the app. You can choose a file to save it to, and then later on load that file to import the data back in.

The app also does autosave to an 'autosave.json' upon changes being made, and will autoload whatever was saved to the autosave file the next time the app opens.

Getting Started

Please read these instructions carefully! Here is a step by step video guide to go along with the instructions: https://www.youtube.com/watch?v=bDjP5eiOfK0

Installing the app

Windows

64 bit Java 8 or above is required:

Install Java 8 - 64 bit https://java.com/en/download/manual.jsp - Get the Windows Offline (64-bit) installer
- After installing, restart your computer (required!)
On the Releases page, choose the latest release, and download the file that looks like FribbelsE7Optimizer-Setup-1.x.x.exe then run the installer
- Do not download the Source Code options, those won't work
Follow the steps to use either the auto importer

Mac OS

On the Releases page, choose the latest release, and download the file that looks like FribbelsE7Optimizer-x.x.x-mac.dmg
- Do not download the Source Code options, those won't work
Install Java 8 - 64 bit
- Mac needs both JRE and JDK:
- JRE: https://java.com/en/download/manual.jsp - Get the 64-bit offline installer
- JDK: https://www.oracle.com/java/technologies/javase/javase8u211-later-archive-downloads.html
- After installing, restart your computer (required!)
  1. Follow the steps to use either the auto importer

Setting up the auto importer

The automatic importer is recommended and requires these additional steps:

First time setup for the automatic importer on Windows

Check out the step-by-step video guide to follow along with instructions: https://youtu.be/bDjP5eiOfK0?t=182

Install Python 3.4+ using the Windows installer (64-bit) option. Click for direct download link to 3.9.2. IMPORTANT: Enable the option to add Python to PATH
Install Npcap for Windows. Click for direct download link. During installation, enable the setting to "Support raw 802.11 traffic (and monitor mode) for wireless adapters".
Restart your computer

First time setup for the automatic importer on Mac

Install Python 3.4+. This will require extra steps to set python3 as your default. Recommended to use pyenv (https://opensource.com/article/19/5/python-3-default-mac)
Install Wireshark
During the Wireshark installation, also install ChmodBPF.pkg: See image
Restart your computer

Using the auto importer

You can use the auto importer with an emulator, a phone, or M1+ chip Macbook.

Running the automatic importer from an emulator or M1 macbook

Check out the step-by-step video guide to follow along with instructions: https://youtu.be/bDjP5eiOfK0?t=357

Install requirements from the instructions above
Leave your emulator open, and close Epic 7
Click Start scanning
Open Epic 7, and load into the lobby
Click Stop scanning
Wait up to 30 secs, then once the data appears, click Export to save it to a "gear.txt"
Import the "gear.txt" with the Merge button
Go to the Gear tab, and use the Level = 0 filter to manually fix any level 0 items

Running the automatic importer from a phone

On Windows 10 machines, enable the Mobile Hotspot setting: See image
1. On Mac, enable Internet Sharing in preferences. (May not be available for all machines depending on hardware)
Connect to the mobile hotspot from your phone (The computer must be the one providing the hotspot, and the phone connects to the computer's hotspot)
Follow steps 3-8 in the previous 'Running the automatic importer from an emulator' section, using your phone instead of the emulator

Optimizing a unit

Add a unit on the Heroes tab, by selecting their name and clicking Add New Hero.
Select the new hero and click Add Bonus Stats. Here add any stats from your artifact, imprint, or EE. Example
Go to the Optimizer tab, then select the hero. Fill in the main stats and set that you want into the right panel. Example
Fill in any filters you would like to apply. Each filter is described in detail in this section: https://github.com/fribbels/Fribbels-Epic-7-Optimizer#optimizer-tab
Hit Submit, and after processing a bit you should see a table of results.
Navigate the results with your arrow keys or mouse, select the result you want, and click Equip Selected.
You should now see your hero using those gears.
If you want to manually equip a certain item on a unit, go to the Gear tab -> Edit Selected Item -> Equipped. Example

Here's a video that covers most of the importing process: https://www.youtube.com/watch?v=i_QW4INcZIE

Updating your gear

After enhancing/reforging/modifying your gear, you'll need to update it in the optimizer
Run the auto importer again to generate a new gear.txt
Use the Merge button on the Importer tab to update your existing save with the new gear

Tips to get good optimization results

Here's some quick tips on getting the best results. This is assuming you've read the Optimization panel descriptions.

Input the sets and main stats whenever possible. This is the easiest way to narrow down results.
Use the substat priority filter and make sure to set your stat priority correctly!
- DPS units should have high priority on Atk / Cr / Cd / Speed for example.
- Tank units should have high priority on Hp / Def / Speed for example.
- Bad priorities will lead to bad results because good options get filtered out.
Lower the Top % to make the search faster, or increase Top % to search more results. Most of the time I use 20-30%, sometimes lower if I want only my best gear on the unit.
If you want a certain piece of gear to stay on a hero, go to the Gear tab -> Edit Selected Item -> Equipped and equip it on them first. Example Then you can use the optimizer with "Keep current" checked to keep that piece on them.

Troubleshooting

Automatic importer troubleshooting

If it takes longer than 30 seconds or no error shows up:
- Make sure the requirements are installed (Python and Npcap for Windows, Python and Wireshark for Mac), or try reinstalling them.
- Restart your computer
Shows an error
- Try it again a couple times, it does fail occasionally
- If you're on VPN, either disable it or change encryption to UDP
- If you have Hyper-V enabled, there's a couple options:
- Try importing on a non Hyper-V machine
- Open the View Network Connections menu, and disable the Hyper-V Bluestacks network adapter, then use the mobile hotspot import option.
- Or modify the scanner code to hardcode your network interface: https://github.com/fribbels/Fribbels-Epic-7-Optimizer/issues/50#issuecomment-804275567
Feel free to drop by the Discord server for help debugging other issues: https://discord.gg/rDmB4Un7qg

Optimizer troubleshooting

If you're seeing Java issues:
- Make sure Java 8 - 64 bit is installed.
- Make sure that Java is in your path environment variable: https://mkyong.com/java/how-to-set-java_home-on-windows-10/
- Try restarting your computer, and reopen the app (there might be an old subprocess still kicking around)
If you're having trouble running the app after downloading:
- You might have downloaded the Source code instead of the installer. Go to https://github.com/fribbels/Fribbels-Epic-7-Optimizer/releases and click on the 'FribbelsE7Optimizer-Setup-1.x.x.exe' file (for Windows, use the dmg for mac), not the Source code
If you see a "Error: EPERM: operation not permitted" error pop up while importing, there are a couple potential fixes:
- Restart your computer, especially if you installed Java recently
- Your antivirus might be blocking the app, try disabling it. I've seen issues with Avast specifically, and disabling Avast temporarily solves it.
- Your file or folder contents might be compressed, uncheck this box on the folder: https://i.imgur.com/kSzTqek.png
- Run the app as administrator
- Move the app folder to a new file location
- Disable Windows security randomware protection: https://www.majorgeeks.com/content/page/how_to_enable_or_disable_windows_defender_exploit_guard_controlled_folder_access.html
If you get a error that contains "Current relative path is C:\Windows\system32..."
- I don't actually know the cause of this one, but one way to fix it is copying the data/tessdata/eng.traineddata/eng.traineddata file into the system32 path that its looking for
If you're having trouble using it on Mac - "The application "FribbelsE7Optimizer" can't be opened":
- Right click the app and click Open from the menu
- Try unzipping the file using Unarchiver from the app store instead of Archive Utility. Example
If a hero is missing from the drop down list, contact me to add it.
If you see a bunch of optimization result rows with the same stats, you probably have duplicate gear. Example
- Use the Duplicates filter on the Gear screen to find and fix your duplicate gear. Alternatively Overwrite/Merge your gear data to start over. Be careful when using the Append option, because that can result in duplicate gear being added. Most of the time you'll want to use Merge.
Drop by the Discord server for help debugging other issues: https://discord.gg/rDmB4Un7qg

Contributing to the project

If you want to contribute, come by the discord server to have a chat about what you want to do. We also have an ongoing translation project to translate the optimizer into various languages.

Project status

The E7 optimizer is currently in maintenance mode - I'll be keeping the project updated with new units but new feature development is on pause.

Setup steps

To run the frontend code locally,

Install requirements
1. Install node.js: https://nodejs.org/
2. Install python2 and python3: https://www.python.org/downloads/
3. Install yarn: npm install --global yarn
Check out the code
Run npm install in the app's root directory
To run the development version locally: yarn dev
To build and package the production executables: yarn package

To run the backend code requires some more setup, contact me for more info.

Contact me

Come join the Fribbels E7 Optimizer Discord server for questions or comments or ideas/suggestions: https://discord.gg/rDmB4Un7qg. If you ran into any issues, please check the troubleshooting section above first.

If you want support the optimizer, you can buy me a coffee or come say hi on Discord!

fribbels / Fribbels-Epic-7-Optimizer

readme