💰 Economy System - WestoniaSMP/Westonia GitHub Wiki

The Economy System in Westonia introduces a physical currency called Westons, allowing players to earn, trade, and store wealth in physical form. Players can engage in economic activities such as selling items, completing quests, killing mobs, and renting marketplace stalls to sell items or services.

In Westonia, Westons are physical items that can be stored in chests, wallets, or bank vaults. Players can collect Westons in various denominations:

• Denominations:
  • 1 Krone, 5 Westons, 10 Westons, 50 Westons, 100 Westons, 500 Westons, 1000 Westons.

Players earn Westons through quests, mob kills, item sales, or services and can exchange them with other players.

---

Players can manage their Westons with the following commands:

• /economy balance – View the current balance of Westons.
• /economy deposit – Deposit Westons into a player's account (bank, wallet).
• /economy withdraw – Withdraw Westons from a player's account.
• /economy give – Give another player a specific amount of Westons.
• /economy pay – Pay another player in Westons.

---

Players can rent market stalls in the spawn area to sell items, services, or offer quests. Each stall comes with a cash register, where offers can be listed.

• Rent a Stall: Players can rent a stall using /stall rent <StallName>. This will deduct the rental cost from their Westons.
• Set an Offer: Use /stall offer <Item/Service/Quest> <Price> to set up an offer.
• Manage Offers via Player Menu: Players can manage their offers (edit, remove, update) through the Player Menu.

• Stall Cash Register Levels:
  • Level 1: 9 slots
  • Level 2: 18 slots
  • Level 3: 27 slots
  • Level 4: 36 slots

These cash registers manage the number of active offers players can make. Upgrading to a higher-level cash register increases the number of offers a player can post.

---

Players can exchange Westons by:

• Dropping Westons on the ground for others to pick up.
• Trade via Player Menu: Use the Player Menu to initiate safe trades with other players.
• /economy give – Directly give a specific amount of Westons to another player.

---

Players can earn Westons through various activities:

Quests are a significant source of income. Quest-givers (NPCs or other players) will reward players in Westons upon completion.

• Start a Quest: Visit a job NPC or interact with a player who has posted a quest at their market stall.
• Receive Rewards: Quests typically provide Westons as a reward upon successful completion.

Players can complete tasks for Job NPCs to earn Westons. These tasks include mining, building, or crafting for the community.

---

Players can also earn Westons by defeating mobs. The amount of Westons earned depends on the mob type:

• Zombie: 1 Krone
• Creeper: 5 Westons
• Ender Dragon: 1000 Westons

Each mob kill automatically adds Westons to the player's balance.

---

Players can rent market stalls to sell items, provide services, or set up quests:

• Rent Command: /stall rent <StallName>
• Rent Price: Each stall has a fixed price per Minecraft day, deducted automatically from the player’s balance.
• Manage via Player Menu: All rental agreements and payments can also be handled through the Player Menu.

Players can set up different types of offers at their stalls, including:

• Item Sales: Set a price in Westons for an item.
• Services: Provide services like repairing or enchanting items for a fee.
• Quests: Post quests for other players, offering Westons as a reward.
• Auctions: Host auctions where other players can place bids.
• Trades: Offer items in exchange for other items or Westons.
• Time-limited offers: Offers can expire after a set duration (configured via Player Menu).

---

Players can store Westons in bank vaults to keep their wealth safe. Bank vaults are separate from player inventories, preventing loss on death.

• Deposit: /bank deposit <amount>
• Withdraw: /bank withdraw <amount>

The bank system provides a safe way to store large amounts of Westons and can be accessed through the Player Menu.

---

The Player Menu provides a user-friendly way for players to access all economy-related actions:

1. Westons Balance: View the current balance of physical Westons.
2. Market Stall Management: Rent, manage, or upgrade market stalls.
3. Offer Creation: Create, edit, or remove item offers, service offers, or quests.
4. Trade Westons: Safely trade Westons with other players.
5. Quest Log: Track current and completed quests, along with their rewards.
6. Deposit/Withdraw Westons: Manage personal Westons holdings in wallets, chests, or banks.
7. View Mob Rewards: See potential rewards for killing different mobs.
8. Banking: Access vault storage for larger sums of Westons.

---

This economy system is fully integrated with Westonia’s clan system. Clans can pool Westons in a shared Clan Bank to fund collective projects like territory expansion or wars.

• Deposit to Clan Bank: /clan deposit <amount>
• Withdraw from Clan Bank: /clan withdraw <amount>
• Manage via Player Menu: Clan leaders can manage clan funds through the Player Menu.

---

The prices of items, services, and quests may fluctuate based on supply and demand. Players can take advantage of market trends to maximize their profits.

• High Supply, Low Demand: Prices decrease as there is more of an item available than players are buying.
• Low Supply, High Demand: Prices increase as there are more players wanting an item than there are available.

The market prices are recalculated every Minecraft day based on the current supply and demand data, creating a dynamic economy. Players can strategically buy or sell items based on market conditions.

• Market Price Reset: Prices for all market items are recalculated at the start of each Minecraft day, based on the transactions and offers from the previous day.
• Max Price Change: The daily price shift is capped at a maximum percentage (configurable), to prevent sudden extreme price fluctuations.

The Economy System in Westonia includes server-wide taxes and transaction fees that are applied to player trades and market sales. These fees help balance the economy and create a more dynamic trading system.

1. Income Tax (Job Income):

   • A tax applied to all job-related income (rewards from NPCs or players for completing tasks, quests, etc.).
   • Tax rate is configurable via the EconomyVariables table.
   • Example: A player completing a quest that rewards 100 Westons will receive 100 - (IncomeTax * 100) Westons after tax is applied.

2. Value-Added Tax (VAT) (Market Transactions):

   • A VAT is applied to all player transactions on the marketplace, including item sales, services, and auctions.
   • The VAT rate is configurable via the EconomyVariables table.
   • Buyer: The buyer pays the total price (item price + VAT).
     • Example: If an item costs **500 Westons ** and the VAT rate is 10%, the buyer pays **550 Westons ** (500 Westons + 50 Westons VAT).
   • Seller: The seller receives the net amount (item price) and must pay the collected VAT to the server.
     • Example: The seller receives **500 Westons ** and must pay 50 Westons VAT to the server (which is automatically deducted).

The taxes and fees are configurable and stored in the EconomyVariables table:

• IncomeTax: The percentage tax applied to income from jobs and quests.
• VAT: The percentage tax applied to all marketplace transactions.
• CraftingModifier: Additional cost applied to crafting actions.
• SmeltingModifier: Additional cost applied to smelting actions.
• BrewingModifier: Additional cost applied to brewing actions.

Variable	Description	Example Value
IncomeTax	Tax applied to all job income	0.15 (15%)
VAT	Tax applied to all market transactions	0.10 (10%)
CraftingModifier	Additional cost for crafting actions	0.05 (5%)
SmeltingModifier	Additional cost for smelting actions	0.19 (19%)
BrewingModifier	Additional cost for brewing actions	0.334 (33.4%)

These taxes and fees help maintain balance within the server’s economy by regulating the amount of Westons players receive from jobs, quests, and market transactions.

---

The Westonia Economy System is designed for future flexibility and expansion, including:

• Bank Loans: Players may borrow Westons from the bank with interest.
• Interest System: Earn interest on deposited Westons in the bank.

This system provides the foundation for an engaging, player-driven economy in Westonia.