NGUInjector is an automation platform for the steam version of NGU Idle.

Releases can be found in the releases section of the github page here. Do not download the source code archive, instead download the zip file with the release version in the name (dist_3.6.3.zip for example). Extract the downloaded archive to a directory of your choice. To start automation, run inject.bat in the extracted folder when NGU Idle is open. DO NOT RUN AS ADMINISTRATOR.

You'll know the injection has worked if you see the following in the upper left portion of NGU.

To upgrade to a new release, unload the injector from the General Settings page and then inject the new version.

After injecting the dll, a new folder will be created on your Desktop called NGUInjector. Settings files will be automatically written to this directory. The following files are of interest:

• settings.json - Contains settings used by the application. Most settings can be configured from the in-game menu.
• zoneOverrides.json - Override the default values for Idle/Manual Power/Toughness for gold sniping

A profiles folder will be created with the following files:

• default.json - Breakpoints for assigning gear, magic, energy, wandoos OS, rebirth time, and diggers. See the allocation section for more information

More profiles can be added to this folder at your discretion.

A logs folder will also be created with the following files:

• loot.log - Logs all the loot dropped by enemies.
• inject.log - Logs general information about the injector
• combat.log - Logs information from the combat algorithm
• allocation.log - Logs information about allocating energy/magic/gear/diggers
• pitspin.log - Logs important things like fruit harvests, money pit, daily spin. This log file will not be overwritten.

Saving either file will automatically reload the settings in the configuration file. Reloading the game isn't necessary

With the latest fork, many changes have been added that aren't found in the GUI.

To access these settings, open the settings.json (in your Desktop folder, mentioned above) and scroll down to find the following configuration options:

• _manageCooking - Set this to true to have the injector optimize your cooking efficiency
• _manageCookingLoadouts - Set this to true to have the injector swap to a Cooking loadout when eating meals
• _manageQuestLoadouts - Set this to true to have the injector swap to a Questing loadout when doing manual questing
• _cookingLoadout - Assign your cooking loadout here. Follow similar pattern as other loadout fields (example: [448, 447, 444, 170, 263, 169, 128, 243, 136, 91, 446, 137, 256, 265, 266, 267, 268, 269])
• _questLoadout - Assign your questing loadout here. Follow similar pattern as other loadout fields (example: [257, 170, 293, 236])
• _manageConsumables - Set this to true to have injector manage consumables via breakpoints in your allocation file (see Section on Consumables below for details)
• _autoBuyConsumables - Set this to true to have the injector auto purchase any consumables you try to use that you do not own. Will only buy consumables if you have the AP to purchase them.

An in game menu can be opened using the F1 button.

• Master Switch - If turned off, will disable all automation

• Disable Overlay - If switched on, will disable the in-game overlay.

• Auto Move to ITOPOD - Automatically move to ITOPOD when nothing else is happening in automation.

• Auto Fight Bosses - Automatically nuke/fight bosses.

• Auto Buy Energy/Magic/R3 - Automatically spend EXP on energy/magic/R3. Will use the custom caps set by the user in the spend exp page. Will always buy unlocked exp spends in groups.

• Unload - Allows you to unload the injector from the game. Check the box next to the unload button and then hit unload

• Allocation Profile - Allows you to quickly switch allocation profiles. Any profiles stored in the profiles folder will be listed here. Press change allocation after swapping to change to load the new allocation. Press edit to open the allocation file in a text editor.

• Manage Energy - Manage energy based on breakpoints in your selected allocation file

• Manage Magic - Manage magic based on breakpoints in your selected allocation file

• Manage R3 - Manage resource 3 based on breakpoints in your selected allocation file

• Manage Gear - Manage gear based on breakpoints in your selected allocation file

• Manage NGU Difficulty - Manage NGU difficulty based on breakpoints in your selected allocation file

• Manage Diggers - Manage diggers based on breakpoints in your selected allocation file

• Auto Upgrade Diggers - Automatically upgrades your cheapest diggers when you have money available. Respects your money pit threshold and wont buy underneath it.

