BUILDHOODS DOCUMENTATION

Build your Hood.
Build your Crew.
Compete for the city.

Official documentation for BuildHoods accounts, Hoods, Crews, rewards, PvP and the game economy.

LIVE SYSTEMSACTIVE DEVELOPMENT

What is BuildHoods?

LIVE

BuildHoods is a wallet-based city game where a player controls a BuildHoods account, develops Hoods, competes on leaderboards and can join forces with other players through Crews.

Your wallet proves ownership of your account. BuildHoods game data such as your player profile, username and Crew membership is stored securely by the BuildHoods backend.

Getting Started

01
Connect Wallet
02
Sign Login Message
03
Choose Username
04
Enter BuildHoods

New players connect a supported wallet, sign a BuildHoods login message and choose a unique username before accessing authenticated game features.

Wallet & Player Login

LIVE

Connecting a wallet and signing in are two separate steps. Connecting allows BuildHoods to see the wallet address. Signing the BuildHoods login message verifies that the player actually controls that wallet.

Signing in does not create a blockchain transaction.
The login message does not spend ETH and does not require gas.

BuildHoods Username

LIVE

Every player must choose a unique BuildHoods username. Usernames belong to the player account, not to an individual Hood.

Username rules
  • 3–20 characters.
  • Letters, numbers and underscore.
  • Unique across BuildHoods.
  • Players may change their username later.

Hoods

IN DEVELOPMENT

Hoods are the core playable city assets in BuildHoods. The new live ownership and Hood Power system is being connected to the BuildHoods backend.

Each Hood will maintain its own progression and power rather than sharing one combined player power value.

Production Leaderboard

LIVE

The live leaderboard uses BuildHoods player accounts from the new BuildHoods database. Production and Hood Power values will expand as the new Hood ownership system is completed.

Crews

LIVE

Crews allow BuildHoods players to organize into groups for cooperation, attack and defense.

PUBLIC

Open Membership

A player may join immediately when space is available.

INVITE ONLY

Approval Required

A player sends a join request. Crew management approves or rejects the request.

A player may belong to only one Crew at a time and may have only one pending join request.

Crew Roles

OWNER
Controls Crew management, officers and settings.
OFFICER
Assists with Crew management and join requests.
MEMBER
Standard Crew participant.

Officers are appointed manually by the Owner. Members are never automatically promoted to Officer.

Crew Ownership Succession

RULESET DEFINED

When the current Owner leaves the Crew, ownership follows a defined succession order:

  1. 1. The earliest joined Officer becomes Owner.
  2. 2. If there is no Officer, the earliest joined Member becomes Owner.
  3. 3. No Member is automatically promoted to Officer.
  4. 4. If no members remain, the Crew is deleted.

The new Owner may manually choose which Member should become an Officer.

Crew Fights

COMING SOON

Crew battles will contain both Attack and Defense activity. Active fights and historical fights will be available from the Crew page.

DateAttack / DefendOpponentWin / LossLoot

HOOD Rewards

IN DEVELOPMENT

Reward production is being migrated to the new BuildHoods live game system. Final production, claiming and Hood Power rules will be documented here as they are activated.

NFT Store

LIVE PAGE

The BuildHoods NFT Store displays game utility assets including the Upgrade NFT and other BuildHoods game assets.

OPEN NFT STORE →

Wallet Security

BuildHoods never needs a player's wallet private key or recovery phrase.

Never share your seed phrase.

BuildHoods authentication uses wallet message signatures. A legitimate login request should not ask you to reveal your private key or seed phrase.

Feature Status

FEATURESTATUS
Wallet LoginLIVE
Player UsernameLIVE
Leaderboard AccountsLIVE
Crew CreationLIVE
Public Crew JoinLIVE
Invite Join RequestsLIVE
Crew MembersLIVE
Leave CrewLIVE
Hood OwnershipIN DEVELOPMENT
Hood PowerIN DEVELOPMENT
Crew BattlesCOMING SOON
Crew Fight HistoryCOMING SOON

FAQ

Do I need to pay gas to log in?

No. BuildHoods login uses a signed wallet message and does not create a blockchain transaction.

Can I change my username?

Yes. Your BuildHoods username can be changed from your player account.

Can I join more than one Crew?

No. A player can belong to one Crew at a time.

Does a Public Crew require approval?

No. Public Crews allow immediate joining when space is available.

What happens if the Crew Owner leaves?

The earliest joined Officer becomes Owner. If no Officer exists, the earliest joined Member becomes Owner.

BuildHoods Documentation