1
mirror of https://github.com/StarWishsama/Slimefun4.git synced 2024-09-20 03:35:51 +00:00
Slimefun4/README.md
Senne Van Rompaey 5cd1780dde
Update README.md
Add translation and common issues to highlighted articles.
2020-02-01 12:11:30 +01:00

94 lines
5.4 KiB
Markdown

# Slimefun 4
Slimefun is a plugin which aims to turn your Bukkit/Spigot Server into a modpack without installing a single mod. It offers everything you could possibly imagine. From Backpacks to Jetpacks!
It adds a whole new layer of survival to your server by adding more than 490+ new Items!
But it also comes with a lot of Addons too!<br>
Check out our [Addons](https://github.com/TheBusyBiscuit/Slimefun4/wiki/Addons), you may find exactly what you wanted there.
Slimefun 4 is licensed under
[GNU GPLv3](https://github.com/TheBusyBiscuit/Slimefun4/blob/master/LICENSE)
## Download Slimefun 4
Use the stable builds, if your Server is heavily reliant on Slimefun not breaking.
But please also consider using development builds. If plenty of people use the development builds, then we can quickly work together on solutions for issues that arise.
**We will NOT accept bug reports from "stable" versions, as they are basically just old development builds**
[Stable Builds](https://thebusybiscuit.github.io/builds/TheBusyBiscuit/Slimefun4/stable/)<br>
[Development Builds](https://thebusybiscuit.github.io/builds/TheBusyBiscuit/Slimefun4/master/)
<p align="center">
<a href="https://thebusybiscuit.github.io/builds/TheBusyBiscuit/Slimefun4/master/">
<img src="https://thebusybiscuit.github.io/builds/TheBusyBiscuit/Slimefun4/master/badge.svg" alt="Build Server"/>
</a>
</p>
## Discord
You can find Slimefun's community on Discord!<br>
Click the badge down below to join the server for suggestions/questions or other discussions about this plugin.<br>
Note that we do **not** accept bug reports on discord, please use our [Issue Tracker](https://github.com/TheBusyBiscuit/Slimefun4/issues) to submit bug reports!
<p align="center">
<a href="https://discord.gg/fsD4Bkh">
<img src="https://img.shields.io/discord/565557184348422174?color=7289DA&label=Discord&style=for-the-badge" alt="Discord Invite"/>
</a>
</p>
## Wiki
Slimefun has a (detailed and well-maintained - *cough*) Wiki for new Users, maybe also consider
expanding the wiki to help grow our community and help out new users of this plugin.
https://github.com/TheBusyBiscuit/Slimefun4/wiki
### Highlighted Articles
* [What is Slimefun?](https://github.com/TheBusyBiscuit/Slimefun4/wiki/Slimefun-in-a-nutshell)
* [How to install Slimefun](https://github.com/TheBusyBiscuit/Slimefun4/wiki/Installing-Slimefun)
* [Addons for Slimefun 4](https://github.com/TheBusyBiscuit/Slimefun4/wiki/Addons)
* [Getting Started](https://github.com/TheBusyBiscuit/Slimefun4/wiki/Getting-Started)
* [Help us expand the Wiki!](https://github.com/TheBusyBiscuit/Slimefun4/wiki/Expanding-the-Wiki)
* [Help us translate Slimefun!](https://github.com/TheBusyBiscuit/Slimefun4/wiki/Translating-Slimefun)
* [Common issues](https://github.com/TheBusyBiscuit/Slimefun4/wiki/Common-Issues)
## Contributions
You are allowed, even encouraged, to contribute to Slimefun 4 by making Pull Requests.
This is an open-source community project, so your contributions keep this plugin alive!
These Pull Requests can be fixes, changes or even additions, but please keep in mind that
if you add too much content to Slimefun 4, you should rather make an Addon for it instead.
<p align="center">
<a href="https://github.com/TheBusyBiscuit/Slimefun4/graphs/contributors">
<img alt="GitHub contributors" src="https://img.shields.io/github/contributors/TheBusyBiscuit/Slimefun4?style=for-the-badge">
</a>
</p>
## Data Collection
Slimefun4 uses various systems that collect or download data.<br>
We do not collect any personal information from you but here is a full list of what services may collect or download other kind of data.
### Auto-Updates
Slimefun4 uses an Auto-Updater which connects to https://thebusybiscuit.github.io/builds/ to check for and download updates.<br>
This behaviour is enabled by default but can be turned off under `/plugins/Slimefun/config.yml`<br>
We highly recommend you to keep this on at any time though, as you could be missing out on important patches.
### Metrics and Statistics
Slimefun4 uses [bStats](https://bstats.org/plugin/bukkit/Slimefun/4574) to collect anonymous information about the usage of this plugin.<br>
This is solely for statistical purposes, as we are interested in how Servers/Players use this plugin.<br>
All available data is anonymous and aggregated, at no point can we see individual server or player information.<br>
All of the collected data is publicly accessible: https://bstats.org/plugin/bukkit/Slimefun/4574
You can also disable this behaviour under `/plugins/bStats/config.yml`.<br>
For more info see [bStats' Privacy Policy](https://bstats.org/privacy-policy)
### GitHub Integration
Lastly, Slimefun4 connects to https://api.github.com/ to gather information about this open-source project.<br>
No information about your Minecraft Server is sent to GitHub.
This information includes (but is not limited to)
* list of contributors, their username and profile link (from the repositories `TheBusyBiscuit/Slimefun4`, `TheBusyBiscuit/Slimefun4-Wiki` and `TheBusyBiscuit/Slimefun4-Resourcepack`)
* amount of open issues in this repository
* amount of pending pull requests in this repository
* amount of stars in this repository
* amount of forks of this repository
* amount of code-bytes in this repository
* date of the last commit to this repository
Additionally the plugin connects to https://mojang.com/ to retrieve the Minecraft skins of our contributors (if possible).