MoversMap
V2 Official Docs

The World is
Your Map.

MoversMap is an interactive, community-driven Web3 map built on the Movement Network. Drop your pin, explore treasures, battle in hub wars, and connect with the global Movement community, all gasless, all on-chain.

�️
Chapter 01
Getting Started
Sign in and drop your first pin on the map

MoversMap supports two ways to get in, pick the one that works for you:

✉️
Google / Email Login
Sign in with your Google account or email via Web3Auth. An embedded wallet is created automatically, non-custodial, meaning you keep full custody via your email. No extensions needed.
🔑
External Wallet
Connect a Movement-compatible wallet like Nightly or Razor. You keep full custody and control of your assets at all times.

Dropping Your First Pin

Once you're signed in, claiming your spot on the map takes under a minute:

1
Click the bouncing PIN button on the map
2
Click your spot on the map to place the pin
3
Enter your username and a short comment or bio
4
Upload an optional avatar (JPEG, PNG, WebP, or GIF up to 5 MB, auto-compressed)
5
Add your social handles: X (Twitter) is required, Discord and TikTok are optional but all must be unique across the map
6
Hit Submit and your pin is stored on-chain (gasless transaction) and live for the world to see!
One pin per wallet. Each wallet address can only have one personal pin. You can edit it anytime from "My Notes" in the dashboard.
🧭
Chapter 02
The Map & Pinning
The beating heart of MoversMap

The map is where everything happens. Every pin tells a story, whether it's a community member, a business, a guild, or a hub. Updates happen in real-time as the Movement ecosystem grows and evolves.

Types of Pins on the Map

📍
Personal Pins
Your own pin stores your username, bio, avatar, social handles, location, active frame, guild membership, hub membership, and more. One pin per wallet.
🏛️
Business & Project Pins
Web3 projects and businesses can list themselves on the map with descriptions, categories, galleries, services, and user reviews, reaching the entire Movement community.
⚔️
Guild Pins
Members of the six Parthenon guilds display their guild affiliation on their pins: Creators, Explorers, Spartans, Scholars, Pathfinders, and Masons.
🌐
Hub Pins
Movement Hubs like Hanoi, Jakarta, HCMC, Taipei, İstanbul, and Germany are represented as pins where local communities gather and coordinate.

When you zoom out, pins cluster together, click any cluster to zoom in and explore individual community members, businesses, and organizations.

Unique handles: Your Twitter, Discord, and TikTok handles are unique across the entire map. Only one user can claim each handle, this prevents impersonation and duplicate profiles.
⚖️
Chapter 03
Marketplace
Frames, Relics, and Warriors: buy with $MOVE or Map Points

The Marketplace has three item categories. Everything can be purchased with either $MOVE tokens or Map Points.

🖼️ Pin Frames

Frames change the visual border around your pin on the map. Only one frame can be active at a time, but you can switch between owned frames freely.

Frame$MOVEMap PointsRarity
Crown Frame6090,000Legendary
Pirate Flag4070,000Legendary
Female Pirate Hat3060,000Epic
Male Pirate Hat3060,000Epic

🔮 Relics

Relics are reusable tools for treasure hunting and visibility, each with a 24-hour cooldown after use. You can use different relics on the same day.

🛡️ Relic-Proof Treasures: Some treasures are marked as Relic-Proof (shown with a shield badge on the map). These cannot be revealed by any relic — they can only be discovered through manual exploration.

🪙
Voyager Coin
Reveals 1 random active User or Project treasure and navigates directly to it. Skips Relic-Proof 🛡️ treasures.
Legendary 70 $MOVE / 30,000 pts
🗺️
Treasure Map
Reveals 1 random active Map Treasure, which can contain points, roles, or frames. Skips Relic-Proof 🛡️ treasures.
Epic 50 $MOVE / 20,000 pts
🔭
Navigator Scope
Takes you 50% closer to a random treasure, no exact location revealed. Coming Soon.
Rare coming soon...
The Unhidden One
Spotlights your pin on the entire map for 24 hours. Only 1 spotlight can be active at a time.
Legendary 15 $MOVE / 5,000 pts

