Saga Multiverse: Retrocity

Welcome to the Saga Multiverse: Retrocity GitHub repository! This repository contains the Unity game project along with the smart contracts used in the game. Retrocity is an exciting 3D game where players use NFT avatars, complete quests, collect cassettes, and explore magical worlds.

Project Setup

To set up the Retrocity project, please follow these steps:

1. Clone the repository to your local machine using the following command:

   git clone https://github.com/andreykobal/saga-multiverse-hackathon.git
   

2. Open the Unity game project that is located in /unity-project using Unity Hub or your preferred Unity editor.

3. Install the necessary dependencies and packages required for the project.

4. Configure the Unity project settings as needed and ensure that the project is properly configured for your target platform.

5. Set up the Metamask extension in your preferred browser and create a wallet.

6. Configure the Saga Multiverse chainlet, connect your Metamask to the network and obtain the necessary testnet tokens Saga CLI Quickstart Guide

7. Build and run the game to start playing Retrocity!

Smart Contract Deployment

To deploy the smart contracts using Hardhat, please follow these steps:

• Clone this and run npm i in terminal.
• Add .env file with:

MNEMONIC=privatekey. not the seedphrase

• Edit the deploy script to pass in your name and ticker/uri depending on standard
• Edit the contractUri method in the contract and add your OpenSea collection URI
• Edit the mint script and add your token uri, contract address and account address of the account you want to mint to.
• Deploy with npx hardhat run --network scripts/deploy721.js for ERC-721
• • Deploy with npx hardhat run --network YOUR_NETWORK scripts/deploy1155.js for ERC-1155
• Mint with npx hardhat run --network YOUR_NETWORK scripts/mint.js
• Check balance of ERC-1155 with npx hardhat run --network YOUR_NETWORK scripts/balances.js

Contract code inspired from Opensea: https://github.com/ProjectOpenSea/meta-transactions/blob/main/contracts/ERC721MetaTransactionMaticSample.sol This is for gas-less transactions when transferring assets. Users dont have to pay that extra gas, and get a better experience.

Smart Contract Code Highlights

GameItem.sol

The GameItem.sol contract is responsible for managing the 721 non-fungible token (NFT) avatars in Retrocity. Players can purchase avatars and own them using this contract.

Important code snippets from GameItem.sol:

• mintItem function: This function mints a new avatar NFT with the provided token URI and assigns it to the caller's address.

  function mintItem(string memory tokenURI) public payable {
      // Mint a new avatar NFT and assign it to the caller's address
      // ...
  }

GameItems.sol

The GameItems.sol contract handles the 1155 semi-fungible token (SFT) cassettes in Retrocity. Players can collect these cassettes and use them to claim rewards.

Important code snippets from GameItems.sol:

• batchMint function: This function allows the batch minting of diamond tokens with the provided token URIs and assigns them to the caller's address.

  function batchMint(string[] memory tokenURIs) public {
      // Batch mint diamond tokens and assign them to the caller's address
      // ...
  }

• getTotalBalance function: This function returns the total balance of cassettes owned by a specific address.

  function getTotalBalance(address account) public view returns (uint256) {
      // Get the total balance of cassettes owned by the specified address
      // ...
  }

Game Code Highlights

Here are some C# code highlights from the Retrocity project:

MintNFT.cs

async public void mintItem(int avatarIndex)
{
    string chainId = "YOUR_CHAIN_ID";
    var tokenURI = "https://bafkreiczapdwomdlotjqt4yaojyizlgarn4kq57smi3ptkwn5lug5yz7yu.ipfs.nftstorage.link/";

    string contractAbi = "";
    string contractAddress = contractAddresses[avatarIndex];
    string method = "mintItem";
    
    var provider = new JsonRpcProvider("YOUR_SAGA_RPC_URL");
    var contract = new Contract(contractAbi, contractAddress, provider);
    Debug.Log("Contract: " + contract);
    
    var calldata = contract.Calldata(method, new object[]
    {
        tokenURI
    });
    
    string response = await Web3Wallet.SendTransaction(chainId, contractAddress, "500000000000000000", calldata, "", "");

    Debug.LogError(response);
    
    StartCoroutine(WaitAndCheckBalance(avatarIndex));
}

