Game server backend and API for PokéRogue
 
 
Go to file
Flashfyre df92ff8b6f Add last activity update on verify 2024-05-15 13:37:36 -04:00
.github/workflows continue if linting fails 2024-05-14 13:23:22 +02:00
api Add last activity update on verify 2024-05-15 13:37:36 -04:00
db Add last activity update on verify 2024-05-15 13:37:36 -04:00
defs Add classic win count to starter data 2024-05-07 00:16:00 -04:00
.dockerignore add GitHub actions workflows and build docker image (#9) 2024-05-10 15:47:22 -04:00
.gitignore Add newclear endpoint 2024-05-10 18:07:14 -04:00
.golangci.yml move linter args to config file 2024-05-14 13:07:07 +02:00
Dockerfile add GitHub actions workflows and build docker image (#9) 2024-05-10 15:47:22 -04:00
LICENSE Relicense under AGPL 2024-04-29 17:26:46 -04:00
README.md Update README.md 2024-05-10 20:38:28 -07:00
docker-compose.Development.yml make server automatically create DB schema if not exists (#5) 2024-05-10 15:30:47 -04:00
docker-compose.Example.yml add watchtower in example compose file 2024-05-12 08:11:36 +02:00
go.mod Rename to rogueserver 2024-04-29 15:22:27 -04:00
go.sum Use better cron package 2024-04-16 21:01:24 -04:00
rogueserver.go run golangci-lint in CI 2024-05-11 14:41:25 +02:00

README.md

rogueserver

Hosting in Docker

It is advised that you host this in a docker container as it will be much easier to manage. There is a sample docker-compose file for setting up a docker container to setup this server.

Self Hosting outside of Docker:

Required Tools:

Installation:

The docker compose file should automatically implement a container with mariadb with an empty database and the default user and password combo of pokerogue:pokerogue

src/utils.ts:224-225 (in pokerogue)

Replace both URLs (one on each line) with the local API server address from rogueserver.go (0.0.0.0:8001) (or whatever port you picked)

If you are on Windows

Now that all of the files are configured: start up powershell as administrator:

cd C:\api\server\location\
go build .
.\rogueserver.exe --debug --dbuser yourusername --dbpass yourpassword 

The other available flags are located in rogueserver.go:34-43.

Then in another run this the first time then run npm run start from the rogueserver location from then on:

powershell -ep bypass
cd C:\server\location\
npm install
npm run start

You will need to allow the port youre running the API (8001) on and port 8000 to accept inbound connections through the Windows Advanced Firewall.

If you are on Linux

In whatever shell you prefer, run the following:

cd /api/server/location/
go build .
./rogueserver --debug --dbuser yourusername --dbpass yourpassword &

cd /server/location/
npm run start

If you have a firewall running such as ufw on your linux machine, make sure to allow inbound connections on the ports youre running the API and the pokerogue server (8000,8001). An example to allow incoming connections using UFW:

sudo ufw allow 8000,8001/tcp

This should allow you to reach the game from other computers on the same network.

Tying to a Domain

If you want to tie it to a domain like I did and make it publicly accessible, there is some extra work to be done.

I setup caddy and would recommend using it as a reverse proxy. caddy installation once its installed setup a config file for caddy:

pokerogue.exampledomain.com {
	reverse_proxy localhost:8000
}
pokeapi.exampledomain.com {
	reverse_proxy localhost:8001
} 

Preferably set up caddy as a service from here.

Once this is good to go, take your API url (https://pokeapi.exampledomain.com) and paste it on

src/utils.ts:224-225

in place of the previous 0.0.0.0:8001 address

Make sure that both 8000 and 8001 are portforwarded on your router.

Test that the server's game and game authentication works from other machines both in and outside of the network. Once this is complete, enjoy!