⚔️ Conquest Warriors

Warriors are combat units deployed in Conquest battles (hub, guild, or movers). Buy multiples to increase your power. All purchased items appear in your Dashboard under "My Items."

Warrior$MOVEMap PointsPowerRarity
Knight Level 131,50025/100Common
Knight Level 273,50050/100Rare
Undead Berserker105,00080/100Epic
Wizard105,000Scout (60 min)Legendary

🏰 Custom Castle Pin

The Custom Castle Pin is the ultimate premium pin on MoversMap. Request one from the Marketplace and our team will design a custom castle for your pin. Payment is on-chain via the marketplace smart contract.

Type$MOVEMap PointsDescription
Personal2,0001,000,000Custom castle pin for your personal profile
Business / Project3,0001,500,000Custom castle pin for your project or brand

After purchasing, our team will contact you via Discord within 24 hours to begin designing your custom castle pin.

🏺
Chapter 04
Treasures
Hidden rewards scattered across the real world

Treasures are hidden rewards planted across the map. There are three types, each with different origins and prize pools.

👤
User Treasures
Created by approved community "Planters." Rewards are defined by the creator: crypto, NFT access, or custom prizes.
�️
Project Treasures
Placed by companies and project sponsors. Rewards include promotional items, NFT whitelists, and $MOVE tokens.
🗺️
Map Treasures
Planted by MoversMap admins. These contain Map Points, Discord Roles, and exclusive Frames.

How to Claim a Treasure

1
Open the Treasure Panel and filter by type (User / Project / Map)
2
Zoom into the required zoom level and search the area, treasures only appear when you're close enough on the map. Explore the region to find them
3
Click "Claim" and fill in the required fields: X username, Discord, secret code (if required), and tweet (if needed)
4
Confirm, the transaction processes gaslessly on-chain and your reward is delivered instantly
Want to become a Planter? Any user can apply from the Dashboard. Once approved by admins, you can create and hide your own treasures across the world.
🌱
Chapter 04b
Planting Treasures
Become a Planter and hide your own rewards on the map

Approved Planters can create and hide their own treasures across the world. Here's everything you need to know.

Apply for Planter Access

1
Open the Dashboard and navigate to the Planter section
2
Fill in your Name / Organization and X (Twitter) username
3
Submit your application — an admin will review it within 24–48 hours
4
Once approved, you'll gain access to the Create Treasure form

Create Your Treasure

1
Give your treasure a Name and Description — make it exciting for hunters!
2
Set the Location Scope: World (random global), Continent, Country, or Specific coordinates (click locations on the map)
3
Choose Quantity (how many treasure instances to place) and Max Claims Per Wallet
4
Set a Start Date and End Date for when the treasure hunt is active
5
Pick a Difficulty level (1–15+) from Very Easy to Expert — this controls the zoom level required to find it
6
Optionally add a Secret Code that claimers must enter, a Custom Icon (PNG, max 1MB), and a Custom Tweet Template
7
Select a Reward Type: Map Points, Discord Role, or Map Frame — then set the reward value
8
Submit! Your treasure will be reviewed by admins before going live on the map
⚠️ Planter treasures require admin approval before they appear on the map.
🌍
Location Scopes
World — random locations globally
Continent — scattered across a chosen continent
Country — hidden within a specific country
Specific — you pick exact map coordinates
🔒
Security
All treasure locations are encrypted on the server. No one can cheat by inspecting network requests — locations only reveal at the correct zoom level.
🎨
Customization
Upload a custom icon, write a personalized claim message, and create a tweet template that claimers share when they find your treasure.
⚔️
Chapter 05
Quests
Daily, weekly, and one-time tasks that earn Map Points

Quests are the main way to earn Map Points. Complete them daily and weekly to climb the leaderboard and unlock exclusive rewards.

Your profile tracks your total points, quests completed, current streak, and last activity date. Keep your streak alive for consistent rewards.

