{"id":50324747,"url":"https://github.com/standardan/leaderstats","last_synced_at":"2026-05-29T05:04:09.258Z","repository":{"id":361062854,"uuid":"1252944390","full_name":"Standardan/leaderstats","owner":"Standardan","description":"Player stats, leaderboards, holograms and PlaceholderAPI placeholders for Paper 1.21+.","archived":false,"fork":false,"pushed_at":"2026-05-29T03:06:45.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T04:24:48.427Z","etag":null,"topics":["bukkit","java","leaderboard","minecraft","minecraft-plugin","paper","paper-plugin","placeholderapi","spigot","stats"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Standardan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-29T02:52:41.000Z","updated_at":"2026-05-29T03:06:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Standardan/leaderstats","commit_stats":null,"previous_names":["standardan/leaderstats"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Standardan/leaderstats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Standardan%2Fleaderstats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Standardan%2Fleaderstats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Standardan%2Fleaderstats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Standardan%2Fleaderstats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Standardan","download_url":"https://codeload.github.com/Standardan/leaderstats/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Standardan%2Fleaderstats/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33637486,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","java","leaderboard","minecraft","minecraft-plugin","paper","paper-plugin","placeholderapi","spigot","stats"],"created_at":"2026-05-29T05:03:55.368Z","updated_at":"2026-05-29T05:04:09.243Z","avatar_url":"https://github.com/Standardan.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LeaderStats\n\nTracks player stats — kills, deaths, mob kills, blocks mined, playtime — with in-game\nleaderboards, **floating leaderboard holograms**, and **PlaceholderAPI** placeholders.\nFor Paper 1.21+.\n\n## Download\n\n**[Download the latest release »](https://github.com/Standardan/leaderstats/releases/latest)**\n\nDrop the `.jar` into your server's `plugins/` folder and restart. Requires Paper 1.21+ (Java 21).\nPlaceholderAPI is optional — placeholders activate automatically if it's installed.\n\n## Features\n\n- Tracks **kills, deaths, mob kills, blocks mined, playtime**, persisted in SQLite\n- `/stats` — see your own stats; `/stats top \u003cstat\u003e` — see the leaderboard\n- **Hologram leaderboards** — `/stats hologram \u003cstat\u003e` drops a live top-10 board in the world\n- **PlaceholderAPI support** — e.g. `%leaderstats_kills%`, `%leaderstats_top_kills_1_name%`\n\n## Commands \u0026 permissions\n\n| Command | Description |\n|---|---|\n| `/stats` | View your own stats |\n| `/stats top \u003cstat\u003e` | View a leaderboard |\n| `/stats hologram \u003cstat\u003e` | Place a leaderboard hologram (admin) |\n| `/stats hologram remove` | Remove nearby holograms (admin) |\n| `/stats reload` | Reload config (admin) |\n\nStat keys: `kills`, `deaths`, `mobkills`, `blocksmined`, `playtime`. Permissions:\n`leaderstats.use` (default: all), `leaderstats.admin` (op).\n\n## PlaceholderAPI\n\n| Placeholder | Returns |\n|---|---|\n| `%leaderstats_\u003cstat\u003e%` | the player's own value |\n| `%leaderstats_top_\u003cstat\u003e_\u003crank\u003e_name%` | the name at that rank |\n| `%leaderstats_top_\u003cstat\u003e_\u003crank\u003e_value%` | the value at that rank |\n\n## Design notes\n\n- **Stats live in an in-memory cache** while a player is online (so increments and placeholder\n  lookups are instant), flushed to SQLite on a timer and on quit.\n- **Leaderboards are a periodically-rebuilt snapshot.** PlaceholderAPI resolves placeholders on\n  the main thread and must return instantly, so it reads the cached snapshot — never a live query.\n- **PlaceholderAPI is isolated.** All of its API lives in one class (`StatExpansion`) that's only\n  loaded after confirming the plugin is installed — so LeaderStats runs fine without it.\n- **Holograms use TextDisplay entities** (no holograms-plugin dependency), re-spawned from config\n  on start so they never orphan.\n\n## Building\n\nJDK 21 + Maven. `mvn clean package` → `target/leaderstats-1.0.0.jar`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstandardan%2Fleaderstats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstandardan%2Fleaderstats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstandardan%2Fleaderstats/lists"}