mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2026-04-24 02:03:01 +02:00
Michael Taylor
dcd2f33f7c
* Update api-documentor and api-extractor. #1566 follow-up.
I have verified that the HTML/markdown table generation bug in
[#4878](https://github.com/microsoft/rushstack/issues/4878) in rushstack
for api-documentor has been fixed as per rushstack#5256. The testcase
[repro](https://github.com/catloversg/api-documenter-bug-pr-4578) now
produces the correct expected output.
I have confirmed that the generated output in bitburner from
`npm run doc` now generated HTML tables, and correctly inserts
a blank line between the </table> and the follow line (e.g. Returns).
Stylisticly it could use some whitespace, but it is correctly rendered.
This commit is only the updated packages, not the updated generated
documentation. I assume that is automatically generated by the GitHub
workflow.
* Follow up to 5f732a6f35, include `npm run doc` changed docs.
* Add missing license info
* Fix React warning
---------
Co-authored-by: CatLover <152669316+catloversg@users.noreply.github.com>
91 lines
1.7 KiB
Markdown
91 lines
1.7 KiB
Markdown
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
||
|
||
[Home](./index.md) > [bitburner](./bitburner.md) > [NS](./bitburner.ns.md) > [weaken](./bitburner.ns.weaken.md)
|
||
|
||
## NS.weaken() method
|
||
|
||
Reduce a server's security level.
|
||
|
||
**Signature:**
|
||
|
||
```typescript
|
||
weaken(host: string, opts?: BasicHGWOptions): Promise<number>;
|
||
```
|
||
|
||
## Parameters
|
||
|
||
<table><thead><tr><th>
|
||
|
||
Parameter
|
||
|
||
|
||
</th><th>
|
||
|
||
Type
|
||
|
||
|
||
</th><th>
|
||
|
||
Description
|
||
|
||
|
||
</th></tr></thead>
|
||
<tbody><tr><td>
|
||
|
||
host
|
||
|
||
|
||
</td><td>
|
||
|
||
string
|
||
|
||
|
||
</td><td>
|
||
|
||
Hostname/IP of the target server to weaken.
|
||
|
||
|
||
</td></tr>
|
||
<tr><td>
|
||
|
||
opts
|
||
|
||
|
||
</td><td>
|
||
|
||
[BasicHGWOptions](./bitburner.basichgwoptions.md)
|
||
|
||
|
||
</td><td>
|
||
|
||
_(Optional)_ Optional parameters for configuring function behavior.
|
||
|
||
|
||
</td></tr>
|
||
</tbody></table>
|
||
|
||
**Returns:**
|
||
|
||
Promise<number>
|
||
|
||
A promise that resolves to the value by which security was reduced.
|
||
|
||
## Remarks
|
||
|
||
RAM cost: 0.15 GB
|
||
|
||
Use your hacking skills to attack a server’s security, lowering the server’s security level. The runtime for this function depends on your hacking level and the target server’s security level when this function is called.
|
||
|
||
This function usually lowers the security level of the target server by 0.05 per thread, and only in unusual situations does it do less. Use [weakenAnalyze](./bitburner.ns.weakenanalyze.md) to determine the exact value.
|
||
|
||
Like [hack](./bitburner.ns.hack.md) and [grow](./bitburner.ns.grow.md)<!-- -->, `weaken` can be called on any server, regardless of where the script is running. This function requires root access to the target server, but there is no required hacking level to run the function.
|
||
|
||
## Example
|
||
|
||
|
||
```js
|
||
let currentSecurity = ns.getServerSecurityLevel("foodnstuff");
|
||
currentSecurity -= await ns.weaken("foodnstuff");
|
||
```
|
||
|