habitica README

The project's README from github.com/HabitRPG/habitica. As one markdown file: README.md.

Public pull request submissions paused as of August 4, 2026

Due to changes in the tech landscape and in how our player base interacts with Habitica on various platforms, we have made the decision to pause our acceptance of code-based contributions (Blacksmith tiers). Our codebase will remain open-source and publicly visible. If you’d like to know more about this pause, you can find additional details on the GitHub wiki.

⚠️ No AI-Generated Code Policy

This repository prohibits the submission of code generated by large language models (LLMs), AI coding assistants, or automated generation tools. All code must be authored entirely by humans. AI-assisted commits will be rejected during pull request reviews.

Habitica Build Status

Habitica is an open-source habit-building program that treats your life like a role-playing game. Level up as you succeed, lose HP as you fail, and earn Gold to buy weapons and armor!

Want to contribute code to Habitica? We're always looking for assistance on any issues in our repo with the "Help Wanted" label. The wiki pages below and the additional linked pages will tell you how to start contributing code and where you can seek further help or ask questions:

Interested in contributing to Habitica’s mobile apps? Visit the links below for our mobile repositories.

Habitica's code is licensed as described at https://github.com/HabitRPG/habitica/blob/develop/LICENSE

Found a bug? Please report it to admin email rather than create an issue (an admin will advise you if a new issue is necessary; usually it is not).

Creating a third-party tool? Please review our API Usage Guidelines to ensure that your tool is compliant and maintains the best experience for Habitica players.

Have any questions about Habitica or contributing? See the links in the Habitica website's Help menu. There’s FAQ’s, guides, and the option to reach out to us with any further questions!

habitica (HabitRPG/habitica)

Searching Database…

14.2K ·GitHub
Что это такое?Habitica — это приложение с открытым исходным кодом для формирования полезных привычек, которое превращает ваши реальные цели и привычки в ролевую игру: за хорошее поведение вы повышаете уровень, за плохое теряете очки здоровья (HP), а золото, которое вы зарабатываете, можно потратить на оружие и броню для вашего аватара.
Это репозиторий мобильного приложения или веб-версии?Этот репозиторий содержит веб-версию Habitica и её серверную часть (сервер на Node/Express с клиентом на Vue, который работает с MongoDB). Приложения для Android и iOS поддерживаются в отдельных репозиториях.
Как запустить проект локально для разработки?Следуйте инструкции 'Setting up Habitica Locally' из вики: в ней описаны установка зависимостей и настройка локальной копии для разработки и тестирования. В репозитории также есть конфигурация docker-compose.
Нужно ли сначала установить Node.js и MongoDB?Да: согласно полю engines в package.json, проекту нужны Node 20 и npm ^10, а все данные приложения хранятся в MongoDB.
Что я на самом деле получаю за выполнение привычек и задач?За выполнение ежедневных заданий, привычек и задач вы получаете опыт и золото, которые можно потратить на оружие, броню и другие предметы для вашего аватара в игре.
Что будет, если я постоянно не выполняю свои задачи?Персонаж теряет очки здоровья (HP) за пропущенные ежедневные задания и вредные привычки. Если HP опускается до нуля, персонаж может «умереть», как в классических ролевых играх.
Можно ли создавать сторонние инструменты на основе Habitica?Да, у Habitica есть публичный API. Разработчикам сторонних инструментов рекомендуется следовать API Usage Guidelines, чтобы соответствовать правилам и сохранять единый игровой опыт для игроков.
Creator
HabitRPG
Size
1.6 GB
Stars
14.2K
Age
14y
Commits · 90 Days