[Request] Add information about each trophy and the points needed for each trophy level to the README

[joelbrostrom]

As a user, I would like to know what the points of every trophy type represent. For example, the commit trophy score seems to match my GitHub one-year contribution score. On the contrary, the issuer trophy does not seem to match the number of issues I create. It is stuck at 20 points, even though I sometimes add 20 issues in a single day.

An explanation of how these scores work would make it a lot easier to understand what you need to do in order to achieve the next rank. This gamifies your work, making it fun to push yourself for a reward.

If someone with insights into how the different points are calculated could add this to the readme, I would be very grateful!

[hesreallyhim]

@joelbrostrom since this is an open source codebase, the actual calculations are open to view, although you may be asking if they can be documented, which personally I can see both sides of the issue - but, at tne end of the day, if it's something you actually want/need to know, you can peruse the source code or ask Copilot or something to write a summary for you. (Or check out my fork where I put together a table just for my own reference purposes - feel free to take a look or let me know if you can't find it.) So I would maybe clarify if the issue is specifically to add clear documentation to the README about what's already visible in the source code, just for the sake of clarity for this request. Hope that helps, just trying to suggest that there's not really any lack of "transparency" per se since it's all right in the codebase but maybe you think it still ought to be documented better. 👍🏽 (Or you may be asking for an "explanation" of why the calculations are what they are, which is something also related to transparency, and not self-evident in the code.)

[joelbrostrom]

@hesreallyhim You are absolutely right! What I'm asking for is indeed information in the README, like a table showing each badge and the points needed for each level. I will update the title per your suggestions.

[Bano733-code]

Hi @joelbrostrom, I’ve added a PR that addresses this! 🎉

It includes a trophy rank table with points needed for each level and descriptions for better transparency.

This should make it easier for users to understand how each trophy works and what’s required to reach the next rank.

[joelbrostrom]

@Bano733-code Fantastic! However, I think all trophies have their own levels. For example, I have 2000 + commits, and I'm still just at the SS level. On the other hand, I only have 11 points on the language trophy, but it awards me an S.

[Bano733-code]

Thanks for the feedback, @joelbrostrom!

Yes, exactly — the table shows estimated points and levels for reference. Actual trophy ranks can vary depending on the specific calculation for each trophy, which is why you might see differences like in your commits or language trophies.

On Fri, Dec 5, 2025, 9:45 PM Joel Broström @.***> wrote:

joelbrostrom left a comment (ryo-ma/github-profile-trophy#376) https://github.com/ryo-ma/github-profile-trophy/issues/376#issuecomment-3617675200

@Bano733-code https://github.com/Bano733-code Fantastic! However, I think all trophies have their own levels. For example, I have 2000 + commits, and I'm still just at the SS level. On the other hand, I only have 11 points on the language trophy, but it awards me an S.

— Reply to this email directly, view it on GitHub https://github.com/ryo-ma/github-profile-trophy/issues/376#issuecomment-3617675200, or unsubscribe https://github.com/notifications/unsubscribe-auth/BQ4RRSYUP2SOTFYI3UWR5JL4AGZEDAVCNFSM6AAAAACLJ7DNVWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTMMJXGY3TKMRQGA . You are receiving this because you were mentioned.Message ID: @.***>

[joelbrostrom]

@Bano733-code I see! While adding some rough guidelines is better than nothing, I would want the exact levels for each trophy. It's like when you're playing a game and grinding to get an achievement. You want to know what you have to do to get it; otherwise, the experience becomes frustrating. So what I'm looking for is a table with rows of trophies and columns of levels, where each cell shows the number of points needed to reach the level.

[Bano733-code]

Thanks for your suggestion, @joelbrostrom!

I totally understand — having exact thresholds for each trophy would make the experience more like a “game grind.” The challenge is that the actual point calculations for each trophy are embedded in the source code and can vary, so it’s not officially documented anywhere.

The table I added provides rough guidelines for now, so users have an idea of what each level represents. If there’s interest, maybe we could add a note encouraging contributors to propose exact thresholds or even extract them directly from the code for transparency.

On Fri, Dec 5, 2025, 10:01 PM Joel Broström @.***> wrote:

joelbrostrom left a comment (ryo-ma/github-profile-trophy#376) https://github.com/ryo-ma/github-profile-trophy/issues/376#issuecomment-3617730814

@Bano733-code https://github.com/Bano733-code I see! While adding some rough guidelines is better than nothing, I would want the exact levels for each trophy. It's like when you're playing a game and grinding to get an achievement. You want to know what you have to do to get it; otherwise, the experience becomes frustrating. So what I'm looking for is a table with rows of trophies and columns of levels, where each cell shows the number of points needed to reach the level.

— Reply to this email directly, view it on GitHub https://github.com/ryo-ma/github-profile-trophy/issues/376#issuecomment-3617730814, or unsubscribe https://github.com/notifications/unsubscribe-auth/BQ4RRS5HFRECEBJ4FI7OETT4AG247AVCNFSM6AAAAACLJ7DNVWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTMMJXG4ZTAOBRGQ . You are receiving this because you were mentioned.Message ID: @.***>

[hesreallyhim]

The challenge is that the actual point calculations for each trophy are embedded in the source code and can vary, so it’s not officially documented anywhere.

That's the point - it's in the source code so the ask is to read the source code and document it - no offense but ya kinda sound like a bot sorry. this is a task copilot could probably do if you asked it nicely - most of the information is here. If you look at my fork i have such a table that was produced by claude:

• i have NOT checked it for accuracy because it wasn't my main focus.
• i do NOT endorse the findings reported there, but they may provide a good starting point, and include line references to relevant files.
• i would not be sharing any of this if @ryo-ma indicated that it was really supposed to be secret-secret - it's legible in the source code, as opposed to stored on the backend, so i infer that the secrecy really just means "not documented" - in which case they will probably not want to document it, so this is more just for your own benefit if you really are interested.
• you may NOT use that information directly to submit a PR regarding this matter.

anyway, TL/DR it's all kept in a few files, if it's important to you, i recommend doing the dirty work to "dig it up" or enlist a coding agent to do it for you. i hope this is not irritating to the maintainers, but since they have not actually hidden or obfuscated the calculations, unless i hear something else i can only assume it's meant be a "soft" secrecy.

[Bano733-code]

Thanks for the clarification, @hesreallyhim! That makes sense — the “secret” seems to just mean “not documented,” and the calculations are visible in the source code. I’ll take a look at the files you mentioned and see if I can produce a table for reference purposes without submitting it as a PR. Appreciate the tips and the fork reference!

On Fri, Dec 5, 2025, 10:41 PM Really Him @.***> wrote:

hesreallyhim left a comment (ryo-ma/github-profile-trophy#376) https://github.com/ryo-ma/github-profile-trophy/issues/376#issuecomment-3617862507

The challenge is that the actual point calculations for each trophy are embedded in the source code and can vary, so it’s not officially documented anywhere.

That's the point - it's in the source code so the ask is to read the source code and document it - no offense but ya kinda sound like a bot sorry. this is a task copilot could probably do if you asked it nicely - most of the information is here https://github.com/ryo-ma/github-profile-trophy/blob/master/src/trophy.ts. If you look at my fork i have such a table https://github.com/hesreallyhim/github-profile-trophy-fork/blob/master/trophy_ranking_analysis.csv that was produced by claude:

• i have NOT checked it for accuracy because it wasn't my main focus.
• i do NOT endorse the findings reported there, but they may provide a good starting point, and include line references to relevant files.
• i would not be sharing any of this if @ryo-ma https://github.com/ryo-ma indicated that it was really supposed to be secret-secret - it's legible in the source code, as opposed to stored on the backend, so i infer that the secrecy really just means "not documented" - in which case they will probably not want to document it, so this is more just for your own benefit if you really are interested.
• you may NOT use that information directly to submit a PR regarding this matter.

anyway, TL/DR it's all kept in a few files, if it's important to you, i recommend doing the dirty work to "dig it up" or enlist a coding agent to do it for you. i hope this is not irritating to the maintainers, but since they have not actually hidden or obfuscated the calculations, unless i hear something else i can only assume it's meant be a "soft" secrecy.

— Reply to this email directly, view it on GitHub https://github.com/ryo-ma/github-profile-trophy/issues/376#issuecomment-3617862507, or unsubscribe https://github.com/notifications/unsubscribe-auth/BQ4RRSZGW7K2FGMW3PH5AK34AG7VLAVCNFSM6AAAAACLJ7DNVWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTMMJXHA3DENJQG4 . You are receiving this because you were mentioned.Message ID: @.***>

[Bano733-code]

Hi @joelbrostrom and everyone! 👋

I’ve gone through the source code and created a table showing trophy ranks, points needed, and descriptions. Please note this is for reference only, as actual trophy points can vary depending on each calculation in the code.

🏆 GitHub Profile Trophy — Rank Threshold Table

Trophy	Description	C	B	A	AA	AAA	S	SS	SSS
Reviews	Number of PR/Issue reviews	1	3	8	20	30	45	57	70
Experience (Account Duration)	How long your account has existed	2	6	11	18	28	40	55	70
Stars	Stars received on repositories	1	10	30	50	100	200	700	2000
Commits	Number of commits made	1	10	100	200	500	1000	2000	4000
Followers	Number of GitHub followers	1	10	20	50	100	200	400	1000
Issues	Number of issues created	1	10	20	50	100	200	500	1000
Pull Requests	Number of pull requests made	1	10	20	50	100	200	500	1000
Repositories	Number of repositories owned	1	10	20	30	35	40	45	50

---

🎉 Hidden / Easter Egg Trophies (Secret Rank Only)

Trophy	Rank	Required Score	Message
MultiLanguage	SECRET	10	Rainbow Lang User
AllSuperRank	SECRET	1	S Rank Hacker
Joined2020	SECRET	1	Everything started…
AncientUser	SECRET	1	Ancient User
LongTimeUser	SECRET	10	Village Elder
Organizations	SECRET	3	Jack of all Trades
OGUser	SECRET	1	OG User