Contributing to Habitica
Habitica is an open-source project that welcomes many types of contributions by people in our community who want to improve the experience for all players. We are currently accepting contributions in the areas of code and translation.
We refer to contributors that use their development skills to help improve our web, iOS, and Android apps as Blacksmiths. Our contributors that translate Habitica into other languages to help players around the world access the app are known as Linguists.
Contributors that offer their time and skills to the betterment of Habitica are rewarded with community tiers and some special in-game items as they move up the ranks. If you’re interested in becoming a contributor, continue reading below to learn more!
Our team periodically awards Contributor tiers to publicly recognize the hard work of our contributors. The tier you receive is dependent on the complexity and number of your contributions.
Each tier comes with a title and colorful theme applied to your Display name within Habitica. This customization will be visible on the messages you send and various Profile views throughout the platform.
You’ll also be immortalized in the Hall of Heroes with a record of the contributions you’ve made.
Tier 1: Friend(Pink hexagon icon)
Tier 2: Friend(Maroon hexagon icon)
Tier 3: Elite(Red triangle icon)
Tier 4: Elite(Orange triangle icon)
Tier 5: Champion(Yellow square icon)
Tier 6: Champion(Green square icon)
Tier 7: Legendary(Teal diamond icon)
Contributor tiers aren’t just a colorful name, they come with some extra goodies too! From Achievements, to Equipment, to Gems, you can look below for a detailed breakdown of what rewards come with each tier.
You’ll also receive some power-up’s that boost the drops you get from completing tasks on Habitica! Each tier grants an additional +2.5% drop chance multiplier and adds +1 to the maximum amount of item drops you can receive each day.
Tier 1 Rewards: An exclusive Achievement that recognizes you as a contributor to Habitica and 10 Gems
Tier 2 Rewards: Animated piece of Crystal Armor and 20 Gems
Tier 3 Rewards: Animated Crystal Helm and 30 Gems
Tier 4 Rewards: Crystal Blade and 40 Gems
Tier 5 Rewards: Crystal Shield and 50 Gems
Tier 6 Rewards: Hydra Pet and 60 Gems
Tier 7 Rewards: This legendary tier has a new reward brewing waiting to be uncovered, and 70 Gems!
Special Reward: Animated Critical Hammer of Bug-Crushing weapon for contributors able to resolve critical priority bugs.
*These rewards have been adjusted to reflect the current requirements for achieving each tier as of 2025.
Those looking to earn Blacksmith tiers should check out issues marked with the “Help Wanted” label on each platform’s respective repository (web / Android / iOS). These are the issues to work on if you’d like to join the ranks of our coding contributors!
Our team has specifically picked those issues out as ones that would be high impact and perfect for an outside contributor to tackle. Issues that may need a lot of discussion or design work are reserved for our team to handle.
We aren’t currently accepting pull requests for feature requests or for issues without the “Help Wanted” label. If you find a bug that could use attention, we recommend creating an issue for that bug before submitting a pull request.
If you’re interested in earning a Linguist tier through translation, help is always needed to update supported languages with the latest additions to the game. Even if a language is finished on one platform, that same language may still need translations on another.
We currently support a sizable amount of language options for our playerbase to choose from. If you’re fluent in any of the below languages and want to submit new or improved translations, we encourage you to check out our translation website.
Languages Currently Accepting Contributions:
Bulgarian
Chinese (Simplified)
Chinese (Traditional)
Croatian
Czech
Danish
Dutch
English (UK)
English (US)
French
German
Hebrew
Hungarian
Indonesian
Italian
Japanese
Korean
Polish
Portuguese (Portugal)
Portuguese (Brasil)
Romanian
Russian
Serbian
Slovak
Spanish (Spain)
Spanish (Latin America)
Swedish
Turkish
Ukrainian
If you want some guidance on how to start translating or have questions regarding the availability of supported languages, you can read more over on the info tab on the website where we host our translations.
The process and requirements for rising through the tiers changes with the type of contribution and the tier you’re currently on. We’ve included some information about these processes below!
After submitting a pull request to one of our repositories, you become eligible to receive a contributor tier. When a pull request is merged and gets through testing, a member of the team will comment to let you know we've recorded your contribution to the Hall of Heroes.
Before commenting, the team will evaluate the difficulty and impact of your pull request and either grant a new tier or note the contribution as partial credit towards your next tier. The requirements for ranking up progressively increase as the tiers get higher.
Tiers for help with development are awarded:
- After your first substantive pull request is merged in
- After a few more small pull requests, or one larger pull request is merged in
- Later tiers are offered to players who consistently submit helpful pull requests
We have a very small team, so it may take some time for us to work your pull request into the release schedule. It may also take some time after the initial merge for testing to be completed.
If you don't receive any update from the team within a few weeks, please comment on the pull request to ask about it. We want to be sure all our contributors are properly credited for their work!
After submitting translations for Habitica, you become eligible to receive a contributor tier. The requirements for ranking up progressively increase as the tiers get higher.
Tiers for help with translation are awarded:
- After your first substantive contribution
- After 1, 3, 6 months, and 1 year of contributions
- Later tiers are offered for 2+ years of contributions
If you meet these conditions, please complete the Translation Badge Application form to let us know about your contribution. We do not receive notifications for activity, so please reach out so we can credit you!
Tier requests are usually processed once every month and are awarded at the Habitica team’s discretion based on translation quality, complexity, and time spent. The language you submitted translations for will be recorded in the Hall of Heroes.
Do not use Google Translate, ChatGPT, or any similar service to do translation work. Please only work on a language of which you are a native speaker or of native level fluency. Poor quality translations will not be accepted and we reserve the right to revoke tiers if translations are found to be of poor quality.
This guidance can also be found on our translation website, under the Info tab for each project.