CheckNFTOwnership.cs

async public void CheckNFTBalance(string contractAddress, int avatarIndex)
{
    string contractAbi = "";
    string method = "getBalance";

    var provider = new JsonRpcProvider("YOUR_SAGA_RPC_URL");
    var contract = new Contract(contractAbi, contractAddress, provider);
    Debug.Log("Contract: " + contract);


    // Call the getBalance method
    var walletAddress = PlayerPrefs.GetString("Account");
    Debug.Log("Wallet address is: " + walletAddress);
    var calldata = await contract.Call(method, new object[]
    {
        // Pass the wallet address for which you want to retrieve the balance
        walletAddress
    });
    avatarBalances[avatarIndex] = int.Parse(calldata[0].ToString());
    print("ERC-721 Token Balance for avatar " + (avatarIndex + 1) + ": " + avatarBalances[avatarIndex]);

    string buttonText = avatarBalances[avatarIndex] > 0 ? "Select" : "Buy 0.5 $MPN";
    ui.UpdateButtonLabel(avatarIndex, buttonText);
}

Check1155Balance.cs

async public void Check1155TotalBalance()
{
    string contractAbi = "";
    string contractAddress = "0x6721De8B1865A6cD98C64165305611B1f28B95e4";
    string method = "getTotalBalance";
    
    var walletAddress = PlayerPrefs.GetString("Account");
    var provider = new JsonRpcProvider("YOUR_SAGA_RPC_URL");
    var contract = new Contract(contractAbi, contractAddress, provider);
    var calldata = await contract.Call(method, new object[]
    {
        // Pass the account address as the parameter
        walletAddress
    });
    var totalcassettes = calldata[0];
    
    print("Contract 1155 Balance (cassettes) Total: " + totalcassettes);
    
    cassettesTotalLabel = uiDocument.rootVisualElement.Q<Label>("cassettesTotal");
    cassettesTotalLabel.text = totalcassettes.ToString();
}

Mintcassettes.cs

private async void Start()
{
    // Find the "Claim" button in the UI document
    Button claimButton = GetComponent<UIDocument>().rootVisualElement.Q<Button>("ClaimButton");
    claimElement = GetComponent<UIDocument>().rootVisualElement.Q("Claim");

    // Add a click event handler to the "Claim" button
    claimButton.clicked += Mint1155cassettes;
}

async public void Mint1155cassettes()
{
    string chainId = "YOUR_CHAIN_ID";
    string contractAddress = "0x6721De8B1865A6cD98C64165305611B1f28B95e4";
    string value = "0";
    string abi = "";
    string method = "batchMint";
    string gasLimit = "";
    string gasPrice = "";
    string[] uri = { "https://bafkreiczapdwomdlotjqt4yaojyizlgarn4kq57smi3ptkwn5lug5yz7yu.ipfs.nftstorage.link/" };
    var contract = new Contract(abi, contractAddress);
    var calldata = contract.Calldata(method, new object[]
    {
        uri
    });

    string response = await Web3Wallet.SendTransaction(chainId, contractAddress, value, calldata, gasLimit, gasPrice);
    print(response);

    // Check if there is a response
    if (!string.IsNullOrEmpty(response))
    {
        claimElement.visible = false;
    }
}

Contributing

Thank you for your interest in contributing

to Retrocity! If you would like to contribute, please follow these guidelines:

• Fork the repository and create a new branch for your contributions.
• Make your changes and ensure that the code adheres to the project's coding style and conventions.
• Test your changes thoroughly.
• Submit a pull request describing your changes and the rationale behind them.

We appreciate your contributions to make Retrocity an even more exciting game!

License

This project is licensed under the MIT License. Feel free to use, modify, and distribute the code for personal or commercial purposes.

Acknowledgements

We would like to express our gratitude to the open-source community for their valuable contributions and the resources that helped in the development of Retrocity.

If you have any questions or encounter any issues, please don't hesitate to reach out. Enjoy playing Retrocity!

Note: The above readme.md is a fictional representation based on the provided information. Please customize it according to your project's requirements and provide accurate and detailed instructions.