Personal_mirrors/bitburner-src
1
0
Fork 0
mirror of https://github.com/bitburner-official/bitburner-src.git synced 2024-12-18 20:25:45 +01:00
Code Issues Packages Projects Releases Wiki Activity
2141032432
bitburner-src/markdown/bitburner.runningscript.md
David Walker 9c9a69f2e2
NETSCRIPT: Add ramOverride() function (#1346) 
This adds a way to dynamically change the static RAM limit of a script,
which is also its current RAM usage. This makes it possible for scripts
to dynamically change their memory footprint, opening up new strategies
beyond current ram-dodging.

Calling functions still permanently increases the *dynamic* memory
limit; RAM-dodging is still the optimal strategy for avoiding RAM costs,
in that sense.

This also adds dynamicRamUsage to the info returned by
`getRunningScript`, to allow introspection on the currently needed ram.
2024-06-28 18:42:20 -07:00

3.3 KiB
Raw Blame History

Home > bitburner > RunningScript

RunningScript interface

Signature:

interface RunningScript

Properties

Property Modifiers Type Description
args ScriptArg[] Arguments the script was called with
dynamicRamUsage number | undefined

The dynamic RAM usage of (one thread of) this script instance. Does not affect overall RAM consumption (ramUsage is for that), but rather shows how much of the reserved RAM is currently in use via all the ns functions the script has called. Initially 1.6GB, this increases as new functions are called.

Only set for scripts that are still running.
filename string Filename of the script
logs string[] Script logs as an array. The newest log entries are at the bottom. Timestamps, if enabled, are placed inside [brackets] at the start of each line.
offlineExpGained number Total amount of hacking experience earned from this script when offline
offlineMoneyMade number Total amount of money made by this script when offline
offlineRunningTime number Number of seconds that the script has been running offline
onlineExpGained number Total amount of hacking experience earned from this script when online
onlineMoneyMade number Total amount of money made by this script when online
onlineRunningTime number Number of seconds that this script has been running online
pid number Process ID. Must be an integer
ramUsage number How much RAM this script uses for ONE thread. Also known as "static RAM usage," this value does not change once the script is started, unless you call ns.ramOverride().
server string Hostname of the server on which this script runs
tailProperties TailProperties | null Properties of the tail window, or null if it is not shown
temporary boolean Whether this RunningScript is excluded from saves
threads number Number of threads that this script runs with
title string | ReactElement The title, as shown in the script's log box. Defaults to the name + args, but can be changed by the user. If it is set to a React element (only by the user), that will not be persisted, and will be restored to default on load.