Submitted on 01 Dec 2023 from Dev Build #232, Approved on 24 Dec 2023
The asynchronous PocketMine-MP plugin manager
Oh My PMMP provides commands to allow you to install plugins from Poggit. It's fast and easy to use.
Table of Contents
Getting Started
Prerequisites
- PHP binary for PocketMine-MP 8.1+
- PocketMine-MP v5.0.0 or higher.
Basic installation
- Download the latest version of the plugin from here.
- Put it in the plugins folder.
- Restart your server.
Using Oh My PMMP
Commands
Oh My PMMP provides omp command to allow you to install, upgrade, remove, etc. plugins from Poggit
omp help
Permission: oh-my-pmmp.help
List available commands.
omp version
Permission: oh-my-pmmp.version
Print plugin version.
omp install <plugin> <version>
Permission: oh-my-pmmp.install
Install a plugin with a specified version or use the word latest as a version to install the latest one.
omp remove <plugin>
Permission: oh-my-pmmp.remove
Remove a plugin.
omp update
Permission: oh-my-pmmp.update
Update cached data.
omp list
Permission: oh-my-pmmp.list
List available plugins or installed plugins.
- To list the installed plugins, you can add
i,-installedor--installedbehind the command,omp list --installed, for instance.
omp show <plugin> <version>
Permission: oh-my-pmmp.show
Get details about a plugin (name, version, api, depends, etc.).
omp upgrade <plugin> <version>
Permission: oh-my-pmmp.upgrade
Upgrade a plugin to a specified version or use the word latest as a version to upgrade to the latest one.
NOTE: To use all commands of Oh My PMMP, use oh-my-pmmp.cmds permission.
Advanced Topics
Developer Mode
Turn on this mode in config.yml by changing devMode to true
Some features will be unlocked after developer mode is enabled:
-
Download plugins as folder: Download the plugin and oh-my-pmmp will help you extract it by adding the word
trueafter the install command. For example:omp i ExamplePlugin latest true
How do I contribute to Oh My PMMP?
Before you participate in our community, please read the Code of Conduct.
See Contributing for more details.
License
Licensed under the GNU General Public License v3.0 license.
- Add an update checker.
- Remove amphp's libraries (amphp/file and amphp/http-client).
- Use async task for Poggit data fetching.
- Remove utopia-php/locale.
- Fixed some bugs
- Support PocketMine-MP v5
- Add list plugins command
- Add show command
- Add upgrade command
- Update Poggit repo URL
- Add developer mode
- Support for multiple languages.
- Show PHP and Oh My PMMP version when using version command.
- Support to run commands in game and add permissions for each command.
- Add a set up PHP version step
- Add dev option to install command
- Add icon
- Add icon path
- Bump promise lib version to 2.9.1
- Create phpstan.yml
- Delete composer update
- Delete unnecessary files
- Disable PHPStan
- Don't need fix CS script anymore
- Dynamic call to static method setInstance() and Fix PHPStan
- Merge pull request #1 from DavidGlitch04/main
- Dynamic call to static method setInstance() and Fix PHPStan
- Merge pull request #2 from DavidGlitch04/main
- promise virion
- Remove GitHub actions
- Remove validate step
- Set up PHPStan
- Update .poggit.yml
- Update AsyncTasks.php
- Update Main file path
- Update PHPDoc
- Update README.md
- Update composer script
- Update generate phar file script
- Update install command
- Update packages
- Use PSR-0
- Use \Phar::unlinkArchive instead of unlink
- promise virion
Reply to review by :
@NhanAZ 
@AIPTU 
@Lunarelly 
@Phuongaz 
@andrew47-c 
@kotyaralih 
@toby7002 
@tobydev27