This commit is contained in:
etjanster 2025-01-20 09:48:13 +01:00
parent a8362a2ac7
commit beab178fc7
4 changed files with 91 additions and 81 deletions

View file

@ -2,7 +2,9 @@
<img src="../../../wiki_images/logos/ikemen-go-logo.png" width="150"> <img src="../../../wiki_images/logos/ikemen-go-logo.png" width="150">
`IkemenGO` is a fighting game engine and the spiritual successor to the dead projects `Ikemen` and `M.U.G.E.N`. It strives to be compatible with games made for those engines. `IkemenGO` is a fighting game engine and the spiritual successor to the dead projects `Ikemen` and `M.U.G.E.N`.
It strives to be compatible with games made for those engines.
### IkemanGO Links: ### IkemanGO Links:
@ -15,29 +17,24 @@
## Where to put the games ## Where to put the games
`IkemenGO` `Ikemen` and `M.U.G.E.N` games should be put under the `retrodeck/roms/mugen/` directory. `IkemenGO` `Ikemen` and `M.U.G.E.N` games should be put under the `retrodeck/roms/mugen/` directory.
## What file formats are supported? ## What file formats are supported?
`.mugen` ```
.mugen
```
## Does IkemenGO require BIOS or Firmware? ## Does IkemenGO require BIOS or Firmware?
No No
## All M.U.G.E.N and IkemanGO games have their own input bindings ## Folder structure
As every game it's own unique instance and input bindings they need to be manually rebound per game so they fit how the game works and how you want to play. | Type | Folder | Comment |
These bindings are usually set in the interface or in the file `<gamename>/save/config.json`. | :---: | :---: | :---: |
| ROMs Folder |`retrodeck/roms/mugen/` | |
## Information
- The games need to be uncompressed to a folder.
- Games made for `IkemenGO` have a higher success rate than those made for `M.U.G.E.N`.
- Each game is its own self-contained game, and no overarching settings exist.
- Depending on the age of the game you want to play it could require less or more tinkering.
- `M.U.G.E.N` have existed since the 90s and some incredibly old games might not run at all without heavy tinkering.
- You will need to make the game executable.
### Example folder structure of a IkemanGO game ### Example folder structure of a IkemanGO game
@ -53,9 +50,27 @@ These bindings are usually set in the interface or in the file `<gamename>/save/
``` ```
Notice the runnable Ultimate Dank Fighter Mugen.mugen Notice the runnable Ultimate Dank Fighter Mugen.mugen
## IkemanGO Games
This How-to is for games that are made with IkemanGO ## About M.U.G.E.N and IkemanGO
Here are some tips:
- The games need to be uncompressed to a folder.
- Games made for `IkemenGO` have a higher success rate than those made for `M.U.G.E.N`.
- Each game is its own self-contained game, and no overarching settings exist.
- Depending on the age of the game you want to play it could require less or more tinkering.
- `M.U.G.E.N` have existed since the 90s and some incredibly old games might not run at all without heavy tinkering.
- You will need to make the game executable.
### The games have their own input bindings per game
As every game it's own unique instance and input bindings they need to be manually rebound per game so they fit how the game works and how you want to play.
These bindings are usually set in the interface or in the file `<gamename>/save/config.json`.
## How-to: Add IkemanGO Games
This How-to is for games that are made with IkemanGO Engine.
- Extract the game if it is compressed into a new folder under `roms/mugen/`. - Extract the game if it is compressed into a new folder under `roms/mugen/`.
- Rename the folder so it is called `<gamename>.mugen` in the end of it. - Rename the folder so it is called `<gamename>.mugen` in the end of it.
@ -67,6 +82,7 @@ This How-to is for games that are made with IkemanGO
The game should now be detected and runnable from RetroDECK. The game should now be detected and runnable from RetroDECK.
### Example on renaming: ### Example on renaming:
If the game is called Ultimate Dank Fighter IkemanGO rename the `Ikemen_GO_Linux` file & the games folder to `Ultimate Dank Fighter IkemanGO.mugen` If the game is called Ultimate Dank Fighter IkemanGO rename the `Ikemen_GO_Linux` file & the games folder to `Ultimate Dank Fighter IkemanGO.mugen`
``` ```
@ -82,6 +98,59 @@ If the `Ikemen_GO_Linux` is missing in the games folder you can download it from
Open up the `.zip` file and extract ONLY the `Ikemen_GO_Linux` file into the game directory and rename it as stated above. Open up the `.zip` file and extract ONLY the `Ikemen_GO_Linux` file into the game directory and rename it as stated above.
## M.U.G.E.N Games ## How-to: Convert M.U.G.E.N Games
This is not a full guide on conversion, as each game is different and can have been made for a different version of M.U.G.E.N or have other unique properties for just that game.
It would be impossible to write a total guide to encompass all games and you will have to check various forums/web pages for the best approach for just that game.
In this How-to example we are going to use a fake game called `Hockey Fighter MUGEN.zip`
### Step 1: Prepare the files and folders
- Download the `Ikemen_GO-<latestversion>-linux.zip` from [IkemanGO Github](https://github.com/ikemen-engine/Ikemen-GO).
- Extract the `Ikemen_GO-<latestversion>-linux.zip` file in some location.
- Have a `M.U.G.E.N` game ready like `Hockey Fighter MUGEN.zip`.
- Extract `Hockey Fighter MUGEN.zip` in some location.
- Create a new folder under `~/retrodeck/roms/mugen/` called `Hockey Fighter MUGEN.mugen`, the result should look like `~/retrodeck/roms/mugen/Hockey Fighter MUGEN.mugen`
### Step 2: Copy the M.U.G.E.N files
From the extracted `Hockey Fighter MUGEN.zip` location copy the following folders into `~/retrodeck/roms/mugen/Hockey Fighter MUGEN.mugen`
```
chars
data
font
sound
stages
```
If the folders from the above top-level folder have capital letters you will need to rename them to lowercase `Chars` to `chars` and EVERY FILE in the `data` folder needs to be lower case as including the file extension.
### Step 3: Copy the IkemanGO files
From the extracted `Ikemen_GO-<latestversion>-linux.zip` location copy the following folders into the game directory:
**HEADS UP:** <br>
DO NOT OVERWRITE WHEN COPYING OVER THE FILES! PRESS NO!
```
data
external
font
Ikemen_GO_Linux <-- file
```
### Step 4: Rename the Ikemen_GO_Linux file
If the game is called Hockey Fighter MUGEN rename the `Ikemen_GO_Linux` file to `Hockey Fighter MUGEN.mugen` so the result is:
```
~/retrodeck/roms/mugen/Hockey Fighter MUGEN.mugen/Hockey Fighter MUGEN.mugen
```
### Step 5: Run the game
The game should now at least show up in RetroDECK and if you are lucky also work when run. If the game does not work check out the forums or web page where you got the game for guidance.
Read the [M.U.G.E.N Convertion Guidelines](mugen-conversion.md)

View file

@ -1,56 +0,0 @@
# IkemenGO - M.U.G.E.N Convertion Guidelines
This is not a full guide on conversion, as each game is different and can have been made for a different version of M.U.G.E.N or have other unique properties for just that game.
It would be impossible to write a total guide to encompass all games and you will have to check various forums/web pages for the best approach for just that game.
## Step 1: Prepare the files and folders
In this example we are going to use a fake game called `Hockey Fighter MUGEN.zip`
- Download the `Ikemen_GO-<latestversion>-linux.zip` from [IkemanGO Github](https://github.com/ikemen-engine/Ikemen-GO).
- Extract the `Ikemen_GO-<latestversion>-linux.zip` file in some location.
- Have a `M.U.G.E.N` game ready like `Hockey Fighter MUGEN.zip`.
- Extract `Hockey Fighter MUGEN.zip` in some location.
- Create a new folder under `~/retrodeck/roms/mugen/` called `Hockey Fighter MUGEN.mugen`, the result should look like `~/retrodeck/roms/mugen/Hockey Fighter MUGEN.mugen`
## Step 2: Copy the M.U.G.E.N files
From the extracted `Hockey Fighter MUGEN.zip` location copy the following folders into `~/retrodeck/roms/mugen/Hockey Fighter MUGEN.mugen`
```
chars
data
font
sound
stages
```
If the folders from the above top-level folder have capital letters you will need to rename them to lowercase `Chars` to `chars` and EVERY FILE in the `data` folder needs to be lower case as including the file extension.
## Step 3: Copy the IkemanGO files
From the extracted `Ikemen_GO-<latestversion>-linux.zip` location copy the following folders into the game directory:
**HEADS UP:** <br>
DO NOT OVERWRITE WHEN COPYING OVER THE FILES! PRESS NO!
```
data
external
font
Ikemen_GO_Linux <-- file
```
## Step 4: Rename the Ikemen_GO_Linux file
If the game is called Hockey Fighter MUGEN rename the `Ikemen_GO_Linux` file to `Hockey Fighter MUGEN.mugen` so the result is:
```
~/retrodeck/roms/mugen/Hockey Fighter MUGEN.mugen/Hockey Fighter MUGEN.mugen
```
## Step 5: Run the game
The game should now at least show up in RetroDECK and if you are lucky also work when run. If the game does not work check out the forums or web page where you got the game for guidance.

View file

@ -141,14 +141,12 @@ We are still investigating the cause of it.
Fighting game engine that is compatible with M.U.G.E.N. Fighting game engine that is compatible with M.U.G.E.N.
Each game is it's own standalone instance, read more here: Each game is it's own standalone instance and we have collected some tips and guidelines on how to convert old M.U.G.E.N games to IkemanGO:
Read more here:
[IkemenGO Guide](../../wiki_engine_guides/ikemengo/ikemengo-guide.md) [IkemenGO Guide](../../wiki_engine_guides/ikemengo/ikemengo-guide.md)
We have collected some tips and guidelines on how to convert old M.U.G.E.N games to IkemanGO:
[IkemenGO: M.U.G.E.N Conversion Guidelines](../../wiki_engine_guides/ikemengo/mugen-conversion.md)
--- ---
## New Engine: Solarus ## New Engine: Solarus

View file

@ -139,7 +139,6 @@ nav:
- IkemenGO / M.U.G.E.N 🥋: - IkemenGO / M.U.G.E.N 🥋:
- IkemenGO - General Guide: wiki_engine_guides/ikemengo/ikemengo-guide.md - IkemenGO - General Guide: wiki_engine_guides/ikemengo/ikemengo-guide.md
- IkemenGO - M.U.G.E.N Convertion Guidelines: wiki_engine_guides/ikemengo/mugen-conversion.md
- Pico-8 8⃣: - Pico-8 8⃣:
- Pico-8 - General Guide: wiki_engine_guides/pico8/pico8-guide.md - Pico-8 - General Guide: wiki_engine_guides/pico8/pico8-guide.md