https://github.com/hex-agon/alter-pangya
A PangYa GB.852 server emulator
https://github.com/hex-agon/alter-pangya
pangya
Last synced: about 2 months ago
JSON representation
A PangYa GB.852 server emulator
- Host: GitHub
- URL: https://github.com/hex-agon/alter-pangya
- Owner: hex-agon
- Created: 2020-06-06T18:19:45.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-12-27T19:44:44.000Z (5 months ago)
- Last Synced: 2025-04-14T20:15:37.786Z (about 2 months ago)
- Topics: pangya
- Language: Kotlin
- Homepage:
- Size: 740 KB
- Stars: 14
- Watchers: 1
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Alter-Pangya
A PangYa GB.852 server emulator
## Finding a client
This emulator only works with the PangYa GB.852 client, if you browse around the pangya communities you'll easily find a download.
In order to run the client it is highly recommended that you use [RugBurn](https://github.com/pangbox/rugburn).
## Working features
The server is still a work in progress and not all features are supported/working correctly, the following features work:
* Practice mode
* Equipping items in 'My Room'
If you're looking for a more feature complete server make sure to checkout acrisio's [SuperSS](https://github.com/Acrisio-Filho/SuperSS-Dev) project.
## Running the servers
Each server requires a configuration file to be present in the working directory, see the readme of each server for a configuration file template:
[Login Server Config](login-server/README.md)
[Game Server Config](game-server/README.md)
### Dependencies
Before running the login & game server you'll need the following extra services:
* A redis instance
* A postgres instance
## Development
### Setting up a Postgres database
You can run a local postgres database using the reference `Dockerfile` contained in the `database` directory, to quickly create an instance run:
```bash
docker image build -t alter_pangya database/
docker container run -d -p 5432:5432 --name alter_pangya alter_pangya
```
### Applying the migrations
Replace the relevant database parameters with your own values
```bash
mvn -Dflyway.url=jdbc:postgresql://localhost/alter_pangya -Dflyway.user=alter_pangya -Dflyway.password=alter_pangya -Dflyway.locations=filesystem:database/migrations org.flywaydb:flyway-maven-plugin:migrate --non-recursive
```
### Regenerating the JooQ classes (Schema changes)
While at the project root, run the following bash script to re-generate the jooq classes:
```bash
mvn -Djooq.codegen.jdbc.url=jdbc:postgresql://localhost/alter_pangya -Djooq.codegen.jdbc.user=alter_pangya -Djooq.codegen.jdbc.password=alter_pangya org.jooq:jooq-codegen-maven:generate --non-recursive
```
A big thanks to everyone at the [Caddie's Cauldron discord](https://discord.gg/HwDTssf)
#### References:
* [PangYa Tools](https://github.com/pangyatools)
* [Pangbox](https://github.com/pangbox/)
* [SuperSS](https://github.com/Acrisio-Filho/SuperSS-Dev)