Plan/README.md

67 lines
4.0 KiB
Markdown
Raw Normal View History

![Player Analytics](http://puu.sh/AXSg7/5f2f78c06c.jpg)
2017-04-19 15:57:51 +02:00
2022-08-31 09:25:18 +02:00
[![Github Actions](https://github.com/plan-player-analytics/Plan/workflows/CI/badge.svg)](https://github.com/plan-player-analytics/Plan/actions/workflows/ci.yml)
2023-02-08 07:44:08 +01:00
[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=com.djrapitops%3APlan&metric=alert_status)](https://sonarcloud.io/dashboard?id=com.djrapitops%3APlan)  
![Java](https://custom-icon-badges.demolab.com/badge/⮞-red?logo=java-white)
2018-12-18 08:33:09 +01:00
[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=com.djrapitops%3APlan&metric=ncloc)](https://sonarcloud.io/dashboard?id=com.djrapitops%3APlan)
2023-02-08 07:44:08 +01:00
[![Code coverage](https://sonarcloud.io/api/project_badges/measure?project=com.djrapitops%3APlan&metric=coverage)](https://sonarcloud.io/dashboard?id=com.djrapitops%3APlan)  
![React](https://custom-icon-badges.demolab.com/badge/⮞-blue?logo=react-white)
2023-02-08 07:44:08 +01:00
[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=plan-player-analytics_Plan&metric=ncloc)](https://sonarcloud.io/summary/overall?id=plan-player-analytics_Plan)
2018-04-08 19:26:53 +02:00
2022-09-04 07:39:01 +02:00
[Documentation & Tutorials](https://github.com/plan-player-analytics/Plan/wiki) | [Releases](https://github.com/plan-player-analytics/Plan/releases) | [DEV builds](https://github.com/plan-player-analytics/Plan/actions/workflows/ci.yml?query=branch%3Amaster) | [Issues & Suggestions](https://github.com/plan-player-analytics/Plan/issues)
2019-10-22 09:26:12 +02:00
Player Analytics is a fully-fledged solution for the analytics needs of your Minecraft server. A built-in webserver displays insights into different aspects of the server such as Online activity, Playerbase, and how these change over time.
2017-12-06 09:25:46 +01:00
Plan supports multiple different platforms and versions; Spigot, Paper, Sponge, SpongeForge, Bungeecord, Velocity, Cauldron & all derivatives - One jar for all platforms.
2017-12-06 09:25:46 +01:00
2020-01-22 19:54:25 +01:00
- [Version 5 Release trailer on Youtube](https://www.youtube.com/watch?v=BS_Ti9zkoRc)
2022-09-04 07:39:01 +02:00
## API
- [Javadocs](https://plan-player-analytics.github.io/Plan/)
- [API documentation](https://github.com/plan-player-analytics/Plan/wiki/APIv5)
[![](https://jitpack.io/v/plan-player-analytics/Plan.svg)](https://jitpack.io/#plan-player-analytics/Plan)
```xml
<repository>
<id>jitpack</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>com.github.plan-player-analytics</groupId>
<artifactId>Plan</artifactId>
<version>{jitpack version}</version>
<scope>provided</scope>
</dependency>
```
2019-06-25 21:18:25 +02:00
## Building
You can build the project by running the following in the repository root:
2019-06-25 21:18:25 +02:00
```
cd Plan
2019-12-07 19:13:25 +01:00
./gradlew build
2019-06-25 21:18:25 +02:00
```
- [More information about setting up the project](https://github.com/plan-player-analytics/Plan/wiki/Project-Setup)
2017-12-06 09:25:46 +01:00
## Used Libraries
2019-10-20 14:09:41 +02:00
- **[SBAdmin 2 Template](https://github.com/BlackrockDigital/startbootstrap-sb-admin-2)** | [MIT License](https://opensource.org/licenses/MIT)
- **[Bootstrap](https://getbootstrap.com/)** | [MIT License](https://v4-alpha.getbootstrap.com/about/license/)
2019-10-20 14:09:41 +02:00
- **[HighCharts](https://www.highcharts.com/)** | [Free for non-commercial](https://www.highcharts.com/products/highcharts/#non-commercial)
- **[jQuery Datatables](https://datatables.net/)** | [MIT License](https://datatables.net/license/mit)
- **[FullCalendar](https://github.com/fullcalendar/fullcalendar)** | [MIT License](https://datatables.net/license/mit)
2017-12-06 09:25:46 +01:00
- **[Font Awesome Icons](http://fontawesome.io/icons/)** | [SIL Open Font License](http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL)
- **[MaxMind GeoIP2 Country](https://www.maxmind.com/en/geoip2-country-database)** | [MaxMind End User License Agreement (EULA)](https://www.maxmind.com/en/end-user-license-agreement)
2022-11-22 12:05:13 +01:00
- **[Dagger](https://dagger.dev/)** | [Apache-2.0 License](https://github.com/google/dagger/blob/master/LICENSE.txt)
2022-07-10 13:52:38 +02:00
- **[DependencyDownload](https://github.com/Vankka/DependencyDownload)** | [MIT License](https://github.com/Vankka/DependencyDownload/blob/main/LICENSE)
2019-10-05 10:46:18 +02:00
## License
Player Analytics is licensed under LGPL-3 (GNU Lesser General Public License)
- [License](https://github.com/plan-player-analytics/Plan/blob/master/LICENSE)