bitburner-src/markdown/bitburner.ns.md

Home > bitburner > NS

NS interface

Collection of all functions passed to scripts

Signature:

export interface NS 

Remarks

Basic usage example:

export async function main(ns) {
 // Basic ns functions can be accessed on the ns object
 ns.getHostname();
 // Some related functions are gathered under a sub-property of the ns object
 ns.stock.getPrice();
 // Most functions that return a promise need to be awaited.
 await ns.hack('n00dles');
}

ns2 in-game docs

---

For (deprecated) .script usage, see: ns1 in-game docs

---

Properties

Property	Modifiers	Type	Description
args	readonly	(string | number | boolean)[]	Arguments passed into the script.
bladeburner	readonly	Bladeburner	Namespace for bladeburner functions. Contains spoilers.
codingcontract	readonly	CodingContract	Namespace for codingcontract functions.
corporation	readonly	Corporation	Namespace for corporation functions. Contains spoilers.
enums		NSEnums
formulas	readonly	Formulas	Namespace for formulas functions.
gang	readonly	Gang	Namespace for gang functions. Contains spoilers.
grafting	readonly	Grafting	Namespace for grafting functions. Contains spoilers.
hacknet	readonly	Hacknet	Namespace for hacknet functions. Some of this API contains spoilers.
infiltration	readonly	Infiltration	Namespace for infiltration functions.
pid	readonly	number	The current script's PID
singularity	readonly	Singularity	Namespace for singularity functions. Contains spoilers.
sleeve	readonly	Sleeve	Namespace for sleeve functions. Contains spoilers.
stanek	readonly	Stanek	Namespace for stanek functions. Contains spoilers.
stock	readonly	TIX	Namespace for stock functions.
ui	readonly	UserInterface	Namespace for user interface functions.

Methods

