bitburner-src/markdown/bitburner.ns.grow.md

54 lines
2.0 KiB
Markdown
Raw Normal View History

<!-- 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; [grow](./bitburner.ns.grow.md)
## NS.grow() method
Spoof money in a server's bank account, increasing the amount available.
**Signature:**
```typescript
grow(host: string, opts?: BasicHGWOptions): Promise<number>;
```
## Parameters
| Parameter | Type | Description |
| --- | --- | --- |
| host | string | Hostname of the target server to grow. |
| opts | [BasicHGWOptions](./bitburner.basichgwoptions.md) | _(Optional)_ Optional parameters for configuring function behavior. |
**Returns:**
Promise&lt;number&gt;
The number by which the money on the server was multiplied for the growth.
## Remarks
RAM cost: 0.15 GB
Use your hacking skills to increase the amount of money available on a server. The runtime for this command depends on your hacking level and the target servers security level. When `grow` completes, the money available on a target server will be increased by amount equal to the number of threads used and a certain, fixed percentage of current money on the server. This percentage is determined by the target servers growth rate (which varies between servers) and security level. Generally, higher-level servers have higher growth rates. The [getServerGrowth](./bitburner.ns.getservergrowth.md) function can be used to obtain a servers growth rate.
Like [hack](./bitburner.ns.hack.md)<!-- -->, `grow` can be called on any server, regardless of where the script is running. The grow() command requires root access to the target server, but there is no required hacking level to run the command. It also raises the security level of the target server by 0.004.
## Example 1
```ts
// NS1:
var currentMoney = getServerMoneyAvailable("foodnstuff");
currentMoney = currentMoney * grow("foodnstuff");
```
## Example 2
```ts
// NS2:
let currentMoney = ns.getServerMoneyAvailable("foodnstuff");
currentMoney *= await ns.grow("foodnstuff");
```