Skip to content

Latest commit

 

History

124 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PokeMMO Port for PortMaster

PokeMMO is a fan-made multiplayer online game that brings together multiple generations of Pokémon in a single MMO experience.

"Buy Me A Coffee"

If you'd like to see updates and active support for this port continue as quickly as possible, consider supporting the project — you can buy me a coffee ☕ to help keep things running!


🛠 Installation Instructions

CFW Tests:

480x320 640x480 720x720 Higher resolutions
Playable? No Yes Yes Yes
Create new character? No Yes (small, android) Yes Yes
All regions? No Yes Yes Yes
Global trade link No Yes (small, android) Yes (small, android) Yes
PC No Yes (small, android) Yes (small, android) Yes

⚠️ Unsupported Devices

Certain devices, such as the R36S and other handheld consoles based on the RK3326 chipset, are not compatible with the latest version of the PokeMMO Port. These devices lack the necessary processing power to deliver a smooth gameplay experience, especially in areas with high player density, where performance issues become critical.

🔒 These devices are not officially supported.

⚠️ Android Theme Mode Warning

The Android UI theme mode is highly resource-intensive and is not recommended for clone handhelds using the same chipset as the K36S, especially when running ArkOS.

These devices often lack the necessary resources to handle the Android-style UI, which can lead to black screens, crashes, or unresponsive behavior.

🔧 If you experience issues, use the "PokeMMO Restore" option available from the PokeMMO Port Launcher to reset the theme and restore default settings.
This will switch back to the classic theme optimized for low-spec devices.

- [x] AmberELEC
- [x] ArkOS
- [x] Rocknix
    -> [x] Panfrost
    -> [x] Libmali
- [x] MuOS
- [x] Knulli
- [x] spruceOS 4.0 or higher works automatically — below 4.0, manual SSH install needed.

PortMaster

Runtime

GamePad TO Key Board v2

How do I enter the security code in PokeMMO?

  • Press: Select + Y to enable virtual keyboard.
  • Press: Select to toggle number/text
  • Dpad Up/Down to select value, A to add, B to remove.
  • Start to disable virtual keyboard.

Experiencing FPS Drops?

The default configuration included with this port is optimized and tested for low-end devices, prioritizing compatibility and performance in power-saving mode.

If You're Experiencing Lag:

  • The most common reason for FPS drops is changing the default FPS or render settings. These defaults are intentionally conservative to ensure stable performance on less powerful hardware.
  • If you have a more capable device, feel free to adjust these settings — but keep in mind that doing so may cause instability or performance issues, especially if you're on low-spec hardware.

About main.properties:

  • This configuration file is tuned specifically for very low-resource devices.
  • Some areas may take longer to load, especially the more demanding ones, but this is expected and should not be frequent or break gameplay.

If performance issues persist even with the default settings, let us know — improvements and tweaks are always ongoing.

Assigning Panfrost in Rocknix

To configure Rocknix to use the Panfrost driver, first ensure your device supports it and that it’s not the only available option. For example, the Powkiddy RGB30 supports both libMali (GLES 3.2) and Panfrost (GL 3.1/GLES 3.1), as shown here.

To switch to the Panfrost driver: step 1 step 2

1. Install/Update the Port Video tutorial

Download pokemmo.zip Place the .zip into:
/PortMaster/autoinstall

Launch PortMaster. It will automatically install/update the port.

Autoinstall Folder Locations

Here are the paths for the autoinstall folder for each CFW supported by PortMaster:

System autoinstall Path
AmberELEC / ROCKNIX / uOS / Jelos /roms/ports/PortMaster/autoinstall/
muOS /mmc/MUOS/PortMaster/autoinstall/
ArkOS /roms/tools/PortMaster/autoinstall/
Knulli /userdata/system/.local/share/PortMaster/autoinstall/

Manual Installation (Alternative)

If the autoinstall folder method doesn't work, you can manually unzip the port contents into the appropriate ports folders.
Note: This may break the port and prevent it from launching properly.

System Ports Folder Location
AmberELEC / ROCKNIX / uOS / Jelos /roms/ports/
muOS Folders: /mmc/ports/
.sh files: /mnt/mmc/ROMS/Ports/
ArkOS /roms/tools/PortMaster/autoinstall/ (same as autoinstall)
Knulli /userdata/system/.local/share/PortMaster/autoinstall/ (same as autoinstall)

2. Add Official PokeMMO Client Files

Go to the official PokeMMO website:
https://pokemmo.com/en/downloads/portable

Download the portable version, extract it, and copy these into:
/roms/ports/pokemmo/

  • PokeMMO.exe
  • data/ folder

⚠️ Make sure not to replace the existing shaders folder and main.properties, as it contains optimized shaders. Replacing them may negatively impact performance on low-end devices.


3. Add Required and Optional ROMs

To add the ROMs, place them inside the pokemmo/roms folder and set the following values in main.properties:

client.roms.nds=roms/pokemon_black.nds  
client.roms.em=roms/pokemon_emerald.gba  
client.roms.fr=roms/pokemon_firered.gba  
client.roms.nds2=roms/pokemon_platinum.nds  
client.roms.nds3=roms/pokemon_heartgold.nds

Required ROM:

  • Pokémon Black or White (Version 1)

Optional ROMs (enable more regions):

  • Fire Red
  • Emerald
  • Platinum
  • HeartGold / SoulSilver

Login Without Keyboard Input

Option 1: Connect a Keyboard for First Login

Temporarily connect a physical keyboard (USB or Bluetooth), log in as usual, and make sure to check the "Remember Me" option.

Option 2: Type Password in Username Field (thanks ddrsoul)

Type your password in the username field, then copy and paste it into the password field. This allows you to use system copy/paste functions even without a keyboard.

The game will now automatically log in when launched on PortMaster-compatible devices.


Controls

Button Action
start menu focus
R1 mouse left
L1 mouse right
A A
B B
X Bag
Y Hotkey 1
L2 Hotkey 2
R2 Hotkey 3
L3 Hotkey 4
R3 Hotkey 5
select + B Hotkey 6
select + A Hotkey 7
select + X Hotkey 8
select + R1 Hotkey 9
select + R2 screenshot
select + L2 mode dpad mouse (on)
select + Y mode text (on)

📝 Hotkeys are assigned by right-clicking on any item or element in the game and selecting register

Virtual Keyboard

Button Action
start mode text (off)
A add character
B backspace
X space
Y toggle case
up prev character
down next character
select toggle number/letter

Third-Party Themes

The following community-created themes are compatible with the PokeMMO Port. These themes are developed and maintained by third parties and are not officially supported.

⚠️ Use third-party themes at your own risk. Compatibility and performance may vary depending on the device and game version.

Validated Mods

The following mods have been personally tested and validated for compatibility with PokeMMO Port. These mods meet my quality and stability standards.


Known Bug

Calibrate cursor

cursor

Thanks

Refs


About

PokeMMO Port for PortMaster

Resources

Stars

75 stars

Watchers

5 watching

Forks

Releases

Packages

Contributors

Languages