🏛️
Chapter 06
Guilds: The Parthenon
Six guilds, one allegiance, choose wisely

Six guilds represent distinct playstyles and community roles. When you join, you're part of something bigger; guilds compete for weekly Map Point rewards based on active membership.

✍️ Creators
Storytellers & Designers
Artisan craftsmanship, guild frames, custom banners. The artists and content creators of the Movement.
🧭 Explorers
Evangelists & Builders
Trailblazing, territory banners, exclusive frames. Community builders who expand the Movement's reach.
⚔️ Spartans
Warriors & Testers
Battle tactics, warrior frames, conquest bonuses. On-chain warriors and protocol stress-testers.
📚 Scholars
Writers & Educators
Wisdom keeping, educational frames, ancient map overlays. The knowledge keepers of the ecosystem.
🌿 Pathfinders
Moderators & Leaders
Navigation frames, waypoint markers. Community moderators and welcoming leaders.
🪨 Masons
Master Builders
Shrouded in mystery. Coming soon, the architects of something extraordinary.
30-Day Lock: Once you join a guild, you cannot switch to another for 30 days. Pick the one that truly represents you.

Weekly Guild Rewards

RankWeekly Reward Per Member
🥇 1st Place10,000 Map Points
🥈 2nd Place7,000 Map Points
🥉 3rd Place5,000 Map Points
4th–5th Place3,000 Map Points
⚠️ Rewards must be claimed weekly. Missed claims are lost, points do not carry over.
Chapter 07
Movement Hubs
City-based communities for real-world connection

Movement Hubs are city-based communities, real-world gathering points for the Movement Network. Your eligibility is determined by your pin's location.

HubCityCountry
🇻🇳 Movement Hub HanoiHanoiVietnam
🇮🇩 Movement Hub JakartaJakartaIndonesia
🇻🇳 Movement Hub HCMCHo Chi Minh CityVietnam
🇹🇼 Movement Hub TaipeiTaipeiTaiwan
🇹🇷 Movement Hub İstanbulİstanbulTurkey
🇩🇪 Movement Hub GermanyBerlinGermany

Each hub features a Members List, a Photo Gallery, Events organized by hub leaders, and participation in Conquest battles. You can only join a hub in your region, hubs outside your pin's location are not available. You can only be in one hub at a time, but there's no lock period, so you can leave and rejoin freely.

🏰
Chapter 08
Conquest: Hub, Guild & Movers Wars
Hub-vs-hub, guild-vs-guild, and free-for-all strategy battles for territorial control

Conquest is a real-time battle system with three modes. Hub Battles pit hubs against each other for city-level control. Guild Battles pit the five guilds (Spartans, Explorers, Creators, Scholars, Pathfinders) against each other for guild supremacy. Movers Battles are free-for-all individual battles where every mover fights for themselves using their username as their identity. All modes share the same strategic locations, warrior mechanics, and fatigue system. Deploy warriors to control locations, earn points, and lead your team (or yourself) to victory.

🏰
Castle
2 pts / second
🗼
Stronghold North
1 pt / second
🗼
Stronghold East
1 pt / second
🗼
Stronghold West
1 pt / second

Fatigue System

  • Warriors fight at full power when freshly deployed
  • Fatigue thresholds vary by warrior — expensive warriors stay strong longer:
  • Knight Lv1: 2h fatigue / 4h severe
  • Knight Lv2: 3h fatigue / 6h severe
  • Undead Berserker: 4h fatigue / 8h severe
  • Wizard (Scout): No fatigue
  • Fatigue reduces power to 50%, severe fatigue to 25%
  • Relocate warriors between locations to adapt strategy, but relocating does not reset fatigue
  • All locations award 2× points in the final 60 minutes of battle

Runner-Up Scoring

