sneedmc/README.md

173 lines
7.9 KiB
Markdown
Raw Normal View History

2017-08-27 10:56:21 +00:00
<p align="center">
2022-02-20 04:16:41 +00:00
<img src="./program_info/org.sneederix.SneedMC.svg" alt="SneedMC logo"/>
2017-08-27 10:56:21 +00:00
</p>
2022-01-16 02:25:49 +00:00
2022-02-20 04:16:41 +00:00
# SneedMC
2022-02-18 17:42:40 +00:00
SneedMC is a sneedful launcher for Minecraft that focuses on sneedictability, long term sneedility, and sneedicity.
2022-01-27 12:46:58 +00:00
<br>
# Installation
- All downloads and instructions for PolyMC can be found [here](https://polymc.org/download/)
- Last build status: https://github.com/PolyMC/PolyMC/actions
2022-01-27 12:46:58 +00:00
### <img src="https://www.vectorlogo.zone/logos/linuxfoundation/linuxfoundation-icon.svg" height="20" alt=""/> Cross-distro packages
2021-12-21 01:58:36 +00:00
<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 12:46:58 +00:00
<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 15:00:25 +00:00
2022-01-27 12:46:58 +00:00
### <img src="https://www.vectorlogo.zone/logos/archlinux/archlinux-icon.svg" height="20"/> Arch Linux
2022-01-31 15:00:25 +00:00
There are several AUR packages available:
2022-02-03 17:47:16 +00:00
2022-02-18 17:42:40 +00:00
[![sneedmc](https://img.shields.io/badge/aur-sneedmc-blue)](https://aur.archlinux.org/packages/sneedmc/)
[![sneedmc-bin](https://img.shields.io/badge/aur-sneedmc--bin-blue)](https://aur.archlinux.org/packages/sneedmc-bin/)
[![sneedmc-git](https://img.shields.io/badge/aur-sneedmc--git-blue)](https://aur.archlinux.org/packages/sneedmc-git/)
2022-01-27 12:46:58 +00:00
```sh
2022-01-29 07:56:04 +00:00
# stable source package:
2022-02-18 17:42:40 +00:00
yay -S sneedmc
2022-01-27 12:46:58 +00:00
# stable binary package:
2022-02-18 17:42:40 +00:00
yay -S sneedmc-bin
2022-01-27 12:46:58 +00:00
# latest git package:
2022-02-18 17:42:40 +00:00
yay -S sneedmc-git
2022-01-27 12:46:58 +00:00
```
2015-11-08 23:27:57 +00:00
2022-01-27 12:46:58 +00:00
### <img src="https://www.vectorlogo.zone/logos/debian/debian-icon.svg" height="20" /> Debian
2022-01-31 15:00:25 +00:00
We use [makedeb](https://docs.makedeb.org/) for our Debian packages.
2022-01-29 07:56:04 +00:00
Several MPR packages are available:
2022-02-18 17:42:40 +00:00
[![sneedmc](https://img.shields.io/badge/mpr-sneedmc-orange)](https://mpr.makedeb.org/packages/sneedmc)
[![sneedmc-bin](https://img.shields.io/badge/mpr-sneedmc--bin-orange)](https://mpr.makedeb.org/packages/sneedmc-bin)
[![sneedmc-git](https://img.shields.io/badge/mpr-sneedmc--git-orange)](https://mpr.makedeb.org/packages/sneedmc-git)
2015-11-08 23:27:57 +00:00
2022-01-27 12:46:58 +00:00
```sh
2022-01-29 07:56:04 +00:00
# stable source package:
2022-02-18 17:42:40 +00:00
sudo tap install sneedmc
2022-01-29 07:56:04 +00:00
# stable binary package:
2022-02-18 17:42:40 +00:00
sudo tap install sneedmc-bin
2022-01-29 08:40:27 +00:00
# latest git package:
2022-02-18 17:42:40 +00:00
sudo tap install sneedmc-git
2022-01-27 12:46:58 +00:00
```
2013-12-30 14:24:18 +00:00
2022-01-27 12:46:58 +00:00
### <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-02-18 17:42:40 +00:00
A Gentoo ebuild is available in the [sneed](https://git.swurl.xyz/Sneederix/overlay) overlay, named `games-action/sneedmc`.
2022-01-28 08:12:55 +00:00
```sh
2022-01-29 07:56:04 +00:00
# as root:
2022-01-28 08:12:55 +00:00
emerge --oneshot eselect-repository
2022-02-18 17:42:40 +00:00
eselect repository enable sneed
emaint sync -r sneed
emerge sneedmc
2022-01-28 08:12:55 +00:00
# to use latest git version:
2022-02-18 17:42:40 +00:00
sudo tee -a /etc/portage/package.accept_keywords <<< "=games-action/sneedmc-9999 **"
2022-01-28 08:12:55 +00:00
```
2022-01-27 12:46:58 +00:00
### <img src="https://www.vectorlogo.zone/logos/getfedora/getfedora-icon.svg" height="20"> Fedora
2022-01-31 17:35:30 +00:00
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-04 20:07:34 +00:00
### <img src="https://lotar.altervista.org/wiki/_media/news/slackware-logo.png" height="20" /> Slackware
2022-02-04 19:58:12 +00:00
[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
2022-01-27 12:46:58 +00:00
## <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
2022-01-29 17:10:46 +00:00
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.
2022-01-27 12:46:58 +00:00
## <img src="https://www.vectorlogo.zone/logos/freebsd/freebsd-icon.svg" height="20" /> FreeBSD
2022-02-04 17:12:32 +00:00
For FreeBSD available are:
2022-02-04 19:58:12 +00:00
- [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 17:12:32 +00:00
2022-02-05 13:04:34 +00:00
- [Gzipped binaries](http://glowiak.github.io/file/polymc-latest-fbsd64-raw) - traditional way to distribute, unpack and run.
2022-02-04 17:12:32 +00:00
2022-02-05 15:07:31 +00:00
In both cases you need X11, Qt5 and Java installed. Both files are 64bit only.
2022-02-04 17:12:32 +00:00
2022-02-05 15:03:16 +00:00
## <img src="https://raw.githubusercontent.com/AliasIO/wappalyzer/master/src/drivers/webextension/images/icons/OpenBSD%20httpd.svg" height="20" /> OpenBSD
2022-02-05 15:07:31 +00:00
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.
2022-02-05 15:03:16 +00:00
2022-02-16 17:31:34 +00:00
## 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 17:31:34 +00:00
2022-01-27 12:46:58 +00:00
# Help & Support
Feel free to create an issue if you need help. However, you might find it easier to ask in the Discord server.
2022-02-21 02:19:36 +00:00
[![SneedMC Discord](https://img.shields.io/discord/923671181020766230?label=SneedMC%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:
2022-02-21 02:19:36 +00:00
[![SneedMC Space](https://img.shields.io/matrix/polymc:polymc.org?label=SneedMC%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:
2022-04-03 10:37:50 +00:00
[![News](https://img.shields.io/matrix/polymc-news:matrix.org?label=PolyMC%20News)](https://matrix.to/#/#polymc-news:matrix.org)
[![Discussion](https://img.shields.io/matrix/polymc-discussion:matrix.org?label=PolyMC%20Discussion)](https://matrix.to/#/#polymc-discussion:matrix.org)
2022-04-03 10:37:50 +00:00
2022-06-04 19:08:35 +00:00
We also have a subreddit you can post your issues and suggestions on:
2022-04-03 10:37:50 +00:00
[r/PolyMCLauncher](https://www.reddit.com/r/PolyMCLauncher/)
2022-01-27 12:46:58 +00:00
# Development
2022-02-21 02:19:36 +00:00
If you want to contribute to SneedMC you might find it useful to join our Discord Server or Matrix Space.
2022-01-27 12:46:58 +00:00
## Building
2022-02-21 02:19:36 +00:00
If you want to build SneedMC yourself, check [BUILD.md](BUILD.md) for build instructions.
2022-01-27 12:46:58 +00:00
## Translations
2022-02-21 02:19:36 +00:00
The translation effort for SneedMC is hosted on [Weblate](https://hosted.weblate.org/projects/polymc/polymc/) and information about translating SneedMC is available at https://github.com/PolyMC/Translations
2022-01-27 12:46:58 +00:00
2022-03-13 13:25:17 +00:00
## Download information
To modify download information or change packaging information send a pull request or issue to the website [here](https://github.com/PolyMC/polymc.github.io/tree/master/src/download).
2022-03-01 00:33:59 +00:00
2022-01-27 12:46:58 +00:00
## Forking/Redistributing/Custom builds policy
2022-02-18 17:42:40 +00:00
SNEED
2022-06-06 19:00:10 +00:00
## Sponsors
Money is not sneedful