/Fribbels-Epic-7-Optimizer

A gear optimizer for the mobile game Epic 7

Primary LanguagePython

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

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

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.

Creating gear data from screenshots

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.

Importing gear data

Once you have the gear.txt file, choose the file to import the gear into the optimizer. Most of the time you will want the Merge option.

  • Merge data will combine your new gear screenshots with your currently loaded gear while keeping your heroes' equipped gear and builds intact.
  • 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 want to wipe all your data and start clean with gear screenshots, use Overwrite.

If you have new screenshot files to add to a save, use the Append option.

If you already have a save, and you want to update your gear, use Merge to replace old items with new items.

Save/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.

Import gear from Zarroc optimizer

If were a user of Zarroc's gear optimizer, this lets you import your data directly from your existing Zarroc save file. All gear, heroes, and artifacts will be imported.

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

  1. 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!)
  2. 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
  3. Follow the steps to use either the auto importer or screenshot importer

Mac OS

  1. 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
  2. Install Java 8 - 64 bit
  3. Follow the steps to use either the auto importer or screenshot importer

Setting up the auto importer

There are two importer options, one that automatically imports gear directly from your game, and one using screenshots. 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

  1. 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
  2. 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".
  3. Restart your computer
First time setup for the automatic importer on Mac
  1. Install Python 3.4+
  2. Install Wireshark
  3. During the Wireshark installation, also install ChmodBPF.pkg: See image
  4. 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/M1 macbook

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

  1. Install requirements from the instructions above
  2. Leave your emulator open, and close Epic 7
  3. Click Start scanning
  4. Open Epic 7, and load into the lobby
  5. Click Stop scanning
  6. Wait up to 30 secs, then once the data appears, click Export to save it to a "gear.txt"
  7. Import the "gear.txt" with the Merge button
  8. 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
  1. On Windows 10 machines, enable the Mobile Hotspot setting: See image
  2. On Mac, enable Internet Sharing in preferences. (May not be available for all machines depending on hardware)
  3. 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)
  4. Follow steps 3-8 in the previous 'Running the automatic importer from an emulator' section, using your phone instead of the emulator

Using the screenshot importer

If you cannot use the automatic importer, or would prefer to use screenshots, follow the following steps to import gear by screenshotting each item.

First time setup for the screenshot importer on Windows
  1. Install an emulator to run Epic 7 on
    • I used LDPlayer, but others have worked as well: MeMu, Nox, etc. Bluestacks works fine with the automatic importer, but has issues with screen resolution for the screenshot importer. See a solution for getting Bluestacks screenshots working here
  2. Set the emulator's screen resolution to 1600 x 900. Example
  3. Set Epic 7 to English and enable High Quality Support in settings. Example
  4. Install and run the optimizer
First time setup for the screenshot importer on Mac
  1. Install Bluestacks
    • Set the emulator's screen resolution to 1600x900 in the Preference menu
  2. 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
  3. 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
  4. Make sure to enter Full Screen Mode (Cmd+Shift+F) before starting your gear capture
Screenshotting gear
  1. Open the Gear Management screen in Epic 7 and sort by Max Enhance
  2. Click each of the gears that you want to import, and screenshot it with your emulator's hotkey. Every screenshot should be 1600x900 and look EXACTLY like this: https://i.imgur.com/68A8Uf0.jpg

https://i.imgur.com/ny7uaa8.jpg

  • Most emulators have a screenshot hotkey to make this easier: Ctrl + 0 for LDPlayer
  • I would recommend screenshotting 10-20 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 for the optimizer.
  1. Create an empty folder and collect all your screenshots into that folder.
  2. Go to the Importer tab, click on "Choose folder" under Creating gear data from screenshots, find your screenshots folder, and click Open Folder.
  3. 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.
  4. Under the Importing gear data section, click on Append data, and select your gear.txt file.
  5. Now you should see your imported gears under the Gears tab.

Optimizing a unit

  1. Add a unit on the Heroes tab, by selecting their name and clicking Add New Hero.
  2. Select the new hero and click Add Bonus Stats. Here add any stats from your artifact, imprint, or EE. Example
  3. Go to the Optimizer tab, then select the hero. Fill in the main stats and set that you want into the right panel. Example
  4. 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
  5. Hit Submit, and after processing a bit you should see a table of results.
  6. Navigate the results with your arrow keys or mouse, select the result you want, and click Equip Selected.
  7. You should now see your hero using those gears.
  8. 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, or use the screenshot importer, 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.

TODO List

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.

Done for 1.8.0

  • Top % now input-able

Working on:

  • v1.8.0

Medium priority:

  • Safer autosave folder loading
  • Unequipped units ingame with gear in optimizer dont get unequipped on hero merge
  • Save subprocess ids in settings and kill at startup
  • Cancel search -> stop search

Low priority:

  • Read file sync everything
  • Customizable optimization column formulas
  • Clear out item previews on refresh
  • Optimizer broken set priority
  • Hero priority equipping
  • Different pinned builds
  • Bug: Comparison method violates its general contract
  • Move save/load to File menu
  • Optimize multiple heroes at once
  • Gear page, option to use more than one set/gear filter at time
  • Auto copy gear image
  • Recolor on filter

Probably not doing:

  • See unit stats for whatever gear they have currently, not just for 6 pieces
  • Cancel ongoing request when start is clicked again
  • Update permutations on 4 piece set
  • Select/interact with multiple heroes at once
  • Verify all imported screenshots are image files
  • Date newly added gear
  • Enable cross platform for Linux
  • Have two windows open at once
  • Optimize results with a missing piece(s)
  • Reapply all filters on Filter button press
  • Check if any gear is an upgrade to a unit
  • Option to equip gear from heroes page

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: fribbels#50 (comment)

  • 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:

  • If you're having trouble running the app after downloading:

  • If you see a "Error: EPERM: operation not permitted" error pop up while importing, there are a couple potential fixes:

  • 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 you're having trouble with Bluestacks/unable to resize the screenshots to 1600x900:

    • Windows: See possible Bluestacks workaround here.
    • Mac: Resize to 1600x900 through Bluestacks options, then restart Bluestacks, then click the green button to fullscreen Bluestacks. After its fullscreened, screenshots will come out as 1600x900.

  • 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.

  • If you're having problems with importing screenshot files:

    • Inspect your screenshots and make sure they are exactly 1600x900 resolution.
    • Make sure your Epic 7 settings have English and High Quality Support enabled.
    • Try moving your app and screenshot folder to a different location. (try the desktop)

Contributing to the project

If you want to contribute, come by the discord server to have a chat about what you want to do. There's a huge list of todo items and I'm happy to have people add to the code.

We also have an ongoing translation project to translate the optimizer into various languages.

To run the frontend code locally,

  1. Install requirements
  2. Install node.js: https://nodejs.org/
  3. Install python2 and python3: https://www.python.org/downloads/
  4. Install yarn: npm install --global yarn
  5. Check out the code
  6. Run npm install in the app's root directory
  7. To run the development version locally: yarn dev
  8. 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 to show support for the optimizer, you can buy me a coffee or come say hi on Discord!