bitburner-src/markdown/bitburner.ns.hack.md
Olivier Gagnon feb0430aff work on doc
2021-10-30 15:46:34 -04:00

1.4 KiB
Raw Blame History

Home > bitburner > NS > hack

NS.hack() method

Function that is used to try and hack servers to steal money and gain hacking experience. The runtime for this command depends on your hacking level and the target servers security level. In order to hack a server you must first gain root access to that server and also have the required hacking level.

A script can hack a server from anywhere. It does not need to be running on the same server to hack that server. For example, you can create a script that hacks the foodnstuff server and run that script on any server in the game.

A successful hack() on a server will raise that servers security level by 0.002.

Signature:

hack(host: string, opts?: BasicHGWOptions): Promise<number>;

Parameters

Parameter Type Description
host string Hostname of the target server to hack.
opts BasicHGWOptions Optional parameters for configuring function behavior.

Returns:

Promise<number>

The amount of money stolen if the hack is successful, and zero otherwise.

Remarks

RAM cost: 0.1 GB

Example

hack("foodnstuff");
hack("10.1.2.3");
hack("foodnstuff", { threads: 5 }); // Only use 5 threads to hack