77 lines
4.1 KiB
Markdown
77 lines
4.1 KiB
Markdown
# popnhook
|
|
|
|
popnhook is a collection of hook libraries for pop'n music, providing ways to play the games on non BemaniPC, hardware and newer Windows versions.
|
|
|
|
## Supported version so far
|
|
|
|
15 ADVENTURE, 16 PARTY♪, 17 THE MOVIE, 18 せんごく列伝
|
|
|
|
We recommend using clean dumps to avoid any conflicts
|
|
with other cracks or binary patches.
|
|
|
|
## How to use Popnhook
|
|
|
|
You need to use an older version of popnhook (as of the time of writing, 4/17/25), as newer versions have broken compatiblity with older games.
|
|
|
|
[Verion 5.44 can be found here](https://github.com/djhackersdev/bemanitools/releases/download/5.44/bemanitools-5.44.zip).
|
|
|
|
Once downloaded, you have to open the game folder, and go into the `prog` folder. If there's multipe files here, you have to choose the one with the biggest number, which is typically the last one.
|
|
|
|
|
|
|
|
this happens when there's multiple versions of a game, you can use the hook for all versions, but you only really need to do the last one.
|
|
|
|
When you open the folder, you'll see a lot of different folders, you just need the `popn-15-to-28.zip` one. Simply extract the contents of the folder with the highest number, it'll look something like this
|
|
|
|
|
|
|
|
|
|
Now that you have everything in the right spot, you choose which `gamestart-XX.bat` file you need for your game. You can delete the ones that aren't your game. To set your controls, you open the `config.exe` program in the same folder we've been working in.
|
|
|
|
What if you don't want to open to the folder everytime you want to start the game? Simply right click the `gamestart-XX.bat`, hover over `Send to`, then select Desktop Shortcut. Now you can move the short cut anywhere you want, and when you open it, it'll boot up the game. Simple Stuff!
|
|
|
|
|
|
|
|
|
|
## Trouble Shooting
|
|
|
|
You may run into a few errors, here's the more common problems, what they mean and how to fix them. If you want a full list of error codes the game may throw out, [You can see so here](https://github.com/djhackersdev/bemanitools/blob/master/doc/game-error-codes.md)
|
|
|
|
## 5-1502
|
|
|
|
|
|
|
|
This means game's security was missing something, it'll typically fail at security. It means that you didn't install the older version of bemanitools/popnhooker, and are using the latest version. Please install the older version, which can be found here.
|
|
|
|
[Verion 5.44 can be found here](https://github.com/djhackersdev/bemanitools/releases/download/5.44/bemanitools-5.44.zip).
|
|
|
|
|
|
## 5-1501
|
|
|
|
The game is trying to connect online, but is failing. This requires a few extra steps to fix. Go to your Firewall settings, and click `Allow an app through firewall`
|
|
|
|
|
|
|
|
Click `Change settings`, then `Allow another app...` and find select the `popnXX.exe` This is in the same folder you extracted your popnhooker. Then set the connection setting to Publc.
|
|
|
|
After that, you can boot up the game just fine. You can do a few things to remove it from the firewall if you care to do it (and doesn't show the e amuse prompt on boot up).
|
|
|
|
Once in the game, press the service menu option (you can set it to w/e you want it to be, in the `config.exe` program.
|
|
|
|
Once in the service menu, go to `Network Settings`
|
|
|
|
|
|
|
|
then e-amusement settings, and on this screen, turn OFF e-amusement
|
|
|
|
|
|
|
|
Now, you can remove `popnXX.exe` from the firewall. Now you can boot up without any issue!
|
|
|
|
|
|
|
|
# Command line options
|
|
|
|
Add the argument *-h* when running inject with popnhook to print help/usage information with a list
|
|
of parameters you can apply to tweak various things.
|