docs: add pokken to game specific info
This commit is contained in:
parent
f47175a144
commit
aa8e33a13e
@ -31,6 +31,7 @@ python dbutils.py migrate
|
|||||||
- [WACCA](#wacca)
|
- [WACCA](#wacca)
|
||||||
- [Sword Art Online Arcade](#sao)
|
- [Sword Art Online Arcade](#sao)
|
||||||
- [Initial D THE ARCADE](#initial-d-the-arcade)
|
- [Initial D THE ARCADE](#initial-d-the-arcade)
|
||||||
|
- [Pokken Tournament](#pokken)
|
||||||
|
|
||||||
|
|
||||||
# Supported Games
|
# Supported Games
|
||||||
@ -797,3 +798,82 @@ python dbutils.py upgrade
|
|||||||
|
|
||||||
A huge thanks to all people who helped shaping this project to what it is now and don't want to be mentioned here.
|
A huge thanks to all people who helped shaping this project to what it is now and don't want to be mentioned here.
|
||||||
|
|
||||||
|
## Pokken
|
||||||
|
|
||||||
|
### SDAK
|
||||||
|
|
||||||
|
| Version ID | Version Name |
|
||||||
|
| ---------- | ------------ |
|
||||||
|
| 0 | Pokken |
|
||||||
|
|
||||||
|
### Config
|
||||||
|
|
||||||
|
Config file is `pokken.yaml`
|
||||||
|
|
||||||
|
#### server
|
||||||
|
|
||||||
|
| Option | Info | Default |
|
||||||
|
| ------ | ---- | ------- |
|
||||||
|
| `hostname` | Hostname override for allnet to tell the game where to connect. Useful for local setups that need to use a different hostname for pokken's proxy. Otherwise, it should match `server`->`hostname` in `core.yaml`. | `localhost` |
|
||||||
|
| `enabled` | `True` if the pokken service should be enabled. `False` otherwise. | `True` |
|
||||||
|
| `loglevel` | String indicating how verbose pokken logs should be. Acceptable values are `debug`, `info`, `warn`, and `error`. | `info` |
|
||||||
|
| `auto_register` | For games that don't use aimedb, this controls weather connecting cards that aren't registered should automatically be registered when making a profile. Set to `False` to require cards be already registered before being usable with Pokken. | `True` |
|
||||||
|
| `enable_matching` | If `True`, allow non-local matching. This doesn't currently work because BIWA, the matching protocol the game uses, is not understood, so this should be set to `False`. | `False` |
|
||||||
|
| `stun_server_host` | Hostname of the STUN server the game will use for matching. | `stunserver.stunprotocol.org` (might not work anymore? recomend changing) |
|
||||||
|
| `stun_server_port` | Port for the external STUN server. Will probably be moved to the `ports` section in the future. | `3478` |
|
||||||
|
|
||||||
|
#### ports
|
||||||
|
| Option | Info | Default |
|
||||||
|
| ------ | ---- | ------- |
|
||||||
|
| `game` | Override for the title server port sent by allnet. Useful for local setups utalizing NGINX. | `9000` |
|
||||||
|
| `admission` | Port for the admission server used in global matching. May be obsolited later. | `9001` |
|
||||||
|
|
||||||
|
### Connecting to Artemis
|
||||||
|
|
||||||
|
Pokken is a bit tricky to get working due to it having a hard requirement of the connection being HTTPS. This is simplified somewhat by Pokken simply not validating the certificate in any way, shape or form (it can be self-signed, expired, for a different domain, etc.) but it does have to be there. The work-around is to spin up a local NGINX (or other proxy) instance and point traffic back to artemis. See below for a sample nginx config:
|
||||||
|
`nginx.conf`
|
||||||
|
```conf
|
||||||
|
# This example assumes your artemis instance is configured to listed on port 8080, and your certs exists at /path/to/cert and are called title.crt and title.key.
|
||||||
|
server {
|
||||||
|
listen 443 ssl;
|
||||||
|
server_name your.hostname.here;
|
||||||
|
|
||||||
|
ssl_certificate /path/to/cert/title.crt;
|
||||||
|
ssl_certificate_key /path/to/cert/title.key;
|
||||||
|
ssl_session_timeout 1d;
|
||||||
|
ssl_session_cache shared:MozSSL:10m;
|
||||||
|
ssl_session_tickets off;
|
||||||
|
|
||||||
|
ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
|
||||||
|
ssl_ciphers "ALL:@SECLEVEL=0";
|
||||||
|
ssl_prefer_server_ciphers off;
|
||||||
|
|
||||||
|
location / {
|
||||||
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||||
|
proxy_pass_request_headers on;
|
||||||
|
proxy_pass http://127.0.0.1:8080/;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
`pokken.yaml`
|
||||||
|
```yaml
|
||||||
|
server:
|
||||||
|
hostname: "your.hostname.here"
|
||||||
|
enable: True
|
||||||
|
loglevel: "info"
|
||||||
|
auto_register: True
|
||||||
|
enable_matching: False
|
||||||
|
stun_server_host: "stunserver.stunprotocol.org"
|
||||||
|
stun_server_port: 3478
|
||||||
|
|
||||||
|
ports:
|
||||||
|
game: 443
|
||||||
|
admission: 9001
|
||||||
|
```
|
||||||
|
|
||||||
|
### Info
|
||||||
|
|
||||||
|
The arcade release is missing a few fighters and supports compared to the switch version. It may be possible to mod these in in the future, but not much headway has been made on this as far as I know. Mercifully, the game uses the pokedex number (illustration_book_no) wherever possible when referingto both fighters and supports. Customization is entirely done on the webui. Artemis currently only supports changing your name, gender, and supporrt teams, but more is planned for the future.
|
||||||
|
|
||||||
|
### Credits
|
||||||
|
Special thanks to Pocky for pointing me in the right direction in terms of getting this game to function at all, and Lightning and other pokken cab owners for doing testing and reporting bugs/issues.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user