BibliothecaDAO/loot-survivor — 89 Stars

Topics

#blockchain #cairo #cairo-lang #focg #onchain #web3

Language breakdown

No language data available.

▸ Files click to expand

README

background

🪦 Loot Survivor

Go and die with glory

Play Loot Survivor

Table of contents

Game Design
Technology
Infrastructure
Contributing

🕹️ Game Design

Loot Survivor is an onchain Arcade machine game. You add some tokens, try to get the highscore and live for eternity onchain.

Each play through will be different and there is no end to the game. Every level just gets progressively harder.

Game Statistics

Each level up grants adventurers 1+ upgrade to help them survive their explorations. Although Luck cannot be upgraded directly, it can be increased by equipping jewelry items:

Strength: Boosts attack damage by 10%.
Vitality: Increases health by +20ph and max health.
Dexterity: Improves chances of successfully fleeing.
Wisdom: Helps evade Beast ambushes.
Intelligence: Aids in avoiding Obstacles.
Luck: Raises chances of critical damage (cannot be upgraded directly).

Combat Logic

There are three categories of weapons and armor materials:

Weapons: Blade, Bludgeon, Magic

Armor materials: Cloth, Hide, Metal

Weapon vs. Armor Efficacy Chart

| Weapon Type | Metal | Hide | Cloth | |-------------|-------|------|-------| | Blade | Weak | Fair | Strong| | Bludgeon | Fair | Strong| Weak| | Magic | Strong | Weak | Fair |

Weapons and Materials

Weapons

The items are based off the OG loot contract

Weapon
Head
Chest
Hands
Waist
Feet
Neck
Ring

Weapon Types and Ranks

| Weapon Type | Item Name | Rank | |-------------|---------------|------| | Blade | Katana | 1 | | Blade | Falchion | 2 | | Blade | Scimitar | 3 | | Blade | Long Sword | 4 | | Blade | Short Sword | 5 | | Bludgeon | Warhammer | 1 | | Bludgeon | Quarterstaff | 2 | | Bludgeon | Maul | 3 | | Bludgeon | Mace | 4 | | Bludgeon | Club | 5 | | Magic | Ghost Wand | 1 | | Magic | Grave Wand | 2 | | Magic | Bone Wand | 3 | | Magic | Wand | 4 | | Magic | Grimoire | 1 | | Magic | Chronicle | 2 | | Magic | Tome | 3 | | Magic | Book | 4 |

Encounters

Beasts
Obstacles

🏗️ Contributing

The game is a work in progress and contributions are greatly appreciated.

⛓️ Technology

Loot Survivor is an onchain game, designed to be immutable and permanently hosted on Starknet. We use advanced gas optimization to reduce costs on Starknet. A player's gamestate exists primarily in a single felt252, every action the player takes only updates a single storage slot.

Client: Nextjs
Indexer: Apibara
Graphql: Strawberry, AIOHTTP
Contracts: Cairo 1.0

🖥️ Infrastructure

Servers

Goerli

Indexer: Northflank loot-survivor-indexer
Mongo DB: Northflank loot-survivor-mongo-goerli
Graph QL: Northflank loot-survivor-graphql

Deploying

Setup Starkli Account

bash scripts/starkli_setup.sh

Deploy Contract

bash scripts/deploy.sh.sh

Run UI

cd ui
yarn dev

Deploy Katana & Run UI

bash scripts/katana/setup.sh

Play

Mint $lords and approve LS to spend

source "/workspaces/loot-survivor/.env"
starkli invoke $LORDSADDRESS mint 0x1feb9c05d31b70a1506decf52a809d57493bfcd5cc85d6a3e9fd54a12d64389 1000000000000000000000 0 --account $STARKNETACCOUNT --private-key $PRIVATE_KEY
starkli invoke $LORDSADDRESS approve $CONTRACTADDRESS 1000000000000000000000 0 --account $STARKNETACCOUNT --private-key $PRIVATEKEY

Start New Game

starkli invoke $CONTRACTADDRESS newgame 0x020b96923a9e60f63a1829d440a03cf680768cadbc8fe737f71380258817d85b 12 123 0 0 0 --account $STARKNETACCOUNT --private-key $PRIVATEKEY

Explore

starkli invoke $CONTRACTADDRESS explore $ADVENTURERID 0 --account $STARKNETACCOUNT --private-key $PRIVATEKEY

Attack Starter Beast

starkli invoke $CONTRACTADDRESS attack $ADVENTURERID 0 --account $STARKNETACCOUNT --private-key $PRIVATEKEY

Upgrade Adventurer

starkli invoke $CONTRACTADDRESS upgrade $ADVENTURERID 0 $CHARISMA 1 --account $STARKNETACCOUNT --private-key $PRIVATEKEY

View Adventurer Details

Adventurer State

starkli call --watch $CONTRACTADDRESS getadventurer $ADVENTURERID 0 --account $STARKNETACCOUNT --private-key $PRIVATE_KEY

Get Adventurer Health

starkli call --watch $CONTRACTADDRESS gethealth $ADVENTURERID 0 --account $STARKNETACCOUNT --private-key $PRIVATE_KEY

Get Adventurer Gold

starkli call --watch $CONTRACTADDRESS getgold $ADVENTURERID 0 --account $STARKNETACCOUNT --private-key $PRIVATE_KEY

Get Adventurer XP

starkli call --watch $CONTRACTADDRESS getxp $ADVENTURERID 0 --account $STARKNETACCOUNT --private-key $PRIVATE_KEY

Get number of stat upgrades available

starkli call --watch $CONTRACTADDRESS getstatupgradesavailable $ADVENTURERID 0 --account $STARKNETACCOUNT --private-key $PRIVATE_KEY

🔗 More in this category