mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-23 22:52:29 +01:00
Update doc & add FAQs
This commit is contained in:
parent
dfae337d26
commit
2747bf4439
@ -84,7 +84,9 @@ changes are okay to contribute:
|
|||||||
- Changes that directly affect the game's balance
|
- Changes that directly affect the game's balance
|
||||||
- New gameplay mechanics
|
- New gameplay mechanics
|
||||||
|
|
||||||
### How to setup fork properly
|
---
|
||||||
|
|
||||||
|
## How to setup fork properly
|
||||||
|
|
||||||
Fork and clone the repo
|
Fork and clone the repo
|
||||||
|
|
||||||
@ -106,7 +108,15 @@ Fork and clone the repo
|
|||||||
# Makes sure you always start from `danielyxie/dev` to avoid merge conflicts.
|
# Makes sure you always start from `danielyxie/dev` to avoid merge conflicts.
|
||||||
```
|
```
|
||||||
|
|
||||||
### Running locally.
|
## 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`
|
||||||
|
|
||||||
|
|
||||||
|
## Running locally.
|
||||||
|
|
||||||
Install
|
Install
|
||||||
|
|
||||||
@ -168,9 +178,14 @@ the following rules:
|
|||||||
|
|
||||||
## As a Documentor
|
## As a Documentor
|
||||||
|
|
||||||
To contribute to and view your changes to the BitBurner documentation, you will
|
To contribute to and view your changes to the BitBurner documentation on [Read The
|
||||||
|
Docs](http://bitburner.readthedocs.io/), you will
|
||||||
need to have Python installed, along with [Sphinx](http://www.sphinx-doc.org).
|
need to have Python installed, along with [Sphinx](http://www.sphinx-doc.org).
|
||||||
|
|
||||||
|
To make change to the [in-game documentation](./markdown/bitburner.md), you will need to modify the [TypeScript definitions](./src/ScriptEditor/NetscriptDefinitions.d.ts), not the markdown files.
|
||||||
|
|
||||||
|
We are using [API Extractor](https://api-extractor.com/pages/tsdoc/doc_comment_syntax/) (tsdoc hints) to generate the markdown doc. Make your changes to the TypeScript definitions and then run `npm run doc`.
|
||||||
|
|
||||||
Before submitting your code for a pull request, please try to follow these
|
Before submitting your code for a pull request, please try to follow these
|
||||||
rules:
|
rules:
|
||||||
|
|
||||||
@ -182,3 +197,14 @@ rules:
|
|||||||
_danielyxie/bitburner_ and the base is _dev_.
|
_danielyxie/bitburner_ and the base is _dev_.
|
||||||
- Do not check in any generated files under `doc\`. The documentation is built
|
- Do not check in any generated files under `doc\`. The documentation is built
|
||||||
automatically by ReadTheDocs.
|
automatically by ReadTheDocs.
|
||||||
|
|
||||||
|
## 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
|
||||||
|
77
FAQ.md
Normal file
77
FAQ.md
Normal file
@ -0,0 +1,77 @@
|
|||||||
|
# Frequently Asked Questions
|
||||||
|
|
||||||
|
## Can I donate to the project?
|
||||||
|
|
||||||
|
No, the project does not take donation.
|
||||||
|
|
||||||
|
If you still want to donate, go donate blood to your local blood bank or donate to the [Electronic Frontier Foundation](https://www.eff.org/) or [Médecins Sans Frontières](https://www.msf.org/)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## I need help / Where can I learn?
|
||||||
|
|
||||||
|
The best way to get help is to join the [official discord server](https://discord.gg/TFc3hKD). People of all skill levels will be able to give you hints and tips.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Can I play the same save on browser & steam?
|
||||||
|
|
||||||
|
Yes, just export the save file from the options menu & import it in the other platform.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Steam: Where is the save game located?
|
||||||
|
|
||||||
|
To maintain compatibility with the web browser version, the save game is not stored as a file on your filesystem. It lives inside the localStorage of the WebKit instance. You may export the save (and should backup it!) in the option menu.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Steam: Game won't stop / Game is shown as "Running"
|
||||||
|
|
||||||
|
Due to a limitation with the way Steam tracks the game, if you launch an external link (such as documentation), Steam may keep tracking the game as "Running" even after it is closed. You should simply have to close your web browser to fix this.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Steam: How do I get to the game files? <a name="game-files"></a>
|
||||||
|
|
||||||
|
You can navigate to the game files by right-clicking the game in your library and then go into "Manage" -> "Browse Local Files". The game can be launched directly from that location, if you're having issues with Steam.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Steam: Game won't launch
|
||||||
|
|
||||||
|
### **On Windows**
|
||||||
|
If the game is installed on a network drive, it will fail to start due to a [limitation in Chromium](https://github.com/electron/electron/issues/27356).
|
||||||
|
|
||||||
|
If you cannot move the game to another drive, you'll have to add the `--no-sandbox` launch option. In your Steam Library, Right click the game and hit "Properties". You'll see the launch option section in the "General" window.
|
||||||
|
|
||||||
|
### **On Linux**
|
||||||
|
The game is built natively, do not use Proton unless native does not work.
|
||||||
|
|
||||||
|
When launching the game, you will be prompted with three options. If the standard launch does not work, you may attempt the `--disable-seccomp-filter-sandbox` or `--no-sandbox` launch option. If this still does not work, the game should be able to start by launching it directly or through the terminal. See [How do I get to the game files?](#game-files).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Steam: File locations
|
||||||
|
|
||||||
|
### Logs (using [electron-log](https://github.com/megahertz/electron-log#readme))
|
||||||
|
|
||||||
|
You may want access the logs to get information about crashes or such.
|
||||||
|
|
||||||
|
* on Linux: `~/.config/bitburner/logs/main.log`
|
||||||
|
* on macOS: `~/Library/Logs/bitburner/main.log`
|
||||||
|
* on Windows: `%USERPROFILE%\AppData\Roaming\bitburner\logs\main.log`
|
||||||
|
|
||||||
|
### Config (using [electron-store](https://github.com/sindresorhus/electron-store#readme))
|
||||||
|
|
||||||
|
Configuration file will be written to disk in the application data directory.
|
||||||
|
|
||||||
|
* on Linux: `~/.config/bitburner/config.json`
|
||||||
|
* on macOS: `~/Library/Application\ Support/bitburner/config.json`
|
||||||
|
* on Windows: `%USERPROFILE%\AppData\Roaming\bitburner\config.json`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Steam: What is the API Server?
|
||||||
|
|
||||||
|
The API Server allows the official [Visual Studio Code Extension](https://github.com/bitburner-official/bitburner-vscode) to push script file from VSCode to your in-game home.
|
11
README.md
11
README.md
@ -1,16 +1,19 @@
|
|||||||
# Bitburner
|
# Bitburner
|
||||||
|
|
||||||
|
[![Build Status](https://github.com/danielyxie/bitburner/actions/workflows/ci.yml/badge.svg?branch=dev)](https://github.com/danielyxie/bitburner/actions/workflows/ci.yml)
|
||||||
|
|
||||||
Bitburner is a programming-based [incremental game](https://en.wikipedia.org/wiki/Incremental_game)
|
Bitburner is a programming-based [incremental game](https://en.wikipedia.org/wiki/Incremental_game)
|
||||||
that revolves around hacking and cyberpunk themes.
|
that revolves around hacking and cyberpunk themes.
|
||||||
The game can be played at https://danielyxie.github.io/bitburner.
|
The game can be played at https://danielyxie.github.io/bitburner or installed through [Steam](https://store.steampowered.com/app/1812820/Bitburner/).
|
||||||
|
|
||||||
|
See the [frequently asked questions](./FAQ.md) for more information . To discuss the game or get help, join the [official discord server](https://discord.gg/TFc3hKD)
|
||||||
|
|
||||||
# Documentation
|
# Documentation
|
||||||
|
|
||||||
The game's official documentation can be found on [Read The
|
The game's official documentation can be found on [Read The
|
||||||
Docs](http://bitburner.readthedocs.io/). Please note that this is still a
|
Docs](http://bitburner.readthedocs.io/). Please note that this is still a work-in-progress.
|
||||||
work-in-progress.
|
|
||||||
|
|
||||||
The documentation is created using [Sphinx](http://www.sphinx-doc.org).
|
The [in-game documentation](./markdown/bitburner.md) is generated from the [TypeScript definitions](./src/ScriptEditor/NetscriptDefinitions.d.ts).
|
||||||
|
|
||||||
Anyone is welcome to contribute to the documentation by editing the [source
|
Anyone is welcome to contribute to the documentation by editing the [source
|
||||||
files](/doc/source) and then making a pull request with your contributions.
|
files](/doc/source) and then making a pull request with your contributions.
|
||||||
|
@ -1,21 +0,0 @@
|
|||||||
## 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`
|
|
Loading…
Reference in New Issue
Block a user