When you start up the world, you'll see a portal. It will take you to the Minemart community where you can interact with villagers with your gems. Be careful, because it is a floating island; however, if you try to jump into the void this way, you'll just be teleported back to the portal to the Overworld, no worries. There are teleporters scattered across the dimension which will teleport players to specific destinations, at a cost of gems depending on the distance between the two points.

You can also move the portal to wherever you want. Just make sure it is not obstructed by blocks. Moving the portal requires operator status though, unless the datapack allows all players to move it. Unfortunately, you can't move the portal to another dimension. You can only move the portal once before the command enters a cooldown of one Minecraft day, so make your move wisely.

Time in the datapack is notated in Minecraft days.

Quick commands:
- To open the main menu, do /trigger minemart_mainmenu.
- To get your purse balance, do /trigger minemart_purse.
- To get a replacement Minemart guide in case you lose your original, do /trigger minemart_guide.
- To get Minemart store demand, do /trigger minemart_demandget.
- To transfer gems to another player, do /trigger minemart_transfer set #. A player must be within five blocks from you, and if there is more than one player within this range, the closest is selected. This command is multiplayer-exclusive.

GEMS

Gems are a currency in Minemart used to buy items at Minemart stores.
You can use the gems obtained for things such as purchasing items, trading with players, and more!

Be careful with gems in your purse, because dying will cause you to lose a percentage of them. The number of gems you lose on death is affected by the world difficulty; the higher it is, the more you'll lose.

- Peaceful = 25%
- Easy = 33% (it is actually 1/3)
- Normal = 50%
- Hard = 100%

For example, if you die with 300 gems, and the world difficulty is Easy, you lose 100 of them.

You can recover 50% of the gems you lost if you pick them up before they disappear; the other 50% cannot be recovered and is gone forever. These dropped gems do not spawn if you were killed by a player. Like items, they despawn after five minutes while in a loaded chunk. Note: this only works when the gamerule "doImmediateRespawn" is disabled, otherwise it'll spawn the dropped gems at your respawn point, meaning you can pick up the dropped gems straight away.

When PvP is enabled, killing other players lets you steal the gems they've lost to dying. Example: if you kill a player with 1000 gems, and the world difficulty is Normal, you steal 500 from them. However, if you shoot an arrow on yourself and die from it, the game will think you were killed by another player, but you won't be able to recover the lost gems, even when the drop percentage is not 0%.

MINEMART STORES

Minemart has a complicated chain of stores that sorts its items into categories in the creative inventory. This means you may find more than one store selling the same product.

All entrances have their corresponding store's supply statistics. They show how many items they sell when they restock (the item supply), the total number of gems required to buy every item there, before demand and taxes (the gem supply), and the average cost per item. Although the average cost per item is rounded to two decimal points displayed on the sign, when calculating demand change from buying/selling items, it will actually round towards the nearest integer.

Some interesting facts about these statistics:
- The total supply across all stores is 6,238,724 items.
- The total gem supply across all stores is 3,656,841,593.31.
- The average cost/item is 586.15 gems.

The store entrances have guards, which check players' inventories and watch the store 24/7/365. Their purpose is to reduce shrinkage in stores by combating shoplifting.

Anything that the guards consider shoplifting is not allowed and will result in consequence(s):
  - Stealing items from a store: you'll be sent to the exit until you either pay for the items you're taking or put all of them away.
  - Dropping items while shopping: the dropped items will simply teleport to your inventory.
  - Eating Minemart's food: you'll get the fast-draining Hunger effect that will put you to zero hunger points. You'll also lose effects that can come from any food and take damage.
  - Drinking Minemart's potions: you'll lose all potion effects and take damage.
  - Splashing tagged splash/lingering potions: thrown potions near you (including the tagged one) will be removed.
  - Throwing tagged ender pearls; like splash potions, thrown ender pearls near you will be removed.

In a store, players may select items to purchase by taking them from chests. Then they go to the checkout where they can interact with the clerk. Players must put the items they take into a chest minecart. Once all the items are put there, they can finish. However, finishing requires the players to confirm that they are going to buy these items. They can review their subtotal, the tax, and the total after taxes. Until they pay the clerk gems, players can review the chest minecart to make sure that these items are what they would want to buy. Once they confirm, players pay the clerk gems, and the items they bought will be de-tagged and be thrown to their inventory.

Players can sell items by talking to the item collector. They will place a barrel so players can insert items they don't want there. Before finishing, the player can check how many gems they could get from selling the items. Once they confirm, the items in the barrel will be converted to gems, and the barrel will be emptied.

Every Minecraft lunar cycle (eight Minecraft days or on a full moon), every item in Minemart stores will be restocked.

