Skip to content

Documentation

Philipp van Kempen edited this page Apr 5, 2021 · 7 revisions

⚠️ This is a draft!

Context

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.

Disclaimer

  • The code is neither written by me nor my property. I do NOT represent the same values as people who have worked on this code before. (Original Source: https://github.com/WorldStarHipHopX/playforia)
  • I am not responsible for any bug, problems, security flaws,...

About

Features

Original game

  • 3718 Maps in 8 Categories
  • Up to 4 players or Single Player mode
  • Graphics quality options
  • ...

Reimplementation

  • Commented out any communication with original Playforia.net servers
  • Use local Map store instead of database
  • Added ability to pass IP and Port of server to client
  • Ability to play on a single computer and hosting a game for up to 4 players in your home network
  • Removed bad words and custom tracks
  • Added ability to choose a nickname freely
  • TODO

Screenshots

Original Playforia Minigolf Main Menu

Documentation

Content

FAQ

See Wiki-Page: TODO

Dependencies

Supported Platforms

Running

Tested:

  • MacOS 10.14.5 Mojave with Java Version 1.8.0_152-ea with (Open)JDK
  • Ubuntu 19.04 with Java version 1.8.0_265
  • Windows (7/8/10)
  • TODO

Feel free to report further compatible OSes via an Issue or Pull Request!

Building

If you just want to run the latest stable version of the game without having to deal with compilers, check out the Releases.

Compiling from Source

Known Issues

The Maven plugin com.akathist.maven.plugins.launch4j.launch4j-maven-plugin is only available for x86 platforms. However building on ARM architectures (i. e. Raspberry Pi) is still possible if you manually remove the corresponding <plugin>...</plugin> section from the client/pom.xml.

Usage

Client

Server

How to Host a Minigolf-Server?

See Wiki-Page: TODO

Editior

Minigolf-Web

Contribution