✓ English | Korean(한국어)
Pikachu Volleyball (対戦ぴかちゅ~ ビーチバレー編) is an old Windows game which was developed by "(C) SACHI SOFT / SAWAYAKAN Programmers" and "(C) Satoshi Takenouchi" in 1997. The source code on this repository is gained by reverse engineering the core part of the machine code — including the physics engine and the AI — of the original game and implementing it into JavaScript.
You can play this game on the website: https://gorisanson.github.io/pikachu-volleyball/en/
- Clone this repoistory and get into the directory.
git clone https://github.com/gorisanson/pikachu-volleyball.git
cd pikachu-volleyball
- Install dependencies. (If errors occur, you can try with
node v16
andnpm v8
.)
npm install
- Bundle the code.
npm run build
- Run a local web server.
npx http-server dist
- Connect to the local web server on a web browser. (In most cases, the URL for connecting to the server would be
http://localhost:8080
. For the exact URL, it is supposed to be found on the printed messages on your terminal.)
-
Physics Engine: The physics engine, which calculates the position of the ball and the players (Pikachus), is contained in the file
src/resources/js/physics.js
. (This file also containes the AI which determines the keyboard input of the computer when you are playing against your computer.) This source code file is gained by reverse engineering the function at the address 00403dd0 of the machine code of the original game. -
Rendering: PixiJS library is used for rendering the game.
Refer comments on src/resources/js/main.js
for other details.
The main tools used for reverse engineering are following.
Ghidra is used for decompiling the machine code to C code. At first look, the decompiled C code looked incomprehensible. One of the reason was that the variable names (iVar1
, iVar2
, ...) and function names (FUN_00402dc0
, FUN_00403070
, ...) in the decompiled C code are meaningless. But, with the aid of Cheat Engine, I could find the location of some significant variables — x, y coordinate of the ball and the players. And reading from the location of the variables, the decompiled C code was comprehensible! OllyDbg was used for altering a specific part of the machine code. For example, to make slower version of the game so that it would be easier to count the number of frames of "Ready?" message on the start of new round in the game. Resource Hacker was used for extract the assets (sprites and sounds) of the game.
If there is no keyboard input, AI vs AI match is started after a while. In the original game, the match lasts only for about 40 seconds. But in this JavaScript version, there's no time limit to the AI vs AI match so you can watch it as long as you want.
- Pressing key "LeftShift" (for player1) or "RightShift" (for player2) can accelerate the speed-x of pikachu.
- Change FPS to 30FPS, 45FPS, 60FPS.