• Manage Wandoos OS - Manage wandoos OS based on breakpoints in your selected allocation file

• Auto Rebirth - Automatically rebirth after the time in your selected allocation file is reached.

• Change Auto Spells - Manage Spoopy Spell casting

• Spaghetti % - Percent to cast Blood Spaghetti until

• Number Bonus - Number to cast Blood NUMBER Boost until

• Counterfeit % - Percent to cast Counterfeit Gold until

• Cast Blood Spells - Cast blood spells automatically. Will try every 10 seconds or at rebirth

• Iron Pill - Amount of +stats to cast Iron Pill at.

• Guff A - Number of +levels to cast Guff A at

• Guff B - Number of +levels to cast Guff B at

• Manage Yggdrasil - Automatically harvest fruits.
• Activate Fruits - Reactivate fruits you haven't bought the exp perk for
• Swap Loadout for Yggdrasil - If checked, equip the loadout specified in YggdrasilLoadout before harvesting
• Minimum Fruit Level for Swap - Don't equip Yggdrasil loadout for fruits below this level.
• Loadout - Edit the loadout used for harvest yggdrasil. Add items using the box in the bottom.
• Harvest All Now - Allows you to do a Yggdrasil swap and immediately harvest all fruits. Check the box next to the button to enable it. Good for manual rebirths

• Manage Inventory - When enabled, the following features will be enabled
  • Auto Boost Merging - If a boost is locked, boosts will automatically be merged until the boost hits 100.
  • Auto Merging - Equipped items and items in inventory will automatically be merged, as well as MacGuffins. The highest level item will be selected for merging automatically. A locked item will always be preferred.
  • Auto Boosting - Automatically boost items. Will start with items in the PriorityBoosts setting, followed by equipped items, locked items in inventory and finally infinity cube.
  • Auto Filtering - If improved loot filter is purchased, will automatically filter items when they hit level 100
  • Auto Convertible Management - Will automatically transform non-locked pendants/lootys and other items
  • Quest Item Management - Will try to merge a quest item to level 100 if a locked one is found. Otherwise will automatically turn in quest items
• Manage Boost Conversion - If all normal 100 Level Challenges are completed, will calculate needed boosts for items in boostIds and then switch auto conversion appropriately. If a locked non-level 100 boost is found in your inventory, will lock conversion to that type first to boost it to 100. Will prioritize power > toughness > special. Will also show you the hourly average of boost progress in the inject.log file.
• Cube Priority - How to boost cube.
  • None - Will turn off boost conversion
  • Balanced - Will keep power and toughness on cube balanced
  • Power - Will only put power into cube
  • Toughness - Will only put toughness into the cube
• Priority Boosts - Edit the items you wish to boost before others. Add items using the box in the bottom. Order is respected.
• Blacklisted Items - Edit the items you wish to never be boosted. Add items using the box in the bottom.
• Reset Boost Average - Resets the running average of cube/item boosting

• Swap Loadout for Titans - Equip the gear in TitanLoadout right before any titan marked for swapping
• Loadout - The gear to equip when autokilling titans.
• Titans to Swap For - Mark titans you wish to swap gear for

• Combat Enabled - Turns on auto combat to go to target zone and kill stuff.

• Bosses Only - If enabled, will only fight bosses when doing combat. Good for zone sniping.

• Precast Buffs - If enabled, will cast charge and parry in safe zone before each combat and wait for the cooldowns to recharge.

• Recover HP - If enabled, will recover HP in safe zone between kills

• Fast Combat - If enabled, will just quickly attack and skip buffs altogether

• Beast Mode - Whether to use beast mode or not while in combat

• Block/Parry with Buffs - If checked, combat will use block/parry along with offensive/defensive/ultimate buffs.

• Combat Mode - If set to manual, will execute a custom combat routine. If set to idle, will just idle the zone.

• Target Zone - The target zone to snipe/do combat in. ITOPOD is at the bottom of the list.

• Allow Fallthrough - If set to true, combat will use the highest unlocked zone you have until the target zone is unlocked.

