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 存储数据)。安卓和 iOS 应用则在单独的仓库中维护。
我该怎么在本地运行它进行开发?按照 wiki 上的“Setting up Habitica Locally”指南操作,其中会讲解如何安装依赖并配置本地的开发/测试环境;仓库中还提供了 docker-compose 的配置方式。
我需要先装好 Node.js 和 MongoDB 吗?需要。依据 package.json 的 engines 字段,项目要求 Node 20 和 npm ^10,并且所有应用数据都存储在 MongoDB 中。
完成习惯和待办事项,我到底能获得什么?完成每日任务、习惯和待办事项,你可以获得经验值和金币,金币可用于为游戏中的角色购买武器、护甲和其他物品。
如果我一直完不成任务会怎样?错过每日任务和养成坏习惯会让角色损失生命值(HP);如果生命值降到零,角色就会“死亡”,这与传统角色扮演游戏的机制相同。
第三方开发者能基于 Habitica 开发工具吗?可以。Habitica 提供公开的 API,第三方工具开发者需要遵循 API 使用指南,以确保合规,并保持玩家体验的一致性。
Creator
HabitRPG
Size
1.6 GB
Stars
14.2K
Age
14y
Commits · 90 Days