From 6784b518d0c0a10d91dbbba8f69036d184400937 Mon Sep 17 00:00:00 2001 From: Mughur Date: Sat, 20 Aug 2022 11:12:11 +0300 Subject: [PATCH] Some docs updates --- doc/source/basicgameplay/factions.rst | 20 ++-- doc/source/gamefrozen.rst | 47 ++++++++++ .../guidesandtips/recommendedbitnodeorder.rst | 92 ++++++++++++++++++- 3 files changed, 145 insertions(+), 14 deletions(-) diff --git a/doc/source/basicgameplay/factions.rst b/doc/source/basicgameplay/factions.rst index 542a9a6ac..430cab103 100644 --- a/doc/source/basicgameplay/factions.rst +++ b/doc/source/basicgameplay/factions.rst @@ -127,34 +127,34 @@ List of Factions and their Requirements | Megacorporations | Faction Name | Requirements | Joining this Faction prevents | | | | | you from joining: | + +----------------+-----------------------------------------+-------------------------------+ -| | ECorp | * Have 200k reputation with | | +| | ECorp | * Have 400k reputation with | | | | | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | MegaCorp | * Have 200k reputation with | | +| | MegaCorp | * Have 400k reputation with | | | | | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | KuaiGong | * Have 200k reputation with | | +| | KuaiGong | * Have 400k reputation with | | | | International | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | Four Sigma | * Have 200k reputation with | | +| | Four Sigma | * Have 400k reputation with | | | | | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | NWO | * Have 200k reputation with | | +| | NWO | * Have 400k reputation with | | | | | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | Blade | * Have 200k reputation with | | +| | Blade | * Have 400k reputation with | | | | Industries | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | OmniTek | * Have 200k reputation with | | +| | OmniTek | * Have 400k reputation with | | | | Incorporated | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | Bachman & | * Have 200k reputation with | | +| | Bachman & | * Have 400k reputation with | | | | Associates | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | Clarke | * Have 200k reputation with | | +| | Clarke | * Have 400k reputation with | | | | Incorporated | the Corporation | | + +----------------+-----------------------------------------+-------------------------------+ -| | Fulcrum Secret | * Have 250k reputation with | | +| | Fulcrum Secret | * Have 400k reputation with | | | | Technologies | the Corporation | | | | | * Install a backdoor on the | | | | | fulcrumassets server | | diff --git a/doc/source/gamefrozen.rst b/doc/source/gamefrozen.rst index 03876ae09..9b961598a 100644 --- a/doc/source/gamefrozen.rst +++ b/doc/source/gamefrozen.rst @@ -19,6 +19,53 @@ Then, to fix your script, make sure you have a sleep or any other timed function await ns.sleep(1000); // Add a 1s sleep to prevent freezing } +Also make sure that each while loop gets to `await`ed function or `break`, for example the next snippet has a sleep +function, but it nor any possible conditional breaks are never reached and therefore will crash the game:: + + while(true) { + let currentMoney = ns.getServerMoneyAvailable("n00dles"); + let maxMoney = ns.getServerMaxMoney("n00dles"); + if (currentMoney < maxMoney/2){ + await ns.grow("n00dles"); + } + if (currentMoney === maxMoney){ + break; + } + } + +If `n00dles` current money is, for example, 75% of the maximum money, the script will not reach neither `grow` nor `break` and crashes the game. +Adding a sleep like in the first example, or changing the code so that `await`ed function or `break` is always reached, would prevent the crash. + +Common infinite loop when translating the server purchasing script in starting guide to :ref:`netscriptjs` is to have a +while loop, that's condition's change is conditional:: + + var ram = 8; + var i = 0; + + while (i < ns.getPurchasedServerLimit()) { + if (ns.getServerMoneyAvailable("home") > ns.getPurchasedServerCost(ram)) { + var hostname = ns.purchaseServer("pserv-" + i, ram); + ns.scp("early-hack-template.script", hostname); + ns.exec("early-hack-template.script", hostname, 3); + ++i; + } + } + +if player does not currently have enough money to purchase a server, the `if`'s condition will be false and `++i` will not be reached. +Since the script doesn't have `sleep` and value `i` will not change without the `if` being true, this will crash the game. Adding a `sleep` +that is always reached would prevent the crash. + +Blackscreen +----------- + +If the game window becomes a black screen without the game itself crashing, this is caused by +the game running too many concurrent scripts (the game runs on a browser and each tab can only +use so much ram until it crashes). Depending on which scripts are running and your hardware, +this number can vary between 50000 to 100000 instances (in version 2.0.2. In prior versions this number +was about 1/5th of that). To prevent this from happening make sure to multithread the scripts as much as +possible. + + Bug --- diff --git a/doc/source/guidesandtips/recommendedbitnodeorder.rst b/doc/source/guidesandtips/recommendedbitnodeorder.rst index f2d4bfe41..6ca2c00e0 100644 --- a/doc/source/guidesandtips/recommendedbitnodeorder.rst +++ b/doc/source/guidesandtips/recommendedbitnodeorder.rst @@ -15,6 +15,7 @@ BitNode-1: Source Genesis Description The first BitNode created by the Enders to imprison the minds of humans. It became the prototype and testing-grounds for all of the BitNodes that followed. + This is the first BitNode that you play through. It has no special modifications or mechanics. @@ -34,6 +35,8 @@ Difficulty BitNode-2: Rise of the Underworld ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Description + From the shadows, they rose. + Organized crime groups quickly filled the void of power left behind from the collapse of Western government in the 2050s. As society and civlization broke down, people quickly succumbed to the innate human impulse of evil and savagery. The organized crime @@ -71,10 +74,12 @@ BitNode-3: Corporatocracy Description Our greatest illusion is that a healthy society can revolve around a single-minded pursuit of wealth. + Sometime in the early 21st century economic and political globalization turned the world into a corporatocracy, and it never looked back. Now, the privileged elite will happily bankrupt their own countrymen, decimate their own community, and evict their neighbors from houses in their desperate bid to increase their wealth. + In this BitNode you can create and manage your own corporation. Running a successful corporation has the potential of generating massive profits. All other forms of income are reduced by 75%. Furthermore: @@ -334,6 +339,7 @@ Description The 2050s was defined by the massive amounts of violent civil unrest and anarchic rebellion that rose all around the world. It was this period of disorder that eventually lead to the governmental reformation of many global superpowers, most notably the USA and China. But just as the world was slowly beginning to recover from these dark times, financial catastrophe hit. + In many countries, the high cost of trying to deal with the civil disorder bankrupted the governments. In all of this chaos and confusion, hackers were able to steal billions of dollars from the world's largest electronic banks, prompting an international banking crisis as governments were unable to bail out insolvent banks. Now, the world is slowly crumbling in the middle of the biggest economic crisis of all time. @@ -345,7 +351,7 @@ Description * The growth rate of servers is significantly reduced * Weakening a server is twice as effective * Company wages are decreased by 50% - * Corporation valuations are 99% lower and are therefore significantly less profitable + * Corporation valuations are 90% lower and are therefore significantly less profitable * Hacknet Node production is significantly decreased * Crime and Infiltration are more lucrative * Augmentations are twice as expensive @@ -381,6 +387,47 @@ Source-File Difficulty Initially very easy, but then it (obviously) becomes harder as you continue to do it. +BitNode-13: They're lunatics +^^^^^^^^^^^^^^^^^^^^^^^^^ +Description + With the invention of Augmentations in the 2040s a religious group known as the Church of the Machine God has rallied far more support than anyone would have hoped. + + Their leader, Allison "Mother" Stanek is said to have created her own Augmentation whose power goes beyond any other. Find her in Chongqing and gain her trust. + + In this BitNode: + + * Your hacking stat is reduced by 75% and exp by 90% + * Your combat stats are reduced by 30% + * Class and gym exp gains halved + * The starting and maximum amount of money available on servers is decreased + * The starting security on servers is significantly increased + * Hacking money is decreased by 80% + * Company wages are decreased by 60% and exp gains by 50% + * Hacknet Node production is decreased by 60% + * Crime money is decreased by 60% and exp gains by 50% + * Stockmarket data costs are increased 10-fold + * Corporation valuations are 99.9% lower and are therefore extremely less profitable + * The rank you gain from Bladeburner contracts/operations is reduced by 55% + * Bladeburner skills cost twice as many skill points + * Coding contracts rewards reduced by 60% + * Gangs gain are reduced significantly and offer low amount of Augmentations + * Size of Stanek's Gift is increased by 1 size + +Source-File + :Max Level: 3 + + Destroying this BitNode will give you Source-File 13, or if you already have this Source-File it will upgrade its level up to a maximum of 3. + This Source-File lets the Church of the Machine God appear in other BitNodes. + + Each level of this Source-File increases the size of Stanek's Gift. + + * Level 1: 5x5 + * Level 2: 6x6 + * Level 3: 7x7 + +Difficulty + Hard + Recommended BitNodes -------------------- As a player, you are not forced to tackle the BitNodes in any particular order. You are @@ -390,9 +437,43 @@ are the recommended BitNodes for different things: For fast progression ^^^^^^^^^^^^^^^^^^^^ -.. note:: This does not recommend the absolute fastest path, as I don't know what - exactly the fastest path is. But it does recommend the BitNodes that are - commonly considered to be optimal by players. +.. note:: These paths do not recommend the absolute fastest path, since speed of progression is + highly dependant on playing style. Path 1 is the recommended path according to the discord community. + +Path 1 (new): + +1. (Optional) 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. This also a let's you + get used to augments and other features resetting. + +2. Do **BitNode-3: Corporatocracy** once to unlock the Corporation mechanic. This mechanic + has highest profit potential in the game. + +3. Do **BitNode-10: Digital Carbon** once to unlock sleeves and grafting. Sleeves are useful in all nodes + and grafting can be useful in future BitNodes (especially 8). It's recommended to buy all sleeves and + their memory during the first run. + + The ordering of the next three is dependant on playing style and wants/needs. + +4. 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. + +5. Do **BitNode-4: The Singularity**. Its Source-File does not directly make you + more powerful in any way, but it does unlock the `Singularity API `_ which + let you automate significantly more aspects of the game. Consider repeating until Level 3, + since each level decreases the RAM cost of Singularity functions. + +6. Do **BitNode-2: Rise of the Underworld** once to unlock the gang mechanic. This mechanic + has high profit potential and offers large amounts of Augmentations in a single faction. + Having sleeves (Source-File 10) greatly reduces the time it takes to get access to gangs + outside this BitNode. + +7. 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. + +Path 2 (old): 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. @@ -479,6 +560,9 @@ simple money-generator to a more interesting mechanic. **BitNode-10: Digital Carbon** unlocks two new mechanics: Re-Sleeving and Duplicate Sleeves. +**BitNode-13: They're lunatics** unlocks Stanek's Gift. This gift can improve skills, +hacknet production and costs, working and crime gains as well hacking power and speed. + For a Challenge ^^^^^^^^^^^^^^^ In general, the higher BitNodes are more difficult than the lower ones.