Gems are a form of in-game currency used for purchases in the Market and the Seasonal Shop, and for backgrounds and avatar customizations (as opposed to the Item Store, where items are purchased with gold). The difference between gems and gold or silver is that the main method of acquiring gems is by purchasing them with real money.
Gems are the primary method through which the Habitica developers receive financial support. Habitica is not a pay-to-win game and gem purchases are not necessary to enjoy the game. Gem-purchasable items are usually one of the following: shareable (e.g., pet quests), entirely cosmetic (e.g., backgrounds), or achievable with time (e.g., Orb of Rebirth). Additionally, any items bought with gems will not give the player an advantage in their stats.
There are currently five ways to obtain gems:
- buying gems directly with real money
- subscribing with real money and then buying gems with gold
- receiving a gifted subscription or gifted gems
- winning a challenge that has a gem reward (free but time consuming)
- contributing (also free but time consuming)
Buying Gems for YourselfEdit
- Click on the Gems display in the Toolbar. The "Buy Gems / Donate" dialog box will appear. Android or iOS app, tap on the gem icon in the header or go to Menu > Gems & Subscription.
- Select the method via which you wish to pay for gems. Purchases can be made with a credit card, Amazon Payments, PayPal, through Google Play on the Android app, or through iTunes on the iOS app. If you pay with a credit card, you might be charged a fee by your bank.
- Follow the on-screen instructions for the payment option you have selected.
- If the gems don't appear in your account immediately, reload the website or log out of the mobile app and log back in. If they still don't appear, please report the problem in the Report a Bug guild, which you can reach from Help > Report a Bug from the website's menu or from Guilds > Report a Bug on the mobile apps.
Note: Only click the Buy or Confirm buttons once. Clicking the buttons multiple times quickly may result in multiple purchases being made.
SubscribingEditsubscription or a corporate plan may use gold to buy gems, at a rate of 20 gold per gem.
The option to buy gems with gold appears in the Special Item section of the Market after subscribing.
A new subscriber may buy a maximum of 25 gems per month with gold. For every 3 consecutive months they keep their subscription, their gem purchasing cap will increase by 5 gems, up to a maximum of 50 per month. For example, a player that has been subscribed for 6 months will have a cap of 35 gems per month instead of 25. Subscribers purchasing a 3, 6 or 12 month subscription will immediately receive the bonus benefits based on the length of the subscription and will continue to receive these benefits each time the subscription renews. For example, if you buy a six-month subscription, you will immediately receive two Mystic Hourglasses and add an additional ten gems to the monthly gem cap.
In the corner of the "purchase gems" button, a green circle will indicate how many gems are still available for purchase to complete the monthly gem cap. If you do not buy enough gems to meet your gem cap for that month, the gems not purchased do not roll over to the next month. If you do not have the gold at the end of the month, you might wish to consider using Fix Character Values to give yourself a loan of enough gold and then pay it back later with a custom reward. Please note that the site admins are not able to refund gems not purchased at the end of the month.
The gem purchase cap resets within the first three days of each month, regardless of what day of the month the player's subscription started.
Gems and subscriptions can also be gifted to other players. You can choose to make a gift of one or more gems from your inventory or to buy gems to send to another player.
To access the Gift dialogue box, click the Gift icon on the player's Profile (in the bottom left hand corner).A popup will then open that gives you the option of sending gems to that player or buying a subscription for that player.
To send gems from your existing inventory, enter the number of gems you'd like to send, then click the Send button.
To purchase gems, enter the number of gems you'd like to purchase. The purchase amount will be displayed, and you will be able to select PayPal, Amazon Payments, or a card as payment options.
To choose a subscription, select from the options of 1 month, 3 months, 6 months, or 1 year. Again, you can select PayPal, Amazon Payments, or a card as payment options.
You can also attach a personal message to send with the gift.
When your gift has been sent, the recipient will receive an automated message in their inbox telling them what you have given them, i.e., the number of gems or the number of months of subscription. If you entered a personal message, it will be appended to the automated message.
Note that asking other players to gift you gems in chat or via private messaging is considered spamming and is forbidden under the Community Guidelines.
Obtaining Gems for FreeEdit
Players may also earn gems through two other means, both of which require a significant time investment:
- Winning challenges that award gems as a prize. Note that not all challenges give gems and that you probably won't win all challenges you join.
- Receiving a contributor reward for helping with the development of Habitica. Note that not all contributions will be accepted and those that are might take a long time to be implemented, especially for art contributions.
All methods of obtaining gems are designed to support Habitica and improve the overall user experience.
Gems can be used to purchase the following:
- Eggs (can also be obtained for free from drops)
- Hatching Potions (can also be obtained for free from drops)
- Food (can also be obtained for free from drops)
- Saddles (to upgrade a pet to a mount immediately)
- Avatar Appearance changers (skin, hair, clothing, some ears)
- Items from the Seasonal Shop (seasonally during the four Grand Galas)
- Fortify Potion
- Certain quest scrolls
- Guild creation (creating a new guild costs four gems)
- Class changes
- Orb of Rebirth (becomes free at level 100)
- Key to the Kennels (becomes free when you have Triad Bingo)
- Prizes in any challenges you create (public challenges in the Tavern must have a reward of at least 1 gem; this is to discourage spam)
As mentioned above, you never have to buy or use gems: gem rewards are either cosmetic, like backgrounds; able to be earned for free, like eggs; or shareable, like quests (only one person in a party needs to buy them and then everyone can participate).
Troubleshooting Gem PurchasesEdit
If you encounter an issue that results in a loss of gems or disrupted a credit card payment, state the issue in the Report a Bug guild with whatever information you can supply about the lost transaction.
Information for Developers
In Habitica's database and in the data extracted from the database using the API, the amount of gems for a user or guild is stored in the
balance field. The value stored is the dollar value of the gems owned, which is $1 for 4 gems. Thus if the balance is 1, the user or guild has 4 gems. If the balance is 0.5, the user or guild has 2 gems.