Update README.md

doc/popnhook/README.md

@@ -1,43 +1,74 @@
 # popnhook
 
-popnhook is a collection of hook libraries for pop'n music providing emulation and various patches
-to run these games on non BemaniPC hardware and newer Windows versions.
+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.
 
-The hook libraries must be bootstrapped either using [inject](../inject.md) or
-[launcher](../launcher.md) depending on the version you want to run. Further instructions are given
-in dedicated readme files for each popnhook version (see below).
+## Supported version so far
 
-# Versions
+15 ADVENTURE, 16 PARTY♪, 17 THE MOVIE, 18 せんごく列伝
 
-popnhook comes in a few different flavors. The game and its engine changed over the years. Some game
-versions might require patches/parameters enabled which others don't need or have different AVS
-versions. Here is the list of supported games:
+We recommend using clean dumps to avoid any conflicts
+with other cracks or binary patches.
 
-- [popnhook1](popnhook1.md): 15 ADVENTURE, 16 PARTY♪, 17 THE MOVIE, 18 せんごく列伝
+## How to use Popnhook
 
-When building bemanitools, independent packages are created for each set of games which are ready to
-be dropped on top of vanilla AC data dumps. We recommend using pristine dumps to avoid any conflicts
-with other hardcoded hacks or binary patches.
+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.
 
-# How to run
+[Verion 5.44 can be found here](https://github.com/djhackersdev/bemanitools/releases/download/5.44/bemanitools-5.44.zip).
 
-To run your game with popnhook, you have to use the inject tool to inject the DLL to the game
-process. `dist/popn` contains bat scripts with all the important parameters configured. Further
-parameters can be added but might not be required to run the game with default settings. Further
-information on how to setup the data for each specific version are elaborated in their dedicated
-readme files.
+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.
 
-# Eamuse network setup
+![image](https://github.com/user-attachments/assets/18b46242-a23d-4378-9d50-b283a8f2f94a) 
 
-Running pop'n music 15 through 18? Modify the appropriate popnhook-15.conf, popnhook-16.conf,
-popnhook-17.conf, or popnhook-18.conf.
+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
+
+![image](https://github.com/user-attachments/assets/9f6bf715-0965-4a44-93c3-187e6c0e1b41)
+
+
+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!
+
+![image](https://github.com/user-attachments/assets/417bd195-fe89-43c0-bfa2-df9eb1eb5593)
+
+
+## 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
+
+![429665247-74a06c2d-c335-408a-91b1-c7ca6356d3f4](https://github.com/user-attachments/assets/b1f2f099-4068-4f17-8a38-af615effc10d)
+
+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`
+
+![Captusre](https://github.com/user-attachments/assets/298f24ec-72e0-4e73-8c1a-6eac9a6a41d5)
+
+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`
+
+![430747057-3fe6be09-d74e-4c67-b011-17fb3876e811](https://github.com/user-attachments/assets/5cd396e9-d789-45fb-ab4e-2f034635ca57)
+
+then e-amusement settings, and on this screen, turn OFF e-amusement
+
+![430747092-4c85e4fa-a473-4aac-9ef5-7d9d214dbdd8](https://github.com/user-attachments/assets/73d96664-3564-4909-860b-418da90dded8)
+
+Now, you can remove `popnXX.exe` from the firewall. Now you can boot up without any issue!
 
-Running anything newer?
 
-- Open the `prop/ea3-config.xml`
-- Replace the `ea3/network/services` URL with network service URL of your choice (for example
-  http://my.eamuse.com)
-- Edit the `ea3/id/pcbid`
 
 # Command line options