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.
Please see the Getting Started section for instructions on how to use it.
Features include:
- Built in image recognition to import gear from screenshots
- Filter gear optimizer with main stats/sub stats/sets/etc
- Automatic data updates from EpicSevenDB for new heroes
- Hero bonus stats for imprints/artifacts/EEs
- Gear substat efficiency scoring
- Reforged stat prediction & editing
- Color coded results sorting
Here's what it looks like currently:
- Windows or MacOS, 64-bit
- Java 8, 64-Bit installed (Please download if you don't yet have it: https://java.com/en/download/manual.jsp, use the offline installer)
Table of Contents:
- Requirements
- Optimizer Tab
- Gear Tab
- Heroes Tab
- Importer tab
- Getting Started
- Closing thoughts
- Troubleshooting
- Contact me
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.
This panel tracks settings for the other panels to use.
- Hero: Select the hero you want to optimize for from the drop down.
- Force mode: Selects the number of substats to enforce from the options selected in the force panel. (See force panel for more details).
- Predict reforges: Predict the reforged stats on +15 level 85 gear to use in the search. Warning: the substat prediction is not 100% accurate so be ready to adjust their stats.
- At least one lv 85: Search only for builds that contain at least one level 85 gear.
- 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.
- 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.
This panel defines the stats to filter your optimization results by. The left boxes represent the minimum (inclusive) and the right boxes represent the maximum (inclusive). In this example, we're looking for a Ruele 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.
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.
- Hp*s --
Health * Speedrating. 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. - Ehp*s --
Effective HP * Speedrating. 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. - Dmg*s -- DPS rating, calculated by:
Attack * Crit Chance * Crit Damage * Speed. This measures how fast your unit can dish out damage. - Mcdmg -- 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. - Mcdmg*s -- Max DPS rating, calculated by
Attack * Crit Damage * Speed. Similar to Dmg*s, just without Crit Chance. - 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.
In this example we're looking for Ruele builds with at least 200,000 Effective HP.
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 its 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.
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.
Note that in the settings panel previously we set Force mode to "At least 2 stats". Here we have 3 substats we want to force, and with the force mode, we're only optimizing with gear that match at least 2 of these substats:
- At least 3 Speed
- At least 1 Hp %
- At least 1 Def %
For example:
- A gear with substats: 4 Speed / 8% Atk / 16% Hp / 8% Res would pass this filter because it matches at least 2 stats: Hp% and Speed.
- A gear with substats: 2 Speed / 8% Atk / 16% HP / 8% Res would fail this filter, because only 1 substat matches the filter: Hp% . This gear will not be used in the optimizations.
Setting the substat force filter is useful for narrowing down the search space for the optimizer, and reducing the number of permutations it needs to go calculate will make it go faster. Do be careful about filters you set, because an overly aggressive filter could exclude good gears that are useable for this unit. You could have a gear with 2 Speed/ 40% Hp / 100 flat Def / 200 flat HP, and it would fail this filter because only Hp% matches, even though the gear would still be useful.
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.
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. 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 / 39 * 0.5
+ Flat Defense / 31 * 0.5
+ Flat Hp / 174 * 0.5
Its 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 used that as a measure of how well the flat stats rolled. The 0.5 multiplier is completely arbitrary, but represents that flat stats are generally less desirable than percent stats.
You can edit existing gears or add new gears with this page, and filling in the relevant fields.
Here you can add new heroes and manage existing ones. I think most of the buttons are fairly self explanatory, the one thing worth noting is the Add Bonus Stats page, which lets you add artifact/imprint stats to the hero for optimization.
SSS Krau with +30 Aurius will have 91 Atk / 819 Hp / and 18% imprint Hp.
This tab lets you do various things with importing/exporting files.
Select the folder you have your screenshots in and the app will start reading your screenshots. Make sure the folder only contains your screenshots and nothing else. This will then output your gear.txt file, and you can export it somewhere for the next step. If there are any errors reading the screenshots, the list of failed files will be shown.
Once you have the gear.txt file from the OCR step, choose the file and it will import the gear into the optimizer.
- Append data will add the new gears to your existing gears.
- Overwrite data will load in the new data, removing all previous items and heroes
If you have new screenshot files to add to a save, use the Append option.
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.
If you're already a user of Zarroc's gear optimizer, this lets you import your data directly from your existing save file. All gear, heroes, and artifacts will be imported.
Please read these instructions carefully!
Installation:
- On the Releases page, choose the latest release, and download the file that looks like
FribbelsE7Optimizer-x.x.x...- There should will be a Windows and Mac version, choose the one you're running on. Mac version is still experimental.
- Do not download the Source Code options, those won't work
- Install Java 8 - 64 bit https://java.com/en/download/manual.jsp - Get the offline installer
- After installing, restart your computer (required!)
- Install an emulator to run Epic 7 on
- I used LDPlayer, but others have worked as well: MeMu, Nox, etc. Bluestacks has issues with screen resolution, would recommend an alternative. See possible Bluestacks workaround here
- Set the emulator's screen resolution to 1600 x 900. Example
- Set Epic 7 to English and enable High Quality Support in settings. Example
- Unzip the downloaded file, and run FribbelsE7Optimizer.exe (or FribbelsE7Optimizer.dmg/app on Mac) Example
- On the Releases page, choose the latest release, and download the file that looks like
FribbelsE7Optimizer-x.x.x...- There should will be a Windows and Mac version, choose the one you're running on. Mac version is still experimental.
- Do not download the Source Code options, those won't work
- Install Java 8 - 64 bit
- JRE: https://java.com/en/download/manual.jsp - Get the offline installer
- JDK: https://www.oracle.com/java/technologies/javase-downloads.html
- After installing, restart your computer (required!)
- Install Bluestacks
- Set the emulator's screen resolution to 1600x900 in the Preference menu
- Configure keyboard shortcut for Screenshot
- On your Mac: System Preference > Keyboard > Shortcuts Tab
- Left Sidebar: Select App Shortcuts
- Click the [+] button to add a shortcut
- Application: Bluestacks
- Menu Title:
Take screenshot(any typo here will make it not work) - Keyboard Shortcut: Anything you want it to be
- On your Mac: System Preference > Keyboard > Shortcuts Tab
- Back to Bluestacks: Install E7 from the Play Store and launch the game
- Set Epic 7 to English and enable High Quality Support in settings. Example
- Make sure to enter Full Screen Mode (Cmd+Shift+F) before starting your gear capture
Importing gear screenshots:
- Open the Gear Management screen in Epic 7 and sort by Max Enhance
- Click each of the gears that you want to import, and screenshot it. Every screenshot should be 1600x900 and look EXACTLY like this: https://i.imgur.com/68A8Uf0.jpg
- Most emulators have a screenshot hotkey to make this easier: Ctrl + 0 for LDPlayer
- I would recommend screenshotting just a few gears to start with, then testing the rest of the steps to make sure the screenshots work before doing them all. I usually only screenshot the +9 to +15 gears.
- Collect all your screenshots into a single folder.
- Go to the Importer tab, click on "Choose folder" under Creating a new gear set from screenshots, find your screenshots folder, and click Open Folder.
- The app will start reading the screenshots and your progress will be displayed. Once it is done, click Export, and save the gear.txt file.
- Under the Importing a gear set from a file section, click on Append data, and select your gear.txt file.
- Now you should see your imported gears under the Gears tab.
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
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
- The goal is to add filters to narrow down results so the optimizer doesn't take forever, but keep the search range wide enough that you don't lose good options.
- Input the sets and main stats whenever possible. This is the easiest way to narrow down results.
- Don't narrow down your results too much. If you see your # of permutations at like 10,000 or so, your filters might be too narrow, you can expand/remove some filters for more/better results.
- Make sure to set your stat priority correctly! DPS units should have high priority on Atk / Cr / Cd / Speed. 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.
- Adjust the Top n% bar on the priority filter to see what your results look like. Too high % will take a long time, but too low % will exclude good results. Most of the time I use 30-50%, 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.
Hopefully this is useful for anyone looking for an easier way to gear their units. I know the Zarroc optimizer does a lot of similar things but it has been pretty unmaintained and out of date, so I decided to build my own app with a different optimization algorithm. There's still a lot of room to improve and I plan on adding new stuff as feedback comes in. I only work on this in my spare time, so please be patient with new features, and I welcome other contributors to the code as well.
** Already done for 1.3.0 Release **
- Invalid dpi error
- Add info on which preset stats are auto-added
- Warning if permutations are > 5 billion
- Alphabetizing sets, hero selector
- Note to add arti/ee/imprint on bonus stats
- Clickable lock icon
- Allow append json
- Save filter preferences
- Filter out abyss 85 lifesteal for reforge
- Enhancement +3/6/9/12/15 filter
- Main stat filter on gear page
- +15 only filter on optimizer
- Change 7Zip to Zip
- Save Gear configurations, compare between them
- Class/Element filter for Heroes tab
- Gear enhance filters
- Autocheck new version
- Manual gear input improvements
- Gear page: count of selected
- Heatmap scores
- Tooltips broken
- Block when incorrect substat prio
- Manual equip is bricked
- Reorder heroes list
- Equipping build after sorting bricks
- Duplicate filter
Working on:
- Dark mode
- Show errors on invalid imports/missing main stat
- Cancel ongoing request when start is clicked again
Medium priority:
- Option to equip gear from heroes page
- Move save/load to File menu
- Use main stat gear for priority filter
- Reapply all filters on Filter button press
- Gear score column in optimizer results
- Sum of substat priority column
- Reforge non +15
- When switching gears, popup asking to unlock the gears being unequipped
- Heroes page: average gear score for each unit
- Date newly added gear
- Copying rows to text
- Popup gear card
- Show conversion/reforge mats
- Customizeable # of 85 gear to filter, 0 - 6 lv 85s in results
Bugs
- Make Network Error less confusing
- Comparison method violates its general contract
Low priority:
- Check if any gear is an upgrade to a unit
- Update permutations on 4 piece set
- Add can reforge, can enhance columns
- Customize result limit
- Clear out item previews on refresh
- Optimize multiple heroes at once
- Optimize results with a missing piece(s)
- Add different level/awakening options
- Tools for optimizing HP scaling units/skill scaling
- Fix: See unit stats for whatever gear they have currently, not just for 6 pieces
- Gear page, option to use more than one set/gear filter at time
- Score per roll column in gear
- Have two windows open at once
- Select/interact with multiple heroes at once
- Keyboard actions ctrl + a, ctrl + s, ctrl + arrows
- Rage set damage calculation
- Option to select a location to save zarroc import
- Enable cross platform for Linux
- Verify all imported screenshots are image files
- Investigate decrypting network traffic for gear data
- Restart your computer and retry first (there might be a child process still kicking around)
- Try killing any java.exe processes in Task Manager that came from this app
- Error message: 'java is not recognized as an internal or external command' upon opening the app. Install Java 8 64-bit version to fix.
- After selecting a screenshot folder and pressing submit, nothing happens or gets stuck. Check if there are any invalid screenshots in your folder. They should all look like exactly like https://i.imgur.com/ny7uaa8.jpg in 1600x900 resolution
- If you don't see the .exe file, you might have downloaded the Source code instead of the binaries. Go to https://github.com/fribbels/Fribbels-Epic-7-Optimizer/releases And click on the 'FribbelsE7Optimizer-x.x.x...' file (for whatever the latest version is)
- If you see a "Error: EPERM: operation not permitted" error in the dev console, 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 and screenshots folder to a new file location
- Gear shows up as +45 or i90 pieces show as i20, etc
- Make sure your screenshots are 1600x900, and on the correct page.
- Make sure Epic 7 has High Quality Support enabled, and the game language is English
- 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 your optimization suddenly stops working completely, check if you have one of these weird looking items in your gear tab: https://i.imgur.com/BzAgRjR.png. If one is there, edit it to fill in all the fields, but just leave the stats at 0. https://i.imgur.com/wDKDaE5.png
- If a hero is missing from the drop down list, the data is being pulled from Epic7DB API so it may be an issue with that. If the hero is available in the Epic7DB API but not in this app, then contact me.
- Mac - "The application "FribbelsE7Optimizer" can't be opened.
- Try unzipping the file using Unarchiver from the app store instead of Archive Utility. Example
- Try downloading the .dmg file if you were using the zip/app file.
- Can't resize Bluestacks to 1600x900. Resize to 1600x900 through options, then restart Bluestacks, then click the green button to fullscreen Bluestacks. After its fullscreened, screenshots will come out as 1600x900. See possible Bluestacks workaround here.
Feel free to contact me on discord at fribbels#7526 with questions or comments or ideas. If you ran into any issues, please check out the troubleshooting section above.
If you want to show support for the optimizer, you can buy me a coffee or come say hi on discord!