Skip to content

Commit

Permalink
Add a README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Bernasss12 committed Jul 26, 2023
1 parent 5d4c74a commit dce1a90
Showing 1 changed file with 43 additions and 0 deletions.
43 changes: 43 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Badge Server

---
This is a simple project made mostly for personal use and the main goal was for me to challenge myself and learn how to do it.
The idea (still incomplete) was for me to have stylized badges for both minecraft mod providers, Modrinth and CurseForge, while using the (almost) same url.

### Usage

`[domain]/[provider]/[modid]/[data]`

Currently only Modrinth data fetching is implemented but ideally this is how you'd generate the badge for both services:

`![modrinth](https://badge.bernasss12.dev/modrinth/better-enchanted-books/downloads)`
![modrinth](https://badge.bernasss12.dev/modrinth/better-enchanted-books/downloads)

`![curseforge](https://badge.bernasss12.dev/curseforge/better-enchanted-books/downloads)`
![not yet](https://badge.bernasss12.dev/curseforge/better-enchanted-books/downloads)

At the moment there is only one style with the provider logo on the left and text on the right, but the plan it to have more flexibility on that as well as the date displayed.
The available preset data options are:

`[none] or /download` - displays a shortened version of the mod's download count.
`/name` - displays the title of the project
`/versions` - displays the latest 3 minecraft versions (supported by the project)
`/loaders` - displays the supported mod loaders by the project
`/licence` - displays the name of the project's licence, if available

### Disclaimer

This service is currently hosted, but it's not quite ready for use, anything mentioned above is prone (and mostly already planned) to change.

#### Examples

![example](https://badge.bernasss12.dev/modrinth/better-enchanted-books/downloads)
![example](https://badge.bernasss12.dev/modrinth/better-enchanted-books/name)
![example](https://badge.bernasss12.dev/modrinth/logistics-pipes/downloads)
![example](https://badge.bernasss12.dev/modrinth/logistics-pipes/name)
![example](https://badge.bernasss12.dev/modrinth/better-enchanted-books/versions)
![example](https://badge.bernasss12.dev/modrinth/better-enchanted-books/loaders)
![example](https://badge.bernasss12.dev/modrinth/better-enchanted-books/licence)



0 comments on commit dce1a90

Please sign in to comment.