modmapper-web/README.md

50 lines
2.5 KiB
Markdown
Raw Normal View History

2022-03-15 04:13:27 +00:00
# modmapper-web
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
This is the frontend code for the modmapper project. Modmapper is an interactive map of Skyrim mods.
2022-01-14 04:24:18 +00:00
2022-04-29 03:03:08 +00:00
[View the site live at modmapper.com](https://modmapper.com).
2022-04-29 03:05:47 +00:00
![Screenshot of the website](/public/img/full-screenshot.jpg)
2022-04-29 03:03:08 +00:00
2022-03-15 04:13:27 +00:00
This project renders every cell edit from all Skyrim SE mods on nexusmods.com as a heatmap on top of a map of Skyrim.
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
You can click on a cell to see all of the mods that edit that cell sorted by popularity. Clicking on a mod in that list will show you all of the cells that the mod edits (across all files and versions of the mod). You can also search for a mod by name or a cell by x and y coordinates in the search bar at the top.
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
You can also upload the plugins from your Skyrim Data folder and the load order from your `plugins.txt` to view all of the edited cells in your current load order. Red cells indicate multiple mods editing the same cell. Clicking on a plugin in your load order will show the cells that the plugin edits and the mods and files it belongs to on nexusmods.com (if it can be found on there).
2022-01-14 04:24:18 +00:00
2022-03-18 22:54:21 +00:00
If you like the Modmapper project and found it useful, [please consider donating me a dollar or two on my NexusMods profile](https://www.nexusmods.com/users/512579) if you can spare it to cover the hosting costs of running the site.
2022-03-15 04:13:27 +00:00
## Related Repositories
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
- [modmapper](https://github.com/thallada/modmapper): program to automate downloading, extracting, and parsing plugins
- [skyrim-cell-dump](https://github.com/thallada/skyrim-cell-dump): library for parsing skyrim plugin files and extracting CELL data
- [skyrim-cell-dump-wasm](https://github.com/thallada/skyrim-cell-dump-wasm): exports skyrim-cell-dump's functions for WebAssembly
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
## Getting Started
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
First, install the dependencies:
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
```
npm install
```
2022-01-14 04:24:18 +00:00
Then create a file named `.env` at the root of the project with the contents:
```
NEXT_PUBLIC_MAPBOX_TOKEN=tokengoeshere
```
You can get a Mapbox token by [creating a mapbox account and generating a token on the access token page](https://docs.mapbox.com/help/glossary/access-token/).
Now, run the dev server:
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
```bash
npm run dev
```
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
Open [http://localhost:3000](http://localhost:3000) with your browser to see the site.
2022-01-14 04:24:18 +00:00
2022-03-15 04:13:27 +00:00
This site is deployed as a static website (with `next build && next export`), so be aware that [SSR and other Node.js features are not supported](https://nextjs.org/docs/advanced-features/static-html-export).