• ITOPOD - Equivalent to setting target zone to ITOPOD, just a quicker option

• ITOPOD Settings - Settings below this apply only to ITOPOD combat

• Combat Mode - If set to manual, will execute a custom combat routine. If set to idle, will just idle the zone.

• Precast Buffs - If enabled, will cast charge and parry in safe zone before each combat and wait for the cooldowns to recharge.

• Recover HP - If enabled, will recover HP in safe zone between kills

• Fast Combat - If enabled, will just quickly attack and skip buffs altogether

• Beast Mode - Whether to use beast mode or not while in combat

• Optimize ITOPOD Floor - Will optimize your ITOPOD floor every 10 seconds. Does nothing if Lazy Floor Shifter is on

• Blacklisted Enemies - Allows you to blacklist enemies when searching for enemies in a zone.

• Enable Gold Management - If turned off, will disable all gold swap logic
• Do Gold Snipe - If checked, will immediately equip gold loadout gear and perform a boss snipe in the best calculated zone based on the zone stats and gold loadout power/toughness.
• Resnipe Time - Set this value to re-enable gold snipe at a certain time during your rebirth. Best set to after AT is completed in order to get a higher zone.
• CBlock Mode - If checked, will automatically gold snipe every new zone that is unlocked. Useful for challenge blocks where zones sporadically become available.
• Loadout - Items to use when swapping for gold loadout.
• Titans to Swap For - Check the box next to titans you want to swap to gold loadouts for. Leave all boxes unchecked in order to never use gold loadouts for titans. If a titan is green, gold snipe has already been completed for this titan.
• Reset Titan Status - Immediately mark all titan gold swaps as incomplete

• Auto Quest - If enabled, quests will automatically be turned in. Behavior varies based on the Allow Major Quests option
• Allow Major Quests
  • If this option is enabled, when major quests are available they will be accepted and automation will manually farm the items from the appropriate zone
  • If this option is disabled, major quests will not be accepted.
  • When no major quests are available, minor quests will be accepted and idled.
• Abandon Minor Quests - If enabled and minor quest progress is below the minor quest threshold, the minor quest will be abandoned and a major quest will be picked up.
• Manual Minors - If enabled will manual minor quests as well as majors
• Use Butter on Majors - If enabled will attempt to butter major quests
• Use Butter on Minors - If enabled will attempt to butter minor quests
• Abandon Minor Quest Threshold - Quest progress before which its acceptable to abandon minor quests.
• Combat Mode - If set to manual, will perform a combat routine to do your quest zone. Otherwise will idle the zone.
• Fast Combat - If enabled will skip all buffs during combat.

• Sort Wishes by Completion Time - If checked, will sort wishes by completion time instead of cost
• Priority Wishes - The wishes to prioritize doing. Will switch to cheapest wish when all wish priorities are complete.
• Sort Priority Wishes - If checked, will also sort your priority wish list by cost

• Auto Daily Spin - Automatically do daily spin and log the result to the loot.log file
• Auto Money Pit - Automatically throw money into the money pit if the Money Pit Threshold is met. Logs the result to the loot.log file
• Money Pit Threshold - The amount of gold to wait for to throw gold into the money pit. Accepts scientific notation (ex: 1E+28)
• Loadout - Items to equip before throwing money in the pit

• Manage Mayo Will prioritize mayo production to be able to cast the first card in your deck asap. If you have no cards, it will equalize all mayo types.
• Auto Trash Cards Will trash cards according to the settings below
• Trash Adventure Cards If checked, adventure cards are trashed according to your settings. If not checked, no adventure cards are deleted, regarless of settings
• Auto Cast Cards Will cast any card that is not trashed according to your settings
• Trash All Cards of Type WIll trash these card types regardless of your other settings
• Trash Chunkers Will trash chunkers of the types in your trash all list.

Allocation profiles can be found in the profiles folder and contain time breakpoints for configuring your gear, diggers, energy allocation and magic allocation. Sample allocation files can be found in the sampleprofile folder.

Sample 24 Hour Profile.

