Update readmes

This commit is contained in:
Bottersnike 2022-02-04 01:22:50 +00:00
parent 0597d90481
commit eb4ee71ed4
2 changed files with 28 additions and 26 deletions

View File

@ -1,40 +1,42 @@
# EAAPI
# e-Amusement Universe Repo
These scripts should be considered complementary to the documentation, not the
other way round. Experimental or unconfirmed this may be present here, however
the doc pages should for the most part only contain confirmed information.
This is a meta repository for different components of my e-Amusement
implementation. This has been done to facilitate partial-access to certain
parts of the codebase using gitea permissions.
If you came here looking for a complete e-Amusement implementation, you
probably want https://github.com/DragonMinded/bemaniutils instead.
Do **not** clone this repository recursively. It will probably fail. Instead,
`setup` should be run after cloning, which will initialise any submodules you
have access to, and will also setup the `eaapi` package (assuming it cloned).
# Requirements
Rather than rolling my own ARC4 and Triple-DES implementations (why does everyone seem to do that?)
I instead opted to just use `pycryptodome`. `lxml` is required for the parsing of string packets,
but is not a hard dependency.
This script assumes both `git` and `py` are on the path.
# Keys
In order to run this code, some encryption keys need loaded in. I have opted to not include them in
this repo because I didn't really feel like doing that. May or may not change that stance later.
I'm happy to provide individual access to the majority of these child
repositories on request.
For now, copy `eaapi/keys.template.py` to `eaapi/keys.py`, and fill in the blanks. If you're
following along with docs, you already have the values you need. Otherwise, I trust you can figure
out somewhere to find them. `CARDCONV_KEY` is only required if you plan to make use of `cardconv`.
The `.cmd` helper scripts in this repo are mostly for bulk management of the
submodules; here be dragons!
## `eaapi/`
The actual implementation of stuff.
## `docs`
The source and build system for https://bsnk.me/eamuse/
## `tests/`
An incredibly incomplete test suite. Run with `test` if you're on windows and lazy.
## `eaapi`
The main implementation of the e-Amusement transport layers.
## `server-dummy/`
Make sure to read the README here because otherwise nothing will start.
## `eaapi/eaapi/server`
A surprisingly capable werkzeug server for rapid development of e-Amusement
servers.
## `server-dummy`
A super barebones e-Amusement server that's able to start a surprising number of games.
Largely exists as a proof of concept, and as a testing ground for specific endpoints without having
the overhead of an entire EA server running.
## `server/`
## `server-full`
A less barebones server, used for experiementing with more complex behaviours. This probably won't
get pushed until it's had a significant tidy.
ever end up public, but now you know what it is I guess.
## `proxy/`
## `proxy`
An e-Amusement server designed to proxy requests to a different upstream server, while allowing the
observation of requests as they're made. As above, probably won't push this for a bit.
observation of requests as they're made.

2
eaapi

@ -1 +1 @@
Subproject commit af5dfb3f6c908a6e1efbdfa99adc80a24217cf96
Subproject commit 40a6ffbb0d0e01f4635b79a81a1d33ce7e752d54