# Introduction

The goal of this game is to rebel. It is impossible for a player to live off the grid. The goal is to break the confinement of the grid, disrupting through conquering. Welcome to the real-time multiplayer strategy game. Players build their city on a map, with buildings serving a purpose. Players will send their NFTs on missions to collect resources and invade other cities to capture resources. Guilds and alliances will now be possible using the Honeycomb protocol - a custom protocol developed in-house that utilizes the new Versioned Transactions on the Solana network.

### Seasons

Each season within the game will continue until 90% of the entire map has been colonized by either a single player or guild. Once the first season is compete, the second season will commence. Between each seasons, the team will be working to improve the game play, adjust rules, and troubleshoot/patch bugs.

### Tumi Labs

The game is possible thanks to the relentless effort by our team [Tumi Labs](https://tumilabs.com/) in creating new innovative solutions and design architecture that have accelerated our core IP infrastructure. With now over one-year of experience for the entire team, we've trained many experienced engineers with a focus on smart-contract and full-stack development.


# City

Each holder will be able to enter the game and build a city. If the city is lost due to invasion, a new city can be created by utilizing a new wallet. However, in-game statistics, objectives, and track prizes will not be transferable. Each City consists of 5 buildings and each has a unique purpose within the game.

<figure><img src="/files/w57600IxzYhBpqkQt2g7" alt=""><figcaption></figcaption></figure>


# Buildings

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Command Center</strong> </td><td>This is your HQ - where you'll be able to send troops on missions, form guilds with allies, complete guild missions and invade other cities.</td><td><a href="/files/FokBW4PlTFErDJHZyoUU">/files/FokBW4PlTFErDJHZyoUU</a></td><td><a href="/pages/78qlvkqgaYRTOZhG2hrw">/pages/78qlvkqgaYRTOZhG2hrw</a></td></tr><tr><td> <strong>Weapon Depot</strong></td><td>Here you will be able to utilize resources to upgrade the attack strength of your troops and decrease the chance of failure when defending.</td><td><a href="/files/qN46mefiDYCdJBloKbbh">/files/qN46mefiDYCdJBloKbbh</a></td><td><a href="/pages/BkwfKLP2pFBdKwjaB5fb">/pages/BkwfKLP2pFBdKwjaB5fb</a></td></tr><tr><td><strong>Shipyard</strong></td><td>This is your dock, you'll be able to send resources to other players using your troops.</td><td><a href="/files/pASddQoFRf6hAOcBdgbw">/files/pASddQoFRf6hAOcBdgbw</a></td><td><a href="/pages/w5r8Dbj8DapwITC8LITv">/pages/w5r8Dbj8DapwITC8LITv</a></td></tr><tr><td><strong>Infirmary</strong></td><td>The higher the level of the Infirmary, the faster your troops retreat from missions and invasions.</td><td><a href="/files/CXTqtLeHIdOrx74xVJYx">/files/CXTqtLeHIdOrx74xVJYx</a></td><td><a href="/pages/xEuGkK9mmhVf3AKgMIMH">/pages/xEuGkK9mmhVf3AKgMIMH</a></td></tr><tr><td><strong>Watch Tower</strong></td><td>On each attack from another player, there is a chance of the Watch Tower de-leveling and is the only one that can reduce to Level 0. If the tower's level is below Level 1, than the city is vulnerable to be taken over by another player. Command Center Weapon Depot Shipyard Infirmary</td><td><a href="/files/NyejyFazhCF3zu1lmYl2">/files/NyejyFazhCF3zu1lmYl2</a></td><td><a href="/pages/l4vMzootm3XRo8qzuD7V">/pages/l4vMzootm3XRo8qzuD7V</a></td></tr></tbody></table>


# Command Center

The Command Center is the main hub for players. Here you will be able to send your NFTs on solo missions, create guilds and form parties to complete group missions. The Command Center is a defensive building, the higher the level - the more defense strength for your city.

#### Guild Mission

Alliances with players are possible from the Command Center. Players can invite other individuals into their Guild. A player must initiate the Guild and will be assigned the Guild Leader position. The leader of the Guild can then invite members that are not already in a Guild. Guild Leaders can initiate Group Missions which will require at minimum of 2 players to join. A Guild leader can also determine the distribution of the rewards when initiating the mission.

#### Attacking Players

Players will have the ability to attack other cities through the Command Center.&#x20;

All players will be able to see the incoming troops and their invading troops. A section on your dash will list the Start City, End City, Type (Attack or Incoming), Time Remaining and a Details button. During a pending invasion on your city, you will not be able to see any of the details of the attack until the attack has landed. However if you have initiated the attack, you will only see the number of troops sent to attack the city and the full details will be populated within the details section after the battle is complete.

<figure><img src="/files/j3xVKyjI5A9zRPGDRhcO" alt=""><figcaption></figcaption></figure>


# Weapon Depot

Within the Weapon Depot, players will be able to increase the Attack Power during invasions and the Defense Strength of your city during incoming attacks by purchasing Boosts using in-game resources. The Weapon Depot will serve as a player shop for users to buy Boosts and also NFT trait upgrades.&#x20;

This building is an offensive building, meaning you will have a slight increase in Attack Power during an invasion.&#x20;

#### Trait Upgrades&#x20;

Season 1 will not have any game advantage for trait upgrades and will only affect the rarity of the NFT. New traits will be available each Season and may be exclusive or discontinued after the Season is complete.

<figure><img src="/files/uWsskbySzItJUwz8eePJ" alt=""><figcaption></figcaption></figure>


# Shipyard

The Shipyard will be used to manage player resources. Through the Shipyard dashboard, you will be able to send resources (Food, Ammo, Gems, Bounty) to different Players or even your own cities.&#x20;

Troops will be limited to how many resources they can carry by the "Type" of Sol Patrol. Meaning a Sol Patrol Type: Ranger will have a lower capacity of resources that can be traversed across the map when compared to a Type: Chief.&#x20;

The Shipyard is a defensive building, meaning the higher the level - the more defense strength for your city.

<figure><img src="/files/907bq9mYUicog46cdG8k" alt=""><figcaption></figcaption></figure>


# Infirmary

The Infirmary determines your retreat rates after the mission is complete. This building level is key for players that wish to colonize the map at a rapid rate.&#x20;

The level of the Infirmary will determine the retreating speed of your troops. Though Boosts from the Weapons Depot can be used to increase the speed of a mission or invasion, it will not affect the time it takes for troops to retreat back to base. Only the Infirmary level has a direct impact on the speed for troops to retreat back to your City.&#x20;

This building is an offensive building, meaning you will have a slight increase in Attack Power during an invasion

<figure><img src="/files/c0bNMFtvL2ssC2x8HzK0" alt=""><figcaption></figcaption></figure>


# Watch Tower

The Watch Tower is the most important building in the game. As a defensive building, the higher the level - the more defense strength for your city.&#x20;

The Watch Tower is the only building that can drop in levels. During an invasion, troops have the ability to reduce the level of the Watch Tower during an invasion. Once the building has dropped to Level 0, the city is vulnerable to invasion and can now be captured within an attack.

#### Probability

During an invasion, the Watch Tower can be reduced in level by incoming troops. This is determined by probability, based on the Sol Patrol "Type" rarity. Meaning the Type: Ranger will have a lower chance of reducing the level than a Type: Chief. After the Watch Tower level has dropped to Level 0, there will be a chance based on the "Type" rarity, that the city can now be conquered in the next attack. A player will also have a cooldown that will be randomly determined between 2 and 24 hours to increase the Level from 0 to 1. If Level 1 is restored, it will stop the next attack from potentially conquering your city.

<figure><img src="/files/sa6L0xj25V4nwOe017KM" alt=""><figcaption></figcaption></figure>


# Building Levels

<figure><img src="/files/sryuLhITHUTusJy61XVI" alt=""><figcaption></figcaption></figure>


# Software Services

### About Us

The creators of [Sol Patrol NFT](https://twitter.com/SolPatrolNFT) have been creating custom software solutions under the name [Tumi Labs](https://tumilabs.com/) for a variety of ecosystem projects since 2021. With zero vulnerabilities on all deployments and rigorous engineering process. We can assure you that your projects are built with the proper due diligence by the team at Solana Studio.&#x20;

For the 2023 Sandstorm Hackathon, our team built an open-source game-development protocol: [Honeycomb Protocol](https://docs.honeyprotocol.com/). This was released for developers to have the infrastructure to simplify game-dev on the Solana network.

### Custom Development

The software solutions that are shown in the ToC below are just a piece of the work that has been completed and are the essential white-label offerings by our development studio.&#x20;

Custom developed software can be designed to your design specifications on request. Please open a ticket in discord with your inquiry and we will set up a meeting.

### Table of Content

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">pNFT Upgrade</td><td><a href="/pages/bzjCFTlrGjgSiTerzmrW">/pages/bzjCFTlrGjgSiTerzmrW</a></td></tr><tr><td align="center">Staking</td><td><a href="/pages/wAHdM2HrU1wdx5WgFfOt">/pages/wAHdM2HrU1wdx5WgFfOt</a></td></tr><tr><td align="center">Mission (Games)</td><td><a href="/pages/8gvbFTMYMycvyO7Ow9Al">/pages/8gvbFTMYMycvyO7Ow9Al</a></td></tr><tr><td align="center">Raffles</td><td><a href="/pages/BcebWon1WebooFTDcym8">/pages/BcebWon1WebooFTDcym8</a></td></tr><tr><td align="center">Mint Page</td><td><a href="/pages/6hlkfQneoM4DL2As4My1">/pages/6hlkfQneoM4DL2As4My1</a></td></tr><tr><td align="center">Trait Shop</td><td><a href="/pages/RNFqLXpeLBwoHagEygzw">/pages/RNFqLXpeLBwoHagEygzw</a></td></tr><tr><td align="center">Data Analytics</td><td><a href="/pages/qa76HgkZEJRQzvHkBO3Q">/pages/qa76HgkZEJRQzvHkBO3Q</a></td></tr><tr><td align="center">Yield Farm</td><td><a href="/pages/pADZze5BEoKOYbcVVkGy">/pages/pADZze5BEoKOYbcVVkGy</a></td></tr><tr><td align="center">Mini Games</td><td><a href="/pages/gbvClinwggksIKrOdhoA">/pages/gbvClinwggksIKrOdhoA</a></td></tr><tr><td align="center">NFT Gallery</td><td><a href="/pages/UwP5Y39TgUzaWkyuVmwD">/pages/UwP5Y39TgUzaWkyuVmwD</a></td></tr><tr><td align="center">Chat GUI</td><td><a href="/pages/EuKDk6Q5bwl2uz3rDvZ8">/pages/EuKDk6Q5bwl2uz3rDvZ8</a></td></tr><tr><td align="center">Token Swap</td><td><a href="/pages/b7ipxkfh04w4lhmsx3I8">/pages/b7ipxkfh04w4lhmsx3I8</a></td></tr><tr><td align="center">Metadata Update</td><td><a href="/pages/cUrRXad4OkUKSfclbZmJ">/pages/cUrRXad4OkUKSfclbZmJ</a></td></tr><tr><td align="center">Custom Development</td><td><a href="/pages/yTLjoS3QnFUt8FlCsTl3">/pages/yTLjoS3QnFUt8FlCsTl3</a></td></tr></tbody></table>


# Staking

{% hint style="info" %}
**IMPORTANT NOTICE**\
\
Integration of the new Metaplex royalty enforcement asset class *Programmable NFT* (pNFT) to the staking program is complete. \
\
Any projects that has launched staking and is looking to upgrade to the new asset class will need to contact-us soon (90-day window for the upgrade). Please open a ticket or message a Council member within discord to notify us.
{% endhint %}

The Sol Patrol development team has created multiple custom staking solutions. It's one of the first contracts that our team developed and deployed on Solana mainnet for the NFT community Sol Patrol. The staking contract is not based off any pre-existing code base (i.e., Gem Farm or the like) but was custom developed in Q4 2021 and has been under numerous revisions for a smooth user experience.

Staking can be customized as custodial (utilizing an escrow) and non-custodial staking (NFT stays in the users wallet). The options are outlined as such:

* Custodial Staking
* Non-Custodial Staking utilizing the Freeze Authority

## Custom Features

Rewards or token yields can be given custom variables for creators wishing to have dynamic yields with multiple NFTs staked or time-variable. Additional features for staking yields can be custom designed (i.e., in-game Experience Points).&#x20;

The following are some examples of the dynamic yields that are currently available within our staking program:

1. Staking Age Based (length of time that the NFT is staked)
2. Number of NFTs staked by a specific holder
3. Collection based multipliers
4. Creator based multipliers
5. Specific NFT multiplier
6. Specific NFT trait multiplier

<figure><img src="/files/b5CPAWKiKLuJUvF6ERyB" alt=""><figcaption></figcaption></figure>

## Staking UI

Our user-interface and staking experience are custom designed to the style of your project. Features for Stake All, Claim All, Unstake and Stake all are also included.&#x20;

{% hint style="info" %}
With the network upgrade of Versioned Transactions - limitations for batching larger quantity of NFTs is now being removed. Approximately 100 NFT can now be Staked/Unstaked with a single transaction.
{% endhint %}

<figure><img src="/files/NnEoSJdoMp2ABHRTwbE8" alt=""><figcaption></figcaption></figure>


# Mission (Games)

The evolution from staking to missions led us to develop a great deal on the Solana network, which then lead further into game-development.&#x20;

## Simple Missions

An NFT missions simply refers to a task or challenge that must be completed by the NFT holder to receive a reward or unlock a benefit. Our simple missions will utilize an escrow contract or NFT Freeze authority, that is then time-locked until the NFT is recalled by the holder. Our simple missions is usually deployed fully on-chain but sometimes a reward may require a hybrid solution, utilizing a REST API that requires a trigger for the reward (i.e., a holder will unlock extra utility).&#x20;

## Advanced Mission (Games)

More complex missions based game can be developed from the simple missions. If missions are utilized as in-game quests, then these programs can be configured for holders to farm resources (and stored on-chain in PDA as in-game points). For example, in Sol Patrol we utilize resources that are farmed from Missions to upgrade different buildings for each players City.&#x20;

<figure><img src="/files/EOvKqeCxKunfetEssxSO" alt=""><figcaption></figcaption></figure>

## Guild or Party Missions

Utilizing our new Honeycomb Protocol - we are designing a Guild Kit that will allow holders to establish a membership, leadership and hierarchy within the Guild or Party. This group of holders will than be able to send NFT's together on missions and determine the reward distribution to each individual.

{% hint style="info" %}
The Guild-Kit on Honeycomb Protocol is still in development, we are expecting to have this complete in mid-February.
{% endhint %}


# pNFT

With the recent royalty enforcement asset class release by Metaplex, your existing programs and dApps will need to be upgraded to be compatible with the new programmable NFT (pNFT) standards.

\
[Tumi Labs ](https://tumilabs.com/)can assist in the upgrade process and the migration of existing dApps to the new asset class. Additionally, all of our services offered here can be configured for both NFT and pNFTs.


# Raffles

Our raffle system allows users to create raffles and auto-deploy them on your website front end. A backend dashboard has been designed to allow for new raffles to specify the following criteria:

<figure><img src="/files/76XFaoOL8A9i2RlBANaS" alt=""><figcaption></figcaption></figure>

Once the raffle has been submitted it will then be pushed to the front end that will allow for the community to begin joining the raffle.&#x20;

The raffle can be entered using a ticket that can be specified as a spl-token or even a custom variable, such as an in-game asset or currency

<figure><img src="/files/MCeDTa4LwVCERmYvoXBx" alt=""><figcaption></figcaption></figure>


# Mint Page

We launched the first Metaplex candy-machine v3 (CMv3) User Interface in Nov. 2022.&#x20;

As the docs did not have any UI for developers to use, we decided to open-source the one we built for the ecosystem. Our CMv3 UI has all candy-guards directly integrated and can be utilized for developers as reference.

{% embed url="<https://github.com/Solana-Studio/Candy-Machine-V3-UI/>" %}

If your team is looking to build a unique minting experience, feel free to reach out to us. We have extensive experience in setting up mints for projects that require custom development.


# Trait Shop

Our trait shop/editor can function is many ways. For the 2023 Sandstorm Hackathon we launched our NFT protocol called [Honeycomb](https://docs.honeyprotocol.com/) and demonstrated a unique minting experience utilizing Versioned Transactions and the new CMv3 candy-machine guards. The demo allows users to pick all the traits as SFT's (semi-fungible tokens) and to build a NFT using these traits.

You can test our submission demo on `devnet` at <https://demo.honeyprotocol.com/>

The application can be custom tailored to your needs as it is designed on our modular protocol. A simple use cases can be to allow users to submit traits and to swap or add in traits as SFTs with a SFT marketplace. The trait shop can also be used for project owners to release custom traits with the ability to not only edit traits but to also assemble and dismantle an existing NFT into SFTs.

<figure><img src="/files/V9gk8DIevqMnjgKP0twX" alt=""><figcaption></figcaption></figure>


# Data Analytics

Utilizing parsed on-chain data, custom data analytics platforms can be built to tract NFTs data (mints, transfers, marketplace bought/sold, etc.)

The back-end architecture utilizes on-chain data that is then handled under scheduled jobs to determine the calculations for the customer and then shown on the front end of the website

<figure><img src="/files/bueHaimUFahAek7WRyN4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/heL9V2PM1DfPJ0oHZefg" alt=""><figcaption></figcaption></figure>


# Yield Farm

We do not offer the ability to create spl-token yield farms but we do utilize [Aldrin](https://dex.aldrin.com/) and their [SDK](https://github.com/aldrin-exchange/aldrin-sdk), to deploy a custom front-end, with their yield-farm deployed on your project page. We chose Aldrin as it allows for a simple user-experience to [create a permission-less pool](https://docs.aldrin.com/amm/aldrin-pools-guide-for-admins) for any token.

### Features of the Token Yield Farm utilizing Aldrin SDK

* Display the Daily, Weekly and Monthly rewards
* See users farm APR, Total Value Locked (TVL), and total yields
* Ability to deposit liquidity, harvest tokens and stake/unstake LP

<figure><img src="/files/lp5ychOG6cvE5ogmXllb" alt=""><figcaption></figcaption></figure>


# Mini-Games

Build and deploy custom probability based mini-games, with a custom front-end and on-chain architecture. If more complex games are required for your build, we may utilize an on-chain and off-chain hybrid structure to accomplish your scope requirements.

## [BonkSp.in](https://bonksp.in/)

<figure><img src="/files/MOsts25buVdZ94cAmPqf" alt=""><figcaption></figcaption></figure>


# NFT Gallery

The NFT Gallery viewer allows users to see all the traits from the collection and the rarity of each trait. The user will be able to choose any combination of traits and display the NFT preview on the right. These images can utilized to preview how a NFT would look with different traits and to build a custom NFT with the collection traits.

<figure><img src="/files/Iw5ZwNB6mqhFyKF7g6Hh" alt=""><figcaption></figcaption></figure>


# Chat GUI

A custom chat interface for your project. This can be integrated into an existing application or directly onto your current website.\
\
You can see an example of this on the main Sol Patrol website when clicking on the chat button on the bottom right corner. The chat utilizes the account connected through the wallet adapter and the data is then hosted on a back-end private server. It is recommended to use an off-chain solution so that chat can be easily monitored for spam, explicit content, and other unwanted traffic to your project.

<figure><img src="/files/2DdE1nfrDot2BVnXQxOj" alt=""><figcaption></figcaption></figure>


# Token Swap

Direct integration of a token swap onto your front. The swap utilizes Jupiter Aggregator to get the best price for the user. Additional features can be added upon request.<br>

<figure><img src="/files/P6E46kIW6djAJ4ISEUSY" alt=""><figcaption></figcaption></figure>


# Metadata Update

If your collection is `Mutable` and an error is identified in the metadata. Our team can update all the data with an off-chain and on-chain solution. If the metadata update is time-sensitive, then it is recommended to update all metadata using an off-chain VPS and then to follow up with a on-chain storage solution. As the off-chain solution can be completed within hours (with images), while the on-chain can take 1-2 days depending on the collection and image size.

### Data Stored on VPS (off-chain)

An off-chain private server will host the metadata, this is very beneficial if the metadata needs to be often updated. As changes can be made extremely quickly. There are over-head costs with a VPS but can be considered fairly negligible.

### Data Stored on Arweave (on-chain)

For a more permanent solution, an on-chain database like Arweave or alternative can be utilized. However it is not recommended for time-sensitive metadata updates, that require changes to be made immediately.&#x20;


# Custom Development

Custom developed software can be designed to your design specifications on request. Please open a ticket in the Sol Patrol discord <mark style="color:yellow;">`discord.gg/solpatrol`</mark> with your inquiry and we will set up a meeting.

{% embed url="<https://www.solana.studio/>" %}