The time portion of every breakpoint refers to rebirth time in seconds. Time can be defined as a simple number (ex: 86400) or as a JSON object:

"Time": {
    "h": 1,
    "m": 30,
    "s": 20
},

Priorities can be modified with an optional percentage cap by adding a : and a percent. As an example:

CAPWISH-0:30

This will cap wish 0 but limit the maximum amount allocated to 30% of your current cap. When applied to non-cap priorities, it will limit to % of idle resource. Priorities will respect targets and not allocate to priorities that are target capped.

An energy breakpoint is structured as follows:

"Energy": [
    {
        "Time": 0,
        "Priorities": ["CAPNGU-0", "CAPWAN", "AT-1", "NGU-1"]
    }
]

Priorities come in 2 types - cap and non-cap. Any priority that has -X after it is 0 indexed.

A cap priority will use as much idle energy as possible and hit the highest BB breakpoint possible for the next 10 seconds. A non-cap priority will take a divider of your idle energy based on number of non-cap priorities and attempt to hit the highest BB breakpoint possible for the next 10 seconds. When a priority is calculated, it will push excess energy to later priorities.

In the above example the following actions will be taken:

• NGU-0 (NGU Augments) will be capped
• Wandoos energy will be capped
• Remaining energy will be split between AT-1 (Advanced Training Power) and NGU-1 (NGU Wandoos)

Available cap priorities for Energy are as follows:

• CAPNGU-X (0-8) - Calculate a cap for the NGU
• CAPALLNGU - Calculate a cap for every NGU starting from 0
• CAPAT-X (0-4) - Calculate a cap for the AT and attempt to BB it.
• CAPALLAT - Calculate caps for all ATs and BB them.
• CAPBESTAUG - Attempts to allocate to the best augment possible. Before pairs are unlocked, will allocate to highest augment that is easily doable. After will try to optimize.
• CAPWAN - Calculate a cap for wandoos energy
• CAPTM - Calculate a cap for energy time machine and attempt to BB it.
• CAPBT-X (0-11) - Calculate a cap for basic training
• CAPALLBT - Caps all basic trainings
• CAPAUG-X (0-13) - Calculate a cap for augments and attempt to BB it
• CAPWISH-X (0-X) - Allocate energy to wishes. X is the wish slot you wish to allocate to. If you only have 1 slot, WISH-0 will be the one you use. Wishes will follow the priority set in the WishPriorities setting and then work through cheapest wishes

Available non-cap priorities for Energy are as follows:

• ALLNGU - Allocate energy to every NGU
• NGU-X (0-8) - Allocate energy to NGU
• AT-X (0-4) - Allocate energy to AT
• ALLAT - Allocate energy to all AT
• AUG-X (0-13) - Allocate energy to augment
• BESTAUG - Attempts to allocate to the best augment possible. Before pairs are unlocked, will allocate to highest augment that is easily doable. After will try to optimize.
• WAN - Allocate energy to energy wandoos
• TM - Allocate energy to energy time machine
• BT-X (0-11) - Allocate energy to basic training
• WISH-X (0-X) - Allocate energy to wishes. X is the wish slot you wish to allocate to. If you only have 1 slot, WISH-0 will be the one you use. Wishes will follow the priority set in the WishPriorities setting and then work through cheapest wishes

More information on allocation indexes can be found on the wiki

A magic breakpoint is structured as follows:

"Magic": [
    {
        "Time": 0,
        "Priorities": ["CAPNGU-0", "CAPWAN", "BR", "NGU-1"]
    }
]

Priorities come in 2 types - cap and non-cap. Any priority that has -X after it is 0 indexed.

A cap priority will use as much idle energy as possible and hit the highest BB breakpoint possible for the next 10 seconds. A non-cap priority will take a divider of your idle energy based on number of non-cap priorities and attempt to hit the highest BB breakpoint possible for the next 10 seconds. When a priority is calculated, it will push excess energy to later priorities.

In the above example the following actions will be taken:

