2020-03-14 12:58:33 +01:00
|
|
|
# Random _Fallout 76_ records
|
|
|
|
|
Allows a user to retrieve a random record from the _Fallout 76_ game files.
|
|
|
|
|
The user can filter records by data type to avoid receiving uninteresting data types.
|
|
|
|
|
|
2020-03-17 19:09:53 +01:00
|
|
|
The back end, `api.php`, communicates with an SQLite database, `.fo76-dumps-ids.db`, containing only the `IDS.csv` dump
|
2020-03-14 12:58:33 +01:00
|
|
|
from [the _Fallout 76_ data dumps repository](https://github.com/FWDekker/fo76-dumps/).
|
|
|
|
|
The database is not included in this repository.
|
|
|
|
|
|
|
|
|
|
The front end, `index.html`, sends asynchronous queries to the back end based on the user's settings.
|
|
|
|
|
Selected data types are stored in a cookie so the user doesn't have to redo their settings each time the page is
|
|
|
|
|
refreshed.
|
2020-06-07 13:20:34 +02:00
|
|
|
|
|
|
|
|
## Development
|
|
|
|
|
### Requirements
|
|
|
|
|
* [npm](https://www.npmjs.com/)
|
|
|
|
|
* a local PHP server
|
|
|
|
|
* a local copy of `.fo76-dumps-ids.db`
|
|
|
|
|
|
|
|
|
|
### Setting up
|
|
|
|
|
```shell script
|
|
|
|
|
# Install dependencies (only needed once)
|
|
|
|
|
$> npm ci
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Building
|
|
|
|
|
```shell script
|
|
|
|
|
# Build the tool in `dist/` for development
|
|
|
|
|
$> npm run dev
|
|
|
|
|
# Same as above, but automatically rerun it whenever files are changed
|
|
|
|
|
$> npm run dev:server
|
|
|
|
|
# Build the tool in `dist/` for deployment
|
|
|
|
|
$> npm run deploy
|
|
|
|
|
```
|
