v0.52.5

React blade

.dockerignore

@@ -0,0 +1,14 @@
+node_modules/
+
+.git
+.gitattributes
+.gitignore
+.editorconfig
+
+.dockerignore
+Dockerfile
+docker-compose.yml
+
+*.md
+Quotes.txt
+netscript_tests/

.eslintignore

@@ -2,3 +2,7 @@ node_modules/
 doc/build/
 dist/
 tests/*.bundle.*
+src/ThirdParty/*
+src/ScriptEditor/CodeMirrorNetscriptMode.js
+src/ScriptEditor/CodeMirrorNetscriptLint.js
+src/JSInterpreter.js

Dockerfile

@@ -0,0 +1,35 @@
+FROM node:15.14.0 AS base
+
+WORKDIR /app
+
+# Scripts used in the npm preinstall hook
+COPY scripts/engines-check.js scripts/semver.js scripts/
+
+# Adding our dependencies and install before adding the rest of the files
+# This prevents reinstallation of npm packages for every subsequent code modification
+ENV npm_config_update_notifier=false
+COPY package.json package-lock.json ./
+RUN npm ci --loglevel=error --no-audit --no-fund && npm rebuild node-sass
+
+# Adding all the remaining source files
+COPY . .
+
+# We need more than the default 512MB otherwise webpack will throw 'heap out of memory' exceptions
+# https://nodejs.org/api/cli.html#cli_max_old_space_size_size_in_megabytes
+ENV NODE_OPTIONS=--max-old-space-size=1536
+
+FROM base AS dev
+# This is the main development build using the file watcher if you mount volumes
+USER node
+EXPOSE 8000
+CMD npm run start:container
+
+FROM base AS prod-dist
+# We'll simply build the production dist files here to later reuse in a simple webserver
+RUN npm run build
+
+FROM nginx:1.20.0-alpine AS prod
+WORKDIR /usr/share/nginx/html
+COPY --from=prod-dist /app/dist ./dist
+COPY --from=prod-dist /app/index.html /app/favicon.ico /app/license.txt ./
+EXPOSE 80

Quotes.txt

@@ -1,13 +1,13 @@
 Collection of Quotes
 
-The past is relevant only as data
+The past is relevant only as data.
 
 Pull on the new flesh like borrowed gloves and burn your fingers once again.
 
 A weapon is a tool. A tool for killing and destroying. And there will be times
 when you must kill and destroy. Then you will choose and equip yourself with the tools
 that you need. But remember the weakness of weapons. They are an extension --
-You are the killer and destroyer. You are whole, with or without them.
+you are the killer and destroyer. You are whole, with or without them.
 
 For all that we have done, as a civilization, as individuals, the universe is
 not stable, and nor is any single thing within it. Stars consume themselves,

README_contribution.md

@@ -0,0 +1,23 @@
+Deploying a new version
+-----------------------
+
+Update the following
+- `src/Constants.ts` `Version` and `LatestUpdate`
+- `package.json` `version`
+- `doc/source/conf.py` `version` and `release`
+- `doc/source/changelog.rst`
+- post to discord
+- post to reddit.com/r/Bitburner
+
+Deploying `dev` to the Beta Branch
+----------------------------------
+
+TODO
+
+Development Workflow Best Practices
+-----------------------------------
+
+- Work in a new branch forked from the `dev` branch to isolate your new code
+    - Keep code-changes on a branch as small as possible. This makes it easier for code review. Each branch should be its own independent feature.
+    - Regularly rebase your branch against `dev` to make sure you have the latest updates pulled.
+    - When merging, always merge your branch into `dev`. When releasing a new update, then merge `dev` into `master`

css/augmentations.scss

@@ -27,5 +27,4 @@
     button {
         padding: 4px;
     }
-
 }

css/bladeburner.scss

@@ -80,7 +80,7 @@
             transform: rotate(-45deg);
         }
     }
-    input[type=checkbox] {
+    input[type="checkbox"] {
         margin: 3px;
         visibility: hidden;
         &:checked + label:after {

css/buttons.scss

@@ -1,5 +1,6 @@
 @import "mixins";
 @import "theme";
+@import "styles";
 
 /**
  * Styling for all buttons
@@ -16,6 +17,7 @@ button {
 
 .a-link-button,
 .std-button {
+    @extend .noselect;
     text-decoration: none;
     background-color: #555;
     color: #fff;
@@ -23,11 +25,6 @@ button {
     margin: 5px;
     border: 1px solid #333;
 
-    -moz-user-select: none;
-    -ms-user-select: none;
-    -khtml-user-select: none;
-    -webkit-user-select: none;
-
     &:hover {
         background-color: #666;
     }
@@ -68,6 +65,7 @@ button {
 
 .a-link-button-bought,
 .std-button-bought {
+    @extend .noselect;
     text-decoration: none;
     background-color: #0a0;
     color: #fff;

css/casino.scss

@@ -0,0 +1,24 @@
+.casino-card {
+    padding: 10px;
+    border: solid 1px #808080;
+    background-color: white;
+    display: inline-block;
+    border-radius: 10px;
+    font-size: 14pt;
+    text-align: center;
+    margin: 3px;
+    font-weight: bold;
+}
+
+.casino-card .value {
+    font-size: 15pt;
+    font-family: sans-serif;
+}
+
+.casino-card.red {
+    color: red;
+}
+
+.casino-card.black {
+    color: black;
+}

css/characteroverview.scss

@@ -43,14 +43,8 @@
     background-color: #444;
 }
 
- .character-stat-cell {
-     text-align: right;
- }
-
-#character-hack-wrapper td,
-#character-agi-wrapper td {
-    border-bottom: 1px #aaa solid;
-    padding-bottom: 10px;
+.character-stat-cell {
+    text-align: right;
 }
 
 #character-str-wrapper td,
@@ -58,11 +52,24 @@
     padding-top: 10px;
 }
 
+.character-divider td {
+    border-top: 1px #aaa solid;
+    padding-top: 10px;
+}
+
 #character-hp-wrapper    { color: $my-stat-hp-color;    }
+.character-hp-cell       { color: $my-stat-hp-color;    }
 #character-money-wrapper { color: $my-stat-money-color; }
+.character-money-cell    { color: $my-stat-money-color; }
 #character-hack-wrapper  { color: $my-stat-hack-color;  }
+.character-hack-cell     { color: $my-stat-hack-color;  }
 #character-cha-wrapper   { color: $my-stat-cha-color;   }
+.character-cha-cell      { color: $my-stat-cha-color;   }
 #character-int-wrapper   { color: $my-stat-int-color;   }
+.character-int-cell      { color: $my-stat-int-color;   }
+.character-combat-cell   { color: $my-stat-physical;    }
+#character-work-wrapper  { color: $my-stat-hack-color;   }
+.character-work-cell     { color: $my-stat-hack-color;   }
 
 .character-overview-btn {
     @include borderRadius(12px);

css/codemirror-overrides.scss

@@ -6,7 +6,7 @@
 
 #codemirror-form-wrapper {
     height: 80%;
-    margin: 10px 0px 0px 6px;
+    margin: 10px 0 0 6px;
 }
 
 .CodeMirror {
@@ -22,11 +22,11 @@
  * Highlight matches
  */
 .cm-matchhighlight {
-    background-color: #8F908A;
+    background-color: #8f908a;
 }
 
 .CodeMirror-selection-highlight-scrollbar {
-    background-color: #8F908A;
+    background-color: #8f908a;
 }
 
 /**
@@ -35,7 +35,7 @@
 .cm-whitespace::before {
     position: absolute;
     pointer-events: none;
-    color: #404F7D;
+    color: #404f7d;
 }
 
 /**

css/dev-menu.css

@@ -1,36 +1,32 @@
 .add-exp-button {
-	margin-right: 0px;
+    margin-right: 0;
 }
 
 .remove-exp-button {
-	margin-left:0px;
+    margin-left: 0;
 }
 
 .exp-input {
-	margin-right: 0px;
-	margin-left:0px;
-	
-	margin-top: 5px;
-	margin-bottom: 5px;
+    margin: 5px 0 5px 0;
 
-	padding: 2px 5px;
+    padding: 2px 5px;
 }
 
 .text-center {
-	margin: auto;
-	text-align: center;
-	vertical-align: middle;
+    margin: auto;
+    text-align: center;
+    vertical-align: middle;
 }
 
 .touch-right {
-	margin-right: 0px;
+    margin-right: 0;
 }
 
 .touch-left {
-	margin-left: 0px;
+    margin-left: 0;
 }
 
 .touch-sides {
-	margin-left: 0px;
-	margin-right: 0px;
-}
+    margin-left: 0;
+    margin-right: 0;
+}

css/infiltration.scss

@@ -0,0 +1,56 @@
+@import "theme";
+
+.blinking-cursor {
+  font-weight: 100;
+  color: #2E3D48;
+  -webkit-animation: 1s cursorblink step-end infinite;
+  -moz-animation: 1s cursorblink step-end infinite;
+  -ms-animation: 1s cursorblink step-end infinite;
+  -o-animation: 1s cursorblink step-end infinite;
+  animation: 1s cursorblink step-end infinite;
+}
+
+@keyframes "cursorblink" {
+  from, to {
+    color: transparent;
+  }
+  50% {
+    color: $hacker-green;
+  }
+}
+
+@-moz-keyframes cursorblink {
+  from, to {
+    color: transparent;
+  }
+  50% {
+    color: $hacker-green;
+  }
+}
+
+@-webkit-keyframes "cursorblink" {
+  from, to {
+    color: transparent;
+  }
+  50% {
+    color: $hacker-green;
+  }
+}
+
+@-ms-keyframes "cursorblink" {
+  from, to {
+    color: transparent;
+  }
+  50% {
+    color: $hacker-green;
+  }
+}
+
+@-o-keyframes "cursorblink" {
+  from, to {
+    color: transparent;
+  }
+  50% {
+    color: $hacker-green;
+  }
+}

css/interactivetutorial.scss

@@ -69,3 +69,22 @@
     float: right;
     padding: 4px;
 }
+
+.interactive-tutorial-command {
+    background-color: #000;
+    color: $hacker-green;
+    white-space: nowrap;
+}
+
+.interactive-tutorial-code {
+    background-color: #272822;
+    color: white;
+    padding: 3px;
+}
+
+.interactive-tutorial-tab {
+    background-color: #555;
+    color: #e6e6e6;
+    padding: 3px;
+    box-shadow: 0 0 3px #000;
+}

css/menupages.scss

@@ -150,39 +150,6 @@
 /* Infiltration */
 #infiltration-container {
     position: fixed;
-    padding: 6px;
-
-    span {
-        margin: 0;
-        padding: 0;
-    }
-}
-
-#infiltration-left-panel,
-#infiltration-right-panel {
-    display: inline-block;
-    border: 1px solid #fff;
-    width: 35%;
-    height: 75%;
-    top: 10px;
-    overflow-y: auto;
-    overflow-x: auto;
-}
-
-#infiltration-faction-select {
-    color: #fff;
-}
-
-#infiltration-left-panel p,
-#infiltration-right-panel p {
-    margin: 4px;
-}
-
-#infiltration-buttons {
-    margin-top: 20px;
-}
-
-#infiltration-buttons .a-link-button {
-    display: inline;
-    width: 25%;
+    margin: 5px;
+    width: 70%;
 }

css/milestones.scss

@@ -0,0 +1,5 @@
+#milestones-container {
+    position: fixed;
+    padding: 6px;
+    width: 60%;
+}

css/popupboxes.scss

@@ -1,5 +1,6 @@
 @import "mixins";
 @import "theme";
+@import "styles";
 
 /* Pop-up boxes */
 .popup-box-container {
@@ -23,6 +24,7 @@
     width: 70%;
     max-height: 80%;
     overflow-y: auto;
+    z-index: 11; /* Sit on top of the container */
     color: var(--my-font-color);
 }
 
@@ -87,6 +89,7 @@
 .dialog-box-close-button {
     @include borderRadius(12px);
     @include boxShadow(1px 1px 3px #000);
+    @extend .noselect;
 
     float: right;
     color: #aaa;

css/redpill.scss

@@ -7,16 +7,28 @@
     position: fixed;
 }
 
-
 .bitnode {
-    color: #00f;
-}
+    &.level-0 {
+        color: red;
+    }
 
-.bitnode-destroyed {
-    color: #f00;
-}
+    &.level-1 {
+        color: yellow;
+    }
 
-.bitnode:hover,
-.bitnode-destroyed:hover {
-    color: #fff;
+    &.level-2 {
+        color: #48d1cc;
+    }
+
+    &.level-3 {
+        color: blue;
+    }
+
+    &.unimplemented {
+        color: gray;
+    }
+
+    &:hover {
+        color: #fff;
+    }
 }

css/resleeving.scss

@@ -1,4 +1,4 @@
-    /**
+/**
  * Styling for the Re-Sleeving Page
  */
 @import "theme";
@@ -15,7 +15,7 @@
 
 .resleeve-panel {
     display: inline-block;
-    margin: 0px;
+    margin: 0;
     padding: 2px;
 }
 

css/sleeves.scss

@@ -20,7 +20,7 @@
 
 .sleeve-panel {
     display: inline-block;
-    margin: 0px;
+    margin: 0;
     padding: 2px;
 
     select {

css/styles.scss

@@ -17,7 +17,8 @@ body {
 p,
 pre,
 h2,
-.text {
+.text,
+td {
     color: var(--my-font-color);
 }
 
@@ -35,6 +36,10 @@ li {
     list-style-type: none;
 }
 
+br {
+    @extend .noselect;
+}
+
 #entire-game-container {
     background-color: transparent;
 }
@@ -79,6 +84,28 @@ a:visited {
     right: 0;
 }
 
+#factions-tab {
+    position: relative;
+}
+
+#factions-notification {
+    font-size: $defaultFontSize * 0.625;
+    position: absolute; /* Position the badge within the relatively positioned button */
+    top: 0;
+    right: 0;
+}
+
+#augmentations-tab {
+    position: relative;
+}
+
+#augmentations-notification {
+    font-size: $defaultFontSize * 0.625;
+    position: absolute; /* Position the badge within the relatively positioned button */
+    top: 0;
+    right: 0;
+}
+
 .notification-on {
     background-color: #fa3e3e;
     color: #fff;
@@ -205,14 +232,15 @@ a:visited {
 }
 
 .status-text {
-    display: inline-block;
-    position: fixed;
     z-index: 2;
     -webkit-animation: status-text 3s 1;
 }
 
 #status-text-container {
     background-color: transparent;
+    position: absolute;
+    top: 0;
+    left: 50%;
 }
 
 #status-text {
@@ -333,6 +361,68 @@ a:visited {
     color: $my-stat-cha-color;
 }
 
+.reputation {
+    color: $light-yellow;
+}
+
 .smallfont {
     font-size: $defaultFontSize * 0.8125;
 }
+
+.samefont {
+    font-size: inherit;
+}
+
+.noscrollbar {
+    -ms-overflow-style: none;  /* IE and Edge */
+    /* stylelint-disable-next-line property-no-unknown */
+    scrollbar-width: none;  /* Firefox https://developer.mozilla.org/en-US/docs/Web/CSS/scrollbar-width */
+}
+
+.noscrollbar::-webkit-scrollbar {
+    display: none;
+}
+
+input[type="checkbox"] {
+    filter: invert(1) sepia(1) hue-rotate(41deg) brightness(100%) saturate(10);
+}
+
+.optionCheckbox {
+    margin: 5px;
+    float: right;
+}
+
+.optionRange {
+    -webkit-appearance: none;
+    background: #777;
+    outline: none;
+    opacity: 0.7;
+    height: 10px;
+    -webkit-transition: 0.2s;
+    transition: opacity 0.2s;
+    margin: 3px;
+}
+
+.optionRange::-webkit-slider-thumb {
+    -webkit-appearance: none;
+    appearance: none;
+    width: 10px;
+    height: 10px;
+    background: var(--my-font-color);
+    cursor: pointer;
+}
+
+.optionRange::-moz-range-thumb {
+    width: 10px;
+    height: 10px;
+    background: var(--my-font-color);
+    cursor: pointer;
+}
+
+.noselect {
+    -moz-user-select: -moz-none;
+    -khtml-user-select: none;
+    -webkit-user-select: none;
+    -ms-user-select: none;
+    user-select: none;
+}

css/tooltips.scss

@@ -35,7 +35,7 @@
         left: 50%;
         transform: translate(-100%, -100%);
 
-         /* Backwards compatibility */
+        /* Backwards compatibility */
         -webkit-transform: translate(-100%, -100%);
         -moz-transform: translate(-100%, -100%);
         -o-transform: translate(-100%, -100%);
@@ -85,3 +85,45 @@
 .tooltip:hover .tooltiptextlow {
     visibility: visible;
 }
+
+.copy_tooltip {
+    position: relative;
+    display: inline-block;
+}
+
+.copy_tooltip_copied {
+    color: #fff;
+    transition: color 0.3s;
+}
+
+.copy_tooltip .copy_tooltip_text {
+    visibility: hidden;
+    font-size: 15px;
+    padding: 5px;
+    background-color: var(--my-background-color);
+    color: #fff;
+    text-align: center;
+    position: absolute;
+    z-index: 1;
+    top: 120%;
+    left: 5%;
+    opacity: 0;
+    border: 2px solid var(--my-highlight-color);
+}
+
+.copy_tooltip .copy_tooltip_text::after {
+    content: "";
+    position: absolute;
+    bottom: 100%;
+    left: 50%;
+    margin-left: -6px;
+    border-width: 8px;
+    border-style: solid;
+    border-color: transparent transparent white transparent;
+}
+
+.copy_tooltip .copy_tooltip_text_visible {
+    visibility: visible;
+    opacity: 1;
+    transition: opacity 0.3s;
+}

css/treant.css

@@ -7,16 +7,16 @@
 .Treant.Treant-loaded .pseudo { visibility: visible; }
 .Treant > .pseudo { width: 0; height: 0; border: none; padding: 0; }
 .Treant .collapse-switch { width: 3px; height: 3px; display: block; border: 1px solid black; position: absolute; top: 1px; right: 1px; cursor: pointer; }
