# Slimefun 4
Slimefun is a plugin which aims to turn your Bukkit/Spigot Server into a modpack without ever installing a single mod. It offers everything you could possibly imagine. From Backpacks to Jetpacks! Slimefun lets every player decide on their own how much they want to dive into Magic or Tech.<br>
We got everything from magical wands to nuclear reactors.<br>
This project originally started back in 2013 and has grown ever since.<br>
It currently adds over **500 new items and recipes** to Minecraft.

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 were looking for.

## 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. Stable builds receive far less frequent updates!<br>
**We will NOT accept bug reports from "stable" versions, as they are basically just old development builds**

[> Download "stable" builds](https://thebusybiscuit.github.io/builds/TheBusyBiscuit/Slimefun4/stable/)<br>
[> Download 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 players, 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)

## Contributing to this project
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>

Slimefun 4 is licensed under 
[GNU GPLv3](https://github.com/TheBusyBiscuit/Slimefun4/blob/master/LICENSE)

## 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).<br>
Note that this project is not associated with Mojang AB.