• NGU-0 (NGU Yggdrasil) will be capped
• Wandoos magic will be capped
• Magic rituals will be capped from highest to lowest, with rituals taking more than 1 hour skipped
• Remaining magic will be allocated to NGU-1 (NGU Exp)

Available cap priorities for Magic are as follows:

• CAPNGU-X (0-6) - Use the cap button for the NGU
• CAPALLNGU - Use the cap button for every NGU starting from 0
• CAPWAN - Use the cap button for wandoos magic
• CAPTM - Calculate a cap for magic time machine and attempt to BB it.
• CAPRIT-X - Calculate a cap for the ritual and allocate
• CAPWISH-X (0-X) - Allocate magic to wishes. X is the wish slot you wish to allocate to. If you only have 1 slot, WISH-0 will be the one you use. Wishes will follow the priority set in the WishPriorities setting and then work through cheapest wishes
• BR - Cast rituals from highest to lowest ignoring rituals you cant afford or will take more than an hour
• BR-X - Cast rituals from highest to lowest that will finish before time specified by X. BR-3600 will cast rituals that will end before the 1 hour mark from your current time.

Available non-cap priorities for Magic are as follows:

• NGU-X (0-6) - Allocate energy to NGU
• WAN - Allocate energy to magic wandoos
• TM - Allocate energy to magic time machine
• RIT-X - Allocate energy to ritual
• WISH-X (0-X) - Allocate magic to wishes. X is the wish slot you wish to allocate to. If you only have 1 slot, WISH-0 will be the one you use. Wishes will follow the priority set in the WishPriorities setting and then work through cheapest wishes

More information on allocation indexes can be found on the wiki

An R3 breakpoint is structured as follows:

"R3": [
    {
        "Time": 0,
        "Priorities": ["HACK-1"]
    }
]

Available priorities for R3 are as follows:

• (CAP)HACK-X (0-14) - Allocate R3 to hacks. Will only ever allocate to the first hack in your priority list that hasn't met its target.
• (CAP)ALLHACK - Adds every hack from 0 to 14 as a priority
• (CAP)WISH-X (0-X) - Allocate R3 to wishes. X is the wish slot you wish to allocate to. If you only have 1 slot, WISH-0 will be the one you use. Wishes will follow the priority set in the WishPriorities setting and then work through cheapest wishes

A gear breakpoint is structured as follows:

"Gear": [
    {
        "Time": 0,
        "ID": [189, 442, 160, 441, 148, 169, 139, 184, 187, 185, 186, 188]
    }
]

The list of IDs is the IDs of the gear desired.

You can dump your loadouts from Gear Optimizer using the method found on this wiki page

A digger breakpoint is structured as follows:

"Diggers": [
    {
        "Time": 3650,
        "List": [3, 4, 5, 8]
    }
]

The list of diggers is 0 indexed. Drop chance digger is 0, EXP digger is 11. More information can be found on the wiki

A wandoos breakpoint is structured as follows:

"Wandoos": [
    {
        "Time": 0,
        "OS": 1
    }
]

The OS is 0 indexed. Wandoos 98 is 0, Wandoos MEH is 1, Wandoos XL is 2

A NGU Difficulty breakpoint is structured as follows:

"NGUDiff": [
    {
    "Time": 0,
    "Diff": 0
    }
]

The difficulty is 0 indexed. Normal NGUs is 0, Evil NGUs is 1, Sadistic NGUs is 2

Rebirth Breakpoints can be written 2 ways. A simple time based breakpoint is written as follows:

"RebirthTime": -1

A setting of -1 means no rebirths. Otherwise rebirth will be performed when the time in seconds is reached.

More complex rebirth breakpoints can be done as follows:

"Rebirth": {
    "Type": "Time",
    "Target": {
    "h": 24,
    "m": 1
    },
    "Challenges": []
},

The following types are available:

• Time - Rebirths when a certain time passes
• Number - Rebirths when your number will be OldNumber * Target
• Bosses - Rebirths when you can defeat Target additional bosses

The following example will rebirth when your number is 10x your previous number:

"Rebirth": {
    "Type": "Number",
    "Target": 10,
    "Challenges": []
},

