pollymc/README.md
2022-02-16 18:36:28 +01:00

8.6 KiB

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.

Installation

🐧 Linux

Cross-distro packages

Download on Flathub

Download as AppImage

Arch Linux

There are several AUR packages available:

polymc polymc-bin polymc-git

# stable source package:
yay -S polymc
# stable binary package:
yay -S polymc-bin
# latest git package:
yay -S polymc-git

Debian

We use makedeb for our Debian packages. Several MPR packages are available:

polymc polymc-bin polymc-git

# 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 is available.

Gentoo

A Gentoo ebuild is available in the swirl overlay, named games-action/polymc.

# 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.

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.

sudo dnf copr enable sentry/polymc
sudo dnf install polymc

Slackware

A SlackBuild is available. You will need qt5 (on 15.0 installed by default), a JDK, 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 and install it with /sbin/installpkg:

sudo /sbin/installpkg ~/Downloads/polymc-version-x86_64-1_SBo.tgz

Windows

Windows (32-bit) (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 it for yourself.

FreeBSD

For FreeBSD available are:

In both cases you need X11, Qt5 and Java installed. Both files are 64bit only.

OpenBSD

For OpenBSD available are gzipped 32-bit binaries, download, unpack and run.

You need X11, Qt5 and Java installed.

Development Builds

There are per-commit development builds available here. 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

For people who don't want to use Discord, we have a Matrix Space which is bridged to the Discord server:

PolyMC Space

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 Discussion Development News

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 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

The translation effort for PolyMC is hosted on Weblate and information about translating PolyMC is available at https://github.com/PolyMC/Translations

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.