Getting Started
Welcome to Helge Village
Helge Village is a browser-based, multiplayer 2D Top-Down Farming RPG built with Next.js, React, Tailwind CSS, Phaser, and Colyseus. Players can plant crops, raise their levels, buy food, repair tools, and explore a shared persistent world in real-time.
Authoritative & Synced State
This game is designed with an authoritative Colyseus server. All player actions are synchronized directly to a MongoDB database to save your gold, level, energy, and inventory progress securely.Start your farming journey, socialize with other villagers through chat bubbles, complete daily quests to collect EXP, and compete for the top spot on the leaderboard!
Solana Wallet Connection
Helge Village integrates Web3 wallets (such as Phantom or Solflare) using standard Solana adapters. Connect your wallet to start playing.
💡 Your Wallet Security
The wallet connection is strictly Read-Only. The game will never ask for your seed phrase or private keys. The wallet is only used as a unique profile identifier to save your game progress permanently.If you don't have a Web3 wallet, you can still play using the local simulator with default initial stats to test the game offline.
Character Onboarding
When you first register with a connected wallet, you will be prompted to complete the character creation process:
- Username Tag: Define a unique username for your character (maximum 15 characters).
- Visual Clothes Style: Choose an initial clothes set (Style 1, 2, or 3) that will immediately show on your player sprite.
- Character Role: Choose your starting role (such as Farmer) to begin the adventure.
Once confirmed, your character data is saved in the MongoDB database and your character will immediately spawn in the center of the village!
Game World
Helge Village (Main Town)
The main game map is designed in a retro 2D pixel art style. Players spawn at the center coordinates `(240, 240)`. The village is surrounded by paths, trees, freshwater ponds for fishing, and essential facilities.
🌲 Map Layer Details:
- Ground & Ground Detail: Grass path layers decorated with small wild flowers.
- Above Layer: Thick tree canopies and rooftops that cover your character when walking underneath, providing visual depth.
- Interactables Layer: A special object layer containing farm plots and interaction hotspots for facilities.
Farming Plots
Farming plots are fertile soil patches where seeds can be planted. You can only plant seeds on designated farming plots defined on the map.
- Approach a fertile soil plot.
- Select a seed package from your hotbar.
- Left-click on the soil to plant it (consumes tool durability & energy).
- Water the soil to keep it damp so the crop can grow to maturity!
Village Facilities
Helge Village provides 4 main facilities that you can interact with by pressing [E] when standing nearby:
🛒 Shop
A marketplace to purchase random seed packs for 20 Gold, and sell your harvested crops and fish for gold coins.
🍛 Food House
The village kitchen where you can buy Fresh Bread (10 Gold) or Rice Bowls (25 Gold) to replenish energy and hunger levels.
🛏️ Sleep Inn
The village inn to fully restore your energy to 100% for a fee of 40 Gold with a 30-second sleep duration.
🔧 Tool Repair
A blacksmith workshop to repair tool durability (watering can and fishing rod) and upgrade them for better perks.
Core Systems
Core Gameplay Loop
The core gameplay loop of Helge Village is cozy yet tactical:
Character Stats
Your farming activity and survival are governed by two main stats in the top-left HUD:
- ⚡Energy (Yellow): Required to plant seeds and water crops. If your energy reaches 0, you cannot perform farming actions until it is restored.
- 🍗Hunger (Green): Represents your character's fullness. Hunger slowly decreases over time as you play.
Replenish hunger and energy by eating Bread or Rice Bowls from the Food House, or rent a room at the Sleep House to fully restore your energy to 100%.
Character Leveling System
Each time you harvest a mature crop, you gain Experience Points (EXP):
- 🌾 Harvesting Rice: rewards +10 EXP
- 🥬 Harvesting Vegetables: rewards +25 EXP
- 🍎 Harvesting Apple: rewards +50 EXP
- ⭐ Harvesting Golden Tree: rewards +100 EXP
The EXP threshold to level up is calculated as `Current Level * 100 EXP`. Upon leveling up, you will see a level-up notification and your new level will be displayed publicly above your character.
Fishing Mechanics
Cast your line in the village waters to gather fish, earn EXP, and generate profit.
🎣 How to Fish
- Equip Rod: Ensure the Fishing Rod (hotbar slot 9 or active selection) is equipped.
- Fishing Spot: Stand near water tiles classified as sea (
laut_1) or lake (danau). Click on the water to cast your line. - Waiting for Bite: Your status changes to WAITING. The wait duration depends on the fish type (5s for Common, 10s for Uncommon/Rare).
- React to Bite: Once a fish bites, the indicator changes to a flashing red ❗️ BITE!. You have exactly 2 seconds to click the screen to reel it in.
- Catch or Miss: Reel in successfully to receive a fish and its associated EXP. Timing it incorrectly (clicking too early or waiting over 2 seconds) will result in a miss!
Fishing reduces Fishing Rod durability by 1 point per cast. If durability drops to 0, you cannot fish until it is repaired at the Blacksmith.
Gameplay Controls
Keyboard Controls & Movement
Control your character's movement and actions using standard keys:
Tool Selection (Hotbar)
The hotbar at the bottom of the HUD contains 9 slots representing active farming tools or edible foods:
- Slot 1 (Harvest/Empty Hand): Used to harvest mature crops.
- Slot 2 (Watering Can): Used to water dry soil tiles.
- Slot 3 - 6 (Crop Seeds): Used to plant rice, vegetable, apple, or golden tree seeds.
- Slot 7 - 8 (Food): Used to eat food items from your inventory to instantly recover stats.
Multiplayer Chat & Bubbles
Since this is a real-time multiplayer game, you can chat with all online players in the same room.
Press [Enter] to focus the chat input bar in the bottom-left, type your message, and press [Enter] again to broadcast it.
Every time you send a message, the chat text floats in a bubble above your player sprite for 5 seconds, making local conversations intuitive and lively!
Game Economy
Crop & Fish Statistics
Full details of production requirements, timers, EXP gains, and sell values:
| Item | Energy Cost | Time Required | EXP Gained | Sell Price |
|---|---|---|---|---|
| 🌾 Rice | 2 Energy | 10 Seconds | +10 EXP | 2 Gold |
| 🥬 Vegy | 8 Energy | 60 Seconds | +25 EXP | 50 Gold |
| 🍎 Apple | 15 Energy | 90 Seconds | +50 EXP | 100 Gold |
| ⭐ Golden Tree | 20 Energy | 120 Seconds | +100 EXP | 200 Gold |
| 🐟 Common Fish | None (Rod dur.) | 5 Seconds | +15 EXP | 25 Gold |
| 🐠 Uncommon Fish | None (Rod dur.) | 10 Seconds | +35 EXP | 60 Gold |
| 🐡 Rare Fish | None (Rod dur.) | 10 Seconds | +75 EXP | 150 Gold |
Seed Pack Probability
Buying random seed packs for 20 Gold at the Shop draws from a gacha system. Rates improve significantly once your watering can is upgraded to Level 3 or higher:
Standard Rates (Lv. 1 - 2)
- 🌾 Rice Seed:50%
- 🥬 Vegetable Seed:34%
- 🍎 Fruit Seed:15%
- ⭐ Golden Tree Seed:1%
Premium Rates (Upgrade Lv. 3+)
- 🌾 Rice Seed:30%
- 🥬 Vegetable Seed:44%
- 🍎 Fruit Seed:23%
- ⭐ Golden Tree Seed:3%
Tool Upgrades & Perks
Upgrade your tools at the blacksmith workshop (Tool Repair) to unlock permanent passive bonuses:
💧 Watering Can
Watering Can Level 2
Speeds up crop maturation time by 10%.
Watering Can Level 3
Increases rates for high-tier seeds in the Shop.
Watering Can Level 4
Reduces planting energy cost by 20% and cuts watering energy cost to 0.
🎣 Fishing Rod
Fishing Rod Level 2
Significantly higher chance of catching Uncommon and Rare fish.
Daily Quests & 24h Reset
Daily quests can be completed by holding the required crops or gold. Claiming quests rewards you with EXP. Quests reset 24 hours after your last claim.