You don't need to be #1 to earn points. At every location, the 2nd most powerful team or mover earns points simultaneously alongside the controller — at 30% of the normal rate.

  • Castle: Controller earns 2 pts/sec, runner-up earns 0.6 pts/sec
  • Strongholds: Controller earns 1 pt/sec, runner-up earns 0.3 pts/sec
  • 3rd place and below earn nothing at that location
  • During Frenzy Hour (last 60 min), both rates are doubled
  • Runner-up points are added to your total score — there's no separate display
  • If the runner-up overtakes the controller, they swap roles and rates instantly
  • Works in all modes: hub wars, guild wars, and movers battles

This means spreading warriors across multiple locations is a viable strategy — even if you can't take #1 everywhere, holding 2nd place still earns points toward victory.

Winning a Conquest

The team or mover with the highest total points at the end of battle wins the Conquest. Total points include both 1st-place and runner-up earnings from all locations throughout the battle. In hub battles, the winning hub's flag is flown on the Conquest pin on the map. In guild battles, the winning guild's banner is displayed on structures. In movers battles, the champion's username is displayed on the victory castle and can be clicked to navigate to their pin.

Rewards

Each Conquest battle has its own reward pool, announced before the battle begins. Rewards vary per battle and can include any combination of the following:

🏆 MAP (Map Activity Points)

  • Conquest Action: 50 MAP per deploy action (up to 3/day)
  • Winner Bonus: Bonus MAP awarded to the winning team or champion
  • MAP contributes to your position on the Activity Leaderboard

💰 Token Rewards

  • $MOVE tokens: Distributed to winners and top performers in select battles
  • USDC: Stablecoin prizes may be included in sponsored or high-stakes battles
  • Partner tokens: Collaborating projects may sponsor battles with their own tokens
  • Token reward amounts and distribution rules are announced per battle

🏰 Custom Castle Rewards

  • Victory Castle: The winner's name or hub flag is displayed on the castle structure on the map
  • Movers Battle Champion Castle: The winner of a Movers Battle gets a custom castle displayed on the map with their name — it stays until the next Movers Battle winner takes the throne
  • Custom Castle Skins: Special visual themes for the castle unlocked by winning specific battles
  • Castle Banner: In hub/guild battles, the winner's banner flies on the castle until the next battle
  • Castle rewards are visible to all users on the map — a public badge of honor

🏅 Conquest Medals & Badges

  • Gold Medal: Awarded to the 1st place winner of each Movers Conquest battle
  • Silver Medal: Awarded to the 2nd place finisher
  • Bronze Medal: Awarded to the 3rd place finisher
  • Medals are permanently displayed on your profile pin and accumulate across battles
  • Click on a mover's medals to see their full conquest history
  • Champion Title: The overall winner earns a visible champion badge on their profile

🎁 Exclusive Rewards

  • NFTs & Relics: Select battles may award exclusive NFT collectibles or in-app relics
  • Marketplace Items: Winners may receive exclusive warriors, frames, or other marketplace items
  • Early Access: Battle champions may receive early access to new MoversMap features

Note: Specific rewards for each Conquest are announced before the battle starts. Check the Conquest panel or announcements channel for the latest reward details.

�️
Chapter 09
Business & Project Listings
Put your project on the map, literally

Businesses and Web3 projects can list themselves on MoversMap to reach the Movement community. Listings span 15 categories including DeFi, NFT, Gaming, Education, E-commerce, and more.

Submit your listing with a name, description, category, location, and optional logo. It enters pending status for admin review, once approved, it appears as a business pin on the map. Each listing supports a gallery of up to 10 images, a list of up to 5 services, user reviews with star ratings, and a likes counter.

📜
Chapter 10
Bounties
Community tasks with real rewards

Bounties are community tasks posted by MoversMap and partner organizations. Categories include Dev, Creator, Thread, Design, and Research. All bounty submissions are recorded on-chain and completely gasless.

A bounty moves through the following lifecycle:

Draft Upcoming Live In Review Ended
Submission Cost: Each new bounty submission costs 1,000 Map Points, deducted on submit. Editing an existing submission is free.

Rewards are paid in USDC, $MOVE and USDT on the Movement Network depending on the bounty, distributed either equally among winners or in tiered placements (1st, 2nd, 3rd, etc.). Winners are recorded in the Hall of Fame and earn the Bounty Winner badge.

