PolyMC logo PolyMC logo


PolyMC is a custom launcher for Minecraft that focuses on predictability, long term stability and simplicity. This is a **fork** of the MultiMC Launcher and not endorsed by MultiMC. The PolyMC community felt that the maintainer was not acting in the spirit of Free Software so this fork was made. Read "[Why was this fork made?](https://github.com/PolyMC/PolyMC/wiki/FAQ)" on the wiki for more details.
# Installation - All packages (archived by version) can be found [here](https://packages.polymc.org/) ([latest](https://packages.polymc.org/latest)). - Last build status: https://jenkins.polymc.org/job/PolyMC/lastBuild/ ## 🐧 Linux ### Cross-distro packages Download on Flathub Download as AppImage - [AppImage SHA256](https://packages.polymc.org/latest/appimage/PolyMC-latest-x86_64.AppImage.sha256) ### Arch Linux There are several AUR packages available: [![polymc](https://img.shields.io/badge/aur-polymc-blue)](https://aur.archlinux.org/packages/polymc/) [![polymc-bin](https://img.shields.io/badge/aur-polymc--bin-blue)](https://aur.archlinux.org/packages/polymc-bin/) [![polymc-git](https://img.shields.io/badge/aur-polymc--git-blue)](https://aur.archlinux.org/packages/polymc-git/) ```sh # stable source package: yay -S polymc # stable binary package: yay -S polymc-bin # latest git package: yay -S polymc-git ``` ### Debian We use [makedeb](https://docs.makedeb.org/) for our Debian packages. Several MPR packages are available: [![polymc](https://img.shields.io/badge/mpr-polymc-orange)](https://mpr.makedeb.org/packages/polymc) [![polymc-bin](https://img.shields.io/badge/mpr-polymc--bin-orange)](https://mpr.makedeb.org/packages/polymc-bin) [![polymc-git](https://img.shields.io/badge/mpr-polymc--git-orange)](https://mpr.makedeb.org/packages/polymc-git) ```sh # stable source package: sudo tap install polymc # stable binary package: sudo tap install polymc-bin # latest git package: sudo tap install polymc-git ``` ### Nix A [Nix derivation](packages/nix/NIX.md) is available. ### Gentoo A Gentoo ebuild is available in the [swirl](https://git.swurl.xyz/swirl/ebuilds) overlay, named `games-action/polymc`. ```sh # as root: emerge --oneshot eselect-repository eselect repository enable swirl emaint sync -r swirl emerge polymc # to use latest git version: sudo tee -a /etc/portage/package.accept_keywords <<< "=games-action/polymc-9999 **" ``` ### Fedora An RPM package is available on [COPR](https://copr.fedorainfracloud.org/coprs/polymc/polymc/). ```sh sudo dnf copr enable polymc/polymc sudo dnf install polymc ``` Alternatively, a COPR maintained by a PolyMC user (instead of Jenkins' automated builds) is available [here](https://copr.fedorainfracloud.org/coprs/sentry/polymc). ```sh sudo dnf copr enable sentry/polymc sudo dnf install polymc ``` ### Slackware [A SlackBuild](https://codeberg.org/glowiak/SlackBuilds/src/branch/master/repository/polymc.md) is available. You will need [qt5](http://slackbuilds.org/repository/14.2/libraries/qt5/) (on 15.0 installed by default), [a JDK](https://codeberg.org/glowiak/SlackBuilds/src/branch/master/repository/adoptium-jdk8.md), and if you're on 14.2, you need to compile newer CMake version manually. To build, type in extracted directory with all dependiences met: sudo ./polymc.SlackBuild sudo installpkg /tmp/polymc-version-arch-1_SBo.tgz If you are too lazy to do all these steps, you can just download [a prebuild x86_64 package](http://glowiak.github.io/file/polymc-latest-slackware) and install it with /sbin/installpkg: sudo /sbin/installpkg ~/Downloads/polymc-version-x86_64-1_SBo.tgz ## Windows [Windows (32-bit)](https://packages.polymc.org/latest/win32/win32.zip) ([SHA256](https://packages.polymc.org/latest/win32/win32.zip.sha256)) - this is a portable package, you can extract it anywhere and run it. This package needs testing. ## MacOS MacOS currently does not have any packages. We are still working on setting up MacOS packaging. Meanwhile, you can [build](https://github.com/PolyMC/PolyMC/blob/develop/BUILD.md#macos) it for yourself. ## FreeBSD For FreeBSD available are: - [AppBSD Image](http://glowiak.github.io/file/polymc-latest-fbsd64-appbsd) - a portable application, requires [AppBSD](https://codeberg.org/glowiak/appbsd/) to be installed. - [Gzipped binaries](http://glowiak.github.io/file/polymc-latest-fbsd64-raw) - traditional way to distribute, unpack and run. In both cases you need X11, Qt5 and Java installed. Both files are 64bit only. ## OpenBSD For OpenBSD available are [gzipped 32-bit binaries](http://glowiak.github.io/file/polymc-latest-obsd32-raw), download, unpack and run. You need X11, Qt5 and Java installed. ## Development Builds There are per-commit development builds available [here](https://github.com/PolyMC/PolyMC/actions). These have debug information in the binaries, so their file sizes are relatively larger. Builds are provided for Linux, AppImage on Linux, Windows, and macOS. # Help & Support Feel free to create an issue if you need help. However, you might find it easier to ask in the Discord server. [![PolyMC Discord](https://img.shields.io/discord/923671181020766230?label=PolyMC%20Discord)](https://discord.gg/xq7fxrgtMP) For people who don't want to use Discord, we have a Matrix Space which is bridged to the Discord server: [![PolyMC Space](https://img.shields.io/matrix/polymc:polymc.org?label=PolyMC%20Space&server_fqdn=matrix.polymc.org)](https://matrix.to/#/#polymc:polymc.org) If there are any issues with the space or you are using a client that does not support the feature here are the individual rooms: [![Support](https://img.shields.io/matrix/support:polymc.org?label=%23support&server_fqdn=matrix.polymc.org)](https://matrix.to/#/#support:polymc.org) [![Discussion](https://img.shields.io/matrix/discussion:polymc.org?label=%23discussion&server_fqdn=matrix.polymc.org)](https://matrix.to/#/#discussion:polymc.org) [![Development](https://img.shields.io/matrix/development:polymc.org?label=%23development&server_fqdn=matrix.polymc.org)](https://matrix.to/#/#development:polymc.org) [![News](https://img.shields.io/matrix/news:polymc.org?label=%23news&server_fqdn=matrix.polymc.org)](https://matrix.to/#/#news:polymc.org) # Development If you want to contribute to PolyMC you might find it useful to join our Discord Server or Matrix Space. ## Building If you want to build PolyMC yourself, check [BUILD.md](BUILD.md) for build instructions. ## Code formatting Just follow the existing formatting. In general, in order of importance: - Make sure your IDE is not messing up line endings or whitespace and avoid using linters. - Prefer readability over dogma. - Keep to the existing formatting. - Indent with 4 space unless it's in a submodule. - Keep lists (of arguments, parameters, initializers...) as lists, not paragraphs. It should either read from top to bottom, or left to right. Not both. ## Translations TODO ## Forking/Redistributing/Custom builds policy Do whatever you want, we don't care. Just follow the license. If you have any questions about this feel free to ask in an issue.