DEMAND

Minemart has a demand system where the store's items' values changes depending on the store's demand. Demand is tracked per store, not per item. When buying items, demand is increased by one point per gem spent, divided by the store's average cost per item. This applies only to that store. Selling items reduces demand from all stores by one point per gem obtained, divided by the average costs per item across all stores. This applies before the price adjustment by demand. Demand changes the store's items' buy price by 0.01 gems per point, while it changes items' sell prices by 0.01 gems per 10 points based on the average demand of the stores. There is a minimum buy/sell price where demand can't lower the price beyond this point. Due to limitations in Minecraft, demand can range from -1,242,756 to 1,242,756.

Average costs per item are calculated by calculating how many gems one would need to buy every single item from a store (before taxes/demand) and determining the store's supply after restocking. A store's initial supply is the number of items they sell when they restock.

Every half a Minecraft day, the stores' demand will passively diminish by 40 points, returning to zero if it was ±40 or less. Every eight Minecraft days (Minemart's restock day), demand also is multiplied by 0.9, rounded down.

BANKING

Minemart has a banking system where players can store gems in their bank accounts. Players can maintain a chequing and a savings account. Chequing accounts have unlimited transactions, whereas savings accounts are limited to ten transactions every 64 Minecraft days. This is a soft limit and can be exceeded, up to 15 where any transactions after that will be refused. Exceeding the limit charges the player an excessive transaction fee of 25 gems per transaction above the limit, doubled for every transaction after that. This fee is paid using gems from their chequing account.

Savings accounts earn 0.5% interest every six Minecraft days, up to a maximum of 10,000 gems, if they have at least 100. On the other hand, chequing accounts don't accrue interest.

LOANING

You can borrow gems from the banker in certain circumstances, for example when you need to buy an expensive item, and you don't have the money to buy it. Your creditworthiness score, which ranges from 0-100%, also comes into play when taking out a loan. You start with a 75% score when you first consider taking out a loan.

To borrow gems, you need at least 20% equity to be eligible for a loan of a size you choose. Loans must be at least 2 gems. You are then required to set a term for it, which can be 8, 16, 32, 64, or 96 Minecraft days. The interest rate can vary depending on your creditworthiness score; different brackets have different interest rates, with scores closer to 100% having lower rates. A longer loan term means you'll have to pay more interest, so you should consider your choices when taking out a loan.

Once you take out a loan, you'll be expected to pay the minimum payment on your loan statement. A successful payment increases creditworthiness score, although this can vary depending on the loan term. Failure to pay that minimum before your next loan statement results in a 5% late fee on your outstanding balance and a decrease of your creditworthiness score by 10%. A successful minimum payment will increase your creditworthiness score; extra payments do NOT help increase it faster but will save you on interest.

You can also set up autopay, which allows you to automatically pay off your loan on your loan statement with gems from your chequing account. Autopay will always pay the minimum payment if you have enough funds in it. You can also configure autopay to pay off additional gems to your loan, but like extra payments, that doesn't help with your creditworthiness score. At any point, you can turn off autopay when you change your mind, or edit the extra payment as necessary.

AUCTIONS

Minemart has an auction house where players can auction their items for players to bid on them. There can only be one auction at a time. There is a limit of 1 billion gems on the starting bid. Note: this is a multiplayer-exclusive feature.

When an auction is created, it has a 90-second pre-bid (grace) period where players cannot bid on the item at that time. This is to allow players that are interested to get in the auction house to bid on the item. When there are no players outside the auction house, the pre-bid phase will end early. After that phase, the auction will last for fifteen seconds. Bidding will increase the timer by fifteen seconds, but it cannot exceed the bidding phase length. After the bidding phase, the highest bidder wins the item, and the auction master will collect the top bidder's gems for the auction owner to claim later. If there were no bids, the item is returned to the player who auctioned the item.

To bid on an auction, do /trigger minemart_bid set #.

During the grace period, players can enter the auction house. After this period is over, the door will be locked so that remaining players cannot enter. When creating auctions, one must pay a fee equal to 2% of the starting bid.

There is a scaling tax of 1% per digit in the top bid (over 3) when claiming at least 1,000 gems, but it cannot decrease the claim below 1,000. It is mostly intended to reduce demand across stores and also acts as an additional fee for selling expensive items.

- Add more features to the "Minemart Services" system.
- Increase the number of decimal places for gems from two to three, making certain calculations (i.e. buy/sell prices, interest) a bit more accurate.
- Disallow players from putting non-tagged items in the chest minecart. If a player attempts to put non-tagged items in the chest minecart, the clerk will move them and throw them to the player.