pollymc/README.md

173 lines
8.4 KiB
Markdown
Raw Normal View History

2017-08-27 16:26:21 +05:30
<p align="center">
<img src="./program_info/polymc-header-black.svg#gh-light-mode-only" alt="PolyMC logo"/>
<img src="./program_info/polymc-header.svg#gh-dark-mode-only" alt="PolyMC logo"/>
2017-08-27 16:26:21 +05:30
</p>
<br>
2022-01-16 07:55:49 +05:30
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.
2022-01-27 18:16:58 +05:30
<br>
# Installation
## 🐧 Linux
2022-01-27 18:16:58 +05:30
### <img src="https://www.vectorlogo.zone/logos/linuxfoundation/linuxfoundation-icon.svg" height="20" alt=""/> Cross-distro packages
2021-12-21 07:28:36 +05:30
<a href='https://flathub.org/apps/details/org.polymc.PolyMC'><img width='240' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.png'/></a>
2022-01-27 18:16:58 +05:30
<a href="https://packages.polymc.org/latest/appimage/PolyMC-latest-x86_64.AppImage"><img src="https://docs.appimage.org/_images/download-appimage-banner.svg" width="240" alt="Download as AppImage" /></a>
- [AppImage SHA256](https://packages.polymc.org/latest/appimage/PolyMC-latest-x86_64.AppImage.sha256)
2022-01-31 20:30:25 +05:30
2022-01-27 18:16:58 +05:30
### <img src="https://www.vectorlogo.zone/logos/archlinux/archlinux-icon.svg" height="20"/> Arch Linux
2022-01-31 20:30:25 +05:30
There are several AUR packages available:
2022-02-03 23:17:16 +05:30
2022-01-31 20:30:25 +05:30
[![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/)
2022-01-27 18:16:58 +05:30
```sh
# source package:
2022-01-27 18:16:58 +05:30
yay -S polymc
# binary package:
2022-01-27 18:16:58 +05:30
yay -S polymc-bin
```
2015-11-09 04:57:57 +05:30
### <img src="https://www.vectorlogo.zone/logos/debian/debian-icon.svg" height="20" /> Debian and <img src="https://www.vectorlogo.zone/logos/ubuntu/ubuntu-icon.svg" height="20" /> Ubuntu
2022-01-31 20:30:25 +05:30
We use [makedeb](https://docs.makedeb.org/) for our Debian packages.
2022-01-29 13:26:04 +05:30
Several MPR packages are available:
2022-01-31 20:30:25 +05:30
[![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)
2015-11-09 04:57:57 +05:30
2022-01-27 18:16:58 +05:30
```sh
# source package:
2022-01-29 13:26:04 +05:30
sudo tap install polymc
# binary package:
2022-01-29 13:26:04 +05:30
sudo tap install polymc-bin
2022-01-27 18:16:58 +05:30
```
2013-12-30 19:54:18 +05:30
2022-01-27 18:16:58 +05:30
### <img src="https://www.vectorlogo.zone/logos/nixos/nixos-icon.svg" height="20" /> Nix
A [Nix derivation](packages/nix/NIX.md) is available.
### <img src="https://www.gentoo.org/assets/img/logo/gentoo-signet.svg" height="20" /> Gentoo
2022-01-28 13:42:55 +05:30
A Gentoo ebuild is available in the [swirl](https://git.swurl.xyz/swirl/ebuilds) overlay, named `games-action/polymc`.
```sh
2022-01-29 13:26:04 +05:30
# as root:
2022-01-28 13:42:55 +05:30
emerge --oneshot eselect-repository
eselect repository enable swirl
2022-01-28 13:42:55 +05:30
emaint sync -r swirl
emerge polymc
# to use latest git version:
2022-01-29 13:26:04 +05:30
sudo tee -a /etc/portage/package.accept_keywords <<< "=games-action/polymc-9999 **"
2022-01-28 13:42:55 +05:30
```
2022-01-27 18:16:58 +05:30
### <img src="https://www.vectorlogo.zone/logos/getfedora/getfedora-icon.svg" height="20"> Fedora
2022-01-31 23:05:30 +05:30
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
```
2022-02-05 01:37:34 +05:30
### <img src="https://lotar.altervista.org/wiki/_media/news/slackware-logo.png" height="20" /> Slackware
2022-02-05 01:28:12 +05:30
[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
2022-02-17 17:23:44 +05:30
You can also download a community-maintained [prebuilt x86_64 package](http://glowiak.github.io/file/polymc-latest-slackware) and install it with /sbin/installpkg:
2022-02-05 01:28:12 +05:30
sudo /sbin/installpkg ~/Downloads/polymc-version-x86_64-1_SBo.tgz
2022-01-27 18:16:58 +05:30
## <img src="https://www.vectorlogo.zone/logos/microsoft/microsoft-icon.svg" height="20" /> 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.
## <img src="https://www.vectorlogo.zone/logos/apple/apple-tile.svg" height="20" /> MacOS
MacOS has experimental development builds available [here](https://github.com/PolyMC/PolyMC/actions)
2022-01-27 18:16:58 +05:30
## <img src="https://www.vectorlogo.zone/logos/freebsd/freebsd-icon.svg" height="20" /> FreeBSD
2022-02-04 22:42:32 +05:30
2022-02-17 17:23:44 +05:30
There are community-maintained binary packages available:
2022-02-04 22:42:32 +05:30
2022-02-05 01:28:12 +05:30
- [AppBSD Image](http://glowiak.github.io/file/polymc-latest-fbsd64-appbsd) - a portable application, requires [AppBSD](https://codeberg.org/glowiak/appbsd/) to be installed.
2022-02-04 22:42:32 +05:30
2022-02-05 18:34:34 +05:30
- [Gzipped binaries](http://glowiak.github.io/file/polymc-latest-fbsd64-raw) - traditional way to distribute, unpack and run.
2022-02-04 22:42:32 +05:30
In both cases you need X11, Qt5 and Java installed. Both files are 64bit only.
You can build from source - see [BUILD.md](./BUILD.md)
2022-02-04 22:42:32 +05:30
2022-02-05 20:33:16 +05:30
## <img src="https://raw.githubusercontent.com/AliasIO/wappalyzer/master/src/drivers/webextension/images/icons/OpenBSD%20httpd.svg" height="20" /> OpenBSD
2022-02-17 17:23:44 +05:30
There are community-maintained packages available:
- [gzipped 32-bit binaries](http://glowiak.github.io/file/polymc-latest-obsd32-raw), download, unpack and run.
2022-02-05 20:37:31 +05:30
You need X11, Qt5 and Java installed.
You can build from source - see [BUILD.md](./BUILD.md)
2022-02-05 20:33:16 +05:30
2022-02-16 23:01:34 +05:30
## 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.
Portable builds are provided for AppImage on Linux, Windows, and macOS.
For Debian and Arch, you can use these packages for the latest development versions:
[![polymc-git](https://img.shields.io/badge/aur-polymc--git-blue)](https://aur.archlinux.org/packages/polymc-git/)
[![polymc-git](https://img.shields.io/badge/mpr-polymc--git-orange)](https://mpr.makedeb.org/packages/polymc-git)
For flatpak, you can use [flathub-beta](https://discourse.flathub.org/t/how-to-use-flathub-beta/2111)
2022-02-16 23:01:34 +05:30
2022-01-27 18:16:58 +05:30
# 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)
2022-01-27 18:16:58 +05:30
# 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
2022-01-27 18:16:58 +05:30
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](https://hosted.weblate.org/projects/polymc/polymc/) and information about translating PolyMC is available at https://github.com/PolyMC/Translations
2022-01-27 18:16:58 +05:30
## 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.