PretendoNetwork / pokemon-gen6

Game servers for the Pokémon Generation 6 (X/Y/OR/AS) games
GNU Affero General Public License v3.0
12 stars 3 forks source link

Pokemon X/Y/OR/AS (Generation 6) (3DS) replacement server

Includes both the authentication and secure servers

Compiling

Setup

Install Go and git, then clone and enter the repository

$ git clone https://github.com/PretendoNetwork/pokemon-gen6
$ cd pokemon-gen6

Compiling using go

To compile using Go, go get the required modules and then go build to your desired location. You may also want to tidy the go modules, though this is optional

$ go get -u
$ go mod tidy
$ go build -o build/pokegen6

The server is now built to build/pokegen6

When compiling with only Go, the authentication servers build string is not automatically set. This should not cause any issues with gameplay, but it means that the server build will not be visible in any packet dumps or logs a title may produce

To compile the servers with the authentication server build string, add -ldflags "-X 'main.serverBuildString=BUILD_STRING_HERE'" to the build command, or use make to compile the server

Compiling using make

Compiling using make will read the local .git directory to create a dynamic authentication server build string, based on your repositories remote origin and current commit. It will also use the current folders name as the executables name

Install make onto your system (this varies by OS), and run make while inside the repository

$ make

The server is now built to build/pokemon-gen6 with the authentication server build string already set

Configuration

All configuration options are handled via environment variables

.env files are supported

Name Description Required
PN_POKEGEN6_POSTGRES_URI Fully qualified URI to your Postgres server (Example postgres://username:password@localhost/pokegen6?sslmode=disable) Yes
PN_POKEGEN6_KERBEROS_PASSWORD Password used as part of the internal server data in Kerberos tickets No (Default password password will be used)
PN_POKEGEN6_AUTHENTICATION_SERVER_PORT Port for the authentication server Yes
PN_POKEGEN6_SECURE_SERVER_HOST Host name for the secure server (should point to the same address as the authentication server) Yes
PN_POKEGEN6_SECURE_SERVER_PORT Port for the secure server Yes
PN_POKEGEN6_ACCOUNT_GRPC_HOST Host name for your account server gRPC service Yes
PN_POKEGEN6_ACCOUNT_GRPC_PORT Port for your account server gRPC service Yes
PN_POKEGEN6_ACCOUNT_GRPC_API_KEY API key for your account server gRPC service No (Assumed to be an open gRPC API)