-.Treant .collapsed .collapse-switch { background-color: #868DEE; }
+.Treant .collapsed .collapse-switch { background-color: #868dee; }
 .Treant > .node img {	border: none; float: left; }
 .Treant > .node {
     cursor: pointer;
-	padding: 4px;
-	min-width: 60px;
-	text-align: center;
-	border: 2px solid #E8E8E3;
-	border-radius: 2px;
-	box-shadow: 1px 1px 1px rgba(0,0,0,.5);
+    padding: 4px;
+    min-width: 60px;
+    text-align: center;
+    border: 2px solid #e8e8e3;
+    border-radius: 2px;
+    box-shadow: 1px 1px 1px rgba(0, 0, 0, 0.5);
     font-size: 12px;
 }
 

css/workinprogress.scss

@@ -26,7 +26,7 @@
     margin: 10px;
 }
 
-#work-in-progress-cancel-button {
+.work-button {
     @include borderRadius(12px);
     @include boxShadow(1px 1px 3px #000);
 
@@ -39,8 +39,8 @@
     border: 3px solid #fff;
 }
 
-#work-in-progress-cancel-button:hover,
-#work-in-progress-cancel-button:focus {
+.work-button:hover,
+.work-button:focus {
     color: #fff;
     text-decoration: none;
     cursor: pointer;

dist/engineStyle.bundle.js

@@ -1,2 +1,2 @@
-!function(n){function t(t){for(var e,i,f=t[0],c=t[1],l=t[2],p=0,s=[];p<f.length;p++)i=f[p],u[i]&&s.push(u[i][0]),u[i]=0;for(e in c)Object.prototype.hasOwnProperty.call(c,e)&&(n[e]=c[e]);for(a&&a(t);s.length;)s.shift()();return r.push.apply(r,l||[]),o()}function o(){for(var n,t=0;t<r.length;t++){for(var o=r[t],e=!0,f=1;f<o.length;f++){var c=o[f];0!==u[c]&&(e=!1)}e&&(r.splice(t--,1),n=i(i.s=o[0]))}return n}var e={},u={1:0},r=[];function i(t){if(e[t])return e[t].exports;var o=e[t]={i:t,l:!1,exports:{}};return n[t].call(o.exports,o,o.exports,i),o.l=!0,o.exports}i.m=n,i.c=e,i.d=function(n,t,o){i.o(n,t)||Object.defineProperty(n,t,{enumerable:!0,get:o})},i.r=function(n){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(n,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(n,"__esModule",{value:!0})},i.t=function(n,t){if(1&t&&(n=i(n)),8&t)return n;if(4&t&&"object"==typeof n&&n&&n.__esModule)return n;var o=Object.create(null);if(i.r(o),Object.defineProperty(o,"default",{enumerable:!0,value:n}),2&t&&"string"!=typeof n)for(var e in n)i.d(o,e,function(t){return n[t]}.bind(null,e));return o},i.n=function(n){var t=n&&n.__esModule?function(){return n.default}:function(){return n};return i.d(t,"a",t),t},i.o=function(n,t){return Object.prototype.hasOwnProperty.call(n,t)},i.p="";var f=window.webpackJsonp=window.webpackJsonp||[],c=f.push.bind(f);f.push=t,f=f.slice();for(var l=0;l<f.length;l++)t(f[l]);var a=c;r.push([361,0]),o()}({304:function(n,t,o){},306:function(n,t,o){},308:function(n,t,o){},310:function(n,t,o){},312:function(n,t,o){},314:function(n,t,o){},316:function(n,t,o){},318:function(n,t,o){},320:function(n,t,o){},322:function(n,t,o){},324:function(n,t,o){},326:function(n,t,o){},328:function(n,t,o){},330:function(n,t,o){},332:function(n,t,o){},334:function(n,t,o){},336:function(n,t,o){},338:function(n,t,o){},340:function(n,t,o){},342:function(n,t,o){},344:function(n,t,o){},346:function(n,t,o){},348:function(n,t,o){},350:function(n,t,o){},352:function(n,t,o){},354:function(n,t,o){},356:function(n,t,o){},358:function(n,t,o){},361:function(n,t,o){"use strict";o.r(t);o(360),o(358),o(356),o(354),o(352),o(350),o(348),o(346),o(344),o(342),o(340),o(338),o(336),o(334),o(332),o(330),o(328),o(326),o(324),o(322),o(320),o(318),o(316),o(314),o(312),o(310),o(308),o(306),o(304)}});
+!function(n){function t(t){for(var e,i,f=t[0],c=t[1],l=t[2],p=0,s=[];p<f.length;p++)i=f[p],u[i]&&s.push(u[i][0]),u[i]=0;for(e in c)Object.prototype.hasOwnProperty.call(c,e)&&(n[e]=c[e]);for(a&&a(t);s.length;)s.shift()();return r.push.apply(r,l||[]),o()}function o(){for(var n,t=0;t<r.length;t++){for(var o=r[t],e=!0,f=1;f<o.length;f++){var c=o[f];0!==u[c]&&(e=!1)}e&&(r.splice(t--,1),n=i(i.s=o[0]))}return n}var e={},u={1:0},r=[];function i(t){if(e[t])return e[t].exports;var o=e[t]={i:t,l:!1,exports:{}};return n[t].call(o.exports,o,o.exports,i),o.l=!0,o.exports}i.m=n,i.c=e,i.d=function(n,t,o){i.o(n,t)||Object.defineProperty(n,t,{enumerable:!0,get:o})},i.r=function(n){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(n,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(n,"__esModule",{value:!0})},i.t=function(n,t){if(1&t&&(n=i(n)),8&t)return n;if(4&t&&"object"==typeof n&&n&&n.__esModule)return n;var o=Object.create(null);if(i.r(o),Object.defineProperty(o,"default",{enumerable:!0,value:n}),2&t&&"string"!=typeof n)for(var e in n)i.d(o,e,function(t){return n[t]}.bind(null,e));return o},i.n=function(n){var t=n&&n.__esModule?function(){return n.default}:function(){return n};return i.d(t,"a",t),t},i.o=function(n,t){return Object.prototype.hasOwnProperty.call(n,t)},i.p="";var f=window.webpackJsonp=window.webpackJsonp||[],c=f.push.bind(f);f.push=t,f=f.slice();for(var l=0;l<f.length;l++)t(f[l]);var a=c;r.push([856,0]),o()}({793:function(n,t,o){},795:function(n,t,o){},797:function(n,t,o){},799:function(n,t,o){},801:function(n,t,o){},803:function(n,t,o){},805:function(n,t,o){},807:function(n,t,o){},809:function(n,t,o){},811:function(n,t,o){},813:function(n,t,o){},815:function(n,t,o){},817:function(n,t,o){},819:function(n,t,o){},821:function(n,t,o){},823:function(n,t,o){},825:function(n,t,o){},827:function(n,t,o){},829:function(n,t,o){},831:function(n,t,o){},833:function(n,t,o){},835:function(n,t,o){},837:function(n,t,o){},839:function(n,t,o){},841:function(n,t,o){},843:function(n,t,o){},845:function(n,t,o){},847:function(n,t,o){},849:function(n,t,o){},851:function(n,t,o){},853:function(n,t,o){},856:function(n,t,o){"use strict";o.r(t);o(855),o(853),o(851),o(849),o(847),o(845),o(843),o(841),o(839),o(837),o(835),o(833),o(831),o(829),o(827),o(825),o(823),o(821),o(819),o(817),o(815),o(813),o(811),o(809),o(807),o(805),o(803),o(801),o(799),o(797),o(795),o(793)}});
 //# sourceMappingURL=engineStyle.bundle.js.map

dist/vendor.css

@@ -11,7 +11,8 @@
   padding: 4px 0;
   /* Vertical padding around content */ }
 
-.CodeMirror pre {
+.CodeMirror pre.CodeMirror-line,
+.CodeMirror pre.CodeMirror-line-like {
   padding: 0 4px;
   /* Horizontal padding of content */ }
 
@@ -98,7 +99,7 @@
   left: 0;
   right: 0;
   top: -50px;
-  bottom: -20px;
+  bottom: 0;
   overflow: hidden; }
 
 .CodeMirror-ruler {
@@ -216,11 +217,11 @@ div.CodeMirror span.CodeMirror-nonmatchingbracket {
 .CodeMirror-scroll {
   overflow: scroll !important;
   /* Things will break if this is overridden */
-  /* 30px is the magic margin used to hide the element's real scrollbars */
+  /* 50px is the magic margin used to hide the element's real scrollbars */
   /* See overflow: hidden in .CodeMirror */
-  margin-bottom: -30px;
-  margin-right: -30px;
-  padding-bottom: 30px;
+  margin-bottom: -50px;
+  margin-right: -50px;
+  padding-bottom: 50px;
   height: 100%;
   outline: none;
   /* Prevent dragging from highlighting the element */
@@ -228,7 +229,7 @@ div.CodeMirror span.CodeMirror-nonmatchingbracket {
 
 .CodeMirror-sizer {
   position: relative;
-  border-right: 30px solid transparent; }
+  border-right: 50px solid transparent; }
 
 /* The fake, visible scrollbars. Used to force redraw during scrolling
    before actual scrolling happens, thus preventing shaking and
@@ -236,7 +237,8 @@ div.CodeMirror span.CodeMirror-nonmatchingbracket {
 .CodeMirror-vscrollbar, .CodeMirror-hscrollbar, .CodeMirror-scrollbar-filler, .CodeMirror-gutter-filler {
   position: absolute;
   z-index: 6;
-  display: none; }
+  display: none;
+  outline: none; }
 
 .CodeMirror-vscrollbar {
   right: 0;
@@ -270,7 +272,7 @@ div.CodeMirror span.CodeMirror-nonmatchingbracket {
   height: 100%;
   display: inline-block;
   vertical-align: top;
-  margin-bottom: -30px; }
+  margin-bottom: -50px; }
 
 .CodeMirror-gutter-wrapper {
   position: absolute;
@@ -300,7 +302,8 @@ div.CodeMirror span.CodeMirror-nonmatchingbracket {
   min-height: 1px;
   /* prevents collapsing before first draw */ }
 
-.CodeMirror pre {
+.CodeMirror pre.CodeMirror-line,
+.CodeMirror pre.CodeMirror-line-like {
   /* Reset some styles that the rest of the page might have set */
   -moz-border-radius: 0;
   -webkit-border-radius: 0;
@@ -321,7 +324,8 @@ div.CodeMirror span.CodeMirror-nonmatchingbracket {
   -webkit-font-variant-ligatures: contextual;
   font-variant-ligatures: contextual; }
 
-.CodeMirror-wrap pre {
+.CodeMirror-wrap pre.CodeMirror-line,
+.CodeMirror-wrap pre.CodeMirror-line-like {
   word-wrap: break-word;
   white-space: pre-wrap;
   word-break: normal; }
@@ -1479,6 +1483,16 @@ span.CodeMirror-selectedtext {
 .cm-s-darcula span.cm-special {
   color: #FF9E59; }
 
+.cm-s-darcula span.cm-matchhighlight {
+  color: #FFFFFF;
+  background-color: rgba(50, 89, 48, 0.7);
+  font-weight: normal; }
+
+.cm-s-darcula span.cm-searching {
+  color: #FFFFFF;
+  background-color: rgba(61, 115, 59, 0.7);
+  font-weight: normal; }
+
 .cm-s-darcula .CodeMirror-cursor {
   border-left: 1px solid #A9B7C6; }
 
@@ -2510,7 +2524,7 @@ Ported to CodeMirror by Peter Kroon
   color: #999; }
 
 .cm-s-lesser-dark span.cm-link {
-  color: #00c; }
+  color: #7070E6; }
 
 .cm-s-lesser-dark span.cm-error {
   color: #9d1e15; }
@@ -2766,103 +2780,105 @@ Ported to CodeMirror by Peter Kroon
   color: white !important; }
 
 /*
-
-    Name:       material
-    Author:     Michael Kaminsky (http://github.com/mkaminsky11)
-
-    Original material color scheme by Mattia Astorino (https://github.com/equinusocio/material-theme)
-
+  Name:       material
+  Author:     Mattia Astorino (http://github.com/equinusocio)
+  Website:    https://material-theme.site/
 */
 .cm-s-material.CodeMirror {
   background-color: #263238;
-  color: #e9eded; }
+  color: #EEFFFF; }
 
 .cm-s-material .CodeMirror-gutters {
   background: #263238;
-  color: #537f7e;
+  color: #546E7A;
   border: none; }
 
-.cm-s-material .CodeMirror-guttermarker, .cm-s-material .CodeMirror-guttermarker-subtle, .cm-s-material .CodeMirror-linenumber {
-  color: #537f7e; }
+.cm-s-material .CodeMirror-guttermarker,
+.cm-s-material .CodeMirror-guttermarker-subtle,
+.cm-s-material .CodeMirror-linenumber {
+  color: #546E7A; }
 
 .cm-s-material .CodeMirror-cursor {
-  border-left: 1px solid #f8f8f0; }
+  border-left: 1px solid #FFCC00; }
 
 .cm-s-material div.CodeMirror-selected {
-  background: rgba(255, 255, 255, 0.15); }
+  background: rgba(128, 203, 196, 0.2); }
 
 .cm-s-material.CodeMirror-focused div.CodeMirror-selected {
-  background: rgba(255, 255, 255, 0.1); }
+  background: rgba(128, 203, 196, 0.2); }
 
-.cm-s-material .CodeMirror-line::selection, .cm-s-material .CodeMirror-line > span::selection, .cm-s-material .CodeMirror-line > span > span::selection {
-  background: rgba(255, 255, 255, 0.1); }
+.cm-s-material .CodeMirror-line::selection,
+.cm-s-material .CodeMirror-line > span::selection,
+.cm-s-material .CodeMirror-line > span > span::selection {
+  background: rgba(128, 203, 196, 0.2); }
 
-.cm-s-material .CodeMirror-line::-moz-selection, .cm-s-material .CodeMirror-line > span::-moz-selection, .cm-s-material .CodeMirror-line > span > span::-moz-selection {
-  background: rgba(255, 255, 255, 0.1); }
+.cm-s-material .CodeMirror-line::-moz-selection,
+.cm-s-material .CodeMirror-line > span::-moz-selection,
+.cm-s-material .CodeMirror-line > span > span::-moz-selection {
+  background: rgba(128, 203, 196, 0.2); }
 
 .cm-s-material .CodeMirror-activeline-background {
-  background: rgba(0, 0, 0, 0); }
+  background: rgba(0, 0, 0, 0.5); }
 
 .cm-s-material .cm-keyword {
-  color: #c792ea; }
+  color: #C792EA; }
 
 .cm-s-material .cm-operator {
-  color: #e9eded; }
+  color: #89DDFF; }
 
 .cm-s-material .cm-variable-2 {
-  color: #80CBC4; }
+  color: #EEFFFF; }
 
-.cm-s-material .cm-variable-3, .cm-s-material .cm-type {
-  color: #82B1FF; }
+.cm-s-material .cm-variable-3,
+.cm-s-material .cm-type {
+  color: #f07178; }
 
 .cm-s-material .cm-builtin {
-  color: #DECB6B; }
+  color: #FFCB6B; }
 
 .cm-s-material .cm-atom {
-  color: #F77669; }
+  color: #F78C6C; }
 
 .cm-s-material .cm-number {
-  color: #F77669; }
+  color: #FF5370; }
 
 .cm-s-material .cm-def {
-  color: #e9eded; }
+  color: #82AAFF; }
 
 .cm-s-material .cm-string {
   color: #C3E88D; }
 
 .cm-s-material .cm-string-2 {
-  color: #80CBC4; }
+  color: #f07178; }
 
 .cm-s-material .cm-comment {
   color: #546E7A; }
 
 .cm-s-material .cm-variable {
-  color: #82B1FF; }
+  color: #f07178; }
 
 .cm-s-material .cm-tag {
-  color: #80CBC4; }
+  color: #FF5370; }
 
 .cm-s-material .cm-meta {
-  color: #80CBC4; }
-
-.cm-s-material .cm-attribute {
   color: #FFCB6B; }
 
+.cm-s-material .cm-attribute {
+  color: #C792EA; }
+
 .cm-s-material .cm-property {
-  color: #80CBAE; }
+  color: #C792EA; }
 
 .cm-s-material .cm-qualifier {
   color: #DECB6B; }
 
-.cm-s-material .cm-variable-3, .cm-s-material .cm-type {
+.cm-s-material .cm-variable-3,
+.cm-s-material .cm-type {
   color: #DECB6B; }
 
-.cm-s-material .cm-tag {
-  color: #ff5370; }
-
 .cm-s-material .cm-error {
   color: white;
-  background-color: #EC5F67; }
+  background-color: #FF5370; }
 
 .cm-s-material .CodeMirror-matchingbracket {
   text-decoration: underline;
@@ -3074,13 +3090,6 @@ div.cm-s-mdn-like span.CodeMirror-matchingbracket {
   background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFcAAAAyCAYAAAAp8UeFAAAHvklEQVR42s2b63bcNgyEQZCSHCdt2vd/0tWF7I+Q6XgMXiTtuvU5Pl57ZQKkKHzEAOtF5KeIJBGJ8uvL599FRFREZhFx8DeXv8trn68RuGaC8TRfo3SNp9dlDDHedyLyTUTeRWStXKPZrjtpZxaRw5hPqozRs1N8/enzIiQRWcCgy4MUA0f+XWliDhyL8Lfyvx7ei/Ae3iQFHyw7U/59pQVIMEEPEz0G7XiwdRjzSfC3UTtz9vchIntxvry5iMgfIhJoEflOz2CQr3F5h/HfeFe+GTdLaKcu9L8LTeQb/R/7GgbsfKedyNdoHsN31uRPWrfZ5wsj/NzzRQHuToIdU3ahwnsKPxXCjJITuOsi7XLc7SG/v5GdALs7wf8JjTFiB5+QvTEfRyGOfX3Lrx8wxyQi3sNq46O7QahQiCsRFgqddjBouVEHOKDgXAQHD9gJCr5sMKkEdjwsarG/ww3BMHBU7OBjXnzdyY7SfCxf5/z6ATccrwlKuwC/jhznnPF4CgVzhhVf4xp2EixcBActO75iZ8/fM9zAs2OMzKdslgXWJ9XG8PQoOAMA5fGcsvORgv0doBXyHrCwfLJAOwo71QLNkb8n2Pl6EWiR7OCibtkPaz4Kc/0NNAze2gju3zOwekALDaCFPI5vjPFmgGY5AZqyGEvH1x7QfIb8YtxMnA/b+QQ0aQDAwc6JMFg8CbQZ4qoYEEHbRwNojuK3EHwd7VALSgq+MNDKzfT58T8qdpADrgW0GmgcAS1lhzztJmkAzcPNOQbsWEALBDSlMKUG0Eq4CLAQWvEVQ9WU57gZJwZtgPO3r9oBTQ9WO8TjqXINx8R0EYpiZEUWOF3FxkbJkgU9B2f41YBrIj5ZfsQa0M5kTgiAAqM3ShXLgu8XMqcrQBvJ0CL5pnTsfMB13oB8athpAq2XOQmcGmoACCLydx7nToa23ATaSIY2ichfOdPTGxlasXMLaL0MLZAOwAKIM+y8CmicobGdCcbbK9DzN+yYGVoNNI5iUKTMyYOjPse4A8SM1MmcXgU0toOq1yO/v8FOxlASyc7TgeYaAMBJHcY1CcCwGI/TK4AmDbDyKYBBtFUkRwto8gygiQEaByFgJ00BH2M8JWwQS1nafDXQCidWyOI8AcjDCSjCLk8ngObuAm3JAHAdubAmOaK06V8MNEsKPJOhobSprwQa6gD7DclRQdqcwL4zxqgBrQcabUiBLclRDKAlWp+etPkBaNMA0AKlrHwTdEByZAA4GM+SNluSY6wAzcMNewxmgig5Ks0nkrSpBvSaQHMdKTBAnLojOdYyGpQ254602ZILPdTD1hdlggdIm74jbTp8vDwF5ZYUeLWGJpWsh6XNyXgcYwVoJQTEhhTYkxzZjiU5npU2TaB979TQehlaAVq4kaGpiPwwwLkYUuBbQwocyQTv1tA0+1UFWoJF3iv1oq+qoSk8EQdJmwHkziIF7oOZk14EGitibAdjLYYK78H5vZOhtWpoI0ATGHs0Q8OMb4Ey+2bU2UYztCtA0wFAs7TplGLRVQCcqaFdGSPCeTI1QNIC52iWNzof6Uib7xjEp07mNNoUYmVosVItHrHzRlLgBn9LFyRHaQCtVUMbtTNhoXWiTOO9k/V8BdAc1Oq0ArSQs6/5SU0hckNy9NnXqQY0PGYo5dWJ7nINaN6o958FWin27aBaWRka1r5myvLOAm0j30eBJqCxHLReVclxhxOEN2JfDWjxBtAC7MIH1fVaGdoOp4qJYDgKtKPSFNID2gSnGldrCqkFZ+5UeQXQBIRrSwocbdZYQT/2LwRahBPBXoHrB8nxaGROST62DKUbQOMMzZIC9abkuELfQzQALWTnDNAm8KHWFOJgJ5+SHIvTPcmx1xQyZRhNL5Qci689aXMEaN/uNIWkEwDAvFpOZmgsBaaGnbs1NPa1Jm32gBZAIh1pCtG7TSH4aE0y1uVY4uqoFPisGlpP2rSA5qTecWn5agK6BzSpgAyD+wFaqhnYoSZ1Vwr8CmlTQbrcO3ZaX0NAEyMbYaAlyquFoLKK3SPby9CeVUPThrSJmkCAE0CrKUQadi4DrdSlWhmah0YL9z9vClH59YGbHx1J8VZTyAjQepJjmXwAKTDQI3omc3p1U4gDUf6RfcdYfrUp5ClAi2J3Ba6UOXGo+K+bQrjjssitG2SJzshaLwMtXgRagUNpYYoVkMSBLM+9GGiJZMvduG6DRZ4qc04DMPtQQxOjEtACmhO7K1AbNbQDEggZyJwscFpAGwENhoBeUwh3bWolhe8BTYVKxQEWrSUn/uhcM5KhvUu/+eQu0Lzhi+VrK0PrZZNDQKs9cpYUuFYgMVpD4/NxenJTiMCNqdUEUf1qZWjppLT5qSkkUZbCwkbZMSuVnu80hfSkzRbQeqCZSAh6huR4VtoM2gHAlLf72smuWgE+VV7XpE25Ab2WFDgyhnSuKbs4GuGzCjR+tIoUuMFg3kgcWKLTwRqanJQ2W00hAsenfaApRC42hbCvK1SlE0HtE9BGgneJO+ELamitD1YjjOYnNYVcraGhtKkW0EqVVeDx733I2NH581k1NNxNLG0i0IJ8/NjVaOZ0tYZ2Vtr0Xv7tPV3hkWp9EFkgS/J0vosngTaSoaG06WHi+xObQkaAdlbanP8B2+2l0f90LmUAAAAASUVORK5CYII=); }
 
 /* Based on the theme at http://bonsaiden.github.com/JavaScript-Garden */
-/*<!--match-->*/
-.cm-s-midnight span.CodeMirror-matchhighlight {
-  background: #494949; }
-
-.cm-s-midnight.CodeMirror-focused span.CodeMirror-matchhighlight {
-  background: #314D67 !important; }
-
 /*<!--activeline-->*/
 .cm-s-midnight .CodeMirror-activeline-background {
   background: #253540; }
@@ -3420,7 +3429,7 @@ div.cm-s-mdn-like span.CodeMirror-matchingbracket {
   background: #292A2B;
   color: #E6E6E6;
   line-height: 1.5;
-  font-family: 'Operator Mono', 'Source Sans Pro', Menlo, Monaco, Consolas, Courier New, monospace; }
+  font-family: 'Operator Mono', 'Source Code Pro', Menlo, Monaco, Consolas, Courier New, monospace; }
 
 .cm-s-panda-syntax .CodeMirror-cursor {
   border-color: #ff2c6d; }
@@ -5000,7 +5009,7 @@ http://ethanschoonover.com/solarized/img/solarized-palette.png
   color: #AEAEAE; }
 
 .cm-s-vibrant-ink .cm-link {
-  color: blue; }
+  color: #5656F3; }
 
 .cm-s-vibrant-ink .cm-error {
   border-bottom: 1px solid red; }
@@ -5305,7 +5314,7 @@ THE SOFTWARE.
 .cm-s-zenburn .CodeMirror-cursor {
   border-left: 1px solid white; }
 
-.cm-s-zenburn {
+.cm-s-zenburn.CodeMirror {
   background-color: #3f3f3f;
   color: #dcdccc; }
 
@@ -5487,17 +5496,17 @@ li.CodeMirror-hint-active {
   -o-transition: opacity .4s;
   -ms-transition: opacity .4s; }
 
-.CodeMirror-lint-mark-error, .CodeMirror-lint-mark-warning {
+.CodeMirror-lint-mark {
   background-position: left bottom;
   background-repeat: repeat-x; }
 
-.CodeMirror-lint-mark-error {
-  background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAYAAAC09K7GAAAAAXNSR0IArs4c6QAAAAZiS0dEAP8A/wD/oL2nkwAAAAlwSFlzAAALEwAACxMBAJqcGAAAAAd0SU1FB9sJDw4cOCW1/KIAAAAZdEVYdENvbW1lbnQAQ3JlYXRlZCB3aXRoIEdJTVBXgQ4XAAAAHElEQVQI12NggIL/DAz/GdA5/xkY/qPKMDAwAADLZwf5rvm+LQAAAABJRU5ErkJggg=="); }
-
 .CodeMirror-lint-mark-warning {
   background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAYAAAC09K7GAAAAAXNSR0IArs4c6QAAAAZiS0dEAP8A/wD/oL2nkwAAAAlwSFlzAAALEwAACxMBAJqcGAAAAAd0SU1FB9sJFhQXEbhTg7YAAAAZdEVYdENvbW1lbnQAQ3JlYXRlZCB3aXRoIEdJTVBXgQ4XAAAAMklEQVQI12NkgIIvJ3QXMjAwdDN+OaEbysDA4MPAwNDNwMCwiOHLCd1zX07o6kBVGQEAKBANtobskNMAAAAASUVORK5CYII="); }
 
-.CodeMirror-lint-marker-error, .CodeMirror-lint-marker-warning {
+.CodeMirror-lint-mark-error {
+  background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAYAAAC09K7GAAAAAXNSR0IArs4c6QAAAAZiS0dEAP8A/wD/oL2nkwAAAAlwSFlzAAALEwAACxMBAJqcGAAAAAd0SU1FB9sJDw4cOCW1/KIAAAAZdEVYdENvbW1lbnQAQ3JlYXRlZCB3aXRoIEdJTVBXgQ4XAAAAHElEQVQI12NggIL/DAz/GdA5/xkY/qPKMDAwAADLZwf5rvm+LQAAAABJRU5ErkJggg=="); }
+
+.CodeMirror-lint-marker {
   background-position: center center;
   background-repeat: no-repeat;
   cursor: pointer;
@@ -5507,17 +5516,17 @@ li.CodeMirror-hint-active {
   vertical-align: middle;
   position: relative; }
 
-.CodeMirror-lint-message-error, .CodeMirror-lint-message-warning {
+.CodeMirror-lint-message {
   padding-left: 18px;
   background-position: top left;
   background-repeat: no-repeat; }
 
-.CodeMirror-lint-marker-error, .CodeMirror-lint-message-error {
-  background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9TAAAAHlBMVEW7AAC7AACxAAC7AAC7AAAAAAC4AAC5AAD///+7AAAUdclpAAAABnRSTlMXnORSiwCK0ZKSAAAATUlEQVR42mWPOQ7AQAgDuQLx/z8csYRmPRIFIwRGnosRrpamvkKi0FTIiMASR3hhKW+hAN6/tIWhu9PDWiTGNEkTtIOucA5Oyr9ckPgAWm0GPBog6v4AAAAASUVORK5CYII="); }
-
 .CodeMirror-lint-marker-warning, .CodeMirror-lint-message-warning {
   background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9TAAAANlBMVEX/uwDvrwD/uwD/uwD/uwD/uwD/uwD/uwD/uwD6twD/uwAAAADurwD2tQD7uAD+ugAAAAD/uwDhmeTRAAAADHRSTlMJ8mN1EYcbmiixgACm7WbuAAAAVklEQVR42n3PUQqAIBBFUU1LLc3u/jdbOJoW1P08DA9Gba8+YWJ6gNJoNYIBzAA2chBth5kLmG9YUoG0NHAUwFXwO9LuBQL1giCQb8gC9Oro2vp5rncCIY8L8uEx5ZkAAAAASUVORK5CYII="); }
 
+.CodeMirror-lint-marker-error, .CodeMirror-lint-message-error {
+  background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9TAAAAHlBMVEW7AAC7AACxAAC7AAC7AAAAAAC4AAC5AAD///+7AAAUdclpAAAABnRSTlMXnORSiwCK0ZKSAAAATUlEQVR42mWPOQ7AQAgDuQLx/z8csYRmPRIFIwRGnosRrpamvkKi0FTIiMASR3hhKW+hAN6/tIWhu9PDWiTGNEkTtIOucA5Oyr9ckPgAWm0GPBog6v4AAAAASUVORK5CYII="); }
+
 .CodeMirror-lint-marker-multiple {
   background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAcAAAAHCAMAAADzjKfhAAAACVBMVEUAAAAAAAC/v7914kyHAAAAAXRSTlMAQObYZgAAACNJREFUeNo1ioEJAAAIwmz/H90iFFSGJgFMe3gaLZ0od+9/AQZ0ADosbYraAAAAAElFTkSuQmCC");
   background-repeat: no-repeat;

doc/source/advancedgameplay/bitnodes.rst

@@ -56,8 +56,3 @@ through destroying BitNodes is:
 
 * Source-Files
 * Scripts on the home computer
-
-BitNode Details
-^^^^^^^^^^^^^^^
-
-TODO

doc/source/advancedgameplay/sleeves.rst

@@ -50,7 +50,7 @@ Duplicate Sleeves. It is a numeral value between 1 and 100, and it affects how m
 is earned when the sleeve is performing a task.
 
 Let N be the sleeve's synchronization. When the sleeve earns experience by performing
-a task, both the sleeve and the player's original host consciousness of N% of the
+a task, both the sleeve and the player's original host consciousness gain N% of the
 amount of experience normally earned by the task. All of the player's other sleeves
 earn ((N/100)^2 * 100)% of the experience.
 

doc/source/advancedgameplay/sourcefiles.rst

@@ -15,73 +15,53 @@ of level 3.
 List of all Source-Files
 ^^^^^^^^^^^^^^^^^^^^^^^^
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-1: Source Genesis          | * Lets the player start with 32 GB of RAM on home computer                          |
-|                                    | * Increases all of the player's multipliers by 16%/24%/28%                          |
+| BitNode-1: Source Genesis          | * Lets the player start with 32 GB of RAM on home computer.                         |
+|                                    | * Increases all of the player's multipliers by 16%/24%/28%.                         |
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-2: Rise of the Underworld  | * Increases the player's crime success rate, crime money, and                       |
-|                                    |   charisma multipliers by 24%/36%/42%                                               |
+| BitNode-2: Rise of the Underworld  | * Lets the player create Gangs in other BitNodes (although some                     |
+|                                    |   BitNodes will disable this mechanic).                                             |
+|                                    | * Increases the player's crime success rate, crime money, and                       |
+|                                    |   charisma multipliers by 24%/36%/42%.                                              |
 +------------------------------------+-------------------------------------------------------------------------------------+
 | BitNode-3: Corporatocracy          | * Lets the player create Corporations in other BitNodes (although some              |
-|                                    |   BitNodes will disable this mechanic)                                              |
-|                                    | * Increases the player's charisma and company salary multipliers by 8%/12%/14%      |
+|                                    |   BitNodes will disable this mechanic).                                             |
+|                                    | * Increases the player's charisma and company salary multipliers by 8%/12%/14%.     |
 +------------------------------------+-------------------------------------------------------------------------------------+
 | BitNode-4: The Singularity         | * Lets the player access and use Netscript Singularity Functions in other BitNodes. |
-|                                    | * Each level of this Source-File opens up more of the Singularity Functions to use  |
+|                                    | * Each level of this Source-File opens up more of the Singularity Functions to use. |
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-5: Artificial Intelligence | * Unlocks :ref:`gameplay_intelligence`                                              |
-|                                    | * Unlocks :js:func:`getBitNodeMultipliers` Netscript function                       |
-|                                    | * Increases all of the player's hacking-related multipliers by 8%/12%/14%           |
+| BitNode-5: Artificial Intelligence | * Unlocks :ref:`gameplay_intelligence`.                                             |
+|                                    | * Unlocks :js:func:`getBitNodeMultipliers` and :js:func:`getServer`                 |
+|                                    |   Netscript functions, as well as :ref:`netscriptformulas`.                         |
+|                                    | * Increases all of the player's hacking-related multipliers by 8%/12%/14%.          |
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-6: Bladeburners            | * Unlocks the Bladeburner feature in other BitNodes                                 |
+| BitNode-6: Bladeburners            | * Unlocks the Bladeburner feature in other BitNodes.                                |
 |                                    | * Increases all of the player's level and experience gain rate multipliers for      |
-|                                    |   combat stats by 8%/12%/14%                                                        |
+|                                    |   combat stats by 8%/12%/14%.                                                       |
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-7: Bladeburners 2079       | * Allows the player to access the :ref:`netscript_bladeburnerapi` in other BitNodes |
-|                                    | * Increases all of the player's Bladeburner multipliers by 8%/12%/14%               |
+| BitNode-7: Bladeburners 2079       | * Allows the player to access the :ref:`netscript_bladeburnerapi` in other BitNodes.|
+|                                    | * Increases all of the player's Bladeburner multipliers by 8%/12%/14%.              |
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-8: Ghost of Wall Street    | * Increases the player's hacking growth multiplier by 12%/18%/21%                   |
+| BitNode-8: Ghost of Wall Street    | * Increases the player's hacking growth multiplier by 12%/18%/21%.                  |
 |                                    | * Level 1 grants permanent access to :ref:`WSE <gameplay_stock_market>` and         |
-|                                    |   :ref:`TIX API <netscript_tixapi>`                                                 |
-|                                    | * Level 2 grants permanent access to shorting stocks                                |
-|                                    | * Level 3 grants permanent access to use limit/stop orders                          |
+|                                    |   :ref:`TIX API <netscript_tixapi>`.                                                |
+|                                    | * Level 2 grants permanent access to shorting stocks.                               |
+|                                    | * Level 3 grants permanent access to use limit/stop orders.                         |
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-9: Coming Soon             |                                                                                     |
+| BitNode-9: Hacktocracy             | * Level 1 permanently unlocks the Hacknet Server in other BitNodes.                 |
+|                                    | * Level 2 lets the player start with 128 GB of RAM on home computer.                |
+|                                    | * Level 3 grants a highly-upgraded Hacknet Server when entering a new BitNode (it   |
+|                                    |   will be lost after installing augments).                                          |
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-10: Digital Carbon         | * Each level of this grants a Duplicate Sleeve                                      |
-|                                    | * Allows the player to access the :ref:`netscript_sleeveapi` in other BitNodes      |
+| BitNode-10: Digital Carbon         | * Each level of this grants a Duplicate Sleeve.                                     |
+|                                    | * Allows the player to access the :ref:`netscript_sleeveapi` in other BitNodes.     |
 +------------------------------------+-------------------------------------------------------------------------------------+
 | BitNode-11: The Big Crash          | * Company favor increases both the player's salary and reputation gain at that      |
-|                                    |   company by 1% per favor (rather than just the reputation gain)                    |
+|                                    |   company by 1% per favor (rather than just the reputation gain).                   |
 |                                    | * Increases the player's company salary and reputation gain multipliers by          |
-|                                    |   24%/36%/42%                                                                       |
+|                                    |   32%/48%/56%.                                                                      |
 +------------------------------------+-------------------------------------------------------------------------------------+
-| BitNode-12: The Recursion          | * There is no maximum level for this Source-File                                    |
-|                                    | * Each level of this Source-File increases all of the player's multipliers by 1%.   |
-|                                    | * This affect is multiplicative with itself. This means that level N of this        |
-|                                    |   Source-File will result in a multiplier of 1.01^N (or 0.99^N for multipliers      |
-|                                    |   that decrease)                                                                    |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
-+------------------------------------+-------------------------------------------------------------------------------------+
-|                                    |                                                                                     |
+| BitNode-12: The Recursion          | * There is no maximum level for this Source-File.                                   |
+|                                    | * Lets the player start with Neuroflux Governor equal to the level of this          |
+|                                    |   Source-File.                                                                      |
 +------------------------------------+-------------------------------------------------------------------------------------+

doc/source/basicgameplay/augmentations.rst

@@ -11,7 +11,7 @@ user's physical and mental faculties.
 Augmentations provide persistent upgrades in the form of multipliers.
 These multipliers apply to a wide variety of things such as stats,
 experience gain, and hacking, just to name a few. Your multipliers
-can be viewed in the 'Character' page (:ref:`keyboard shortcut <shortcuts>` Alt + c)
+can be viewed in the 'Character' page (:ref:`keyboard shortcut <shortcuts>` Alt + c).
 
 How to acquire Augmentations
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^

doc/source/basicgameplay/codingcontracts.rst

@@ -204,8 +204,8 @@ The list contains the name of (i.e. the value returned by
 |                                    | | the string, the result should be an array with only an empty string.                   |
 |                                    | |                                                                                        |
 |                                    | | Examples:                                                                              |
-|                                    | |  ()())() -> ["()()()", "(())()"]                                                       |
-|                                    | |  (a)())() -> ["(a)()()", "(a())()"]                                                    |
+|                                    | |  ()())() -> [()()(), (())()]                                                           |
+|                                    | |  (a)())() -> [(a)()(), (a())()]                                                        |
 |                                    | |  )( -> [""]                                                                            |
 +------------------------------------+------------------------------------------------------------------------------------------+
 | Find All Valid Math Expressions    | | You are given a string which contains only digits between 0 and 9 as well as a target  |
@@ -214,10 +214,12 @@ The list contains the name of (i.e. the value returned by
 |                                    | |                                                                                        |
 |                                    | | The answer should be provided as an array of strings containing the valid expressions. |
 |                                    | |                                                                                        |
+|                                    | | NOTE: Numbers in an expression cannot have leading 0's                                 |
+|                                    | |                                                                                        |
 |                                    | | Examples:                                                                              |
 |                                    | |  Input: digits = "123", target = 6                                                     |
-|                                    | |  Output: ["1+2+3", "1*2*3"]                                                            |
+|                                    | |  Output: [1+2+3, 1*2*3]                                                                |
 |                                    | |                                                                                        |
 |                                    | |  Input: digits = "105", target = 5                                                     |
-|                                    | |  Output: ["1*0+5", "10-5"]                                                             |
+|                                    | |  Output: [1*0+5, 10-5]                                                                 |
 +------------------------------------+------------------------------------------------------------------------------------------+

doc/source/basicgameplay/factions.rst

@@ -35,7 +35,7 @@ List of Factions and their Requirements
 | Early Game          | Faction Name   | Requirements                            | Joining this Faction prevents |
 |  Factions           |                |                                         | you from joining:             |
 +                     +----------------+-----------------------------------------+-------------------------------+
-|                     | CyberSec       | * Hack CSEC Manually                    |                               |
+|                     | CyberSec       | * Install a backdoor on the CSEC server |                               |
 +                     +----------------+-----------------------------------------+-------------------------------+
 |                     | Tian Di Hui    | * $1m                                   |                               |
 |                     |                | * Hacking Level 50                      |                               |
@@ -74,13 +74,16 @@ List of Factions and their Requirements
 |                     |                |                                         | * New Tokyo                   |
 |                     |                |                                         | * Ishima                      |
 +---------------------+----------------+-----------------------------------------+-------------------------------+
-| Hacking             | NiteSec        | * Hack avmnite-02h manually             |                               |
-| Groups              |                | * Home Computer RAM of at least 32GB    |                               |
+| Hacking             | NiteSec        | * Install a backdoor on the avmnite-02h |                               |
+| Groups              |                |   server                                |                               |
+|                     |                | * Home Computer RAM of at least 32GB    |                               |
 +                     +----------------+-----------------------------------------+-------------------------------+
-|                     | The Black Hand | * Hack I.I.I.I manually                 |                               |
+|                     | The Black Hand | * Install a backdoor on the I.I.I.I     |                               |
+|                     |                |   server                                |                               |
 |                     |                | * Home Computer RAM of at least 64GB    |                               |
 +                     +----------------+-----------------------------------------+-------------------------------+
-|                     | Bitrunners     | * Hack run4theh111z manually            |                               |
+|                     | Bitrunners     | * Install a backdoor on the run4theh111z|                               |
+|                     |                |   server                                |                               |
 |                     |                | * Home Computer RAM of at least 128GB   |                               |
 +---------------------+----------------+-----------------------------------------+-------------------------------+
 | Megacorporations    | ECorp          | * Have 200k reputation with             |                               |
@@ -112,7 +115,8 @@ List of Factions and their Requirements
 +                     +----------------+-----------------------------------------+-------------------------------+
 |                     | Fulcrum Secret | * Have 250k reputation with             |                               |
 |                     | Technologies   |   the Corporation                       |                               |
-|                     |                | * Hack fulcrumassets manually           |                               |
+|                     |                | * Install a backdoor on the             |                               |
+|                     |                |   fulcrumassets server                  |                               |
 +---------------------+----------------+-----------------------------------------+-------------------------------+
 | Criminal            | Slum Snakes    | * All Combat Stats of 30                |                               |
 | Organizations       |                | * -9 Karma                              |                               |

doc/source/basicgameplay/stats.rst

@@ -124,6 +124,6 @@ Gain experience by:
 
 * Committing certain crimes
 * Infiltration
-* Working out at a gym
+* Studying at a university
 * Working a relevant job at a company
 * Doing Field work for a Faction

doc/source/basicgameplay/stockmarket.rst

@@ -184,7 +184,7 @@ See :ref:`netscript_tixapi` for more details.
 
 Under the Hood
 --------------
-Stock prices are updated very ~6 seconds.
+Stock prices are updated every ~6 seconds.
 
 Whether a stock's price moves up or down is determined by RNG. However,
 stocks have properties that can influence the way their price moves. These properties

doc/source/basicgameplay/terminal.rst

@@ -148,6 +148,14 @@ has root access, what ports are opened/closed, and also hacking-related informat
 such as an estimated chance to successfully hack, an estimate of how much money is
 available on the server, etc.
 
+backdoor
+^^^^^^^^
+
+Installs a backdoor on the current server. Root access is required to do this.
+
+Servers will give different bonuses when you install a backdoor.
+This can pass faction tests or give bonsues such as discounts from companies.
+
 buy
 ^^^
 
@@ -312,9 +320,12 @@ kill
 ^^^^
 
     $ kill [script name] [args...]
+    $ kill [pid]
 
-Kill the script specified by the script name and arguments. Each argument must
-be separated by a space. Remember that a running script is uniquely identified
+Kill the script specified by the script filename and arguments OR by its PID.
+
+If you are killing the script using its filename and arguments, then each argument
+must be separated by a space. Remember that a running script is uniquely identified
 by both its name and the arguments that are used to start it. So, if a script
 was ran with the following arguments::
 
@@ -324,8 +335,7 @@ Then to kill this script the same arguments would have to be used::
 
     $ kill foo.script 50e3 sigma-cosmetics
 
-Note that after issuing the 'kill' command for a script, it may take a few seconds for
-the script to actually stop running.
+If you are killing the script using its PID, then the PID argument must be numeric. 
 
 killall
 ^^^^^^^
@@ -403,7 +413,7 @@ to convert from script to text file, or vice versa.
 This function can also be used to rename files.
 
 .. note:: Unlike the Linux :code:`mv` command, the *destination* argument must be the
-          full filepath. It cannot be a directory. 
+          full filepath. It cannot be a directory.
 
 Examples::
 
@@ -511,6 +521,8 @@ sudov
 
 Prints whether or not you have root access to the current server.
 
+.. _tail_terminal_command:
+
 tail
 ^^^^
 
@@ -584,7 +596,7 @@ The data can only be downloaded to a script (.script, .ns, .js) or a text file
 (.txt). If the target file already exists, it will be overwritten by this command.
 
 Note that will not be possible to download data from many websites because they
-do not allow cross-origin origin sharing (CORS). This includes websites such
+do not allow cross-origin resource sharing (CORS). This includes websites such
 as gist and pastebin. One notable site it will work on is rawgithub. Example::
 
     $ wget https://raw.githubusercontent.com/danielyxie/bitburner/master/README.md game_readme.txt

doc/source/changelog.rst

@@ -3,6 +3,820 @@
 Changelog
 =========
 
+v0.52.5 - 2021-07-19 CPU cores are useful!? (hydroflame)
+-------------------------------------------
+
+** Terminal ** 
+
+* When executing 'run SCRIPT' any script can now add '--tail' to
+  automatically bring up the logs.
+
+** Netscript ** 
+
+* The 'flags' function now works with single letter flags but they only take
+  one dash.
+* Fix several broken bladeburner netscript functions.
+* Fix gang.getMemberInformation returning inconsistent data after the gang
+  rework.
+
+** CPU Cores **
+
+* CPU Cores on the home computer now provide a bonus to grow() money gain
+  and makes weaken lower more security. Only for scripts running on 'home'
+
+** Misc. **
+
+* Fix weird scrolling in the new Bladeburner React console.
+* nerf noodle bar
+
+v0.52.4 - 2021-07-19 Bladeburner in React (hydroflame)
+-------------------------------------------
+
+** Bladeburner **
+
+* The entire UI was rebuild in React. It should be more responsive
+
+** Hacknet ** 
+
+* Displays how many time each hash upgrade was bought.
+* Displays cummulative effect of the upgrade.
+* Removed "Close" button from hash upgrade menu.
+
+** Misc. **
+
+* More popup/modals have dark background, can be dismissed by clicking
+  outside, or by pressing escape.
+* Small reword in the guide.
+* Fix several typos in the bladeburner documentation.
+* Linting (no one cares except the dev)
+* nerf noodle bar
+
+v0.52.3 - 2021-07-15 Gangs were OP (hydroflame)
+-------------------------------------------
+
+** Gang **
+
+* Significant rework. Ascension is now based on exp gained.
+* All upgrades give exp bonuses.
+* Maximum gang members reduced to 12.
+* Respect required to recruit sharply increased.
+* Rewritten in React, the UI should be smoother and less laggy now.
+
+** Infiltration **
+
+* Now isTrusted protected.
+
+** Misc. **
+
+* Many UI element are now "noselect" protected.
+* Fixed an issue where you could join the same faction twice via script and
+  UI simultaneously.
+* Factions list screen converted to React.
+* nerf noodle bar
+
+v0.52.2 - 2021-07-15 Oh yeah, BN11 is a thing (drunk hydroflame tbh)
+-------------------------------------------
+
+** Source-Files **
+
+* Source-File 11 now also provides a small reduction to the price increase
+  multiplier.
+
+** Augmentations **
+
+* New Augmentation offered by Aevum, themed around 777 and offers some basic
+  programs.
+* Augmentation descriptions are now more concise and consistent.
+
+** Misc. ** 
+
+* nerf noodle bar
+
+v0.52.1 - 2021-07-10 bugfixing (hydroflame & community)
+-------------------------------------------
+
+**Misc.**
+
+* Fix game crash/corruption when quitting a job while working for it unfocused.
+* Fix typo in corporation Market Data.
+* Fix typo in docs for hackPercent.
+* The tutorial encourages the players to connect to home before creating `n00dles.script`
+* The dark web `buy` command now accepts `-1` (one) and `--list` instead of just
+ `-l`. Helps some confused players.
+* Character overview screen no longer hidden on the corporation screen.
+* Infiltration difficulty display is now more explicit (It's a big arrow instead
+ of just one word.)
+* Fix wrong ram value in tutorial. (@MageKing17)
+* Plenty of augmentation description cleanup (@Kwazygloo)
+* Plenty of typo/description fixed (@MageKing17)
+* Cleanup description of singularity function on readthedocs (@PurePandemonium)
+* Fix bug when autolinking a server while backdooring (@schroederIT)
+* nerf noodle bar
+
+v0.52.0 - 2021-06-13 Infiltration 2.0 (hydroflame & community)
+--------------------------------------------------------------
+
+**Infiltration**
+
+* Completely reworked. Not the same mechanic at all.
+
+**Terminal**
+
+* tail is smarter. It automatically assume the only possible options in some
+  cases.
+
+**Intelligence**
+
+* Now available when starting BN5 instead of after beating it for the first
+  time.
+* Nerf the effect of intelligence on reputation gain.
+
+**Augmentation**
+
+* Added a new augmentation, the 'Unstable Circadian Modulator', whose
+  gimmick is that its stats are randomized every hour.
+
+**Netscript**
+
+* 'getPlayer' is not a singularity function anymore.
+* 'hacknetNodes.constants' returns the correct values.
+* 'createGang' has been added.
+* 'inGang' has been added.
+
+**Tutorial**
+
+* Updated the tutorial. Made it look cleaner, fixed typos, etc.
+
+**Misc.**
+
+* Fix many typos in literature (@kwazygloo)
+* Fix being able to unfocus from gym and university.
+* Fix being able to do hacking missions while unfocused.
+* Fix many typos in Augmentation descriptions (@kwazygloo)
+* More numbers handle absurdly large values. (@Tesseract1234567890)
+* Fix many typos (@Tesseract1234567890)
+* Fixed an issue that caused a UI desync when sleeves were set to workout
+  stats other than strength at the gym.
+* Fix weird alignment of donation text box and button. (@Tesseract1234567890)
+* Fixed an issue where reputation could be transfered to new jobs when unfocused.
+* Empty stack traces should no longer appear.
+* Purchasing anything with Infinity money doesn't result in NaN.
+* nerf noodle bar
+
+v0.51.10 - 2021-05-31 Focus Mark, Focus! (hydroflame)
+-----------------------------------------------------
+
+**Focus**
+
+* You can now use the terminal and write scripts while working for factions
+  but you will gain reputation at a slower rate.
+
+**SF -1**
+
+* Added a new SF -1: Bypass
+
+**Gang**
+
+* "Vigilante justice"/"Ethical hacking" now reduces wanted level by a very
+  small percentage as well an absolute value.
+
+**Netscript**
+
+* 'tFormat' now has a second argument to display with millisecond precision.
+* 'purchaseSleeveAug' can no longer purchase the same aug over and over for
+  the same sleeve.
+* fix typo in logging for 'getServerSecurityLevel'
+* Fixed some weird issue where very rarely you would get 0 exp from 'grow'
+* 'getActionTime' now returns correct values for Diplomacy and Regeneration.
+
+**Corporations**
+
+* Fixed an exploit where you could get nearly infinite corporation funds by
+  entering negative numbers in textboxes.
+* Fixed an exploit where shares could be sold again by clicking the
+  "sell share" button via scripts.
+
+**Documentation**
+
+* typo fix in purchaseTor
+* typo fix in basicgameplay/stats
+
+**Misc.**
+
+* Very large number will no longer appear as "$NaNt"
+* Hash capacity now displays in the "big number" format.
+* nerf noodle bar
+
+v0.51.9 - 2021-05-17 offline progress and exports! (hydroflame & community)
+---------------------------------------------------------------
+
+**Alias**
+
+* several commands can be included in 1 alias. Recursive alias now work to
+  a depth of 10. (@Dawe)
+
+**Offline**
+
+* Offline money gain has been reworked (it is more generous)
+* If you're not working anywhere and go offline the game will work for you
+  at all your factions evenly.
+
+**Export**
+
+* Exporting now gives +1 favor to all joined factions every 24h.
+
+**Corp**
+
+* Self-fund with an invalid name no longer takes away 150b anyway.
+* Can no longer export negative amount
+
+**Bladeburner**
+
+* No longer waste overflowing time.
+
+**Text Editors**
+
+* All settings will now be saved and loaded correctly.
+
+**Terminal**
+
+* 'scan' now works for servers that are more than 21 character long.
+
+**Misc.**
+
+* ls now correctly lists all files.
+* importing auto save+reloads (@Dawe)
+* Fix a bug where .fconf could not be created
+* Fix formatting inconsistencies for some logs of netscript functions.
+* Fix a bug where Cashroot starter kit would appear as [object Object] in 
+  confirmation dialog.
+* Fix some ram not displayed as 0.00GB
+* Fix error message throw undefined variable error
+* City hall now has some generic text if you can't create a corp yet.
+* Deleting a file without extension now returns an appropriate error message.
+* Fixed an issue where bladeburner would miscalculate the cost of hospitalization.
+* It is now possible to suppress bladeburner "action stopped" popup.
+* Updated several dependencies (big who cares, I know)
+* ls no longer prints lingering newline.
+* Money earned/spent by sleeves is now tracked under Character>Money
+* nerf noodle bar
+
+
+v0.51.8 - 2021-05-07 It was there all along (hydroflame & community)
+--------------------------------------------------------
+
+**Servers**
+
+* Update n00dles metadata
+
+**Netscript**
+
+* 'hashGainRate' use the correct 'usedRam' and 'maxRam'
+* Fix 'setActionAutolevel' logging.
+* Fix 'setActionLevel' not working at all.
+* Add 'installBackdoor' singularity function.
+
+**Hacknet**
+
+* Fix Hacknet Servers total production always displaying 0
+
+**Documentation**
+
+* Updated guide to no longer recommend BN12.
+* Fix documentation for maxNumNodes (@ModdedGamers)
+* Fix typo in 'sourcefiles.rst'
+* Fix typo in 'recommendedbitnodeorder.rst'
+* Fix 'getServer' documentation missing 'server' argument.
+* Fix missing ram cost in 'getData.rst'
+* Fix basic formulas examples.
+* Fix typo in BN11 description.
+* Fix formatting issue in Bladeburner (@Pimgd)
+
+**Misc.**
+
+* Fix negative money being displayed in full.
+* Fix Hacking Missions not working.
+* Fix Corporation tree not rendering.
+* Fix script being needlessly recompiled. This should save real ram (not game ram)
+* w0r1d_d43m0n can be backdoored
+* Coding Contracts title is click-to-copy (@Rodeth)
+* Covenant memory upgrade works better.
+* Fix Neuroflux not being correctly calculated when entering BN with SF12.
+* Delete Active Script now delete all active scripts, not just home.
+* Now you can 'cd' in directories that only contain '.txt' files.
+* Fix 'analyze' always saying players had root access
+* Passive faction rep no longer builds for special factions.
+* Donation option no longer appears for special factions.
+* Rephrased some milestones.
+* donation textbox now accepts money in the format '1b' and the like (@Dawe)
+* Fix being able to join hated factions simultaneously. (@Dawe)
+* 'ls' now displays files in multiple column. (Helps players with many files)
+* Bladeburner multiplers now appear under Character>Stats and
+  Character>Augmentation when they are relevant.
+* Fix missing functions syntax highlight in codemirror.
+* Fix infiltration number formatting.
+* script income transfers to parent on death. This helps keep track of
+  income for scripts that spawn short lived scripts.
+* nerf noodle bar
+
+v0.51.7 - 2021-04-28 n00dles (hydroflame & community)
+-----------------------------------------
+
+**Tutorial servers**
+
+* All the tutorial servers have been reverted to their original value
+* The new server n00dles has been added as tutorial server.
+
+**Terminal**
+
+* 'tail' now accepts Pid.
+* 'analyze' now handles Hacknet Servers correctly.
+* 'ServerProfiler.exe' now handles Hacknet Servers correctly.
+
+**SF12**
+
+* Now makes you start with Neuroflux Governor equal to the level of the SF.
+
+**Netscript**
+
+* Deprecated 'getServerRam'.
+* 'getServerMaxRam' added to replace 'getServerRam'
+* 'getServerUsedRam' added to replace 'getServerRam'
+* 'getBitnodeMultipliers' is available inside BN5
+* Time logged by hack/grow/weaken now displays in human time.
+* thread count logged by hack/grow/weaken now displays with commas every
+  thousands place.
+
+**Donation**
+
+* Always visible but locked until favor requirements are reached.
+
+**Augmentations**
+
+* City factions has been rebalanced to give a reason to visit them all.
+
+**Sleeves**
+
+* Fix sleeves not being able to work at Volhavens gym.
+
+**Lint**
+
+* This shouldn't change anything but was like 10h of work. So I'm logging it.
+
+**Misc.**
+
+* Plethora of typo fixed (@Pimgd)
+* ps documentation fix (@Dawe)
+* The dev menu now has a quick bitflume option.
+* Fix SF -1 not being as powerful as intended.
+* Fix cashroot starter kit not displaying correctly.
+* Fix DOM element 'character-overview-text' being nested twice.
+* Hacknet documentation example fix.
+* Money amount under 1000 dont display 3 decimal anymore.
+* Fix nextSourceFile flag miscalculation on the bitverse (for Bn12)
+* Faction invite text says "Decide later"/"Join!" instead of "No"/"Yes"
+* nerf noodle bar
+
+
+v0.51.6 - 2021-04-28 Backdoor! (hydroflame & community)
+------------------------------------------
+
+**Backdoor**
+
+* a new terminal command, backdoor, has been added to help differentiate
+  between the terminal hack command and the netscript hack function. (@dewint)
+
+**Servers**
+
+* foodnstuff, sigma-cosmetics, and joesguns have been rebalanced to help new players.
+
+**Milestones**
+
+* A new tab under the Help menu has been added to guide players through the
+  game.
+
+**Casino**
+
+* Blackjack has been added (@BigD)
+
+**Netscript**
+
+* 'prompt' now converts input to JSON.
+* 'getRunningScript' is a new netscript function that returns a bunch of
+  data related to a running script.
+
+**Coding contracts**
+
+* trivial puzzles should no longer appear.
+
+**Infiltration**
+
+* All numbers are formatted like the rest of the game.
+
+**Misc.**
+
+* Server security is capped at 100.
+* Added option to quit a job.
+* 'cd' no longer works on unexistent folders.
+* cd with no arguments brings you back to top level folder (@Andreas)
+* 'softReset' documentation udpated.
+* Money tracker now accounts for going to the hospital manually.
+* codemirror is now the default editor (for new save files)
+* fix typo in dark web help text (@Rodeth)
+* so many documentation and typos fixes (@Pimgd)
+* A corruption visual effect has been added to location with servers that
+  have backdoor installed. (@dewint)
+* nerf noodle bar
+
+
+v0.51.5 - 2021-04-20 Flags! (hydroflame)
+----------------------------------------
+
+**Netscript**
+
+* 'flags' is a new function that helps script handle flags.
+  This is subject to change if it doesn't meet the need of the players.
+* 'ps' now returns the pid.
+* 'tail' now works with pid as first argument.
+* 'tail' hostname defaults to current server. (like the documentation says)
+* 'isRunning' hostname defaults to current server.
+* 'isRunning' now works with pid as first argument.
+
+**Gang**
+
+* Nerfed ascension mechanic once again :(
+
+**Misc.**
+
+* Souce-File typo fix
+* Fix 'while you were away' screen.
+* Bladeburner team size can no longer be set to negative amounts.
+* nerf noodle bar
+
+v0.51.4 - 2021-04-19 Manual hacking is fun (hydroflame)
+-------------------------------------------------------
+
+**Manual hacking**
+
+* These bonus require an install or a soft reset to take effect.
+* Manual hacking gyms and university gives you a 10% discount.
+* Manual hacking a corporation server decreases the penalty for leaving work
+  early.
+
+**BladeBurner**
+
+* nerfed int exp gained.
+
+**Documentation**
+
+* purchaseServer specifies what happens on failure.
+* Fixed typo in recommended bitnode page.
+* Removed misleading ram requirements for hacking factions.
+
+**Netscript**
+
+* growthAnalyze handles Infinity correctly.
+
+**Misc.**
+
+* Faction Augmentation will list how much reputation is required even after
+  that goal has been reached.
+* Removed dollar sign in travel agency confirmation dialog box.
+* Fixed typo in alpha-omega.lit
+* the 'Game saved!' text no longer blocks the save game/options button.
+* The text editor now remembers the location of your cursor and restores it.
+* skills are recalculated instantly.
+* Fix typo in Operation Zero description.
+* nerf noodle bar
+
+v0.51.3 - 2021-04-16 Y'all broke it on the first day (hydroflame)
+-----------------------------------------------------------------
+
+**Passive faction reputation**
+
+* Reworked, from 1 rep / 2 minute. Now is a complicated percentage of the
+  reputation you'd gain working for them. It's not op but it feels a bit
+  more useful.
+
+**Netscript**
+
+* print/tprint now take any number of arguments.
+* print/tprint will now print object as json.
+* print/tprint now handle passing in an undefined argument properly.
+
+**Casino**
+
+* Cannot bet negative money anymore.
+* Roulette max bet is a bit higher.
+* Coin Flip has a small cooldown.
+* All buttons reject unstrusted mouse events.
+
+**Documentation**
+
+* Changed a message that said nsjs only works on Chrome.
+
+**Bugfix**
+
+* hacknet.maxNumNodes now works for both nodes and servers.
+* Fixed a bug where the popup boxes would contain data from previous popup boxes.
+* .js files will also have the 'export async function' boilerplate.
+
+**Misc.**
+
+* turned off web form autocomplete for the terminal text input.
+* Fixed an issue on Windows+Firefox where pressing up on the terminal would
+  bring the cursor to the begining of the line. (Issue #836)
+* Hacknet node names is easier to handle for screen readers.
+* Money spent on classes is now tracked independently of work money.
+* running coding contract from the terminal will display its name.
+* nerf noodle bar
+
+v0.51.2 - 2021-04-09 Vegas, Baby! (hydroflame)
+----------------------------------------------
+
+**New location: The Iker Molina Casino**
+
+* A casino opened in Aevum. However the house is rumored to cheat. If only 
+  we could give them a taste of their own medicine.
+
+**Misc.**
+
+* Link to discord added under options
+* 'getMemberInformation' doc updated, oops
+* tech vendor now handle max ram and cores.
+* nerf noodle bar
+
+v0.51.1 - 2021-04-06 Bugfixes because the author of the last patch sucks (it's hydroflame)
+------------------------------------------------------------------------------------------
+
+**Netscript**
+
+* 'getPlayer' returns players faction and tor
+* 'hospitalization' is a new singularity function.
+* 'gang.getMemberInformation' now returns more information.
+* 'hacknet.hashCapacity' is a new hacknet function that returns the maximum hash capacity.
+
+**Hospitalization**
+
+* Now only cost at most 10% of your money.
+
+**Bugfix**
+
+* confirmation dialog box no longer use previous text
+
+**Accessibility**
+
+* The game is a little easier to handle for screen readers (yes, there's an
+  absolute legend playing this game with a screen reader)
+* Infiltration use buttons instead of a-links
+* New option to disable ASCII art. This will make the metro map and world
+  map display as a list of buttons.
+
+**Misc.**
+
+* 'fl1ght.exe' will no longer suggest the combat path. Related faction
+  requirements unchanged.
+* nerf noodle bar
+
+v0.51.0 - 2021-03-31 Formulas (hydroflame)
+------------------------------------------
+
+**Formulas API**
+
+* A new API is introduced, this gives players access to various formulas used in the game.
+  It'll help you make more informed decisions.
+
+**Netscript**
+
+* 'getServer' is a new function meant to be used with the formulas API.
+* 'getPlayer' is a new function meant to be used with the formulas API.
+* 'getStats' and 'getCharacterInformation' are deprecated in favor of 'getPlayer'
+* 'getCurrentServer' is a new function that returns the server the player is currently connected.
+
+**Display**
+
+* All money should now consistently be orange.
+* All rep should now consistently be light-yellow.
+* Most numbers should display consistently now (aka all money is formatted the same).
+
+**Click to copy**
+
+* Certain UI elements are now 'click-to-copy'
+
+** Misc. **
+
+* nerf noodle bar
+
+v0.50.2 - 2021-03-25 Everyone asked for this one. (hydroflame)
+--------------------------------------------------------------
+
+**BitNodeMultipliers**
+
+* 'GangKarmaRequirements': a new multipler that influences how much karma is required to make a gang different bitnodes.
+
+**Netscript**
+
+* 'connect': a new singularity function that connects you to a server. (like the terminal command)
+* 'manualHack': a new singularity function that performs a manual hack on the players current server.
+* ns2 stack trace works on Firefox now.
+
+**Misc.**
+
+* New shortcut, Alt + b, brings you to bladeburner
+* New shortcut, Alt + g, brings you to gang
+* nerf noodle bar
+
+v0.50.1 - 2021-03-22 (hydroflame)
+---------------------------------
+**Netscript**
+
+* getTaskStats works
+
+**Source-File -1**
+
+* Added a new Exploit
+
+**Factions**
+
+* Augmentations offered by a Faction but already bought are in a separate list at the bottom of the page.
+
+**Bug fixed**
+
+* Fixed a bug where completing a maxed non-repeatable BitNode would make its color on the BitVerse like level 1.
+
+**Misc.**
+
+* Minor spacing in stats tables.
+* nerf noodle bar
+
+v0.50.0 - 2021-03-20 Intelligence (hydroflame)
+----------------------------------------------
+
+**Intelligence**
+
+* int exp gain and effect has been reworked. It is now much more easy to
+  acquire and far more powerful. The goal here is to feel like players have
+  another tool in their arsenal.
+
+**Factions**
+
+* Hacking factions no longer have hacking level requirements since their associated servers do.
+
+**Misc.**
+
+* Sleeve styling.
+* number formatting
+* remove wiki button in Hacking Missions.
+* Fix NaN displayed when very very large numbers are reached.
+* nerf noodle bar
+
+v0.49.2 - 2021-03-13 (hydroflame)
+---------------------------------
+
+**BN8**
+
+* A new bitnode multipler has been added, it lets you reduce money from a
+  server without gaining actually any money. This is important for BN8 where
+  hack/grow can influence the stock market. No money can be gained from
+  hacking but server money can still be reduced.
+
+**Documentation**
+
+* readthedocs should now be more consistent and many examples were added.
+
+**Netscript**
+
+* Ace editor will now correctly highlight all functions.
+* 'tFormat' is a new netscript function that returns a human readable
+  representation of milliseconds. eg. "2 hours 15 minute 43 seconds"
+
+**Gang**
+
+* style improvements
+
+**Bladeburner**
+
+* style improvements
+* fix bug where 'skill list SKILL' would crash if skill is level 0.
+
+**Sleeve**
+
+* karma gain now scales with sync.
+
+**Misc.**
+
+* Fix issue where the effective stats under Character>Stats were being calculated.
+* nerf noodle bar
+
+v0.49.0 - 2021-03-11 Source-File -1 (hydroflame)
+------------------------------------------------
+
+**Source-File -1**
+
+* For advanced players: The game now embraces exploits and will reward
+  players for doing so.
+
+**Gang**
+
+* ascension is less effective as the ascension multiplier goes up.
+* territory gain scales with power difference.
+
+**Netscript**
+
+* 'gang.getEquipmentStats' returns the stats of the equipment.
+* 'gang.getTaskStats' returns the stats of a task.
+* 'getCrimeStats' returns the stats of a crime.
+* Crashes should now print the ns stack trace.
+* Log messages are now more consistent.
+* 'softReset' now accepts a callback script like 'installAugmentations'
+
+**Misc.**
+
+* Minor formatting under Hacking>Active Scripts
+* option menu colors now match the rest of the game, kinda.
+* nerf noodle bar
+
+
+v0.48.0 - ASCII - 2021-03-07 (hydroflame)
+-----------------------------------------
+
+**ASCII**
+
+* Travel Agency now displays a world map
+* Cities are now top view of metro station maps
+
+**Netscript**
+
+* 'softReset' is a new netscript function that performs a soft reset
+    regardless of if the player has bought augmentations or not.
+* 'getAugmentationStats' is a new netscript function that returns the stats of
+    an augmentation.
+* getCharacterInformation now additionally returns exp
+* pid resets back to 1 when installing or destroying a BitNode.
+* New '.ns' scripts start with a main function.
+* 'hacknet.maxNumNodes' returns the maximum number of hacknet nodes.
+
+**Bladeburner**
+
+* Current stamina will scale as max stamina increases, this prevents players
+    from having very high penalty when they gain huge amount of exp at the 
+    start of a reset.
+
+**Misc.**
+
+* Fixed an issue where SF3 was listed as infinitly repeatable and SF12 as
+    having a limit of 3.
+* Fixed an issue where the gang equipment screen would freeze the game if a 
+    script installed augmentations while it is open.
+* All BonusTime now displays in the 'H M S' format.
+* Donation textbox style updated to match the rest of the game.
+* Corporation name style updated to match the rest of the game.
+* minor formatting under Hacking>Active Scripts
+* typo in BN12 description
+* BN12 now reduces contract money
+* Character>Stats percentages are aligned, server and hacknet limit are
+    displayed, if the player has SF5 the reduces stats are shown.
+* Character>Augmentations now displays by how much the player stats will
+    increase.
+* Character>Augmentations has a badge indicating how many augs the player
+    has bought but not installed
+* Character>Factions has a badge indicating how many factions have pending
+    invites.
+* nerf noodle bar
+
+v0.47.2 - 7/15/2019
+-------------------
+
+**Netscript Changes**
+
+* Added tail() Netscript function
+* hacknet.getNodeStats() function now returns an additional property for Hacknet Servers: hashCapacity
+* When writing to a file, the write() function now casts the data being written to a string (using String())
+* BitNode-selection page now shows what Source-File level you have for each BitNode
+* Overloaded kill() function so that you can kill a script by its PID
+* spawn() now only takes 10 seconds to run (decreased from 20 seconds)
+* run() and exec() now return the PID of the newly-executed scripts, rather than a boolean
+    * (A PID is just a positive integer)
+* run(), exec(), and spawn() no longer need to be await-ed in NetscriptJS
+* Script parsing and RAM calculations now support ES9
+* installAugmentations() no longer has a return value since it causes all scripts to die
+* isBusy() now returns true if you are in a Hacking Mission
+* Bug fix: workForFaction() function now properly accounts for disabled logs
+* Bug fix: RAM should now be properly calculated when running a callback script with installAugmentations()
+* Bug fix: Fixed bug that caused scripts killed by exit()/spawn() to "clean up" twice
+
+**Misc Changes**
+
+* The 'kill' Terminal command can now kill a script by its PID
+* Added 'Solarized Dark' theme to CodeMirror editor
+* After Infiltration, you will now return to the company page rather than the city page
+* Bug fix: Stock Market UI should no longer crash for certain locale settings
+* Bug fix: You can now properly remove unfinished programs (the `*.exe-N%-INC` files)
+* Bug fix: Fixed an issue that allowed you to increase money on servers with a 'maxMoney' of 0 (like CSEC)
+* Bug fix: Scripts no longer persist if they were started with syntax/import errors
+* Bug fix: 'hack' and 'analyze' Terminal commands are now blocking
+* Bug fix: Exp earned by duplicate sleeves at universities/gyms now takes hash upgrades into account
+
 v0.47.1 - 6/27/2019
 -------------------
 * Stock Market changes:

doc/source/conf.py

@@ -64,9 +64,9 @@ documentation_title = '{0} Documentation'.format(project)
 # built documents.
 #
 # The short X.Y version.
-version = '0.47'
+version = '0.52'
 # The full version, including alpha/beta/rc tags.
-release = '0.47.0'
+release = '0.52.5'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

doc/source/guidesandtips/gettingstartedguideforbeginnerprogrammers.rst

@@ -634,18 +634,18 @@ This tells me that I can reach :code:`CSEC` by going through :code:`iron-gym`::
     Make sure you notice the required hacking skill for the :code:`CSEC` server.
     This is a random value between 51 and 60. Although you receive the message
     from CSEC once you hit 50 hacking, you cannot actually pass their test
-    until your hacking is high enough to hack their server.
+    until your hacking is high enough to install a backdoor on their server.
 
-After you are connected to the :code:`CSEC` server, you can hack it. Note that this
+After you are connected to the :code:`CSEC` server, you can backdoor it. Note that this
 server requires one open port in order to gain root access. We can open the SSH port
 using the :code:`BruteSSH.exe` program we created earlier. In |Terminal|::
 
     $ run BruteSSH.exe
     $ run NUKE.exe
-    $ hack
+    $ backdoor
 
-Keep hacking the server until you are successful. After you successfully hack it, you should
-receive a faction invitation from |CyberSec| shortly afterwards. Accept it. If you accidentally
+After you successfully install the backdoor, you should receive a faction
+invitation from |CyberSec| shortly afterwards. Accept it. If you accidentally
 reject the invitation, that's okay. Just go to the :code:`Factions` tab
 (|Keyboard shortcut| Alt + f) and you should see an option that lets you
 accept the invitation.
@@ -860,7 +860,7 @@ Random Tips
 .. Substitution definitions
 .. |Alpha Enterprises|      replace:: :code:`Alpha Enterprises`
 .. |Augmentations tab|      replace:: :code:`Augmentations` tab
-.. |AutoLink|               replace:: :code:`NUKE.exe`
+.. |AutoLink|               replace:: :code:`AutoLink.exe`
 .. |BruteSSH|               replace:: :code:`BruteSSH.exe`
 .. |City tab|               replace:: :code:`City` tab
 .. |CyberSec|               replace:: :code:`CyberSec`

doc/source/guidesandtips/recommendedbitnodeorder.rst

@@ -278,6 +278,7 @@ Description
     hashes, which can be spent on a variety of different upgrades.
 
     In this BitNode:
+
     * Your stats are significantly decreased
     * You cannnot purchase additional servers
     * Hacking is significantly less profitable
@@ -292,7 +293,7 @@ Source-File
     * Level 3: Grants a highly-upgraded Hacknet Server when entering a new BitNode
 
     (Note that the Level 3 effect of this Source-File only applies when entering a new BitNode, NOT
-    when installing Augmentation
+    when installing Augmentations.)
 
 Difficulty
     Hard
@@ -312,6 +313,7 @@ Description
     2. Duplicate Sleeves: Duplicate your consciousness into Synthoids, allowing you to perform different tasks synchronously
 
     In this BitNode:
+
     * Your stats are significantly decreased
     * All methods of gaining money are half as profitable (except Stock Market)
     * Purchased servers are more expensive, have less max RAM, and a lower maximum limit
@@ -321,7 +323,7 @@ Source-File
     :Max Level: 3
 
     This Source-File unlocks Sleeve technology in other BitNodes.
-    Each level of this Source-File also grants you a Duplicate Sleeve
+    Each level of this Source-File also grants you a Duplicate Sleeve.
 
 Difficulty
     Hard
@@ -371,9 +373,10 @@ Description
 Source-File
     :Max Level: Infinity
 
-    Each level of Source-File 12 will increase all of your multipliers by 1%. This effect
-    is multiplicative with itself. In other words, level N of this Source-File will result
-    in a multiplier of 1.01^N (or 0.99^N for multipliers that decrease)
+    Each level of Source-File 12 will let you start with Neuroflux Governor
+    equal to the level of this Source-File.
+
+    This BitNode is meant to be done passively or when waiting for new content.
 
 Difficulty
     Initially very easy, but then it (obviously) becomes harder as you continue to do it.
@@ -394,27 +397,22 @@ For fast progression
 1. Repeat **BitNode-1: Source Genesis** until you max out its Source-File. Its Source-File
    is extremely powerful, as it raises all multipliers by a significant amount.
 
-2. Repeat **BitNode-12: The Recursion** several times. This BitNode will be extremely easy the
-   first few times you tackle it, and its Source-File raises all multipliers. Furthermore,
-   its effect stacks multiplicatively with itself and other Source-Files/Augmentations,
-   which gets better as time goes on
-
-3. Do **BitNode-5: Artificial Intelligence** once or twice. The intelligence stat it unlocks
+2. Do **BitNode-5: Artificial Intelligence** once or twice. The intelligence stat it unlocks
    will gradually build up as you continue to play the game, and will be helpful
    in the future. The Source-File also provides hacking multipliers, which are
    strong because hacking is typically one of the best ways of earning money.
 
-4. (Optional) Consider doing **BitNode-4: The Singularity**. Its Source-File does not directly make you
+3. (Optional) Consider doing **BitNode-4: The Singularity**. Its Source-File does not directly make you
    more powerful in any way, but it does unlock :ref:`netscript_singularityfunctions` which
    let you automate significantly more aspects of the game.
 
-5. Do **BitNode-3: Corporatocracy** once to unlock the Corporation mechanic. This mechanic
+4. Do **BitNode-3: Corporatocracy** once to unlock the Corporation mechanic. This mechanic
    has high profit potential.
 
-6. Do **BitNode-6: Bladeburners** once to unlock the Bladeburners mechanic. The Bladeburner
+5. Do **BitNode-6: Bladeburners** once to unlock the Bladeburners mechanic. The Bladeburner
    mechanic is useful for some of the future BitNodes (such as 9 and 10).
 
-7. Do **BitNode-9: Hacktocracy** to unlock the Hacknet Server mechanic. You can
+6. Do **BitNode-9: Hacktocracy** to unlock the Hacknet Server mechanic. You can
    consider repeating it as well, as its Level 2 and 3 effects are pretty helpful as well.
 
 .. todo:: To be continued as more BitNodes get added

doc/source/netscript.rst

@@ -30,4 +30,5 @@ to reach out to the developer!
     Gang API <netscript/netscriptgangapi>
     Coding Contract API <netscript/netscriptcodingcontractapi>
     Sleeve API <netscript/netscriptsleeveapi>
+    Formulas API <netscript/netscriptformulasapi>
     Miscellaneous <netscript/netscriptmisc>

doc/source/netscript/advancedfunctions/getBitNodeMultipliers.rst

@@ -3,14 +3,22 @@ getBitNodeMultipliers() Netscript Function
 
 .. js:function:: getBitNodeMultipliers()
 
-    Returns an object containing the current BitNode multipliers. This function requires Source-File 5 in order
-    to run. The multipliers are returned in decimal forms (e.g. 1.5 instead of 150%). The multipliers represent
-    the difference between the current BitNode and the original BitNode (BitNode-1). For example, if the
-    *CrimeMoney* multiplier has a value of 0.1, then that means that committing crimes in the current BitNode
-    will only give 10% of the money you would have received in BitNode-1.
+    :RAM cost: 4 GB
 
-    The structure of the returned object is subject to change as BitNode multipliers get added to the game.
-    Refer to the `source code here <https://github.com/danielyxie/bitburner/blob/master/src/BitNode/BitNodeMultipliers.ts>`_
+    If you are not in BitNode-5, then you must have Source-File 5-1 in order to
+    run this function.
+
+    Returns an object containing the current BitNode multipliers. The
+    multipliers are returned in decimal forms (e.g. 1.5 instead of 150%). The
+    multipliers represent the difference between the current BitNode and the
+    original BitNode (BitNode-1). For example, if the *CrimeMoney* multiplier
+    has a value of 0.1, then that means that committing crimes in the current
+    BitNode will only give 10% of the money you would have received in
+    BitNode-1.
+
+    The structure of the returned object is subject to change as BitNode
+    multipliers get added to the game. Refer to the `source code here
+    <https://github.com/danielyxie/bitburner/blob/master/src/BitNode/BitNodeMultipliers.ts>`_
     to see the name of the BitNode multipliers.
 
     Example::

doc/source/netscript/advancedfunctions/getHackGrowWeakenTimes.rst

@@ -1,15 +0,0 @@
-getHackTime(), getGrowTime(), & getWeakenTime()
-===============================================
-
-The :js:func:`getHackTime`, :js:func:`getGrowTime`, and :js:func:`getWeakenTime`
-all take an additional third optional parameter for specifying a specific intelligence
-level to see how that would affect the hack/grow/weaken times. This parameter
-defaults to your current intelligence level.
-
-(Intelligence is unlocked after obtaining Source-File 5).
-
-The function signatures are then::
-
-    getHackTime(hostname/ip[, hackLvl=current level, intLvl=current level])
-    getGrowTime(hostname/ip[, hackLvl=current level, intLvl=current level])
-    getWeakenTime(hostname/ip[, hackLvl=current level, intLvl=current level])

doc/source/netscript/advancedfunctions/getServer.rst

@@ -0,0 +1,40 @@
+getServer() Netscript Function
+==========================================
+
+.. js:function:: getServer([hostname])
+
+    :RAM cost: 2 GB
+    :param string hostname: Hostname of the server, defaults to host server.
+
+    If you are not in BitNode-5, then you must have Source-File 5-1 in order to run this function.
+
+    This function is meant to be used in conjunction with the :doc:`formulas API<../netscriptformulasapi>`.
+
+    Returns an object with the Server's stats. The object has the following properties::
+
+        {
+            cpuCores
+            ftpPortOpen
+            hasAdminRights
+            hostname
+            httpPortOpen
+            ip
+            isConnectedTo
+            maxRam
+            organizationName
+            ramUsed
+            smtpPortOpen
+            sqlPortOpen
+            sshPortOpen
+            baseDifficulty
+            hackDifficulty
+            backdoorInstalled
+            minDifficulty
+            moneyAvailable
+            moneyMax
+            numOpenPortsRequired
+            openPortCount
+            purchasedByPlayer
+            requiredHackingSkill
+            serverGrowth
+        }

doc/source/netscript/basicfunctions/brutessh.rst

@@ -1,13 +1,17 @@
 brutessh() Netscript Function
 =============================
 
-.. js:function:: brutessh(hostname/ip)
+.. js:function:: brutessh(hostname)
 
-    :param string hostname/ip: IP or hostname of the target server
-    :RAM cost: 0 GB
+    :RAM cost: 0.05 GB
 
-    Runs the BruteSSH.exe program on the target server. BruteSSH.exe must exist on your home computer.
+    :param string hostname: Hostname of the target server.
 
-    Example::
+    Runs the ``BruteSSH.exe`` program on the target server. ``BruteSSH.exe``
+    must exist on your home computer.
+
+    Examples:
+
+    .. code-block:: javascript
 
         brutessh("foodnstuff");

doc/source/netscript/basicfunctions/clear.rst

@@ -1,13 +1,16 @@
 clear() Netscript Function
 ==========================
 
-.. js:function:: clear(port/fn)
+.. js:function:: clear(portOrFilename)
 
-    :param string/number port/fn: Port or text file to clear
     :RAM cost: 1 GB
 
-    This function is used to clear data in a `Netscript Ports <http://bitburner.wikia.com/wiki/Netscript_Ports>`_ or a text file.
+    :param string/number portOrFilename: Port or text file to clear.
 
-    If the *port/fn* argument is a number between 1 and 20, then it specifies a port and will clear it (deleting all data from the underlying queue).
+    This function is used to clear data in a :ref:`Netscript Port <netscript_ports>` or a text file.
 
-    If the *port/fn* argument is a string, then it specifies the name of a text file (.txt) and will delete all data from that text file.
+    If the ``portOrFilename`` argument is a number between 1 and 20, then it
+    specifies a port and will clear it (deleting all data from the underlying queue).
+
+    If the ``portOrFilename`` argument is a string, then it specifies the name
+    of a text file (.txt) and will delete all data from that text file.

doc/source/netscript/basicfunctions/clearLog.rst

@@ -5,4 +5,13 @@ clearLog() Netscript Function
 
     :RAM cost: 0 GB
 
-    Clears the script's logs
+    Clears the script's logs. Useful when making monitoring scripts.
+
+    Examples:
+
+    .. code-block:: javascript
+
+        while(true) {
+            clearLog();
+            print(getServerMoneyAvailable('foodnstuff'));
+        }

doc/source/netscript/basicfunctions/deleteServer.rst

@@ -3,12 +3,12 @@ deleteServer() Netscript Function
 
 .. js:function:: deleteServer(hostname)
 
-    :param string hostname: Hostname of the server to delete
     :RAM cost: 2.25 GB
+    :param string hostname: Hostname of the server to delete.
+    :returns: ``true`` if successful, ``false`` otherwise.
 
-    Deletes one of your purchased servers, which is specified by its hostname.
+    Deletes the specified purchased server.
 
-    The *hostname* argument can be any data type, but it will be converted to a string. Whitespace is automatically removed from
-    the string. This function will not delete a server that still has scripts running on it.
-
-    Returns true if successful, and false otherwise.
+    The ``hostname`` argument can be any data type, but it will be converted to
+    a string. Whitespace is automatically removed from the string. This function
+    will not delete a server that still has scripts running on it.

doc/source/netscript/basicfunctions/disableLog.rst

@@ -1,16 +1,11 @@
 disableLog() Netscript Function
 ===============================
 
-.. js:function:: disableLog(fn)
+.. js:function:: disableLog(functionName)
 
-    :param string fn: Name of function for which to disable logging
     :RAM cost: 0 GB
 
+    :param string functionName: Name of function for which to disable logging.
+
     Disables logging for the given function. Logging can be disabled for
     all functions by passing 'ALL' as the argument.
-
-    Note that this does not completely remove all logging functionality.
-    This only stops a function from logging
-    when the function is successful. If the function fails, it will still log the reason for failure.
-
-    Notable functions that cannot have their logs disabled: run, exec, exit

doc/source/netscript/basicfunctions/enableLog.rst

@@ -1,10 +1,12 @@
 enableLog() Netscript Function
 ==============================
 
-.. js:function:: enableLog(fn)
+.. js:function:: enableLog(functionName)
 
-    :param string fn: Name of function for which to enable logging
     :RAM cost: 0 GB
 
-    Re-enables logging for the given function. If 'ALL' is passed into this function
-    as an argument, then it will revert the effects of disableLog('ALL')
+    :param string functionName: Name of function for which to enable logging.
+
+    Re-enables logging for the given function. If 'ALL' is passed into this
+    function as an argument, then it will revert the effects of
+    ``disableLog('ALL')``

doc/source/netscript/basicfunctions/exec.rst

@@ -1,34 +1,40 @@
 exec() Netscript Function
 =========================
 
-.. js:function:: exec(script, hostname/ip, [numThreads=1], [args...])
+.. js:function:: exec(script, hostname[, numThreads=1[, args...]])
 
-    :param string script: Filename of script to execute
-    :param string hostname/ip: IP or hostname of the 'target server' on which to execute the script
-    :param number numThreads: Optional thread count for new script. Set to 1 by default. Will be rounded to nearest integer
-    :param args...:
-        Additional arguments to pass into the new script that is being run. Note that if any arguments are being
-        passed into the new script, then the third argument *numThreads* must be filled in with a value.
     :RAM cost: 1.3 GB
 
-    Run a script as a separate process on a specified server. This is similar to the *run* function except
-    that it can be used to run a script on any server, instead of just the current server.
+    :param string script: Filename of script to execute.
+    :param string hostname: Hostname of the target server on which to execute the script.
+    :param number numThreads: Optional thread count for new script. Set to 1 by
+        default. Will be rounded to nearest integer
+    :param args...: Additional arguments to pass into the new script that is
+        being run. Note that if any arguments are being
+        passed into the new script, then the third argument ``numThreads`` must
+        be filled in with a value.
+    :returns: Newly created process id on success, 0 on failure.
 
-    Returns true if the script is successfully started, and false otherwise.
+    Run a script as a separate process on a specified server. This is similar to
+    the :doc:`run<run>` function except that it can be used to run a script on any
+    server, instead of just the current server.
 
-    Running this function with a *numThreads* argument of 0 will return false without running the script.
-    However, running this function with a negative *numThreads* argument will cause a runtime error.
+    .. warning:: Running this function with a ``numThreads`` argument of 0 or
+                 less will cause a runtime error.
 
-    The simplest way to use the *exec* command is to call it with just the script name and the target server.
-    The following example will try to run *generic-hack.script* on the *foodnstuff* server::
+    The simplest way to use the :doc:`exec<exec>` command is to call it with
+    just the script name and the target server. The following example will try
+    to run ``generic-hack.script`` on the ``foodnstuff`` server::
 
         exec("generic-hack.script", "foodnstuff");
 
-    The following example will try to run the script *generic-hack.script* on the *joesguns* server with 10 threads::
+    The following example will try to run the script ``generic-hack.script`` on
+    the ``joesguns`` server with 10 threads::
 
         exec("generic-hack.script", "joesguns", 10);
 
-    This last example will try to run the script *foo.script* on the *foodnstuff* server with 5 threads. It will also pass
-    the number 1 and the string "test" in as arguments to the script::
+    This last example will try to run the script ``foo.script`` on the
+    ``foodnstuff`` server with 5 threads. It will also pass the number 1 and the
+    string "test" in as arguments to the script::
 
         exec("foo.script", "foodnstuff", 5, 1, "test");

doc/source/netscript/basicfunctions/exit.rst

@@ -5,4 +5,13 @@ exit() Netscript Function
 
     :RAM cost: 0 GB
 
-    Terminates the current script immediately
+    Terminates the current script immediately.
+
+    .. warning:: In :ref:`netscriptjs`, execution may continue past a call to
+        this function; while some game-related functions (e.g. those with an
+        ``ns.`` prefix) will not function after this function has been called,
+        there might still be unintended behavior if you assume ``exit`` will
+        immediately halt execution, like it does in :ref:`netscript1`. To be
+        safe, you should probably ``return`` from the main function instead
+        of/in addition to calling ``ns.exit()`` when halting a NetscriptJS
+        script.

doc/source/netscript/basicfunctions/fileExists.rst

@@ -1,25 +1,29 @@
 fileExists() Netscript Function
 ===============================
 
-.. js:function:: fileExists(filename, [hostname/ip])
+.. js:function:: fileExists(filename[, hostname])
 
-    :param string filename: Filename of file to check
-    :param string hostname/ip:
-        Hostname or IP of target server. This is optional. If it is not specified then the
-        function will use the current server as the target server
     :RAM cost: 0.1 GB
 
-    Returns a boolean indicating whether the specified file exists on the target server. The filename
-    for scripts is case-sensitive, but for other types of files it is not. For example, *fileExists("brutessh.exe")*
-    will work fine, even though the actual program is named "BruteSSH.exe".
+    :param string filename: Filename of file to check.
+    :param string hostname:
+        Hostname of target server. This is optional. If it is not specified then
+        the function will use the current server as the target server.
+    :returns: ``true`` if the file exists, ``false`` if it doesn't.
 
-    If the *hostname/ip* argument is omitted, then the function will search through the current server (the server
-    running the script that calls this function) for the file.
+    The filename for scripts is case-sensitive, but for other types of files it
+    is not. For example, ``fileExists("brutessh.exe")`` will work fine, even
+    though the actual program is named ``BruteSSH.exe``.
 
-    Examples::
+    If the ``hostname`` argument is omitted, then the function will search
+    through the server running the script that calls this function for the file.
 
-        fileExists("foo.script", "foodnstuff");
-        fileExists("ftpcrack.exe");
+    Examples:
 
-    The first example above will return true if the script named *foo.script* exists on the *foodnstuff* server, and false otherwise.
-    The second example above will return true if the current server contains the *FTPCrack.exe* program, and false otherwise.
+    .. code-block:: javascript
+
+        fileExists("foo.script", "foodnstuff"); // returns: false
+        fileExists("ftpcrack.exe"); // returns: true
+
+    The first example above will return true if the script named ``foo.script`` exists on the ``foodnstuff`` server, and false otherwise.
+    The second example above will return true if the current server contains the ``FTPCrack.exe`` program, and false otherwise.

doc/source/netscript/basicfunctions/flags.rst

@@ -0,0 +1,46 @@
+flags() Netscript Function
+============================
+
+.. js:function:: flags(data)
+
+    :RAM cost: 0 GB
+    :param data array of pairs of strings: Flags definition.
+    :returns: Object containing all the flags that were parsed or default.
+
+    This function allows for a more flexible way of parsing script arguments
+    than to just pass a fixed list in a fixed order. Options can be given
+    names, and passed in any order, while having defined default values.
+
+    The flag definition is an array of pairs of values: the first value is the
+    name of the flag, and the 2nd value is the default value for that flag.
+
+    The return object is a map containing flag names to the value. It also 
+    contains the special field '_', which contains all arguments that were not
+    flags.
+
+    Example:
+
+    .. code-block:: javascript
+
+        // example.script
+        var data = flags([
+            ['delay', 0], // a default number means this flag is a number
+            ['server', 'foodnstuff'], //  a default string means this flag is a string
+            ['exclude', []], // a default array means this flag is a default array of string
+            ['help', false], // a default boolean means this flag is a boolean
+        ]);
+        tprint(data);
+        /*
+        [home ~/]> run example.script
+        {"_":[],"delay":0,"server":"foodnstuff","exclude":[],"help":false}
+        [home ~/]> run example.script --delay 3000
+        {"_":[],"server":"foodnstuff","exclude":[],"help":false,"delay":3000}
+        [home ~/]> run example.script --delay 3000 --server harakiri-sushi
+        {"_":[],"exclude":[],"help":false,"delay":3000,"server":"harakiri-sushi"}
+        [home ~/]> run example.script --delay 3000 --server harakiri-sushi hello world
+        {"_":["hello","world"],"exclude":[],"help":false,"delay":3000,"server":"harakiri-sushi"}
+        [home ~/]> run example.script --delay 3000 --server harakiri-sushi hello world --exclude a --exclude b
+        {"_":["hello","world"],"help":false,"delay":3000,"server":"harakiri-sushi","exclude":["a","b"]}
+        [home ~/]> run example.script --help
+        {"_":[],"delay":0,"server":"foodnstuff","exclude":[],"help":true}
+        */

doc/source/netscript/basicfunctions/ftpcrack.rst

@@ -1,13 +1,17 @@
 ftpcrack() Netscript Function
 =============================
 
-.. js:function:: ftpcrack(hostname/ip)
+.. js:function:: ftpcrack(hostname)
 
-    :param string hostname/ip: IP or hostname of the target server
-    :RAM cost: 0 GB
+    :RAM cost: 0.05 GB
 
-    Runs the FTPCrack.exe program on the target server. FTPCrack.exe must exist on your home computer.
+    :param string hostname: Hostname of the target server.
 
-    Example::
+    Runs the ``FTPCrack.exe`` program on the target server. ``FTPCrack.exe``
+    must exist on your home computer.
+
+    Examples:
+
+    .. code-block:: javascript
 
         ftpcrack("foodnstuff");

doc/source/netscript/basicfunctions/getFavorToDonate.rst

@@ -4,5 +4,10 @@ getFavorToDonate() Netscript Function
 .. js:function:: getFavorToDonate()
 
     :RAM cost: 0.1 GB
+    :returns: Amount of faction favor required to unlock donation.
 
-    Returns the amount of Faction favor required to be able to donate to a faction.
+    Example:
+
+    .. code-block:: javascript
+
+        getFavorToDonate() // returns: 150

doc/source/netscript/basicfunctions/getGrowTime.rst

@@ -1,13 +1,23 @@
 getGrowTime() Netscript Function
 ================================
 
-.. js:function:: getGrowTime(hostname/ip[, hackLvl=current level])
+.. js:function:: getGrowTime(hostname[, hackLvl=current level])
 
-    :param string hostname/ip: Hostname or IP of target server
-    :param number hackLvl: Optional hacking level for the calculation. Defaults to player's current hacking level
     :RAM cost: 0.05 GB
 
-    Returns the amount of time in seconds it takes to execute the *grow()* Netscript function on the target server.
+    :param string hostname: Hostname of target server.
+    :param number hackLvl: Optional hacking level for the calculation. Defaults
+        to player's current hacking level.
+    :returns: seconds it takes to execute :doc:`grow<grow>` on that server.
 
-    The function takes in an optional *hackLvl* parameter that can be specified
-    to see what the grow time would be at different hacking levels.
+    The function takes in an optional ``hackLvl`` parameter that can be
+    specified to see what the grow time would be at different hacking levels.
+
+    Example:
+
+    .. code-block:: javascript
+
+        getGrowTime("foodnstuff"); // returns: 53.4
+
+.. note:: For Hacknet Servers (the upgraded version of a Hacknet Node), this function will
+              return ``Infinity``.

doc/source/netscript/basicfunctions/getHackTime.rst

@@ -1,13 +1,22 @@
 getHackTime() Netscript Function
 ================================
 
-.. js:function:: getHackTime(hostname/ip[, hackLvl=current level])
+.. js:function:: getHackTime(hostname[, hackLvl=current level])
 
-    :param string hostname/ip: Hostname or IP of target server
-    :param number hackLvl: Optional hacking level for the calculation. Defaults to player's current hacking level
     :RAM cost: 0.05 GB
+    :param string hostname: Hostname of target server.
+    :param number hackLvl: Optional hacking level for the calculation. Defaults
+        to player's current hacking level.
+    :returns: seconds it takes to execute :doc:`hack<hack>` on that server.
 
-    Returns the amount of time in seconds it takes to execute the *hack()* Netscript function on the target server.
+    The function takes in an optional ``hackLvl`` parameter that can be
+    specified to see what the hack time would be at different hacking levels.
 
-    The function takes in an optional *hackLvl* parameter that can be specified
-    to see what the hack time would be at different hacking levels.
+    Example:
+
+    .. code-block:: javascript
+
+        getHackTime("foodnstuff"); // returns: 53.4
+
+    .. note:: For Hacknet Servers (the upgraded version of a Hacknet Node), this function will
+              return :code:`Infinity`. 

doc/source/netscript/basicfunctions/getHackingLevel.rst

@@ -4,5 +4,10 @@ getHackingLevel() Netscript Function
 .. js:function:: getHackingLevel()
 
     :RAM cost: 0.05 GB
+    :returns: The player's current hacking level.
 
-    Returns the player's current hacking level
+    Example:
+
+    .. code-block:: javascript
+
+        getHackingLevel(); // returns: 124

doc/source/netscript/basicfunctions/getHackingMultipliers.rst

@@ -4,9 +4,11 @@ getHackingMultipliers() Netscript Function
 .. js:function:: getHackingMultipliers()
 
     :RAM cost: 4 GB
+    :returns: object containing the player's hacking multipliers. These
+        multipliers are returned in decimal forms, not percentages (e.g. 1.5
+        instead of 150%).
 
-    Returns an object containing the Player's hacking related multipliers. These multipliers are
-    returned in decimal forms, not percentages (e.g. 1.5 instead of 150%). The object has the following structure::
+    Structure::
 
         {
             chance: Player's hacking chance multiplier,
@@ -15,7 +17,9 @@ getHackingMultipliers() Netscript Function
             growth: Player's hacking growth multiplier
         }
 
-    Example of how this can be used::
+    Example:
+
+    .. code-block:: javascript
 
         mults = getHackingMultipliers();
         print(mults.chance);

doc/source/netscript/basicfunctions/getHacknetMultipliers.rst

@@ -4,9 +4,11 @@ getHacknetMultipliers() Netscript Function
 .. js:function:: getHacknetMultipliers()
 
     :RAM cost: 4 GB
+    :returns: object containing the player's hacknet multipliers. These
+        multipliers are returned in decimal forms, not percentages (e.g. 1.5
+        instead of 150%).
 
-    Returns an object containing the Player's hacknet related multipliers. These multipliers are
-    returned in decimal forms, not percentages (e.g. 1.5 instead of 150%). The object has the following structure::
+    Structure::
 
         {
             production: Player's hacknet production multiplier,
@@ -16,7 +18,9 @@ getHacknetMultipliers() Netscript Function
             levelCost: Player's hacknet level cost multiplier
         }
 
-    Example of how this can be used::
+    Example:
+
+    .. code-block:: javascript
 
         mults = getHacknetMultipliers();
         print(mults.production);

doc/source/netscript/basicfunctions/getHostname.rst

@@ -4,5 +4,10 @@ getHostname() Netscript Function
 .. js:function:: getHostname()
 
     :RAM cost: 0.05 GB
+    :returns: Hostname of the server this script is running on.
 
-    Returns a string with the hostname of the server that the script is running on
+    Example:
+
+    .. code-block:: javascript
+
+        getHostname(); // returns: "foodnstuff"

doc/source/netscript/basicfunctions/getPlayer.rst

@@ -0,0 +1,101 @@
+getPlayer() Netscript Function
+==============================
+
+.. js:function:: getPlayer()
+
+    :RAM cost: 0.5 GB
+
+    The result of this function can be passed to the :doc:`formulas API<../netscriptformulasapi>`.
+
+    Returns an object with the Player's stats. The object has the following properties::
+
+        {
+            hacking_skill:                   Current Hacking skill level
+            hp:                              Current health points
+            max_hp:                          Maximum health points
+            strength:                        Current Strength skill level
+            defense:                         Current Defense skill level
+            dexterity:                       Current Dexterity skill level
+            agility:                         Current Agility skill level
+            charisma:                        Current Charisma skill level
+            intelligence:                    Current Intelligence skill level (from BitNode-5)
+            hacking_chance_mult:             Hacking Chance multiplier (from Source-Files and Augments)
+            hacking_speed_mult:              Hacking Speed multiplier (from Source-Files and Augments)
+            hacking_money_mult:              Hacking Money multiplier (from Source-Files and Augments)
+            hacking_grow_mult:               Hacking Growth multiplier (from Source-Files and Augments)
+            hacking_exp:                     Current Hacking experience points
+            strength_exp:                    Current Strength experience points
+            defense_exp:                     Current Defense experience points
+            dexterity_exp:                   Current Dexterity experience points
+            agility_exp:                     Current Agility experience points
+            charisma_exp:                    Current Charisma experience points
+            hacking_mult:                    Hacking Level multiplier (from Source-Files and Augments)
+            strength_mult:                   Strength Level multiplier (from Source-Files and Augments)
+            defense_mult:                    Defense Level multiplier (from Source-Files and Augments)
+            dexterity_mult:                  Dexterity Level multiplier (from Source-Files and Augments)
+            agility_mult:                    Agility Level multiplier (from Source-Files and Augments)
+            charisma_mult:                   Charisma Level multiplier (from Source-Files and Augments)
+            hacking_exp_mult:                Hacking Experience multiplier (from Source-Files and Augments)
+            strength_exp_mult:               Strength Experience multiplier (from Source-Files and Augments)
+            defense_exp_mult:                Defense Experience multiplier (from Source-Files and Augments)
+            dexterity_exp_mult:              Dexterity Experience multiplier (from Source-Files and Augments)
+            agility_exp_mult:                Agility Experience multiplier (from Source-Files and Augments)
+            charisma_exp_mult:               Charisma Experience multiplier (from Source-Files and Augments)
+            company_rep_mult:                Company reputation gain multiplier (from Source-Files and Augments)
+            faction_rep_mult:                Faction reputation gain multiplier (from Source-Files and Augments)
+            money:                           Current money
+            city:                            Name of city you are currently in
+            location:                        Name of the last location visited
+            crime_money_mult:                Crime money multiplier (from Source-Files and Augments)
+            crime_success_mult:              Crime success multiplier (from Source-Files and Augments)
+            isWorking:                       Boolean indicating whether the player is currently performing work
+            workType:                        Name of the kind of work the player is performing
+            currentWorkFactionName:          Name of the faction the player is currently working for
+            currentWorkFactionDescription:   Description of the kind of work the player is currently doing
+            workHackExpGainRate:             Amount of Hacking experience the player will gain every cycle (fifth of a second)
+            workStrExpGainRate:              Amount of Strength experience the player will gain every cycle
+            workDefExpGainRate:              Amount of Defense experience the player will gain every cycle
+            workDexExpGainRate:              Amount of Dexterity experience the player will gain every cycle
+            workAgiExpGainRate:              Amount of Agility experience the player will gain every cycle
+            workChaExpGainRate:              Amount of Charisma experience the player will gain every cycle
+            workRepGainRate:                 Amount of Reputation the player will gain every cycle
+            workMoneyGainRate:               Amount of Money the player will gain every cycle
+            workMoneyLossRate:               Amount of Money the player will lose every cycle
+            workHackExpGained:               Total Hacking experience gained while working thus far
+            workStrExpGained:                Total Strength experience gained while working thus far
+            workDefExpGained:                Total Defense experience gained while working thus far
+            workDexExpGained:                Total Dexterity experience gained while working thus far
+            workAgiExpGained:                Total Agility experience gained while working thus far
+            workChaExpGained:                Total Charisma experience gained while working thus far
+            workRepGained:                   Total Reputation gained while working thus far
+            workMoneyGained:                 Total Money gained while working thus far
+            createProgramName:               Name of the program the player is currently creating
+            createProgramReqLvl:             Hacking skill required to make that program
+            className:                       Name of the class the player is currently studying
+            crimeType:                       Name of the crime the player last started
+            work_money_mult:                 Salary multiplier (from Source-Files and Augments)
+            hacknet_node_money_mult:         Hacknet Node production multiplier (from Source-Files and Augments)
+            hacknet_node_purchase_cost_mult: Hacknet Node purchase cost multiplier (from Source-Files and Augments)
+            hacknet_node_ram_cost_mult:      Hacknet Node RAM upgrade cost multiplier (from Source-Files and Augments)
+            hacknet_node_core_cost_mult:     Hacknet Node Core purchase cost multiplier (from Source-Files and Augments)
+            hacknet_node_level_cost_mult:    Hacknet Node level upgrade cost multiplier (from Source-Files and Augments)
+            hasWseAccount:                   Boolean indicating whether the player has a WSE Account
+            hasTixApiAccess:                 Boolean indicating whether the player has TIX API Access
+            has4SData:                       Boolean indicating whether the player has 4S Market Data Access
+            has4SDataTixApi:                 Boolean indicating whether the player has 4S Market Data TIX API Access
+            bladeburner_max_stamina_mult:    Bladeburner Max Stamina multiplier (from Source-Files and Augments)
+            bladeburner_stamina_gain_mult:   Bladeburner Stamina Gain multiplier (from Source-Files and Augments)
+            bladeburner_success_chance_mult: Bladeburner Success Chance multiplier (from Source-Files and Augments)
+            bitNodeN:                        Current BitNode number
+            totalPlaytime:                   Total amount of time the game has been running, in milliseconds
+            playtimeSinceLastAug:            Milliseconds since the last time Augmentations were installed
+            playtimeSinceLastBitnode:        Milliseconds since this BitNode was started
+            jobs:                            A mapping of companies the player works for to the title of the player's job at that company
+            factions:                        An array of factions the player is currently a member of
+            tor:                             Boolean indicating whether or not you have a tor router
+        }
+
+    Example::
+
+        player = getPlayer();
+        print('My charisma level is: ' + player.charisma);

doc/source/netscript/basicfunctions/getPortHandle.rst

@@ -3,9 +3,9 @@ getPortHandle() Netscript Function
 
 .. js:function:: getPortHandle(port)
 
-    :param number port: Port number
     :RAM cost: 10 GB
 
-    Get a handle to a Netscript Port. See more details here: :ref:`netscript_ports`
+    :param number port: Port number
+    :returns: portHandle object. See :ref:`netscript_ports`
 
     **WARNING:** Port Handles only work in :ref:`netscriptjs`. They will not work in :ref:`netscript1`.

doc/source/netscript/basicfunctions/getPurchasedServerCost.rst

@@ -6,11 +6,10 @@ getPurchasedServerCost() Netscript Function
     :RAM cost: 0.25 GB
 
     :param number ram: Amount of RAM of a potential purchased server. Must be a power of 2 (2, 4, 8, 16, etc.). Maximum value of 1048576 (2^20)
+    :returns: Cost to purchase a server with the specified amount of ``ram``.
 
-    Returns the cost to purchase a server with the specified amount of *ram*.
+    Example:
 
-    Examples::
+    .. code-block:: javascript
 
-        for (i = 1; i <= 20; i++) {
-            tprint(i + " -- " + getPurchasedServerCost(Math.pow(2, i)));
-        }
+        getPurchasedServerCost(8192); // returns: 450560000

doc/source/netscript/basicfunctions/getPurchasedServerLimit.rst

@@ -4,5 +4,10 @@ getPurchasedServerLimit() Netscript Function
 .. js:function:: getPurchasedServerLimit()
 
     :RAM cost: 0.05 GB
+    :returns: The maximum number of servers you can purchase.
 
-    Returns the maximum number of servers you can purchase
+    Example:
+
+    .. code-block:: javascript
+
+        getPurchasedServerLimit() // returns: 25

doc/source/netscript/basicfunctions/getPurchasedServerMaxRam.rst

@@ -4,5 +4,10 @@ getPurchasedServerMaxRam() Netscript Function
 .. js:function:: getPurchasedServerMaxRam()
 
     :RAM cost: 0.05 GB
+    :returns: The maximum RAM that a purchased server can have.
 
-    Returns the maximum RAM that a purchased server can have
+    Example:
+
+    .. code-block:: javascript
+
+        getPurchasedServerMaxRam(); // returns: 1048576

doc/source/netscript/basicfunctions/getPurchasedServers.rst

@@ -1,11 +1,13 @@
 getPurchasedServers() Netscript Function
 ========================================
 
-.. js:function:: getPurchasedServers([hostname=true])
+.. js:function:: getPurchasedServers()
 
-    :param boolean hostname:
-        Specifies whether hostnames or IP addresses should be returned. If it's true then hostnames will be returned, and if false
-        then IPs will be returned. If this argument is omitted then it is true by default
     :RAM cost: 2.25 GB
+    :returns: String array of hostnames of all of the servers you have purchased.
 
-    Returns an array with either the hostnames or IPs of all of the servers you have purchased.
+    Example:
+
+    .. code-block:: javascript
+
+        getPurchasedServers(); // returns: ['grow-server-0', 'grow-server-1', 'weaken-server-0']

doc/source/netscript/basicfunctions/getRunningScript.rst

@@ -0,0 +1,88 @@
+getRunningScript() Netscript Function
+=====================================
+
+.. js:function:: getRunningScript()
+
+    :RAM cost: 0.3 GB
+    :returns: Script object or null if not found.
+
+    The object has the following properties:
+
+    .. code-block:: javascript
+
+        {
+            // Script arguments
+            args
+
+            // Script filename
+            filename
+
+            // This script's logs. An array of log entries
+            logs
+
+            // Flag indicating whether the logs have been updated since
+            // the last time the UI was updated
+            logUpd
+
+            // Total amount of hacking experience earned from this script when offline
+            offlineExpGained
+
+            // Total amount of money made by this script when offline
+            offlineMoneyMade
+
+            // Number of seconds that the script has been running offline
+            offlineRunningTime
+
+            // Total amount of hacking experience earned from this script when online
+            onlineExpGained
+
+            // Total amount of money made by this script when online
+            onlineMoneyMade
+
+            // Number of seconds that this script has been running online
+            onlineRunningTime
+
+            // Process ID.
+            pid
+
+            // How much RAM this script uses for ONE thread
+            ramUsage
+
+            // IP of the server on which this script is running
+            server
+
+            // Number of threads that this script is running with
+            threads
+        }
+
+    Examples:
+
+    .. code-block:: javascript
+
+        getRunningScript(); // get the current script.
+
+.. js:function:: getRunningScript(pid)
+
+    :RAM cost: 0.3 GB
+    :param number pid: PID of the script.
+    :returns: Script object or null if not found.
+
+    Examples:
+
+    .. code-block:: javascript
+
+        getRunningScript(42); // get the script with pid 42.
+
+.. js:function:: getRunningScript(fn, hostname[, args...])
+
+    :RAM cost: 0.3 GB
+    :param number fn: Filename of the target script.
+    :param number hostname: Hostname of the server running the script.
+    :param number args...: Arguments that the script is running with.
+    :returns: Script object or null if not found.
+
+    Examples:
+
+    .. code-block:: javascript
+
+        getRunningScript("example.script", "home", "foodnstuff"); // get the script called "example.script" on "home" with argument "foodnstuff"

doc/source/netscript/basicfunctions/getScriptExpGain.rst

@@ -1,14 +1,17 @@
 getScriptExpGain() Netscript Function
 =====================================
 
-.. js:function:: getScriptExpGain([scriptname], [hostname/ip], [args...])
+.. js:function:: getScriptExpGain([scriptname[, hostname[, args...]]])
 
-    :param string scriptname: Filename of script
-    :param string hostname/ip: Server on which script is running
-    :param args...: Arguments that the script is running with
     :RAM cost: 0.1 GB
+    :param string scriptname: Filename of script.
+    :param string hostname: Server on which script is running.
+    :param args...: Arguments that the script is running with.
+    :returns: The amount of hacking experience the specified script generates
+        while online.
 
-    Returns the amount of hacking experience the specified script generates while online (when the game is open, does not apply for offline experience gains).
-    Remember that a script is uniquely identified by both its name and its arguments.
+    This function can also return the total experience gain rate of all of your
+    active scripts by running the function with no arguments.
 
-    This function can also return the total experience gain rate of all of your active scripts by running the function with no arguments.
+    .. note:: A script is uniquely identified by both its name and its
+        arguments.

doc/source/netscript/basicfunctions/getScriptIncome.rst

@@ -1,18 +1,19 @@
 getScriptIncome() Netscript Function
 ====================================
 
-.. js:function:: getScriptIncome([scriptname], [hostname/ip], [args...])
+.. js:function:: getScriptIncome([scriptname[, hostname/ip[, [args...]]])
 
+    :RAM cost: 0.1 GB
     :param string scriptname: Filename of script
     :param string hostname/ip: Server on which script is running
     :param args...: Arguments that the script is running with
-    :RAM cost: 0.1 GB
+    :returns: Amount of income the specified script generates while online.
 
-    Returns the amount of income the specified script generates while online (when the game is open, does not apply for offline income).
-    Remember that a script is uniquely identified by both its name and its arguments. So for example if you ran a script with the arguments
-    "foodnstuff" and "5" then in order to use this function to get that script's income you must specify those same arguments in the same order
-    in this function call.
+    If called with no arguments this function will return an array of two
+    values. The first value is the total income ($ / second) of all of your
+    active scripts (scripts that are currently running on any server). The
+    second value is the total income ($ / second) that you've earned from
+    scripts since you last installed Augmentations.
 
-    This function can also be called with no arguments. If called with no arguments, then this function will return an array of two values. The
-    first value is the total income ($ / second) of all of your active scripts (scripts that are currently running on any server). The second value
-    is the total income ($ / second) that you've earned from scripts since you last installed Augmentations.
+    .. note:: A script is uniquely identified by both its name and its
+        arguments.

doc/source/netscript/basicfunctions/getScriptLogs.rst

@@ -1,27 +1,27 @@
 getScriptLogs() Netscript Function
 ==================================
 
-.. js:function:: getScriptLogs([fn], [hostname/ip=current ip], [args...])
+.. js:function:: getScriptLogs([filename[, hostname=current hostname[, args...]]])
 
-    :param string fn: Optional. Filename of script to get logs from.
-    :param string ip: Optional. IP or hostname of the server that the script is on
-    :param args...: Arguments to identify which scripts to get logs for
     :RAM cost: 0 GB
+    :param string filename: Optional. Filename of script to get logs from.
+    :param string hostname: Optional. Hostname of the server running the script.
+    :param args...: Arguments to identify which scripts to get logs for
+    :returns: Array of string, each line being a logged line. Chronological.
 
-    Returns a script's logs. The logs are returned as an array, where each
-    line is an element in the array. The most recently logged line is at the
-    end of the array.
+    .. note:: There is a maximum number of lines that a script stores in its logs.
+        This is configurable in the game's options.
 
-    Note that there is a maximum number of lines that a script stores in its logs.
-    This is configurable in the game's options.
+    If the function is called with no arguments, it will return the current
+    script's logs.
 
-    If the function is called with no arguments, it will return the current script's logs.
+    Otherwise, the ``filename``, ``hostname``, and ``args...`` arguments can be
+    used to get the logs from another script. Remember that scripts are uniquely
+    identified by both their names and arguments.
 
-    Otherwise, the `fn`, `hostname/ip,` and `args...` arguments can be used to get the logs
-    from another script. Remember that scripts are uniquely identified by both
-    their names and arguments.
+    Example:
 
-    Examples::
+    .. code-block:: javascript
 
         // Get logs from foo.script on the current server that was run with no args
         getScriptLogs("foo.script");

doc/source/netscript/basicfunctions/getScriptName.rst

@@ -4,5 +4,10 @@ getScriptName() Netscript Function
 .. js:function:: getScriptName()
 
     :RAM cost: 0 GB
+    :returns: Current script name.
 
-    Returns the current script name
+    Example:
+
+    .. code-block:: javascript
+
+        getScriptName(); // returns: "example.script"

doc/source/netscript/basicfunctions/getScriptRam.rst

@@ -1,11 +1,16 @@
 getScriptRam() Netscript Function
 =================================
 
-.. js:function:: getScriptRam(scriptname[, hostname/ip])
+.. js:function:: getScriptRam(filename[, hostname])
 
-    :param string scriptname: Filename of script. This is case-sensitive.
-    :param string hostname/ip: Hostname or IP of target server the script is located on. This is optional, If it is not specified then the function will set the current server as the target server.
     :RAM cost: 0.1 GB
+    :param string filename: Filename of script.
+    :param string hostname: Hostname of target server the script is located on.
+        Default to the server this script is running on.
+    :returns: Amount of RAM required to run the script, 0 if it does not exist.
 
-    Returns the amount of RAM required to run the specified script on the target server. Returns
-    0 if the script does not exist.
+    Example:
+
+    .. code-block:: javascript
+
+        getScriptRam("grow.script"); // returns: 1.75

doc/source/netscript/basicfunctions/getServerBaseSecurityLevel.rst

@@ -1,12 +1,28 @@
 getServerBaseSecurityLevel() Netscript Function
 ===============================================
 
-.. js:function:: getServerBaseSecurityLevel(hostname/ip)
+.. js:function:: getServerBaseSecurityLevel(hostname)
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: Base security level of target server.
 
-    Returns the base security level of the target server. This is the security level that the server starts out with.
-    This is different than *getServerSecurityLevel()* because *getServerSecurityLevel()* returns the current
-    security level of a server, which can constantly change due to *hack()*, *grow()*, and *weaken()*, calls on that
-    server. The base security level will stay the same until you reset by installing an Augmentation(s).
+    The base security level is the security level that the server starts out with.
+    
+    This function isn't particularly useful.
+    :doc:`getServerSecurityLevel<getServerSecurityLevel>` and
+    :doc:`getServerMinSecurityLevel<getServerMinSecurityLevel>` are more often
+    used.
+
+    Example:
+
+    .. code-block:: javascript
+
+        getServerBaseSecurityLevel('foodnstuff'); // returns: 9
+
+.. note:: This is different than :doc:`getServerSecurityLevel<getServerSecurityLevel>`
+        because :doc:`getServerSecurityLevel<getServerSecurityLevel>` returns the current
+        security level of a server, which can constantly change due to
+        :doc:`hack<hack>`, :doc:`grow<grow>`, and :doc:`weaken<weaken>` calls on
+        that server. The base security level will stay the same until you reset
+        by installing augmentation(s).

doc/source/netscript/basicfunctions/getServerGrowth.rst

@@ -1,12 +1,19 @@
 getServerGrowth() Netscript Function
 ====================================
 
-.. js:function:: getServerGrowth(hostname/ip)
+.. js:function:: getServerGrowth(hostname)
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: Server growth parameter.
 
-    Returns the server's instrinsic "growth parameter". This growth parameter is a number
-    between 1 and 100 that represents how quickly the server's money grows. This parameter affects the
-    percentage by which the server's money is increased when using the *grow()* function. A higher
-    growth parameter will result in a higher percentage increase from *grow()*.
+    The growth parameter is a number, typically between 1 and 100, that affects
+    the percentage by which the server's money is increased when using the
+    :doc:`grow<grow>` function. A higher growth parameter will result in a
+    higher percentage increase.
+
+    Example:
+
+    .. code-block:: javascript
+
+        getServerGrowth('foodnstuff'); // returns: 5

doc/source/netscript/basicfunctions/getServerMaxMoney.rst

@@ -1,9 +1,14 @@
 getServerMaxMoney() Netscript Function
 ======================================
 
-.. js:function:: getServerMaxMoney(hostname/ip)
+.. js:function:: getServerMaxMoney(hostname)
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: Maximum amount of money that can be available on a server.
 
-    Returns the maximum amount of money that can be available on a server
+    Example:
+
+    .. code-block:: javascript
+
+        getServerMaxMoney('foodnstuff'); // returns: 50000000

doc/source/netscript/basicfunctions/getServerMaxRam.rst

@@ -0,0 +1,15 @@
+getServerMaxRam() Netscript Function
+====================================
+
+.. js:function:: getServerMaxRam(hostname)
+
+    :RAM cost: 0.05 GB
+    :param string hostname: Hostname of target server.
+    :returns: Total ram available on that server. In GB.
+
+    Example:
+
+    .. code-block:: javascript
+
+        maxRam = getServerMaxRam("helios"); // returns: 16
+        print("helios has "+maxRam + "GB");

doc/source/netscript/basicfunctions/getServerMinSecurityLevel.rst

@@ -1,9 +1,14 @@
 getServerMinSecurityLevel() Netscript Function
 ==============================================
 
-.. js:function:: getServerMinSecurityLevel(hostname/ip)
+.. js:function:: getServerMinSecurityLevel(hostname)
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: The minimum security level of the target server.
 
-    Returns the minimum security level of the target server
+    Example:
+
+    .. code-block:: javascript
+
+        getServerMinSecurityLevel('foodnstuff'); // returns: 3

doc/source/netscript/basicfunctions/getServerMoneyAvailable.rst

@@ -1,15 +1,19 @@
 getServerMoneyAvailable() Netscript Function
 ============================================
 
-.. js:function:: getServerMoneyAvailable(hostname/ip)
+.. js:function:: getServerMoneyAvailable(hostname)
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: Money available on that server.
 
-    Returns the amount of money available on a server. **Running this function on the home computer will return
-    the player's money.**
+    .. note::
 
-    Example::
+        Running this function on the home computer will return the player's money.
 
-        getServerMoneyAvailable("foodnstuff");
-        getServerMoneyAvailable("home"); //Returns player's money
+    Example:
+
+    .. code-block:: javascript
+
+        getServerMoneyAvailable("foodnstuff"); // returns: 120000
+        getServerMoneyAvailable("home"); // returns: 1000

doc/source/netscript/basicfunctions/getServerNumPortsRequired.rst

@@ -1,9 +1,15 @@
 getServerNumPortsRequired() Netscript Function
 ==============================================
 
-.. js:function:: getServerNumPortsRequired(hostname/ip)
+.. js:function:: getServerNumPortsRequired(hostname)
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: The number of open ports required to successfully run NUKE.exe on
+        the specified server.
 
-    Returns the number of open ports required to successfully run NUKE.exe on the specified server.
+    Example:
+
+    .. code-block:: javascript
+
+        getServerNumPortsRequired("unitalife"); // returns: 4

doc/source/netscript/basicfunctions/getServerRam.rst

@@ -1,17 +1,25 @@
 getServerRam() Netscript Function
 =================================
 
-.. js:function:: getServerRam(hostname/ip)
+.. js:function:: getServerRam(hostname)
+
+    .. warning:: This function is deprecated. It still functions, but new
+                 scripts should prefer :doc:`getServerMaxRam<getServerMaxRam>`
+                 and :doc:`getServerUsedRam<getServerUsedRam>` instead.
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: An array of 2 numbers; the first number is the total RAM, and the
+        second is the used RAM.
 
     Returns an array with two elements that gives information about a server's memory (RAM). The first
     element in the array is the amount of RAM that the server has total (in GB). The second element in
     the array is the amount of RAM that is currently being used on the server (in GB).
 
-    Example::
+    Example:
 
-        res = getServerRam("helios");
+    .. code-block:: javascript
+
+        res = getServerRam("helios"); // returns: [5, 10]
         totalRam = res[0];
         ramUsed = res[1];

doc/source/netscript/basicfunctions/getServerRequiredHackingLevel.rst

@@ -1,9 +1,14 @@
 getServerRequiredHackingLevel() Netscript Function
 ==================================================
 
-.. js:function:: getServerRequiredHackingLevel(hostname/ip)
+.. js:function:: getServerRequiredHackingLevel(hostname)
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: The required hacking level of target server.
 
-    Returns the required hacking level of the target server
+    Example:
+
+    .. code-block:: javascript
+
+        getServerRequiredHackingLevel("foodnstuff"); // returns: 5

doc/source/netscript/basicfunctions/getServerSecurityLevel.rst

@@ -1,10 +1,14 @@
 getServerSecurityLevel() Netscript Function
 ===========================================
 
-.. js:function:: getServerSecurityLevel(hostname/ip)
+.. js:function:: getServerSecurityLevel(hostname)
 
-    :param string hostname/ip: Hostname or IP of target server
     :RAM cost: 0.1 GB
+    :param string hostname: Hostname of target server.
+    :returns: The security level of the target server.
 
-    Returns the security level of the target server. A server's security level is denoted by a number, typically
-    between 1 and 100 (but it can go above 100).
+    Example:
+
+    .. code-block:: javascript
+
+        getServerSecurityLevel("foodnstuff"); // returns: 3.45

doc/source/netscript/basicfunctions/getServerUsedRam.rst

@@ -0,0 +1,15 @@
+getServerUsedRam() Netscript Function
+=====================================
+
+.. js:function:: getServerUsedRam(hostname)
+
+    :RAM cost: 0.05 GB
+    :param string hostname: Hostname of target server.
+    :returns: Used ram on that server. In GB.
+
+    Example:
+
+    .. code-block:: javascript
+
+        usedRam = getServerUsedRam("harakiri-sushi"); // returns: 5.6
+        print("harakiri-sushi uses "+usedRam + "GB");

doc/source/netscript/basicfunctions/getTimeSinceLastAug.rst

@@ -4,5 +4,10 @@ getTimeSinceLastAug() Netscript Function
 .. js:function:: getTimeSinceLastAug()
 
     :RAM cost: 0.05 GB
+    :returns: Milliseconds since you last installed augmentations.
 
-    Returns the amount of time in milliseconds that have passed since you last installed Augmentations
+    Example:
+
+    .. code-block:: javascript
+
+        getTimeSinceLastAug(); // returns: 13912400

doc/source/netscript/basicfunctions/getWeakenTime.rst

@@ -1,13 +1,23 @@
 getWeakenTime() Netscript Function
 ==================================
 
-.. js:function:: getWeakenTime(hostname/ip[, hackLvl=current level])
+.. js:function:: getWeakenTime(hostname[, hackLvl=current level])
 
-    :param string hostname/ip: Hostname or IP of target server
-    :param number hackLvl: Optional hacking level for the calculation. Defaults to player's current hacking level
     :RAM cost: 0.05 GB
-
-    Returns the amount of time in seconds it takes to execute the *weaken()* Netscript function on the target server.
+    :param string hostname: Hostname of target server.
+    :param number hackLvl: Optional hacking level for the calculation. Defaults
+        to player's current hacking level.
+    :returns: seconds it takes to execute the :doc:`weaken<weaken>` Netscript
+        function on the target server.
 
     The function takes in an optional *hackLvl* parameter that can be specified
     to see what the weaken time would be at different hacking levels.
+
+    Example:
+
+    .. code-block:: javascript
+
+        getWeakenTime("foodnstuff"); // returns: 34.5
+
+    .. note:: For Hacknet Servers (the upgraded version of a Hacknet Node), this function will
+              return :code:`Infinity`. 

doc/source/netscript/basicfunctions/grow.rst

@@ -1,9 +1,10 @@
 grow() Netscript Function
 =========================
 
-.. js:function:: grow(hostname/ip[, opts={}])
+.. js:function:: grow(hostname[, opts={}])
 
-    :param string hostname/ip: IP or hostname of the target server to grow
+    :RAM cost: 0.15 GB
+    :param string hostname: Hostname of the target server.
     :param object opts: Optional parameters for configuring function behavior. Properties:
 
         * threads (*number*) - Number of threads to use for this function.
@@ -12,18 +13,25 @@ grow() Netscript Function
           :ref:`gameplay_stock_market_player_actions_influencing_stock`
 
     :returns: The number by which the money on the server was multiplied for the growth
-    :RAM cost: 0.15 GB
 
-    Use your hacking skills to increase the amount of money available on a server. The runtime for this command depends on your hacking
-    level and the target server's security level. When grow() completes, the money available on a target server will be increased by a
-    certain, fixed percentage. This percentage is determined by the target server's growth rate (which varies between servers) and security level.
-    Generally, higher-level servers have higher growth rates. The getServerGrowth() function can be used to obtain a server's growth rate.
+    Increase the amount of money available on a server. The time it takes to
+    execute depends on your hacking level and the target server's security
+    level. When :doc:`grow<grow>` completes, the money available on a target
+    server will be increased by a certain, fixed percentage. This percentage is
+    determined by the target server's growth rate (which varies between servers)
+    and security level. Generally, higher-level servers have higher growth
+    rates. The :doc:`getServerGrowth<getServerGrowth>` function can be used to
+    obtain a server's growth rate.
 
-    Like hack(), grow() can be called on any server, regardless of where the script is running. The grow() command requires
-    root access to the target server, but there is no required hacking level to run the command. It also raises the security level
-    of the target server by 0.004.
+    Like :doc:`hack<hack>`, :doc:`grow<grow>` can be called on any server, from
+    any server. The :doc:`grow<grow>` command requires root access to the target
+    server, but there is no required hacking level to run the command. It also
+    raises the security level of the target server by 0.004 per thread.
 
-    Example::
+    Example:
 
-        grow("foodnstuff");
-        grow("foodnstuff", { threads: 5 }); // Only use 5 threads to grow
+    .. code-block:: javascript
+
+        while(true) {
+            grow("foodnstuff");
+        }

doc/source/netscript/basicfunctions/growthAnalyze.rst

@@ -1,24 +1,23 @@
 growthAnalyze() Netscript Function
 ==================================
 
-.. js:function:: growthAnalyze(hostname/ip, growthAmount)
+.. js:function:: growthAnalyze(hostname, growthAmount)
 
-    :param string hostname/ip: IP or hostname of server to analyze
-    :param number growthAmount: Multiplicative factor by which the server is grown. Decimal form.
-    :returns: The amount of grow() calls needed to grow the specified server by the specified amount
     :RAM cost: 1 GB
+    :param string hostname: Hostname of server to analyze.
+    :param number growthAmount: Multiplicative factor by which the server is
+        grown. Decimal form. Must be >= 1.
+    :returns: The amount of :doc:`grow<grow>` threads needed to grow the specified
+        server by the specified amount.
 
-    This function returns the number of "growths" needed in order to increase the amount
-    of money available on the specified server by the specified amount.
+    Example:
 
-    The specified amount is multiplicative and is in decimal form, not percentage.
+    .. code-block:: javascript
 
-    For example, if you want to determine how many `grow()` calls you need
-    to double the amount of money on `foodnstuff`, you would use::
+        // How many grow threads are needed to double the current money on 'foodnstuff'
+        growthAnalyze("foodnstuff", 2); // returns: 5124
 
-        growthAnalyze("foodnstuff", 2);
-
-    If this returns 100, then this means you need to call `grow()` 100 times
-    in order to double the money (or once with 100 threads).
+    If this returns 5124, then this means you need to call :doc:`grow<grow>`
+    5124 times in order to double the money (or once with 5124 threads).
 
     **Warning**: The value returned by this function isn't necessarily a whole number.

doc/source/netscript/basicfunctions/hack.rst

@@ -1,29 +1,35 @@
 hack() Netscript Function
 =========================
 
-.. js:function:: hack(hostname/ip[, opts={}])
+.. js:function:: hack(hostname[, opts={}])
 
-    :param string hostname/ip: IP or hostname of the target server to hack
+    :RAM cost: 0.1 GB
+    :param string hostname: Hostname of the target server.
     :param object opts: Optional parameters for configuring function behavior. Properties:
 
         * threads (*number*) - Number of threads to use for this function.
           Must be less than or equal to the number of threads the script is running with.
         * stock (*boolean*) - If true, the function can affect the stock market. See
           :ref:`gameplay_stock_market_player_actions_influencing_stock`
-
     :returns: The amount of money stolen if the hack is successful, and zero otherwise
-    :RAM cost: 0.1 GB
 
-    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 server's security level. In order to hack a server you must first gain root access
-    to that server and also have the required hacking level.
+    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 server's 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 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 server's security level by 0.002.
+    A successful :doc:`hack<hack>` on a server will raise that server's security
+    level by 0.002.
 
-    Example::
+    Example:
+
+    .. code-block:: javascript
 
         hack("foodnstuff");
         hack("10.1.2.3");

doc/source/netscript/basicfunctions/hackAnalyzePercent.rst

@@ -1,20 +1,22 @@
 hackAnalyzePercent() Netscript Function
 =======================================
 
-.. js:function:: hackAnalyzePercent(hostname/ip)
+.. js:function:: hackAnalyzePercent(hostname)
 
-    :param string hostname/ip: IP or hostname of target server
-    :returns: The percentage of money you will steal from the target server with a single hack
     :RAM cost: 1 GB
+    :param string hostname: Hostname of target server.
+    :returns: The percentage of money you will steal from the target server with
+        a single hack.
 
     Returns the percentage of the specified server's money you will steal with a
-    single hack. This value is returned in **percentage form, not decimal (Netscript
-    functions typically return in decimal form, but not this one).**
+    single hack. This value is returned in percentage form, not decimal.
 
-    For example, assume the following returns 1::
+    For example, assume the following returns 1:
 
-        hackAnalyzePercent("foodnstuff");
+    .. code-block:: javascript
 
-    This means that if hack the `foodnstuff` server, then you will steal 1% of its
-    total money. If you `hack()` using N threads, then you will steal N% of its total
+        hackAnalyzePercent("foodnstuff"); // returns: 1
+
+    This means that if hack the 'foodnstuff' server, then you will steal 1% of its
+    total money. If you :doc:`hack<hack>` using N threads, then you will steal N% of its total
     money.

doc/source/netscript/basicfunctions/hackAnalyzeThreads.rst

@@ -1,24 +1,28 @@
 hackAnalyzeThreads() Netscript Function
 =======================================
 
-.. js:function:: hackAnalyzeThreads(hostname/ip, hackAmount)
+.. js:function:: hackAnalyzeThreads(hostname, hackAmount)
 
-    :param string hostname/ip: IP or hostname of server to analyze
-    :param number hackAmount: Amount of money you want to hack from the server
-    :returns: The number of threads needed to hack() the server for *hackAmount* money
     :RAM cost: 1 GB
+    :param string hostname: Hostname of server to analyze.
+    :param number hackAmount: Amount of money you want to hack from the server.
+    :returns: The number of threads needed to :doc:`hack<hack>` the server for
+        ``hackAmount`` money.
 
     This function returns the number of script threads you need when running
-    the `hack()` command to steal the specified amount of money from the target server.
+    the :doc:`hack<hack>` command to steal the specified amount of money from
+    the target server.
 
-    If `hackAmount` is less than zero or greater than the amount of money available
-    on the server, then this function returns -1.
+    If ``hackAmount`` is less than zero or greater than the amount of money
+    available on the server, then this function returns -1.
 
-    For example, let's say the `foodnstuff` server has $10m and you run::
+    For example, let's say the 'foodnstuff' server has $10m and you run:
+
+    .. code-block:: javascript
 
         hackAnalyzeThreads("foodnstuff", 1e6);
 
-    If this function returns 50, this means that if your next `hack()` call
+    If this function returns 50, this means that if your next :doc:`hack<hack>` call
     is run on a script with 50 threads, it will steal $1m from the `foodnstuff` server.
 
     .. warning:: The value returned by this function isn't necessarily a whole number.

doc/source/netscript/basicfunctions/hackChance.rst

@@ -1,11 +1,16 @@
 hackChance() Netscript Function
 ===============================
 
-.. js:function:: hackChance(hostname/ip)
+.. js:function:: hackChance(hostname)
 
-    :param string hostname/ip: IP or hostname of target server
-    :returns: The chance you have of successfully hacking the target server
     :RAM cost: 1 GB
+    :param string hostname: Hostname of target server.
+    :returns: The chance you have of successfully hacking the target server.
+        in decimal form.
 
-    Returns the chance you have of successfully hacking the specified server. This
-    returned value is in decimal form, not percentage.
+    Example:
+
+    .. code-block:: javascript
+
+        hackChance("foodnstuff"); // returns: .5
+        // So 50% chance to hack "foodnstuff"

doc/source/netscript/basicfunctions/hasRootAccess.rst

@@ -1,14 +1,15 @@
 hasRootAccess() Netscript Function
 ==================================
 
-.. js:function:: hasRootAccess(hostname/ip)
+.. js:function:: hasRootAccess(hostname)
 
-    :param string hostname/ip: Hostname or IP of the target server
     :RAM cost: 0.05 GB
+    :param string hostname: Hostname of the target server.
+    :returns: ``true`` if you have root access on the target server.
 
-    Returns a boolean indicating whether or not the player has root access to the specified target server.
+    Example:
 
-    Example::
+    .. code-block:: javascript
 
         if (hasRootAccess("foodnstuff") == false) {
             nuke("foodnstuff");

doc/source/netscript/basicfunctions/httpworm.rst

@@ -1,13 +1,16 @@
 httpworm() Netscript Function
 =============================
 
-.. js:function:: httpworm(hostname/ip)
+.. js:function:: httpworm(hostname)
 
-    :param string hostname/ip: IP or hostname of the target server
-    :RAM cost: 0 GB
+    :RAM cost: 0.05 GB
+    :param string hostname: Hostname of the target server.
 
-    Runs the HTTPWorm.exe program on the target server. HTTPWorm.exe must exist on your home computer.
+    Runs the ``HTTPWorm.exe`` program on the target server. ``HTTPWorm.exe``
+    must exist on your home computer.
 
-    Example::
+    Example:
+
+    .. code-block:: javascript
 
         httpworm("foodnstuff");

doc/source/netscript/basicfunctions/isLogEnabled.rst

@@ -1,10 +1,14 @@
 isLogEnabled() Netscript Function
 =================================
 
-.. js:function:: isLogEnabled(fn)
+.. js:function:: isLogEnabled(functionName)
 
-    :param string fn: Name of function to check
     :RAM cost: 0 GB
+    :param string functionName: Name of function to check.
+    :returns: ``true`` is logs are enabled for this function or for 'ALL'
 
-    Returns a boolean indicating whether or not logging is enabled for that
-    function (or 'ALL')
+    Example:
+
+    .. code-block:: javascript
+
+        isLogEnabled('hack'); // returns: true