The following example will rebirth when you can kill 5 more bosses than your last rebirth:

"Rebirth": {
    "Type": "Bosses",
    "Target": 5,
    "Challenges": []
},

Additionally, you may specify challenges to rebirth into. The following string correspond to challenges:

• BASIC - Basic
• NOAUG - No Augments
• 24HR - 24 Hour
• 100LC - 100 Level Challenge
• NOEC - No Equipment
• TC - Troll Challenge
• NORB - No Rebirth
• LSC - Laser Sword Challenge
• BLIND - Blind Challenge
• NONGU - No NGU
• NOTM - No Time Machine

Challenges must be given a number afterwards to specify which challenge is being completed. Challenges start at 1. Ex:

"Challenges": ["BASIC-1", "BASIC-2", "TC-1","NOEQ-1"]

A Consumables breakpoint is structured as follows:

"Consumables": [
    {
    "Time": 0,
    "Items": ["EPOT-B", "MPOT-B"]
    }
]

Consumables are indexed as follows:

• EPOT-A - Energy Potion alpha
• EPOT-B - Energy Potion beta
• EPOT-C - Energy Potion delta
• MPOT-A - Magic Potion alpha
• MPOT-B - Magic Potion beta
• MPOT-C - Magic Potion delta
• R3POT-A - R3 Potion alpha
• R3POT-B - R3 Potion beta
• R3POT-C - R3 Potion delta
• EBARBAR - Energy Bar Bar
• MBARBAR - Magic Bar Bar
• MUFFIN - MacGuffin Muffin
• LC - Lucky Charm
• SLC - Super Lucky Charm
• MAYO - Mayo Infuser

IMPORTANT NOTE: BE CAREFUL WHEN USING CONSUMABLE BREAKPOINTS

The injector cannot remember consumable usage across session. Therefore, if you restart NGU and/or the injector, it will run your latest Consumables breakpoint again -- and use any items again (except for beta pots and MacGuffin Muffins, those only activate if not already active).

Example: Let's say you have it set to use a Lucky Charm 4 hours into your run.

4 hours into your run, you use a Lucky Charm, all is well and life is good.

But sometime after this, you restart your computer. :(

When firing up NGU and injector, if the 4hour breakpoint is your latest one, it will run that one again once and use another Lucky Charm.

If you had set that breakpoint to use a Lucky Charm AND a Super Lucky Charm, the injector will use both Lucky Charm and Super Lucky Charm again once.

Be mindful of this or your AP will be sad. No one likes sad AP.

Beta potions and Macguffin Muffins are smart enough to only activate if not already active.

The optimal zone for gold sniping is calculated using a set of values from pins that show stats necessary to do each zone. If the manual threshold is met for a zone, the script will snipe a boss without fast combat. If the idle threshold is met, the script will snipe a boss using fast combat. Beast Mode will always be turned off for this.

The stats for the zones can be manually overriden using the zoneOverrides.json file in the user's directory. For the default stats used see here

Pressing the F3 button will dump a NGU save file as well as a ngusav.es JSON file in the folder on desktop, which can be loaded into Gear Optimizer.

Pressing the F7 button will load the save created by the quicksave function

Pressing the F5 button will dump your current equipment to the log file for use in allocation files

The adventure log will automatically be monitored and loot dropped will be written to loot.log in the folder on your desktop.

The pitspin.log file will contain the results of each automatic money pit, daily spin, and yggdrasil harvest and will persist across sessions.

Pressing the F2 button will globally disable all features of the app until re-enabled.

Have you forgotten to turn on auto attack before and left yourself AFK in ITOPOD doing nothing? Me too! Pressing the F4 button will toggle the script to automatically turn auto attack on if you're in ITOPOD and its not on.

Lock a boost in your inventory and the script will automatically merge boosts on to that boost until it hits level 100!

SharpMonoInjector can be found here. This wouldn't be possible without the excellent work done there. Obviously 4G for making NGU Idle. Altizar on discord for WISH logic, cooking logic and some other fixes Ingwar on discord for allocation profile logic and some other fixes