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

54 lines
1.6 KiB
Markdown
Raw Normal View History

2021-10-30 18:34:14 +02:00
<!-- 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; [weaken](./bitburner.ns.weaken.md)
## NS.weaken() method
2021-11-03 05:27:21 +01:00
Reduce a server security level.
2021-10-30 18:34:14 +02:00
<b>Signature:</b>
```typescript
2021-10-30 21:46:34 +02:00
weaken(host: string, opts?: BasicHGWOptions): Promise<number>;
2021-10-30 18:34:14 +02:00
```
## Parameters
| Parameter | Type | Description |
| --- | --- | --- |
2021-10-30 21:46:34 +02:00
| host | string | Hostname of the target server to weaken. |
2021-10-30 18:34:14 +02:00
| opts | [BasicHGWOptions](./bitburner.basichgwoptions.md) | Optional parameters for configuring function behavior. |
<b>Returns:</b>
Promise&lt;number&gt;
The amount by which the target servers security level was decreased. This is equivalent to 0.05 multiplied by the number of script threads.
## Remarks
RAM cost: 0.15 GB
2022-01-08 19:25:06 +01:00
Use your hacking skills to attack a servers security, lowering the servers security level. The runtime for this command depends on your hacking level and the target servers security level when this function is called. This function lowers the security level of the target server by 0.05.
2021-11-03 05:27:21 +01:00
Like hack and grow, `weaken` can be called on any server, regardless of where the script is running. This command requires root access to the target server, but there is no required hacking level to run the command.
2021-10-30 18:34:14 +02:00
2022-01-08 19:25:06 +01:00
## Example 1
2021-10-30 18:34:14 +02:00
2021-10-30 21:46:34 +02:00
```ts
2022-01-08 19:25:06 +01:00
// NS1:
var currentSecurity = getServerSecurityLevel("foodnstuff");
currentSecurity = currentSecurity - weaken("foodnstuff");
```
## Example 2
```ts
// NS2:
let currentSecurity = ns.getServerSecurityLevel("foodnstuff");
currentSecurity -= await ns.weaken("foodnstuff");
2021-10-30 18:34:14 +02:00
```