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. The latest release can be found here. Do not download the source code archive, instead download the zip file with the release version in the name. 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, restart NGU idle and run the inject script again.

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.
• allocation.json - Breakpoints for assigning gear, magic, energy, wandoos OS, rebirth time, and diggers. See the allocation section for more information

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

• loot.log - Logs all the loot dropped by enemies. Also logs money pit and daily spin results.
• 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

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

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

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

• 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

• 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 - Automatically spend EXP on energy/magic. Will use the custom caps set by the user in the spend exp page. Will always buy energy and magic in pairs.

• Money Pit Threshold - The amount of gold to wait for to throw gold into the money pit. Accepts scientific notation (ex: 1E+28)

• Manage Energy - Manage energy based on breakpoints in allocation.json

• Manage Magic - Manage magic based on breakpoints in allocation.json

• Manage R3 - Manage resource 3 based on breakpoints in allocation.json

• Manage Gear - Manage gear based on breakpoints in allocation.json

• Manage Diggers - Manage diggers based on breakpoints in allocation.json

• Manage Wandoos OS - Manage wandoos OS based on breakpoints in allocation.json

• Auto Rebirth - Automatically rebirth after the time in allocation.json 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

• Manage Yggdrasil - Automatically harvest fruits.
• Activate Fruits - Reactivate fruits you haven't bought the exp perk for
• Swap Loadout for Yggdrasil - Equip the loadout specified in YggdrasilLoadout before harvesting
• Loadout - Edit the loadout used for harvest yggdrasil. Add items using the box in the bottom.

• 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 boost conversion is unlocked from 100 Level Challenge, will calculate needed boosts for items in boostIds and then switch auto conversion appropriately. 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.

• Swap Loadout for Titans - Equip the gear in TitanLoadout right before any titan less than or equal your highest autokillable titan spawns
• Highest Autokillable Titan - The highest titan you can autokill in your TitanLoadout. When this titan or any previous titan is spawning.
• Loadout - The gear to equip when autokilling titans.

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

• Gold Loadout Zone - The zone in which to snipe a boss with the gold loadout gear equipped
• Use Gold Loadout - If checked, automation will go to the target zone and snipe a boss in gold loadout gear. This will automatically enable itself on each rebirth.
• Initial Gold Zone - Automation will visit this zone to kill an enemy to jumpstart your time machine initially.
• Loadout - Items to use when swapping for gold loadout.

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

• Priority Wishes - The wishes to prioritize doing. Will switch to cheapest wish when all wish priorities are complete

The allocation.json file is a JSON file that contains time breakpoints for configuring your gear, diggers, energy allocation and magic allocation. A sample allocation file can be found in the sampleprofile folder or on the repo here.

The time portion of every breakpoint refers to rebirth time in seconds.

An energy breakpoint is structured as follows:

{
"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.

When a cap priority is used, the equivalent of hitting the cap button will be used. If a cap button doesn't exist, the program will calculate an appropriate cap and attempt to BB for the next 10 seconds. If cap is higher than idle, all energy will be allocated to it. Cap priorities always run before regular priorities. When a non-cap priority is used, remaining energy after cap priorities will be evenly divided between the allocations specified.

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) - Use the cap button for the NGU
• CAPALLNGU - Use the cap button for every NGU starting from 0
• CAPAT-X (0-4) - Calculate a cap for the AT and attempt to BB it.
• CAPWAN - Use the cap button for wandoos energy
• CAPTM - Calculate a cap for energy time machine and attempt to BB it.
• CAPBT-X (0-11) - Use the cap button for basic training
• CAPAUG-X (0-13) - Calculate a cap for augments and attempt to BB it

Available non-cap priorities for Energy are as follows:

• NGU-X (0-8) - Allocate energy to NGU
• AT-X (0-4) - Allocate energy to AT
• AUG-X (0-13) - Allocate energy to augment
• 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-223) - Allocate energy to wish

More information on allocation indexes can be found on the wiki

A magic breakpoint is structured as follows:

{
"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.

When a cap priority is used, the equivalent of hitting the cap button will be used. If a cap button doesn't exist, the program will calculate an appropriate cap and attempt to BB for the next 10 seconds. Cap priorities always run before regular priorities. When a non-cap priority is used, remaining magic after cap priorities will be evenly divided between the allocations specified.

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.
• BR - Cast rituals from highest to lowest ignoring rituals you cant afford or will take more than an hour

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
• WISH-X (0-223) - Allocate energy to wish

More information on allocation indexes can be found on the wiki

An R3 breakpoint is structured as follows:

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

Available priorities for R3 are as follows:

• HACK-X (0-13) - Allocate R3 to hacks
• WISH-X (0-223) - Allocate R3 to wishes

A gear breakpoint is structured as follows:

{
    "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:

{
    "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:

{
    "Time": 0,
    "OS": 1
}

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

A rebirth breakpoint is added as follows:

"RebirthTime": -1

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

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 buttonw will dump your current equipment to the log file for use in allocation.json

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

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! The script will 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.