bstats-graph-api

Generate bStats chart images on the fly — embed live plugin stats in any README.

Examples

Servers — dark (default) /v1/plugins/30992/charts/servers/chart.png

Players — light /v1/plugins/30992/charts/players/chart.png?theme=light

Servers — purple, last 7 days /v1/plugins/30992/charts/servers/chart.png?theme=purple&max_elements=336

Players — green, last 7 days /v1/plugins/30992/charts/players/chart.png?theme=green&max_elements=336

Servers — sketch /v1/plugins/30992/charts/servers/chart.png?theme=sketch

Core count — pie chart /v1/plugins/30992/charts/coreCount/chart.png

Find the available chart IDs for any plugin:

GET /v1/plugins/{plugin_id}/charts

Embed a chart in your README:

![Servers](https://bstats-graph.gritter.nl/v1/plugins/{plugin_id}/charts/{chart_id}/chart.png)

Pick a theme, then override individual parameters as needed:

?theme=green&width=600&height=200
?theme=purple&max_elements=336
?theme=light&line_color=dc2626

theme=dark

Default. Navy background, cyan line.

theme=light

White background, blue line.

theme=purple

Deep purple background, purple line.

theme=green

Dark green background, emerald line.

theme=sketch

Paper/hand-drawn style with xkcd font and wobbly lines.

Parameter	Default	Limits	Description
theme	dark	dark, light, purple, green, sketch	Color preset — overridable by any color param below
width	830	200–2000	Image width in px
height	315	100–1000	Image height in px
max_elements	1440	2–17520	Data points to fetch (~30 days at default)
bg_color	from theme	6-char hex	Background color
line_color	from theme	6-char hex	Line color (also base color for pie palettes)
text_color	from theme	6-char hex	Axis label color
grid_color	from theme	6-char hex	Grid line color
fill	true	bool	Fill area under line
fill_alpha	from theme	0.0–1.0	Fill opacity
line_width	2.0	0.5–5.0	Line thickness (line charts only)
title	from bStats	max 100 chars	Override the chart title