EVESalvage

[Amadeus]

DESCRIPTION
This script is designed to be used as a 'cleanup' script after doing missions or any other situation in which you have created a large number of wrecks in certain locations. I designed it primarily in order so that I could go out, do two missions, then return to my base and have my 'salvage ship' go out and do all the salvaging while I take a break.

The bot will also loot the cans left behind by wrecks with loot if you tell it to do so. An added bonus to this is that since the script simply checks for cans in space, if there are any in the area that you own (ie, a ship dropped a can as loot) it will loot that for you as well.) The script also comes with an xml file that keeps track of items you have looted and allows you to select whether you want to ignore that item type or loot it everytime the bot encounters it.

The bot will salvage/loot any entity that belongs to a member of your current fleet or corporation. It also has functionality that allows you to indicate to the bot that you want it to salvage at a particular fleet member rather than a bookmark. Finally, it has a flag that allows you to indicate to the bot that you want it to stop completely after its final salvage/loot operation (rather than returning to a home base.)


REQUIREMENTS:

1. A ship fitted with at least 1 salvager module and 1 tractor beam module. (Optimal would be 4 of each on a 'destroyer' type ship; suggested min. would be 2 of each). It is important to note that the script works best if you have equal numbers of salvagers and tractor beams.
2. The script will utilize an afterburner if you have one equipped; however, it is not required.

INSTRUCTIONS (using bookmarks):

1. For each location that you want to do salvaging, create a bookmark with a unique label (ie, "Salvage1"). (Typically, you would create this bookmark while on your mission that creates the wrecks in the first place.) Your bookmarks can be any number of different systems.
2. While inside your home station, make your salvage ship your 'active' ship. Make sure all cargoholds are closed. You MUST run this script while *IN* a station. Also, before you run the script, make sure that you do not have a bookmark created that points to the station you're in at ALL (regardless of the bookmark's label.) The script creates a bookmark and it will only do that if there is currently no bookmark in existance that points to the current station.
3. Run the script using the bookmark labels that you created along with any optional flags that the script supports. Currently, these are your options:

>run EVESalvage <bookmarklabel1> <bookmarklabel2> ...
   : Salvages at these bookmark locations, no looting >

run EVESalvage -loot <bookmarklabel1> <bookmarklabel2> ...
   : Salvages at these bookmark locations, looting cans as it goes (Note: You can use as many bookmark locations as you wish.)

After following those instructions, the script will perform the following actions:

1. Undock
2. Warp/Autopilot to the first bookmark
3. Salvage all wrecks utilizing your afterburner (if applicable) and tractor beams
4. Remove the first bookmark.
5. Repeat 2-4 for the remainder of the bookmarks given
6. Return to your base, dock, and unload all salvaged items to your hangar. If you looted items, then only the items you looted along with all salvaged items will be unloaded.

If you have selected the looting option, then after each salvage attempt the script will check for cargo containers in space (ie, cans). It will tractor and/or approach the can, and then open it. The script will then check your xml file (EVEIgnoreLootingItems.xml) -- if the item name is marked as TRUE, then it will ignore the item. If the item is set to FALSE it will be looted. If it doesn't exist in the file, then it will be added to the xml file with a default setting of FALSE and looted. Finally, if you happen to get a full ship while salvaging, the script should go back to your home station, unload, and then come back to that same location and resume.


XML File:
This script produces an xml file called "EVEIgnoreLootingItems.xml". It contains a list of all of the items you have looted while using the script. Items set to TRUE are ignored and not looted while items set to FALSE will be looted. (ie, TRUE = ignored, FALSE = not ignored.)

If an item looted does not exist in the file, it will be added with a default setting of FALSE.


INSTRUCTIONS (using the 'at' flag)

1. Make sure that the person that you wish to be the destination of your salvage bot is in your current fleet.

> run EVESalvage -at <NAME>
: Travel to, and then salvage at the location of the given fleet member's name

*NOTE: You can add the '-stop' flag to this runscript command to direct the bot to stop in its tracks after finishing the final salvage/loot operation.

INSTALLATION:

1. Make sure that you have a valid subscription to ISXEQ2 and that it is properly installed.
2. Download Tortoise SVN from the internet at http://tortoisesvn.net/downloads. Then, install it and reboot your computer. Reboot.
3. Open Windows Explorer and browse to your /innerspace/Scripts folder. Right click anywhere in this folder and choose the option "SVN Checkout". In the window that pops up, enter https://github.com/isxGames/isxScripts/trunk/EVE-Online/Scripts/EVESalvage as the "URL of Repository" and then be sure that the checkout path is "/innerspace/Scripts/EVESalvage". (Leave the other settings alone.)
4. The new directory that was created (/innerspace/Scripts/EVESalvage) should have an "SVN" icon in it. You can now update this directory at any time by right-clicking it in Windows Explorer and choosing the option "SVN Update". You should update this directory every so often to stay up-to-date with your files.

 

[Amadeus]

EXAMPLES:

Let's say I have three bookmarks for the three locations that have wrecks I want to loot and they're named "Spot1", "Spot2", and "Spot3":

run EVESalvage Spot1 Spot2 Spot3

Now, let's imagine that I want to loot all of the wrecks as I go (using those three bookmarks.)

run EVESalvage [COLOR=red]-loot[/COLOR] Spot1 Spot2 Spot3

Ok -- let's say that my main character is "Amadeus" and I'm running my salvager on my alt. "Amadeus" is at the location that has the wrecks (wherever that might be) and he's in my current fleet. I also want to loot all cans as I go and have the bot remain where it is when finished (rather than returning to a home station.)

run EVESalvage [COLOR=red]-loot[/COLOR] [COLOR="#00FF00"]-stop -at[/COLOR] Amadeus

 

[Amadeus]

USAGE (from script -- for those that process better in this format)

