NETSCRIPT: Add functionality and support to fully allow Players to use IP addresses in place of hostnames

markdown/bitburner.codingcontract.attempt.md

@@ -18,7 +18,7 @@ attempt(answer: any, filename: string, host?: string): string;
 |  --- | --- | --- |
 |  answer | any | Attempted solution for the contract. This can be a string formatted like submitting manually, or the answer in the format of the specific contract type. |
 |  filename | string | Filename of the contract. |
-|  host | string | _(Optional)_ Hostname of the server containing the contract. Optional. Defaults to current server if not provided. |
+|  host | string | _(Optional)_ Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided. |
 
 **Returns:**
 

markdown/bitburner.codingcontract.getcontract.md

@@ -17,7 +17,7 @@ getContract(filename: string, host?: string): CodingContractObject;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  filename | string | Filename of the contract. |
-|  host | string | _(Optional)_ Host of the server containing the contract. Optional. Default to the current server if not provided. |
+|  host | string | _(Optional)_ Hostname/IP of the server containing the contract. Optional. Default to the current server if not provided. |
 
 **Returns:**
 

markdown/bitburner.codingcontract.getcontracttype.md

@@ -17,7 +17,7 @@ getContractType(filename: string, host?: string): `${CodingContractName}`;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  filename | string | Filename of the contract. |
-|  host | string | _(Optional)_ Hostname of the server containing the contract. Optional. Defaults to current server if not provided. |
+|  host | string | _(Optional)_ Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided. |
 
 **Returns:**
 

markdown/bitburner.codingcontract.getdata.md

@@ -17,7 +17,7 @@ getData(filename: string, host?: string): any;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  filename | string | Filename of the contract. |
-|  host | string | _(Optional)_ Host of the server containing the contract. Optional. Defaults to current server if not provided. |
+|  host | string | _(Optional)_ Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided. |
 
 **Returns:**
 

markdown/bitburner.codingcontract.getdescription.md

@@ -17,7 +17,7 @@ getDescription(filename: string, host?: string): string;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  filename | string | Filename of the contract. |
-|  host | string | _(Optional)_ Hostname of the server containing the contract. Optional. Defaults to current server if not provided. |
+|  host | string | _(Optional)_ Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided. |
 
 **Returns:**
 

markdown/bitburner.codingcontract.getnumtriesremaining.md

@@ -17,7 +17,7 @@ getNumTriesRemaining(filename: string, host?: string): number;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  filename | string | Filename of the contract. |
-|  host | string | _(Optional)_ Hostname of the server containing the contract. Optional. Defaults to current server if not provided. |
+|  host | string | _(Optional)_ Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided. |
 
 **Returns:**
 

markdown/bitburner.hacknet.spendhashes.md

