[![Contributors][contributors-shield]][contributors-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![MIT License][license-shield]][license-url] [![LinkedIn][linkedin-shield]][linkedin-url] [![Discord][discord-shield]][discord-url] [![Modrinth][modrinth-shield]][modrinth-url]

fStats

Fabric metric system for developers
Support · Report Bug · Request Feature

Table of Contents

About The Project
Usage
- For users
- For developers
Roadmap
Contributing
License

## About The Project ![Project Page Preview](https://cdn.modrinth.com/data/DkOr2M32/images/95a352019440c7011ef8183fe6307a587c28dc62.png) fStats is a 3rd-party metric collection library. The Main idea is help developers to recognize their actual community based on charts

(back to top)

## Usage ### For user The mod has a config that allows to turn off a metric collection from the server and hiding location > ../config/fstats-api/config.json ```json5 { "enabled": true, // Enable/Disable collection from our server "hideLocation": false // Mod does not collect your IP, only the country name } ``` ### For developers The first thing that you need to do is [register](https://fstats.dev/register) and create a project to get projectId After that, you are ready to add a library as/to dependency

Java - build.gradle

```groovy repositories { maven { url "https://api.modrinth.com/maven" } } dependencies { // Option 1: Include fStats API to project for it to be available within your own jar (IT'S ONLY ~9KB!) include(modImplementation("maven.modrinth:fstats:") // Option 2: Depend on fStats API, but require that users install it manually modImplementation "maven.modrinth:fstats:" } ```

Kotlin - build.gradle.kts

```kts repositories { maven("https://api.modrinth.com/maven") } dependencies { // Option 1: Include fStats API to project for it available within your own jar IT'S ONLY ~9KB! include(modImplementation("maven.modrinth", "fstats", "")) // Option 2: Depend on fStats API, but require that users install it manually modImplementation("maven.modrinth", "fstats", "") } ```

> fabric.mod.json ```json "suggests": { "fstats-api": "*" } ``` Setup project > fabric.mod.json ```json "custom": { "fstats": } ``` Done, now when any server uses your mod, and if they don't disable fStats, you are going to get data about that on [website](https://fstats.dev) Also, recommend adding the badge to your project description to notify users that you collect information. *Resize badge to any size that you want* ![Badge](https://cdn.modrinth.com/data/DkOr2M32/images/597e8bc81f48ad606ae5624f566994dde65ac409.png)

(back to top)

## Roadmap See the [open issues](https://github.com/fstats/fstats-api/issues) for a full list of proposed features (and known issues).

(back to top)

## Contributing Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**. If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again! 1. Fork the Project 2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) 3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the Branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request

(back to top)

## License Distributed under the MIT License. See `LICENSE.txt` for more information.

(back to top)

[contributors-shield]: https://img.shields.io/github/contributors/fstats/fstats-api.svg?style=for-the-badge [contributors-url]: https://github.com/fstats/fstats-api/graphs/contributors [forks-shield]: https://img.shields.io/github/forks/fstats/fstats-api.svg?style=for-the-badge [forks-url]: https://github.com/fstats/fstats-api/network/members [stars-shield]: https://img.shields.io/github/stars/fstats/fstats-api.svg?style=for-the-badge [stars-url]: https://github.com/fstats/fstats-api/stargazers [issues-shield]: https://img.shields.io/github/issues/fstats/fstats-api.svg?style=for-the-badge [issues-url]: https://github.com/fstats/fstats-api/issues [license-shield]: https://img.shields.io/github/license/fstats/fstats-api.svg?style=for-the-badge [license-url]: https://github.com/fstats/fstats-api/blob/master/LICENSE.txt [linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555 [linkedin-url]: https://linkedin.com/in/kit-lehto [discord-shield]: https://img.shields.io/discord/1032138561618726952?logo=discord&logoColor=white&style=for-the-badge&label=Discord [discord-url]: https://discord.gg/pbwnMwnUD6 [modrinth-shield]: https://img.shields.io/modrinth/v/fstats?label=Modrinth&style=for-the-badge [modrinth-url]: https://modrinth.com/mod/fstats

fStats

Project Page

fStats Badge