Update README.md

.github/issue_template/bug.md

@@ -0,0 +1,30 @@
+---
+
+name: "Bug report"
+about: "Encountered an issue"
+ref: "develop"
+labels:
+- Type/Bug
+
+---
+
+# Bug Report
+<!-- Description of problem -->
+I tried to ...
+
+But instead ...
+
+## Steps to Reproduce
+<!-- How can developers replicate & test the problem? -->
+1. 
+2. 
+3. 
+
+## Logs
+<!-- Any logs that accompenied the error -->
+```
+
+```
+
+## Screenshots
+<!-- Screenshots (annoted if possible) of the problem -->

.github/issue_template/enhancement.md

@@ -0,0 +1,22 @@
+---
+
+name: "Enhancement"
+about: "Request a feature"
+ref: "develop"
+labels:
+- Type/Enhancement
+
+---
+
+# Feature Request
+<!-- Detailed description -->
+...
+
+## Requirements
+<!-- Bullet list of requirments -->
+1. ...
+2. ...
+
+## Notes
+<!-- Any additional considerations, solutions or design choices -->
+...

.github/pull_request_template.md

@@ -0,0 +1,14 @@
+## Description
+<!-- Adition information & context -->
+...
+
+## Issues
+<!-- Issues this PR will address -->
+ - closes #___
+ - owner/repo#___
+
+## Checklist
+<!-- Compelte after creating PR -->
+ - [ ] Linked issues
+ - [ ] Reviewed changes
+ - [ ] Updated comments/documentation

LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2023 Zakary Timson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -1,33 +1,65 @@
-# BitBurner - Scripts
+<!-- Header -->
-A collection of scripts & information pertaining to the [open source](https://github.com/danielyxie/bitburner) game 
+<div id="top" align="center">
-[BitBurner](https://danielyxie.github.io/bitburner/).
+  <br />
+  
+  <!-- Logo -->
+  <img src="https://git.zakscode.com/repo-avatars/9b25b57330ba3a1d9da80dad4051be68373e52c4bfffc6f6ba9e89f7392f5f7d" alt="Logo" width="200" height="200">
+
+  <!-- Title -->
+  ### Bitburner
+  
+  <!-- Description -->
+  Collection of Bitburner scipts
+
+  <!-- Repo badges -->
+  [![Version](https://img.shields.io/badge/dynamic/json.svg?label=Version&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/bitburner/tags&query=$[0].name)](https://git.zakscode.com/ztimson/bitburner/tags)
+  [![Pull Requests](https://img.shields.io/badge/dynamic/json.svg?label=Pull%20Requests&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/bitburner&query=open_pr_counter)](https://git.zakscode.com/ztimson/bitburner/pulls)
+  [![Issues](https://img.shields.io/badge/dynamic/json.svg?label=Issues&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/bitburner&query=open_issues_count)](https://git.zakscode.com/ztimson/bitburner/issues)
+
+  <!-- Links -->
+
+  ---
+  <div>
+    <a href="https://git.zakscode.com/ztimson/bitburner/releases" target="_blank">Release Notes</a>
+    • <a href="https://git.zakscode.com/ztimson/bitburner/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
+    • <a href="https://git.zakscode.com/ztimson/bitburner/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
+  </div>
+
+  ---
+</div>
 
 ## Table of Contents
-- [BitBurner - Scripts](#bitburner-scripts)
+- [Bitburner](#top)
-  - [Table of Contents](#table-of-contents)
+  - [About](#about)
-  - [Quick Start](#quick-start)
+    - [Built With](#built-with)
-- [Guide](#guide)
+  - [Quick Start](#qiuck-start)
-  - [BitNode 1](#bitnode-1)
   - [Scripts](#scripts)
-    - [banner.js](#bannerjs)
+    - [banner.js](#banner)
-    - [botnet-manager.js (WIP)](#botnet-managerjs-wip)
+    - [botnet-manager.js (WIP)](#botnet)
-    - [connect.js](#connectjs)
+    - [connect.js](#connect)
-    - [copy.js](#copyjs)
+    - [copy.js](#copy)
-    - [crawler.js](#crawlerjs)
+    - [crawler.js](#crawler)
-    - [find-target.js](#find-targetjs)
+    - [find-target.js](#find-target)
-    - [hacknet-manager.js](#hacknet-managerjs)
+    - [hacknet-manager.js](#hacknet)
-    - [miner.js](#minerjs)
+    - [miner.js](#miner)
-    - [network-graph.js](#network-graphjs)
+    - [network-graph.js](#network-graph)
-    - [rm.js](#rmjs)
+    - [rm.js](#rm)
-    - [rootkit.js](#rootkitjs)
+    - [rootkit.js](#rootkit)
-    - [server-manager.js](#server-managerjs)
+    - [server-manager.js](#server-manager)
-    - [update.js](#updatejs)
+    - [update.js](#update)
+  - [License](#license)
+
+## About
+A collection of scripts & information pertaining to the [open source](https://github.com/danielyxie/bitburner) game [Bitburner](https://danielyxie.github.io/bitburner/)
+
+### Built with
+[![JavaScript](https://img.shields.io/badge/JavaScript-000000?style=for-the-badge&logo=javascript)](https://javascript.com/)
 
 ## Quick Start
 
 ```bash
 # Download the update script in-game & run it
-wget https://gitlab.zakscode.com/ztimson/BitBurner/-/raw/develop/scripts/update.js scripts/update.js
+wget https://gitlab.zakscode.com/ztimson/Bitburner/-/raw/develop/scripts/update.js scripts/update.js
 run scripts/update.js # Repeat to pull the latest
 
 # View the network
@@ -50,31 +82,15 @@ run scripts/connect.js CSEC
 backdoor
 ```
 
-Learn more about the [available scripts](#scripts) bellow or pass the `--help` flag to any of the included scripts in-game.
-
-## Guide
-This guide documents how you can use this repository to progress through the game. You should complete the tutorial
-first if you haven't already.
-
-### BitNode 1
-1. First you need to download this repo into the game. Manually download `update.js` & run it:
-`wget https://gitlab.zakscode.com/ztimson/BitBurner/-/raw/develop/scripts/update.js scripts/update.js; run scripts/update.js` 
-2. Scan the network to figure out your bearings, take note of discovered server's required hack level:
-`run scripts/network-graph.js -vd 3`
-3. Root the lowest level server (probably n00dles) & make it hack itself for money. You should repeat this step when 
-ever your hack level is high enough to hack another a new server. `run scripts/rootkit.js n00dles /scripts/miner.js`
-4. Start `hacknet-manger.js`. You won't have enough *RAM* in the beginning to run the manager & hack servers. It's 
-recommended you `tail` the manager, so you can easily start/stop it as needed. `run script/hacknet-manager.js -a`
-5. Once you have enough money ($??,???.??), upgrade your home severs *RAM*: 
-`City > alpha ent. > Upgrade 'home' RAM (8.00GB -> 16.00GB)`
-6. At this point you have enough *RAM* to use `crawler.js` to automatically discover servers & hack them. Continue to
-run this periodically as your hack level increases & you unlock more exploits:
-`run scripts/crawler.js -n /scripts/rootkit.js {{TARGET}} /scripts/miner.js`
-
 ## Scripts
 
-### [banner.js](./scripts/banner.js)
+<details>
-**RAM:** 1.60 GB
+<summary>
+  <h3 id="banner" style="display: inline">banner.js</h3>
+</summary>
+<br />
+
+**RAM:** 1.60 GB | [Code](./src/banner.js)
 
 Aesthetic & serves no real purpose. Prints a banner to the terminal & can repeat after game restarts.
 ```
@@ -91,9 +107,15 @@ Options:
 	-r, --reboot            Automatically display after game reboots
 	-h, --help              Display this help message
 ```
+</details>
 
-### [botnet-manager.js (WIP)](./scripts/botnet-manager.js)
+<details>
-**RAM:** 7.15 GB
+<summary>
+  <h3 id="botnet" style="display: inline">botnet-manager.js (WIP)</h3>
+</summary>
+<br />
+
+**RAM:** 7.15 GB | [Code](./scripts/botnet-manager.js)
 
 Late-game solution to hack servers. It orchestrates an unlimited number of servers to carry out distributed batched 
 attacks against targets. It includes a bunch of utilities to quickly dispatch single commands to all workers. Manger
@@ -121,9 +143,15 @@ Commands:
 	run                     Copy & run script on all worker nodes
 	start                   Start this device as the swarm manager
 ```
+</details>
 
-### [connect.js](./scripts/connect.js)
+<details>
-**RAM:** 1.85 GB
+<summary>
+  <h3 id="connect" style="display: inline">connect.js</h3>
+</summary>
+<br />
+
+**RAM:** 1.85 GB | [Code](./scripts/connect.js)
 
 The built in `connect` command only allows you to connect to devices in the immediate vicinity or servers that have
 backdoors installed requiring you to make several jumps. This script will automatically find a path & connect you saving
@@ -143,9 +171,15 @@ Usage:	run connect.js [OPTIONS] SERVER
 Options:
 	-h, --help              Display this help message
 ```
+</details>
 
-### [copy.js](./scripts/copy.js)
+<details>
-**RAM:** 4.20 GB
+<summary>
+  <h3 id="copy" style="display: inline">copy.js</h3>
+</summary>
+<br />
+
+**RAM:** 4.20 GB | [Code](./scripts/copy.js)
 
 Scripts often import other scripts requiring multiple `scp` calls before it can be run on a remote machine. This script 
 will automatically scan the file being copied for imports & recursively scan & copy the dependencies. Plus it has a
@@ -171,9 +205,15 @@ Options:
 	-q, --quite             Suppress program output
 	-h, --help              Display this help message
 ```
+</details>
 
-### [crawler.js](./scripts/crawler.js)
+<details>
-**RAM:** 5.80 GB
+<summary>
+  <h3 id="crawler" style="display: inline">crawler.js</h3>
+</summary>
+<br />
+
+**RAM:** 5.80 GB | [Code](./scripts/crawler.js)
 
 Mid-game solution to distribute & run scripts across the network.
 ```
@@ -202,9 +242,15 @@ Options:
 	-v, --verbose           Display the server names in the final report
 	-h, --help              Display this help message
 ```
+</details>
 
-### [find-target.js](./scripts/find-target.js)
+<details>
-**RAM:** 4.05 GB
+<summary>
+  <h3 id="find-target" style="display: inline">find-target.js</h3>
+</summary>
+<br />
+
+**RAM:** 4.05 GB | [Code](./scripts/find-target.js)
 
 A utility to help figure out which server is worth hacking the most. It does this by estimating the financial yield per
 minute for each server & returns the servers in a sorted list.
@@ -225,9 +271,15 @@ Options:
 	-v, --verbose           Display the estimated income per minute per core
 	-h, --help              Display this help message
 ```
+</details>
 
-### [hacknet-manager.js](./scripts/hacknet-manager.js)
+<details>
-**RAM:** 5.70 GB
+<summary>
+  <h3 id="hacknet" style="display: inline">hacknet-manager.js</h3>
+</summary>
+<br />
+
+**RAM:** 5.70 GB | [Code](./scripts/hacknet-manager.js)
 
 An early game solution to automate the hacknet & get easy money.
 ```
@@ -248,12 +300,18 @@ Options:
 	-s, --sleep             Amount of time to wait between purchases, defaults to 1 (second)
 	-h, --help              Display this help message
 ```
+</details>
 
-### [miner.js](./scripts/miner.js)
+<details>
-**RAM:** 2.45 GB
+<summary>
+  <h3 id="miner" style="display: inline">miner.js</h3>
+</summary>
+<br />
+
+**RAM:** 2.45 GB | [Code](./scripts/miner.js)
 
 An early-game HGW script to steal money from servers. You can deploy this on each server and have them hack themselves, 
-or they can all target the server with the most money which is more efficient (see [find-target.js](#find-targetjs)).
+or they can all target the server with the most money which is more efficient (see [find-target.js](#find-target)).
 ```
 [home ~/]> run scripts/miner.js --help
 Running script with 1 thread(s), pid 1 and args: ["--help"].
@@ -272,9 +330,15 @@ Options:
 	-s, --sleep             Amount of time to wait between purchases, defaults to 1 (second)
 	-h, --help              Display this help message
 ```
+</details>
 
-### [network-graph.js](./scripts/network-graph.js)
+<details>
-**RAM:** 3.85 GB
+<summary>
+  <h3 id="network-graph" style="display: inline">network-graph.js</h3>
+</summary>
+<br />
+
+**RAM:** 3.85 GB | [Code](./scripts/network-graph.js)
 
 A utility to scan the network & build a visual tree of all the devices. It comes with lots of flags to narrow down the
 results. It's useful for figuring out where you are, manually finding targets & discovering the path to a server & 
@@ -304,11 +368,17 @@ Options:
 	-v, --verbose           Display level, specs & usage in that order: [HL|P] {CPU|RAM} (USG%)
 	-h, --help              Display this help message
 ```
+</details>
 
-### [rm.js](./scripts/rm.js)
+<details>
-**RAM:** 2.85 GB
+<summary>
+  <h3 id="rm" style="display: inline">rm.js</h3>
+</summary>
+<br />
 
-[BitBurner-Connector](https://plugins.jetbrains.com/plugin/18338-bitburner-connector) would occasionally push my IDE
+**RAM:** 2.85 GB | [Code](./scripts/rm.js)
+
+[bitburner-connector](https://plugins.jetbrains.com/plugin/18338-bitburner-connector) would occasionally push my IDE
 files to the game, so I created this simple script to recursively search & delete files from a directory to save me 
 from having to delete files one-by-one.
 ```
@@ -329,9 +399,15 @@ Options:
 	-r, --recursive         Delete everything inside directory
 	-h, --help              Display this help message
 ```
+</details>
 
-### [rootkit.js](./scripts/rootkit.js)
+<details>
-**RAM:** 4.65 GB
+<summary>
+  <h3 id="rootkit" style="display: inline">rootkit.js</h3>
+</summary>
+<br />
+
+**RAM:** 4.65 GB | [Code](./scripts/rootkit.js)
 
 Automatically gains root on the local or remote server. A script can be passed as an additional argument; it will be
 copied and automatically executed with the maximum number of threads after being rooted.
@@ -359,9 +435,15 @@ Options:
 	-v, --verbose           Display level, specs & usage in that order: [HL|P] {CPU|RAM} (USG%)
 	-h, --help              Display this help message
 ```
+</details>
 
-### [server-manager.js](./scripts/server-manager.js)
+<details>
-**RAM:** 11.35 GB
+<summary>
+  <h3 id="server-miner" style="display: inline">server-miner.js</h3>
+</summary>
+<br />
+
+**RAM:** 11.35 GB | [Code](./scripts/server-manager.js)
 
 Mid-game script to handle purchasing and upgrading servers for more computer power. You can also set a script to run
 automatically after purchase. Useful to chain with `miner.js` or `botnet.js`.
@@ -386,9 +468,15 @@ Options:
 	-s, --sleep             Amount of time to wait between purchases, defaults to 1 (second)
 	-h, --help              Display this help message
 ```
+</details>
 
-### [update.js](./scripts/update.js)
+<details>
-**RAM:** 2.65 GB
+<summary>
+  <h3 id="update" style="display: inline">update.js</h3>
+</summary>
+<br />
+
+**RAM:** 2.65 GB | [Code](./scripts/update.js)
 
 Uses the in-game `wget` to download all the scripts in this repository. Can target remote servers to quickly copy the 
 entire toolkit to the target.
@@ -409,3 +497,9 @@ Options:
 	--no-banner             Hide the banner (Used internally)
 	-h, --help              Display this help message
 ```
+</details>
+
+## License
+Copyright © 2023 Zakary Timson | Available under MIT Licensing
+
+See the [license](./LICENSE) for more information.

scripts/bitburner.js

@@ -1,34 +0,0 @@
-/**
- * Automatically complete the current BitNode.
- *
- * @param {NS} ns - BitBurner API
- */
-export function main(ns) {
-    let modules = [
-        'auto-root',
-        'auto-hack',
-        'botnet-manager',
-        'hacknet-manager',
-        'server-manager'
-    ];
-
-    // Banner
-    ns.run('/scripts/banner.js', 1, '-r');
-    ns.tprint(`Starting BitBurner with ${modules.length} enabled: `);
-    ns.tprint(modules.join(', '));
-
-    // botnet-manager
-
-    // hacknet-manager
-    ns.run('/scripts/hacknet-manager', 1, '-a');
-
-    // server-manager
-    ns.run('/scripts/server-manager', 1, '');
-
-    while(true) {
-        // auto-hack
-
-
-        ns.sleep(1000);
-    }
-}

scripts/botnet-manager.js

@@ -1,20 +1,16 @@
 import {ArgParser} from '/scripts/lib/arg-parser';
-import {Config} from '/scripts/lib/data-file';
 import {Logger} from '/scripts/lib/logger';
 import {copyWithDependencies} from '/scripts/copy';
 
-const configPath = '/etc/botnet.txt';
-const port = 1;
-
 class Manager {
     running;
     workers = [];
 
-    async constructor(ns, hostname) {
+    constructor(ns, device, port, config = '/conf/botnet.txt') {
         ns.disableLog('ALL');
         this.ns = ns;
-        this.config = new Config(configPath);
+        this.config = config;
-        this.hostname = hostname;
+        this.device = device;
         this.logger = new Logger(this.ns, [
             () => `Botnet: ${device}`,
             () => `Workers: ${this.workers.length}\tCores: ${this.workers.reduce((acc, w) => acc + w.cpuCores, 0)}\tRAM: ${this.workers.reduce((acc, w) => acc + w.maxRam, 0)} GB`
@@ -128,8 +124,7 @@ class Manager {
 export async function main(ns) {
     // Setup
     ns.disableLog('ALL');
-    const config = await new Config(ns, configPath).load();
+    const hostname = ns.getHostname(), portNum = 1;
-    const hostname = ns.getHostname();
     const argParser = new ArgParser('botnet-manager.js', 'Connect & manage a network of servers to launch distributed attacks.', [
         new ArgParser('copy', 'Copy file & dependencies to botnet', [
             {name: 'file', desc: 'File to copy', default: false},
@@ -144,7 +139,6 @@ export async function main(ns) {
         new ArgParser('leave', 'Disconnect worker node from swarm', [
             {name: 'device', desc: 'Device to disconnect, defaults to the current machine', optional: true, default: hostname}
         ]),
-        new ArgParser('list', 'List connected worker nodes'),
         new ArgParser('run', 'Copy & run script on the botnet', [
             {name: 'script', desc: 'Script to copy & execute', type: 'string'},
             {name: 'args', desc: 'Arguments for script. Forward the current target with: {{TARGET}}', optional: true, extras: true},
@@ -160,9 +154,9 @@ export async function main(ns) {
 
     // Run command
     if(args['_command'] == 'start') { // Start botnet manager
-        ns.tprint(`Starting botnet controller on: ${hostname}`);
+        ns.tprint(`Starting ${hostname} as botnet manager`);
-        ns.tprint(`Connect workers to botnet with: run botnet-manager.js join [SERVER]`);
+        ns.tprint(`Connect more nodes with: run botnet-manager.js join [SERVER]`);
-        await new Manager(ns, hostname).start();
+        await new Manager(ns, hostname, portNum).start();
     } else if(args['_command'] == 'copy') { // Issue copy command
         await ns.writePort(portNum, JSON.stringify({
             command: 'copy',
@@ -182,9 +176,6 @@ export async function main(ns) {
             command: 'leave',
             value: args['device']
         }));
-    } else if(args['_command'] == 'list') {
-        ns.tprint('Botnet workers:');
-        ns.tprint(config['workers'].map(worker => worker.hostname).join(', '));
     } else if(args['_command'] == 'run') { // Issue run command
         await ns.writePort(portNum, JSON.stringify({
             command: 'run',

scripts/lib/data-file.js

@@ -1,31 +0,0 @@
-export class DataFile {
-    /**
-     * Read & write data to a JSON file.
-     *
-     * @param {NS} ns - Bitburner API
-     * @param path - Path to config file
-     */
-    constructor(ns, path) {
-        this.ns = ns;
-        this.path = path;
-    }
-
-    /**
-     * Load data file
-     *
-     * @returns {Promise<any>} - Saved data
-     */
-    async load() {
-        return JSON.parse(await this.ns.read(this.path) || 'null');
-    }
-
-    /**
-     * Save data to file
-     *
-     * @param values - Data to save
-     * @returns {Promise<void>} - Save complete
-     */
-    async save(values) {
-        await this.ns.write(this.path, JSON.stringify(values), 'w');
-    }
-}

scripts/lib/port-helper.js

@@ -1,42 +0,0 @@
-export class PortHelper {
-    /**
-     *
-     * @param ns
-     * @param port
-     * @param host
-     */
-    constructor(ns, port, host) {
-        this.ns = ns;
-        this.host = host;
-        this.portNum = port;
-        this.port = ns.getPortHandle(port);
-        this.callbacks = {};
-    }
-
-    check() {
-        const pending = [];
-        while(!this.port.empty()) pending.push(this.port.read());
-        pending.filter(p => {
-            try {
-                const payload = JSON.parse(p);
-                if(this.callbacks[payload.subject]) return !this.callbacks[payload.subject](payload.value);
-                if(this.callbacks['*']) return !this.callbacks['*'](payload.value);
-                return true;
-            } catch {
-                return true;
-            }
-        }).forEach(p => this.port.write(p));
-    }
-
-    subscribe(subject, callback) { if(typeof callback == 'function') this.callbacks[subject] = callback; }
-
-    send(subject, value) {
-        this.ns.writePort(this.portNum, JSON.stringify({
-            from: this.host,
-            subject,
-            value
-        }));
-    }
-
-    unsubscribe(subject) { delete this.callbacks[subject]; }
-}

scripts/update.js

@@ -183,7 +183,7 @@ export async function main(ns) {
 		{name: 'no-banner', desc: 'Hide the banner (Used internally)', flags: ['--no-banner'], default: false}
 	]);
 	const args = argParser.parse(ns.args || []);
-	const src = 'https://gitlab.zakscode.com/ztimson/BitBurner/-/raw/develop/scripts/';
+	const src = 'https://raw.githubusercontent.com/PointyTrident/Bitburner/develop/scripts/';
 	const dest = '/scripts/';
 	const fileList = [
 		'lib/arg-parser.js',