Fill readme with instructions

This commit is contained in:
Matthew Stratford 2020-10-29 19:59:08 +00:00
parent 3c20139597
commit 2623c75627
No known key found for this signature in database
GPG key ID: 5F50E4308A3416E8
2 changed files with 47 additions and 1 deletions

View file

@ -1 +1,47 @@
bapsicle
# Bapsicle
### AKA The Next Gen BAPS server
!["BAPSicle logo, a pink melting ice lolly."](/dev/logo.png "BAPSicle Logo")
Welcome! This is BAPS. More acurately, this is yet another attempt at a BAPS3 server.
## Installing
Just want to install BAPSicle?
### Windows
Currently there's just a batch script. Simply run ``install.bat`` as administrator. If you've just built BAPSicle youself, it'll be in ``/install`` folder.
This will:
* Copy BAPSicle into ``C:\Program Files\BAPSicle``
* Install BAPSicle.exe as a Windows Service with NSSM.
* If all goes well, open [http://localhost:5000](localhost:5000) for the server UI.
### Linux
Installed service for linux is comming soon. Testing is primarily on Ubuntu 20.04. Your milage with other distros will vary.
### MacOS
Support for MacOS will be the last to come, sorry about that.
## Developing
### Requirements
* Python 3.7 (3.8 may also work, 3.9 is unlikely to.)
* Git (Obviously)
### Running
To just run the server standaline without installing, run ``python ./launch_standalone.py``.
### Building
Currently mostly Windows focused.
To build a BAPSicle.exe, run ``build\build-exe.py``. The resulting file will appear in ``build\output``. You can then use the install instructions above to install it, or just run it standalone.
### Other bits
Provided is a VScode debug config to let you debug live, as well as ``dev\install-githook.bat`` that will help git to clean your code up as you're committing!

BIN
dev/logo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB