Planet Launcher

An interactive launcher for MCPi-Reborn.

Try Planet now »

Report Bug | Request Feature | Website (Under Development)

Table Of Contents

• About the Project
• Built With
• Getting Started
• Roadmap
• Contributing
• License
• Acknowledgements

About The Project

The Minecraft Pi: Reborn mod is a great addition to the game. However, as fun as it can be, there is a big problem. The built-in launcher is too annoying. You have to type in every single field to just remember that you forgot to turn on a teeny little flag. Planet fixes that. Instead of making you type in every single field, Planet lets you write it one time, auto-save, and forget for the rest of your life. With Planet you can even edit the world names and it supports the newly-introduced Reborn AppImages. It is also maintained unlike the other launchers.

Built With

• The GUI is made using the PyQt5 Qt binding for Python, and additional widgets from qtwidgets.
• Big thanks to pypresence developers, for making such a good interface to Discord RPC.
• Thanks to pyqtdarktheme and darkdetect for awesome Qt theming tools.
• Pillow was used for skin manipulation
• The NBT editor is now served through editpi
• Texture packs are installed through mcpit

Installation

Prerequisites

• Minecraft Pi: Reborn AppImage or DEB install
• PyQt5
• Python 3
• pypresence
• qtdarktheme
• Pillow
• qtwidgets
• darkdetect
• EditPi
• mcpit

If you're installing a DEB, all of them with the exception of Minecraft: Pi Edition: Reborn will be automatically installed. Please install an AppImage for the latest build. If you want a DEB, please consider checking out MCPI++.

Installation

Option A (Raspberry Pi Only)

Option B (Raspberry Pi Only)

Install the planet-launcher package through APT.

Option C (Any Debian-Based)

Use our PPA

Option D (Manual Installation)

1. Download the DEB from the releases section.
2. Install the DEB using apt
3. Follow the on-screen instructions

Alternatives

gMCPIL vs jMCPIL vs pipan vs Planet

Feature	Planet	gMCPIL	jMCPIL	pipan	Built-in launcher
Profile & feature saving	Yes	Bullseye only	Yes	No	No
AppImage support	Yes	No	No	No	Yes
Legacy DEB support	Yes	Yes	Yes	Yes	Yes
Official MCPi-Revival	No	Yes	Yes	No	Yes
Tab icons	Yes	No	No	No	No
Maintained	Yes	No	No	No	Yes
Supported on Debian Buster	Yes, some bugs exist	No	Yes	Yes	Yes
Discord RPC	Yes	No	No	No	No
External server support	Yes	Yes	Yes	No	No
Flatpak support	Not tested	No	No	No	Yes
Pre-made profiles	Yes	Yes	Yes	Yes	No
Easy GUI navigation	Yes	Yes	Yes	No	Yes
Skin support	Yes	No	No	No	No
Built-in NBT editor	Yes	No	No	No	No
Texure pack support	Yes	No	No	No	No

Conclusion

• Use Planet if you want a maintained and a feature-rich launcher.
• Use gMCPIL if you are on Debian Bullseye, using a DEB install OR want a basic experience
• Use jMCPIL if you're using a DEB install on a distro other than Debian Bullseye
• Use the built-in launcher if you like to fill in things constantly
• Don't use pipan, it's a dirty prototype, not a working launcher

Roadmap

• AppImage support
• Skin support
• NBT editor
• Localization system
• Texture pack support
• Mods
• Chat logging
• MarketPi

Troubleshooting

Permission denied or No such file or directory

You have run Planet with sudo. NEVER RUN PLANET WITH SUDO. THIS MAKES YOU LOSE OWNERSHIP OF FOLDERS AND BREAKS PLANET.

Contributing

Creating A Pull Request

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Adding a translation

1. Register an account on Crowdin
2. Go to our project page
3. Start translating. If the desired langauge is not available, start a new thread.
4. Patiently wait until your translation is reviewed and added.

Please don't add fake translations, invalid or rude translations.

License

Planet is licensed under the GNU Affero General Public License

Acknowledgements

• cdtso - Creator and maintainer
• Red-exe-engineer - Active contributor
• Grimet14 - Active contributor
• g4o2 - Making the website look better
• Bigjango13 - Multiple fixes

Translations

• Spanish translation by BasedSkeleton
• Russian translation by cdtso
• Polish translation by karolxyz8

Additional Credits

• Heart, Planet, Pi, Steve and Portal icons by cdtso.
• Wrench by Santoniche on OpenGameArt.org.