From b13122805da0c7270f86309ed4204c5e6358e71b Mon Sep 17 00:00:00 2001
From: ztimson <zaktimson@gmail.com>
Date: Thu, 28 Apr 2022 08:21:10 -0400
Subject: [PATCH] Added availableThreads function

---
 scripts/lib/utils.js | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/scripts/lib/utils.js b/scripts/lib/utils.js
index ac4fd67..1cbd558 100644
--- a/scripts/lib/utils.js
+++ b/scripts/lib/utils.js
@@ -12,6 +12,18 @@ export function addCSS(id, css) {
 	doc.head.insertAdjacentHTML('beforeend', `<style id="${id}">${css}</style`);
 }
 
+/**
+ * Calculate the maximum number of threads a script can be executed with the remaining available RAM on a server.
+ *
+ * @param {NS} ns - BitBurner API
+ * @param {string} script - Full path to script
+ * @param {string} server - Server script will run on
+ * @returns {number} - Number of threads the server will be able to support
+ */
+export function availableThreads(ns, script, server = ns.getHostname()) {
+	return ~~((ns.getServerMaxRam(server) - ns.getServerUsedRam(server)) / ns.getScriptRam(script, ns.getHostname()));
+}
+
 /**
  * Format number to look like a dollar value ($1,000.00).
  *
@@ -46,7 +58,7 @@ export function htmlPrint(html, wrap = true) {
 }
 
 /**
- * Calculate the maximum number of threads a script can be executed with.
+ * Calculate the maximum number of threads a script can be executed with using all server resources.
  *
  * @param {NS} ns - BitBurner API
  * @param {string} script - Full path to script
@@ -54,7 +66,7 @@ export function htmlPrint(html, wrap = true) {
  * @returns {number} - Number of threads the server will be able to support
  */
 export function maxThreads(ns, script, server = ns.getHostname()) {
-	return ~~(ns.getServerMaxRam(server) / ns.getScriptRam(script, ns.getHostname()))
+	return ~~(ns.getServerMaxRam(server) / ns.getScriptRam(script, ns.getHostname()));
 }
 
 /**