Chapter 16
Memories & Photos
Pin your moments to the world, minted as NFTs on-chain

Upload photo memories tied to real map locations, share moments from Movement community events, meetups, or everyday adventures. Each memory is minted as an NFT on-chain on the Movement Network, giving you permanent, verifiable ownership of your moments.

1
Click the Gallery icon on the map
2
Click the bouncing pin button inside the gallery modal
3
Pick or auto-detect your location on the map
4
Upload a photo or take one directly via camera on mobile
5
Add an optional description
6
Submit and your memory is minted as an NFT on-chain and appears on the map for everyone to see
Supported formats: JPEG, PNG, WebP, GIF, max 5 MB, auto-compressed to WebP. Limit: 2 uploads per wallet per day, resetting at midnight UTC.
📦
Chapter 13
Gifts & Sending $MOVE
Send $MOVE to any user on the map, instantly
1
Click on a user's pin or memory pin on the map
2
Click the gift icon on their profile
3
Enter the amount of $MOVE you want to send, even fractional amounts like 0.5 $MOVE work
4
Confirm the transaction, the transfer completes instantly on-chain

All gifts are recorded with sender, recipient, amount, timestamp, and transaction hash. Gifts count toward your gift quest progress, and a Top Gifters ranking tracks the most generous users in the community.

👑
Chapter 11
Leaderboard
Top 20 Champions, Top Gifters, and Top Treasure Hunters

The Leaderboard has three tabs: Activity (MAP based on platform engagement), Top Gifter (most generous $MOVE senders), and Top Hunter (most treasures claimed). The top 3 earn 🥇🥈🥉 medals on their profile. If you're on the board, your own rank is highlighted. In case of a tie, the user who earned their points first ranks higher.

How to Earn MAP

MAP is a type of points earned by engaging and interacting with the map frequently. MAP is not a token and there are no plans to make it one. It simply measures your overall activity on MoversMap. Earn MAP by engaging with the platform in different ways.

Action MAP Cap
📍 Drop a Pin100One-time
🎁 Send a Gift503/day
📋 Submit Bounty
Submissions only — edits don’t count
300 No cap
🏆 Win Bounty500No cap
💭 Save a Memory501/day
🏛️ Join a Hub500One-time
🛡️ Join a Guild100One-time
⚔️ Conquest Action503/day
🛍️ Marketplace Purchase503/day
⛓️ Refer a Friend250No cap
🖼️ Wear a Frame50Per day
🔮 Use a Relic100No cap
ℹ️ MAP is automatically awarded within 24 hours. Tap the ℹ info icon in the Activity tab to see the full breakdown anytime.
Chapter 12
Wallet & Transactions
Gasless. Always.
100% Gasless: All transactions on MoversMap are gasless. Gas fees are sponsored by Shinami infrastructure, you never pay to claim, send, deploy, or buy.

If you signed in with Google or email, Web3Auth auto-created an embedded wallet for you. You can also link an external wallet as a secondary wallet, both wallets can interact with MoversMap, and both are checked for OG Badge eligibility.

⛓️
Chapter 14
Referrals
Grow the Movement, bring your people

Share your personal referral link (moversmap.xyz/?ref=YOUR_USERNAME) and when a new user clicks it and creates a pin, you're recorded as their referrer. Referral rewards in Map Points and $MOVE bonuses are coming in a future update.

Chapter 15
Badges
Collectible achievements on your profile
🏅
OG Explorer
Awarded to users who had a pin on MoversMap V1. Both your primary and secondary wallets are checked against ~1,924 verified OG wallets.
👑
Bounty Champion
Earned by winning at least one bounty. Multiple wins stack, shown as ×2, ×3, and so on.
🔮
Chapter 17
AI Helper
Your in-app guide to everything MoversMap