Method	Description
alert(msg)	Open up a message box.
asleep(millis)	Suspends the script for n milliseconds. Doesn't block with concurrent calls.
atExit(f)	Add callback function when the script dies
brutessh(host)	Runs BruteSSH.exe on a server.
clear(handle)	Clear data from a file.
clearLog()	Clears the script’s logs.
clearPort(handle)	Clear data from a port.
closeTail(pid)	Close the tail window of a script.
deleteServer(host)	Delete a purchased server.
disableLog(fn)	Disables logging for the given function.
enableLog(fn)	Enable logging for a certain function.
exec(script, hostname, threadOrOptions, args)	Start another script on any server.
exit()	Terminates the current script immediately.
fileExists(filename, host)	Check if a file exists.
flags(schema)	Parse command line flags.
formatNumber(n, fractionalDigits, suffixStart, isInteger)	Format a number.
formatPercent(n, fractionalDigits, multStart)	Format a number as a percentage.
formatRam(n, fractionalDigits)	Format a number as an amount of ram.
ftpcrack(host)	Runs FTPCrack.exe on a server.
getBitNodeMultipliers(n, lvl)	Get the current Bitnode multipliers.
getFavorToDonate()	Returns the amount of Faction favor required to be able to donate to a faction.
getFunctionRamCost(name)	Get the ram cost of a netscript function.
getGrowTime(host)	Get the execution time of a grow() call.
getHackingLevel()	Returns the player’s current hacking level.
getHackingMultipliers()	Get hacking related multipliers.
getHacknetMultipliers()	Get hacknet related multipliers.
getHackTime(host)	Get the execution time of a hack() call.
getHostname()	Returns a string with the hostname of the server that the script is running on.
getMoneySources()	Get information about the sources of income for this run.
getPlayer()	Get information about the player.
getPortHandle(portNumber)	Get all data on a port.
getPurchasedServerCost(ram)	Get cost of purchasing a server.
getPurchasedServerLimit()	Returns the maximum number of servers you can purchase.
getPurchasedServerMaxRam()	Returns the maximum RAM that a purchased server can have.
getPurchasedServers()	Returns an array with the hostnames of all of the servers you have purchased.
getPurchasedServerUpgradeCost(hostname, ram)	Get cost of upgrading a purchased server to the given ram.
getRecentScripts()	Get an array of recently killed scripts across all servers.
getResetInfo()	Get information about resets.
getRunningScript(filename, hostname, args)	Get general info about a running script.
getScriptExpGain(script, host, args)	Get the exp gain of a script.
getScriptIncome(script, host, args)	Get the income of a script.
getScriptLogs(fn, host, args)	Get all the logs of a script.
getScriptName()	Returns the current script name.
getScriptRam(script, host)	Get the ram cost of a script.
getServer(host)	Returns a server object for the given server. Defaults to the running script's server if host is not specified.
getServerBaseSecurityLevel(host)	Get the base security level of a server.
getServerGrowth(host)	Get a server growth parameter.
getServerMaxMoney(host)	Get the maximum money available on a server.
getServerMaxRam(host)	Get the maximum amount of RAM on a server.
getServerMinSecurityLevel(host)	Returns the minimum security level of the target server.
getServerMoneyAvailable(host)	Get money available on a server.
getServerNumPortsRequired(host)	Returns the number of open ports required to successfully run NUKE.exe on the specified server.
getServerRequiredHackingLevel(host)	Returns the required hacking level of the target server.
getServerSecurityLevel(host)	Get server security level.
getServerUsedRam(host)	Get the used RAM on a server.
getSharePower()	Calculate your share power. Based on all the active share calls.
getTimeSinceLastAug()	Returns the amount of time in milliseconds that have passed since you last installed Augmentations.
getTotalScriptExpGain()	Get the exp gain of all scripts.
getTotalScriptIncome()	Get the income of all scripts.
getWeakenTime(host)	Get the execution time of a weaken() call.
grow(host, opts)	Spoof money in a server's bank account, increasing the amount available.
growthAnalyze(host, multiplier, cores)	Calculate the number of grow threads needed for a given multiplicative growth factor.
growthAnalyzeSecurity(threads, hostname, cores)	Calculate the security increase for a number of grow threads.
hack(host, opts)	Steal a server's money.
hackAnalyze(host)	Get the part of money stolen with a single thread.
hackAnalyzeChance(host)	Get the chance of successfully hacking a server.
hackAnalyzeSecurity(threads, hostname)	Get the security increase for a number of threads.
hackAnalyzeThreads(host, hackAmount)	Calculate the decimal number of threads needed to hack a specified amount of money from a target host.
hasRootAccess(host)	Check if you have root access on a server.
hasTorRouter()	Returns whether the player has access to the darkweb.
httpworm(host)	Runs HTTPWorm.exe on a server.
isLogEnabled(fn)	Checks the status of the logging for the given function.
isRunning(script, host, args)	Check if a script is running.
kill(pid)	Terminate the script with the provided PID.
kill(filename, hostname, args)	Terminate the script(s) with the provided filename, hostname, and script arguments.
killall(host, safetyguard)	Terminate all scripts on a server.
ls(host, substring)	List files on a server.
moveTail(x, y, pid)	Move a tail window.
mv(host, source, destination)	Move a file on the target server.
nFormat(n, format)	Format a number using the numeral library. This function is deprecated and will be removed in 2.4.
nuke(host)	Runs NUKE.exe on a server.
peek(portNumber)	Get a copy of the data from a port without popping it.
print(args)	Prints one or more values or variables to the script’s logs.
printf(format, args)	Prints a formatted string to the script’s logs.
prompt(txt, options)	Prompt the player with an input modal.
ps(host)	List running scripts on a server.
purchaseServer(hostname, ram)	Purchase a server.
read(filename)	Read content of a file.
readPort(portNumber)	Read data from a port.
relaysmtp(host)	Runs relaySMTP.exe on a server.
renamePurchasedServer(hostname, newName)	Rename a purchased server.
resizeTail(width, height, pid)	Resize a tail window.
rm(name, host)	Delete a file.
run(script, threadOrOptions, args)	Start another script on the current server.
scan(host)	Get the list of servers connected to a server.
scp(files, destination, source)	Copy file between servers.
scriptKill(script, host)	Kill all scripts with a filename.
scriptRunning(script, host)	Check if any script with a filename is running.
serverExists(host)	Returns a boolean denoting whether or not the specified server exists.
share()	Share the server's ram with your factions.
sleep(millis)	Suspends the script for n milliseconds.
spawn(script, threadOrOptions, args)	Terminate current script and start another in 10 seconds.
sprintf(format, args)	Format a string.
sqlinject(host)	Runs SQLInject.exe on a server.
tail(fn, host, args)	Open the tail window of a script.
tFormat(milliseconds, milliPrecision)	Format time to a readable string.
toast(msg, variant, duration)	Queue a toast (bottom-right notification).
tprint(args)	Prints one or more values or variables to the Terminal.
tprintf(format, values)	Prints a raw value or a variable to the Terminal.
tryWritePort(portNumber, data)	Attempt to write to a port.
upgradePurchasedServer(hostname, ram)	Upgrade a purchased server's RAM.
vsprintf(format, args)	Format a string with an array of arguments.
weaken(host, opts)	Reduce a server's security level.
weakenAnalyze(threads, cores)	Predict the effect of weaken.
wget(url, target, host)	Download a file from the internet.
write(filename, data, mode)	Write data to a file.
writePort(portNumber, data)	Write data to a port.