Skip to content

examples of the kind of stuff builders can create on top of the current MUD infrastructure

License

Notifications You must be signed in to change notification settings

projectawakening/builder-examples

Repository files navigation

alt text

Welcome to EVE Frontier Building!

Welcome, this repository contains guides and examples to get started building on EVE Frontier. For more information, you can visit https://docs.evefrontier.com/.

To start building, follow the steps below to setup your local development tools and environment. If you already have the tools, make sure they are the correct version as otherwise you may have difficulties running the examples and building.

Step 0: Installing general tools

Before you get started you need to either install, or make sure you have the required tools. Install these tools for Linux, if you use a different OS then visit https://docs.evefrontier.com/Tools and follow the guide for your operating system.

Installing Git

Install Git through https://git-scm.com/book/en/v2/Getting-Started-Installing-Git.

To confirm Git has been installed run:

git --version

Installing Node Version Manager

Install NVM by using this command:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

Restart the shell to use it.

Installing NPM

Install version 18 of NPM (Node.JS Version Manager) using NVM with:

nvm install 18

Installing PNPM

Install PNPM version 8, which is used as a more efficient version of NPM with:

npm install -g pnpm@latest-8

Step 0.1: Installing Foundry + Forge

Install foundry and restart the shell with:

curl -L https://foundry.paradigm.xyz | bash && source /root/.bashrc

Run the below command to install forge, cast, anvil and chisel:

foundryup

Step 0.2: Setting up your environment:

This guide will walk you through setting up a local environment for running a local Anvil node, deploying world contracts using Docker, and pulling ABIs.

Prerequisites

Make sure you have the Docker installed on your system: Installation Guide

Step 0.3: Deploying world contracts into a local node.

We have provided a docker compose file which bundles the running of the local node and deploying the world chain contracts to simulate the existing world. Run that with the command:

docker compose up -d

alt text

Monitor the progress of the world deployment with:

docker compose logs -f world-deployer

The deployment progress and relevant addresses will be displayed during the process. Once deployment is complete, you should see an output similar to the one below. Make sure to copy the world contract address and save it for future reference.

alt text

Step 0.4 (Optional): Retrieving world ABIs

You can also retrieve the world abis and save them to the root directory from the deployment by running:

docker compose cp world-deployer:/monorepo/abis .

Step 0.5: Start Building!

Now that your local tools and development environment is set up, you're ready to start building! To begin, simply navigate to the desired example directory (or use the links below) then follow the instructions outlined in its README file. For more information on Smart Assemblies you can visit this page on the documentation.

cd item-seller
cat readme.md

Bonus TIP

Run the local indexer, explore, interact and observe the state changes using world explorer

From any of the example root folder run the below command to run a local world explorer to see all the state changes

builder-examples/gate-keeper/
pnpm explorer <worldAddress>

eg: pnpm explorer 0x8a791620dd6260079bf849dc5567adc3f2fdc318

It looks like this

alt text

alt text

You can interact in the inteact tab and explore the values in the explore tab and also query using SQL commands

alt text

Guides

Smart Turret: View

Configure and deploy a Smart Turret smart contract, ready to be further developed.

Item Seller: View

Create a Smart Storage Unit (SSU) which can accept ERC20 tokens to transfer items to players.

Smart Gate: View

Configure and deploy a Smart Gate smart contract, ready to be further developed.

Vending Machine: View

Create a Vending Machine Smart Storage Unit (SSU) in the game which trade items between the owner and players.

Gate Keeper: View

Create a Smart Storage Unit (SSU) which can accept item donations toward a specific goal.

About

examples of the kind of stuff builders can create on top of the current MUD infrastructure

Resources

License

Stars

Watchers

Forks

Packages

No packages published