* Syntax:   'run EVESalvage [flags] <bookmarklabel1> <bookmarklabel2> ...'
*           'run EVESalvage -at <FleetMemberName>'
*           'run EVESalvage -here'
*
* Flags:    '-loot'                 [the script will loot all cans that are found in space]
*           '-stop'                 [the script will stop after the last wreck is handled and will not return to the base/location from which you started]
*           '-cyclebelts #'         [after everything else is handled, the script will cycle through all asteroid belts in the current solar system # times]
*           '-here'                 [the script will only work at your current location (it will return to your 'home station' unless the -stop flag is used)]
*           '-IgnoreContraband'     [the script will not loot contraband (only applicable if the '-loot' flag is used)]
*           '-IgnoreRightsOnWrecks' [the script will take the time to salvage wrecks for which you do not have loot rights (after all other wrecks have been salvaged)]
*           '-IgnoreRightsOnCans'   [when '-loot' is used, the script will attempt to loot all cans regardless of 'loot rights']
*           '-maxTargets #'         [indicates maximum number of targets you wish to use (otherwise, default to the maximum you or your ship can handle)]
*
* Examples: 'run EVESalvage -loot -here -stop'
*           'run EVESalvage -loot Salvage1 Salvage2 Salvage3'
*           'run EVESalvage -loot -IgnoreRightsOnWrecks -cyclebelts 999'
*
* NOTES:
*           1.  EVESalvage will unload to a station with a bookmark labeled 'Salvager Home Base'.  If this bookmark does not exist, it will be created
*               if you start the script while in a station.   This bookmark is NOT deleted after the script ends.  So, if you want to set a new station
*               for unloading, you will need to delete the old bookmark.
*
*           2.  The '-CycleBelts #' option will cycle through the belts in the system that is current once all other directives have been processed.

 

[Amadeus]

Version 3.1
* Updated all "Fleet" references to utilize the new methodology implimented in ISXEVE.

 

[Amadeus]

Version 3.2
* Fixed a bug in 3.1 that was causing the script to not work when using the "-at" parameter.

 

[Amadeus]

Version 3.3

Initial update for the 11.2.2010 version of ISXEVE. (Further updates/testing may be necessary.)

See links on initial posting in this thread for files.

 

[Amadeus]

Re: EVESalvage v. 3.2

Version 3.4

Initial update for the 1.29.2012 version of ISXEVE. (Further updates/testing may be necessary.)

See links on initial posting in this thread for files. Please note that they changed this release.

 

[Amadeus]

Re: EVESalvage v. 3.5

Version 3.5

* Fixed the script. It should now be running as originally designed!
* Added a new flag (-here). If used, the script will only salvage at the location that it is at that point. If you want the script to end after it salvages in that location, then be sure to use the "-stop" flag as well. For example, "run EVESalvage -loot -stop -here" might be a useful version of this script if you just want to salvage where you are currently and not go anywhere (it's also useful for debugging.)

See links on initial posting in this thread for files. Please note that they changed this release.

 

[Amadeus]

Version 4.0+

* Major update! Lots of efficiency improvements, etc.
* Script is now housed on the SVN in a different location than before. You must read the NEW installation instructions on the first post of this thread!!
* This thread will not be updated in the future. The script will only be updated in SVN (as described in the new installation instructions.) So, update via SVN often to make sure you have the latest version.

 

[Amadeus]

Version 4.0+

* ISXEVE has been updated in order to fix a few bugs that was causing problems with EVESalvage
* Fixed some typographical errors
* Added a new flag: "-MaxTargets #" This is useful for testing, or if you simply want to keep the script limited to a particular number of locked targets.
* When no indication of 'maxtargets' is given, EVESalvage will now default to using whichever is lower: ${Me.MaxLockedTargets} or ${Me.Ship.MaxLockedTargets}

 

[Amadeus]

Version 4.0+

* Major bugs fixed with regard to comparing int64 IDs. Everyone must remember to use "if (${Variable1.Equal[${Variable2}]})" not "if (${Variable1} == ${Variable2})". This should upgrade the script SIGNIFICANTLY (i.e., it will now use all of your tractor beams!)
* A few more typographical errors have been corrected

 

[Amadeus]

Version 4.0+

* Quite a few tweaks and bug fixes
* Ship Cargo Window stays open throughout the entire salvaging operation (for efficiency/speed)
* Items in ship's cargo are only "stacked" when the cargo window is closed (for efficiency/speed)
* Fixed issues related to using bookmarks
* It should now be possible to start the script anywhere and it function properly regardless of the status/distance/etc. of the salvage fields
* EVESalvage will no longer delete the bookmark "Salvager Home Base" after each use.
* Added more documentation for usage. To see the text below, simply use "run evesalvage" (i.e., with no parameters)

 

[Amadeus]

Version 4.0+

* Quite a few more bug fixes and tweaks for efficiency and reliability (you definitely want to get this new version)
* Updated the routine that 'loots' the cargo containers. It is now significantly more efficient and much faster than before
* Added new feature that can be activated via parameters:

'-IgnoreContraband' [the script will not loot contraband (only applicable if the '-loot' flag is used)]

 

[Amadeus]

Version 4.0+

* Fixed issue that would cause a perpertual loop if there were cargo containers in the area, but you had no loot rights on any of them.
* The script now allows you to use the -at flag along with bookmarks (it will process the -at directive first, and then any bookmarks you provide)
* The script will now process the -here flag and then continue on with any other directives (unless you also provided the -stop flag)
* Added a new FEATURE: '-cyclebelts #'. This flag indicates that the Salvager should cycle through the asteroid belts in that system # times (salvaging at each stop.) If you want it to cycle all day, just provide a big number like 9999.
- Please NOTE that the script will process the '-at' flag (if provided) and any bookmarks (if applicable) before starting the cycling of asteroid belts.
- Also, please note that the script doesn't (yet) have any checks for low shield/armor or hostile handling if you're in a dangerous area.


EXAMPLE USAGE:

run EVESalvage -loot -IgnoreRightsOnWrecks -cyclebelts 999 Salvage1 Salvage2

The above command will tell the script to LOOT cans as it goes and to salvage "yellow" wrecks. It also directs the script to go and salvage and bookmark "Salvage1", then "Salvage2". After that, it will cycle through all of the asteroid belts in its current system (i.e., the system where 'Salvage2' is located) 999 times. After it's finished, it will go back to the station bookmark "Salvager Home Base" or, if it does not exist, will immediately end.

Or, if you just want to cycle through the asteroid belts in your current system:

run EVESalvage -loot -IgnoreRightsOnWrecks -cyclebelts 999

 

[Amadeus]

Version 4.0+

* Fixed an issue where you could have an endless loop occur during the targeting routine
* Removed the '-SalvYellowWrecks' flag in favor of the new paradigm below
* Updated the syntax/usage spew with more examples and additional notes (type 'run evesalvage' to see it in the console.)
* Added new parameters:

*           '-IgnoreRightsOnWrecks' [the script will take the time to salvage wrecks for which you do not have loot rights (after all other wrecks have been salvaged)]
*           '-IgnoreRightsOnCans'   [when '-loot' is used, the script will attempt to loot all cans regardless of 'loot rights']

 

[Amadeus]

Version 4.0+

* Misc. bug fixes and other optimizations (the script should process everything much faster now.)
* The script will now attempt to handle bad targets caused by the EVE 'target back' option. (Turn that off if you want the script to run 100% perfectly.)
* The script will unlock all current targets if "ended" while running.
* For those that hate typing long parameter options when running the script, the following aliases will now work:

-LC  == -LootContraband
-IROC == -IgnoreRightsOnCans
-IROW == -IgnoreRightsOnWrecks

 

[Amadeus]

Version 4.0+
* The salvager will no longer 'wait' while locking all targets. This is a major boost to efficiency.
* EVESalvage will now utilize Sensor Boosters
* Removed the parameter flag "-IgnoreContraband"
* Added new parameter flag "-LootContraband"
(In other words, the script will now IGNORE 'contraband items' by default. If you want to loot contraband, then use the '-LootContraband' parameter flag when starting the script.)
* EVESalvage will now loot cans by default. (See changes below for more information.)
* The parameter flag '-loot' is now deprecated and will not do anything (It will be removed in a later patch.)
* Added new parameter flag '-NoLoot'. This flag indicates to the script that no looting should take place.
* EVESalvage should no longer use more than one salvager module on the same wreck at the same time.
* Updated all "waits" in the script to make it run *MUCH* faster. If you have issues and want to slow down or speed up the waiting, you can use the new '-WaitTimeVar #' parameter flag:

'-WaitTimeVar #'        [The script will 'wait #' while changing targets and activating/deactivating modules"

(NOTE: The default value is 3 and should suffice for most users with good FPS.)

 

[Amadeus]

Version 4.0+
* Humanized the targeting juuuust a bit
* Script will now check for loot (cans) within tractor range before 'moving' to wrecks that are out of tractor range.
* Fixed a few bugs and optimized a few things.
* The 'syntax' (help) text will now spew to a lavishUI window instead of the console. Type "Run EVESalvage" to see the manual.
* Added ability to unload at a "Corporate Hangar Array" if so desired. TYPE 'run EVESalvage' FOR USAGE AND MORE INFORMATION!)
* Added ability to unload to a corporate hangar instead of your personal hangar (when using a 'station bookmark' as your home base bookmark.)
* In the past, EVESalvage used a bookmark called "Salvager Home Base" to keep track of where to return and unload after finishing. This is still the default. However, now, you can set it to a location in space as well as a station (see the '-UnloadTo <NAME>' parameter) and you can name it something else if you want (see the '-HomeBase <NAME>' parameter.) Again, type "run evesalvage" for examples on how to run the script with these new features.
* Added "Cargo Container" and "Secure Cargo Container" group types as valid '-UnloadTo <NAME>' destinations.
* Revamped the routines that handle a 'full' ship. In other words, EVESalvage should now properly return to your unload location, unload, and then go back to the previous location at any time that the cargo hold is full.
* If your cargo hold is full, and you do not have a "HomeBase" bookmark set. Then, the script will just give up and ":End"
* Added "Industrial Command Ship" (i.e., Orca) as a valid group type for the '-UnloadTo <NAME>' destination.

For information on the script, including command line arguments and examples, please type "run evesalvage" in the console with no arguments. You'll now get a popup window that contains everything you need to know (you can safely close that window at any time.)

 

[Amadeus]

April 9, 2016
* Updated the installation instructions (in the original posting on this thread.)

 

[Amadeus]

October 15, 2025
* Updated path to isxevepopup.xml