The AI Helper is a built-in assistant that answers questions about any MoversMap feature in natural language. It covers 60+ topics, from "What's a pin?" to "How does Conquest fatigue work?", and adapts guidance contextually based on what you're currently doing. Use the floating tips button for random feature highlights, or chat directly for instant answers.

Chapter 20
Quick Reference
All costs, limits, and free actions at a glance
⛽ Free Actions: Zero Gas, Always
  • Claiming treasures
  • Sending $MOVE gifts
  • Joining guilds and hubs
  • Marketplace purchases
  • Deploying Conquest warriors
  • All other on-chain actions
ActivityLimit
Pins per wallet1
Active frame1 at a time
Hub membership1 at a time
Guild membership1 at a time (30-day lock)
Memory uploads2 per day
Gift sendingUnlimited, gasless
Spotlight (Unhidden One)1 active at a time
Bounty submission cost1,000 Map Points
🌐
Chapter 21
Socials & Links
Connect with MoversMap across the web

🗣️ Community

𝕏
X (Twitter)
@MoversMap
✈️
Telegram
t.me/moversmap
💬
Discord
discord.com/invite/NTytthPS3d

🔗 Platform Links

🗺️
Map
moversmap.xyz
📊
Dashboard
moversmap.xyz/dashboard
📜
Bounties
moversmap.xyz/bounty
🛡️
Chapter 22
Privacy Policy & Terms
Legal information, data handling, and wallet responsibility

🗺️ About MoversMap

MoversMap is an interactive Web3 exploration platform built on the Movement blockchain. Users can pin locations, discover treasures, upload photo memories, join community hubs, complete quests, and explore the Movement ecosystem, all on an interactive world map.

👁️ Privacy Policy

  • All data contributed by users (pins, comments, photos, social handles) is publicly visible on the map. By using MoversMap, you consent to this public display.
  • We collect wallet addresses (public blockchain addresses), optional social handles (X, Discord, TikTok), and approximate location data you choose to share when pinning.
  • No passwords, private keys, or seed phrases are ever collected or stored by MoversMap. Your wallet is entirely self-custodial.
  • Photo memories are stored on our servers and displayed publicly. Do not upload content you do not wish to be publicly accessible.
  • We may use anonymized, aggregated analytics data (page views, feature usage) to improve the platform. No personal data is sold to third parties.

💰 Wallet & Funds Responsibility

  • You are solely responsible for your wallet and funds. Whether you use an external wallet (Nightly, Razor, etc.) or a Web3Auth embedded wallet (created via Google/email login), you hold the keys and control your assets.
  • MoversMap does not have access to your private keys, seed phrases, or the ability to move your funds. All on-chain transactions require your explicit approval.
  • Embedded wallets (Web3Auth) are secured by Web3Auth's infrastructure. MoversMap is not responsible for any loss of access to embedded wallets. We recommend exporting your private key and storing it securely.
  • MoversMap is not liable for any loss of funds resulting from user error, phishing, unauthorized wallet access, smart contract interactions, or blockchain network issues.
  • Gasless transactions are sponsored by MoversMap via Shinami as a convenience. This sponsorship may be modified or discontinued at any time.

📜 Terms & Conditions

  • By pinning your location, uploading memories, claiming treasures, or interacting with the map in any way, you accept these terms and our privacy policy in full.
  • You agree not to post harmful, misleading, offensive, or illegal content. MoversMap reserves the right to remove any content or restrict accounts that violate community standards.
  • Treasure rewards are provided by individual creators (Planters) or by admin. MoversMap is not responsible for third-party reward fulfillment. You may report creators who fail to distribute rewards.
  • The platform is provided "as is" without warranties of any kind. We do not guarantee uptime, accuracy of map data, or continuous availability of any features.
  • Marketplace purchases (frames, relics) are final on-chain transactions. Refunds are not available for blockchain-based purchases.
  • MoversMap may update these terms at any time. Continued use of the platform after changes constitutes acceptance of the updated terms.

⭐ Credits & Attribution

🛡️ By using MoversMap, pinning, uploading memories, claiming treasures, or any interaction, you acknowledge and accept these terms.