P3D-Legacy

The game is not in active development by the original developer nilllzz anymore, but a few people from the community are still developing and maintaining the game, hence the name P3D-Legacy.

You are free to fork and redistribute the code under the GNU GPLv3 license.

Looking for documentation for the game? Check out the Wiki we have for the game!

Downloading the game

You will find the latest release here.

Instructions to play the game

• Go to the releases page (here) and download the game (you need the one that ends with "Release.zip") to a location where you can find it.
• After it has been downloaded, use an application like WinRAR or 7zip to extract the contents of the zip archive to a location of your preference.
• Navigate to the folder where you extracted the zip and double-click Pokemon3D.exe.
• Have fun playing Pokémon 3D!

If you want to play online on the official Pokémon 3D server, you need a GameJolt account and your game token (Click here if you don't know where to find your game token).

• Start the game, click on the GameJolt button in the Main Menu and enter your GameJolt username and your game token in the corresponding boxes.
• Click on the button that says "Log In" and when you're back in the Main Menu, select the new Savegame that appeared.
• If you want to play as a different character, check out the Skin Changer page on the Pokémon 3D homepage here.
• Log in with your GameJolt account

Instructions to build the game from source

The game is written in Visual Basic/VB.NET and was compiled targeting the .NET 7

It is built using the MonoGame framework as graphics middleware.

In order to build the game's solution, you need the following:

• Microsoft Windows operating system (7 and up)
• Microsoft Visual Studio Community Edition (2022 and up)
• Dotnet 7 SDK - Included in VS 2022

Make sure you've cloned the repository to a filepath without any spaces in it. It won't build otherwise. To run the game after a successful build, you also need an applicable graphics card that supports DirectX (version 9 minimum).

The first build of the game will take a little longer due to the MonoGame Content Pipeline building all assets for the first time.

To build the game, you can either use the publish tool in Visual Studio or Dotnet CLI.

Dotnet CLI (Windows x64): dotnet publish -c Release -r win-x64 -o bin/win-x64 --self-contained

This game only supports windows for now due to Windows Form usage. Trimming is disabled due to it as well.

Classified information

The game was configured to connect to several servers and internet APIs using private keys. To keep the private keys private, they have been redacted from the source code, along with a few URLs.

If you want to you can add your own private keys/URLs back into the game to enable certain online features. To find these places search for these comments in the source code: ' CLASSIFIED

Every line that has the "CLASSIFIED" comment at the end of it had some kind of string removed from it.

File Validation

To ensure that the game has the original files, for fair online gaming, the game validates the files. It basically stores a hash for each map, script and data-file in a file called "meta". This is stored in the game's root directory.

Hardcoded into the game's code is the hash for the meta file, to ensure that it did not get altered.

The code responsible for this is located in Security/FileValidation.vb.

The generation of meta file is done during compile time using source generators. The code will be generated when building the game.

Development

The game has a Solution Configuration that enables debug mode which makes map development or general fooling around easier.

Set the Solution Configuration at the top of the screen to Debug (not Release), then rebuild the game.

This is basically the Sandbox Mode that can be enabled in the game's save files plus these features:

• Display last build time in the F3 menu.
• Trade with yourself in the Game Jolt GTS.
• Bypass current version checks in the Game Jolt login screen.
• Update the game's current version on Game Jolt. Set UPDATEONLINEVERSION to True in Core/GameController.vb and rebuild the game.
• Move the 3rd person camera around freely with arrow keys. Hold CTRL and up/down to move the camera on the Y axis.
• Open the Pokégear even though the player has not received it yet and use its modules without receiving them.
• Legacy diagonal movement support.
• Reduce Kolben Splash Screen delay as much as possible.
• All HM moves are present in every Pokémon's menu.
• Ignore FileValidation warning.