Currently there are major code and toolchain changes in development. Meanwhile feel free to use the latest stable Release!
Playforia.net was an online game community created by Finnish game studio Playforia Inc. in 2002. As of the end of 2018, Playforia announced to close its web presence on January 7th, 2019. (Wikipedia: https://en.wikipedia.org/wiki/Playforia) The gaming platform was also formerly known as Aapeli or Playray.
The Java Applet-based Minigolf Client was one of the most popular multiplayer games on the platform. When I found a partially working codebase for parts of the Playforia related Java-Projects on GitHub (https://github.com/WorldStarHipHopX/playforia) I got it running on my computer by implementing a few small changes, which are explained below.
git clone git@github.com:PhilippvK/playforia-minigolf.git
maven
for building: https://maven.apache.org/install.htmlRun mvn install
in the root directory. This builds client
, server
and editor
submodules and all their respectable executables
First, the server application has to be started as it provides resources like sounds, maps and textures which are required for "offline" modes, too.
By default, the server uses tracks from the project's bundled resources, however if you want to run with a custom set of tracks, launch the server using the --tracks-dir
option!
Assuming that all 3 tools have compiled successfully (or downloaded them from the Releases Page), you have 3 possible ways for running the server binary:
mvn compile exec:java
in the ./server
, ./client
or ./editor
directoryjava -jar server.jar
and so on.The client can be started the same way (AFTER THE SERVER WAS STARTED) but you can also give launch options for server ip and game language in the following format
java -jar client.jar -server 192.168.1.7 -lang en_US # Replace IP with the one of your server (which you can find out by using for example `ifconfig`/`ipconfig`) and lang with en_US, fi_FI or sv_SE
NEW: You can now choose your nickname freely. Please avoid using hate speech,...
We provide an experimental Dockerfile for easy hosting of the server application. You can either build and run the image:
docker build -t pfmg .
docker run pfmg
or download the pre-built images from quay.io via docker pull quay.io/philippvk/minigolf:latest
.
Running the Editor is quite straightforward as it can be started like expected: java -jar editor.jar
Common CLI options for both the client and the server:
-ip
to set the hostname-p
to set the port-h
to learn about all the available optionsServer CLI options:
--tracks-dir
to use custom tracks instead of the default set of bundled tracksClient CLI options:
--verbose
to enable debug logging--norandom
to disable randomization for shots--username
to set username from CLI and skip inputting itTested:
21.0.3
allowCheating
in GameCanvas.java
for trying it out. Use it wisely.git status
on master
branch is clean and mvn install
runs finemvn versions:set -DnewVersion=2.1.1.0-BETA
git tag v2.1.1.0-BETA
git push origin master v2.1.1.0-BETA
Have fun.
If you miss the good old times before Playforia.net went down, Minigolf probably was one of your favourite games. I hope you will have some fun in the single player or with friends with this little crappy piece of oldschool software!