@@ -34,7 +34,7 @@ This function is only applicable for Hacknet Servers (the upgraded version of a
 
 Spend the hashes generated by your Hacknet Servers on an upgrade. Returns a boolean value - true if the upgrade is successfully purchased, and false otherwise.
 
-The name of the upgrade must be an exact match. The `upgTarget` argument is used for upgrades such as `Reduce Minimum Security`<!-- -->, which applies to a specific server. In this case, the `upgTarget` argument must be the hostname of the server.
+The name of the upgrade must be an exact match. The `upgTarget` argument is used for upgrades such as `Reduce Minimum Security`<!-- -->, which applies to a specific server. In this case, the `upgTarget` argument must be the hostname or IP of the server.
 
 ## Example
 

markdown/bitburner.hostreturnoptions.md

@@ -0,0 +1,20 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [HostReturnOptions](./bitburner.hostreturnoptions.md)
+
+## HostReturnOptions interface
+
+Options to control how a server identifier (hostname or IP address) is returned. Affects the behavior of [scan](./bitburner.ns.scan.md)<!-- -->, [getPurchasedServers](./bitburner.ns.getpurchasedservers.md)<!-- -->, and [getCurrentServer](./bitburner.singularity.getcurrentserver.md)
+
+**Signature:**
+
+```typescript
+interface HostReturnOptions 
+```
+
+## Properties
+
+|  Property | Modifiers | Type | Description |
+|  --- | --- | --- | --- |
+|  [returnByIP?](./bitburner.hostreturnoptions.returnbyip.md) |  | boolean | _(Optional)_ If set to <code>true</code>, returns IP addresses instead of hostnames. Defaults to <code>false</code>. |
+

markdown/bitburner.hostreturnoptions.returnbyip.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [HostReturnOptions](./bitburner.hostreturnoptions.md) &gt; [returnByIP](./bitburner.hostreturnoptions.returnbyip.md)
+
+## HostReturnOptions.returnByIP property
+
+If set to `true`<!-- -->, returns IP addresses instead of hostnames. Defaults to `false`<!-- -->.
+
+**Signature:**
+
+```typescript
+returnByIP?: boolean;
+```

markdown/bitburner.md

@@ -101,6 +101,7 @@
 |  [HacknetRAMRequirement](./bitburner.hacknetramrequirement.md) | Player's Hacknet devices must have at least this much total RAM. |
 |  [HacknetServerConstants](./bitburner.hacknetserverconstants.md) | Hacknet server related constants |
 |  [HacknetServersFormulas](./bitburner.hacknetserversformulas.md) | Hacknet Server formulas |
+|  [HostReturnOptions](./bitburner.hostreturnoptions.md) | Options to control how a server identifier (hostname or IP address) is returned. Affects the behavior of [scan](./bitburner.ns.scan.md)<!-- -->, [getPurchasedServers](./bitburner.ns.getpurchasedservers.md)<!-- -->, and [getCurrentServer](./bitburner.singularity.getcurrentserver.md) |
 |  [HP](./bitburner.hp.md) |  |
 |  [ILocation](./bitburner.ilocation.md) |  |
 |  [IndustryData](./bitburner.industrydata.md) | Corporation industry information |

markdown/bitburner.ns.brutessh.md

@@ -16,7 +16,7 @@ brutessh(host: string): boolean;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | Hostname of the target server. |
+|  host | string | Hostname/IP of the target server. |
 
 **Returns:**
 

markdown/bitburner.ns.deleteserver.md

@@ -16,7 +16,7 @@ deleteServer(host: string): boolean;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | Hostname of the server to delete. |
+|  host | string | Hostname/IP of the server to delete. |
 
 **Returns:**
 
@@ -28,7 +28,7 @@ True if successful, and false otherwise.
 
 2.25 GB
 
-Deletes one of your purchased servers, which is specified by its hostname.
+Deletes one of your purchased servers, which is specified by its hostname/ip.
 
-The hostname argument can be any data type, but it will be converted to a string. Whitespace is automatically removed from the string. This function will not delete a server that still has scripts running on it.
+The host argument can be any data type, but it will be converted to a string. Whitespace is automatically removed from the string. This function will not delete a server that still has scripts running on it.
 

markdown/bitburner.ns.dnslookup.md

@@ -0,0 +1,28 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [NS](./bitburner.ns.md) &gt; [dnsLookup](./bitburner.ns.dnslookup.md)
+
+## NS.dnsLookup() method
+
+Given a hostname, returns its IP address; or given an IP address, returns its hostname.
+
+**Signature:**
+
+```typescript
+dnsLookup(host: string): string;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  host | string | Hostname/IP of target server. |
+
+**Returns:**
+
+string
+
+## Remarks
+
+RAM cost: 0 GB
+

markdown/bitburner.ns.exec.md

@@ -9,15 +9,15 @@ Start another script on any server.
 **Signature:**
 
 ```typescript
-exec(script: string, hostname: string, threadOrOptions?: number | RunOptions, ...args: ScriptArg[]): number;
+exec(script: string, host: string, threadOrOptions?: number | RunOptions, ...args: ScriptArg[]): number;
 ```
 
 ## Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  script | string | Filename of script to execute. This file must already exist on the target server. |
-|  hostname | string | Hostname of the <code>target server</code> on which to execute the script. |
+|  host | string | Hostname/IP of the <code>target server</code> on which to execute the script. |
 |  threadOrOptions | number \| [RunOptions](./bitburner.runoptions.md) | _(Optional)_ Either an integer number of threads for new script, or a [RunOptions](./bitburner.runoptions.md) object. Threads defaults to 1. |
 |  args | [ScriptArg](./bitburner.scriptarg.md)<!-- -->\[\] | Additional arguments to pass into the new script that is being run. Note that if any arguments are being passed into the new script, then the third argument threadOrOptions must be filled in with a value. |
 

markdown/bitburner.ns.fileexists.md

@@ -17,7 +17,7 @@ fileExists(filename: string, host?: string): boolean;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  filename | string | Filename of file to check. |
-|  host | string | _(Optional)_ Host of target server. Optional, defaults to the server the script is running on. |
+|  host | string | _(Optional)_ Hostname/IP of target server. Optional, defaults to the server the script is running on. |
 
 **Returns:**
 

markdown/bitburner.ns.ftpcrack.md

@@ -16,7 +16,7 @@ ftpcrack(host: string): boolean;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | Hostname of the target server. |
+|  host | string | Hostname/IP of the target server. |
 
 **Returns:**
 

markdown/bitburner.ns.getgrowtime.md

@@ -16,7 +16,7 @@ getGrowTime(host: string): number;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | Hostname of target server. |
+|  host | string | Hostname/IP of target server. |
 
 **Returns:**
 

markdown/bitburner.ns.gethacktime.md

@@ -16,7 +16,7 @@ getHackTime(host: string): number;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | Hostname of target server. |
+|  host | string | Hostname/IP of target server. |
 
 **Returns:**
 

markdown/bitburner.ns.getip.md

@@ -0,0 +1,23 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [NS](./bitburner.ns.md) &gt; [getIP](./bitburner.ns.getip.md)
+
+## NS.getIP() method
+
+Returns a string with the IP address of the server that the script is running on.
+
+**Signature:**
+
+```typescript
+getIP(): string;
+```
+**Returns:**
+
+string
+
+IP address of the server that the script runs on.
+
+## Remarks
+
+RAM cost: 0.05 GB
+

markdown/bitburner.ns.getpurchasedservers.md

@@ -4,18 +4,25 @@
 
 ## NS.getPurchasedServers() method
 
-Returns an array with the hostnames of all of the servers you have purchased.
+Returns an array with the hostnames or IP addresses of all of the servers you have purchased. Returns hostnames by default.
 
 **Signature:**
 
 ```typescript
-getPurchasedServers(): string[];
+getPurchasedServers(returnOpts?: HostReturnOptions): string[];
 ```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  returnOpts | [HostReturnOptions](./bitburner.hostreturnoptions.md) | _(Optional)_ Optional. Controls whether the function returns IPs |
+
 **Returns:**
 
 string\[\]
 
-Returns an array with the hostnames of all of the servers you have purchased.
+Returns an array with the hostnames or IP addresses of all of the servers you have purchased.
 
 ## Remarks
 

markdown/bitburner.ns.getpurchasedserverupgradecost.md

@@ -9,21 +9,21 @@ Get cost of upgrading a purchased server to the given ram.
 **Signature:**
 
 ```typescript
-getPurchasedServerUpgradeCost(hostname: string, ram: number): number;
+getPurchasedServerUpgradeCost(host: string, ram: number): number;
 ```
 
 ## Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  hostname | string | Hostname of the server to upgrade. |
+|  host | string | Hostname/IP of the server to upgrade. |
 |  ram | number | Amount of RAM of the purchased server, in GB. Must be a power of 2 (2, 4, 8, 16, etc.). Maximum value of 1048576 (2^20). |
 
 **Returns:**
 
 number
 
-The price to upgrade or -1 if either input is not valid, i.e. hostname is not the name of a purchased server or ram is not a valid amount.
+The price to upgrade or -1 if either input is not valid, i.e. host is not the name of a purchased server or ram is not a valid amount.
 
 ## Remarks
 

markdown/bitburner.ns.getrunningscript.md

@@ -9,15 +9,15 @@ Get general info about a running script.
 **Signature:**
 
 ```typescript
-getRunningScript(filename?: FilenameOrPID, hostname?: string, ...args: ScriptArg[]): RunningScript | null;
+getRunningScript(filename?: FilenameOrPID, host?: string, ...args: ScriptArg[]): RunningScript | null;
 ```
 
 ## Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  filename | [FilenameOrPID](./bitburner.filenameorpid.md) | _(Optional)_ Optional. Filename or PID of the script. |
-|  hostname | string | _(Optional)_ Hostname of target server. Optional, defaults to the server the calling script is running on. |
+|  host | string | _(Optional)_ Hostname/IP of target server. Optional, defaults to the server the calling script is running on. |
 |  args | [ScriptArg](./bitburner.scriptarg.md)<!-- -->\[\] | Arguments to specify/identify the script. Optional, when looking for scripts run without arguments. |
 
 **Returns:**
@@ -30,5 +30,5 @@ The info about the running script if found, and null otherwise.
 
 RAM cost: 0.3 GB
 
-Running with no args returns current script. If you use a PID as the first parameter, the hostname and args parameters are unnecessary. If hostname is omitted while filename is used as the first parameter, hostname defaults to the server the calling script is running on. Remember that a script is semi-uniquely identified by both its name and its arguments. (You can run multiple copies of scripts with the same arguments, but for the purposes of functions like this that check based on filename, the filename plus arguments forms the key.)
+Running with no args returns current script. If you use a PID as the first parameter, the host and args parameters are unnecessary. If host is omitted while filename is used as the first parameter, host defaults to the server the calling script is running on. Remember that a script is semi-uniquely identified by both its name and its arguments. (You can run multiple copies of scripts with the same arguments, but for the purposes of functions like this that check based on filename, the filename plus arguments forms the key.)
 

markdown/bitburner.ns.getscriptexpgain.md

@@ -17,7 +17,7 @@ getScriptExpGain(script: string, host: string, ...args: ScriptArg[]): number;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  script | string | Filename of script. |
-|  host | string | Server on which script is running. |
+|  host | string | Hostname/IP of the server on which script is running. |
 |  args | [ScriptArg](./bitburner.scriptarg.md)<!-- -->\[\] | Arguments that the script is running with. |
 
 **Returns:**

markdown/bitburner.ns.getscriptincome.md

@@ -17,7 +17,7 @@ getScriptIncome(script: string, host: string, ...args: ScriptArg[]): number;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  script | string | Filename of script. |
-|  host | string | Server on which script is running. |
+|  host | string | Hostname/IP of the server on which script is running. |
 |  args | [ScriptArg](./bitburner.scriptarg.md)<!-- -->\[\] | Arguments that the script is running with. |
 
 **Returns:**

markdown/bitburner.ns.getscriptlogs.md

@@ -17,7 +17,7 @@ getScriptLogs(fn?: FilenameOrPID, host?: string, ...args: ScriptArg[]): string[]
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  fn | [FilenameOrPID](./bitburner.filenameorpid.md) | _(Optional)_ Optional. Filename or PID of script to get logs from. |
-|  host | string | _(Optional)_ Optional. Hostname of the server that the script is on. |
+|  host | string | _(Optional)_ Optional. Hostname/IP of the server that the script is on. |
 |  args | [ScriptArg](./bitburner.scriptarg.md)<!-- -->\[\] | Arguments to identify which scripts to get logs for. |
 
 **Returns:**

markdown/bitburner.ns.getscriptram.md

@@ -17,7 +17,7 @@ getScriptRam(script: string, host?: string): number;
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  script | string | Filename of script. This is case-sensitive. |
-|  host | string | _(Optional)_ Hostname of target server the script is located on. This is optional. If it is not specified then the function will use the current server as the target server. |
+|  host | string | _(Optional)_ Hostname/IP of target server the script is located on. This is optional. If it is not specified then the function will use the current server as the target server. |
 
 **Returns:**
 

markdown/bitburner.ns.getserver.md

@@ -16,7 +16,7 @@ getServer(host?: string): Server;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | _(Optional)_ Optional. Hostname for the requested server object. |
+|  host | string | _(Optional)_ Optional. Hostname/IP for the requested server object. |
 
 **Returns:**
 

markdown/bitburner.ns.getserverbasesecuritylevel.md

@@ -16,7 +16,7 @@ getServerBaseSecurityLevel(host: string): number;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | Host of target server. |
+|  host | string | Hostname/IP of target server. |
 
 **Returns:**
 

markdown/bitburner.ns.getservergrowth.md

@@ -16,7 +16,7 @@ getServerGrowth(host: string): number;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | Hostname of target server. |
+|  host | string | Hostname/IP of target server. |
 
 **Returns:**
 

markdown/bitburner.ns.getservermaxmoney.md

@@ -16,7 +16,7 @@ getServerMaxMoney(host: string): number;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  host | string | Hostname of target server. |
+|  host | string | Hostname/IP of target server. |
 
 **Returns:**