Thread by @gabrielleydon

1/ For those who did some searching through our new AdventureERC721 token we released with @DigiDaigaku Spirits we thought we would give a more in depth explanation of what where we're going with the new Adventure Quest system! 🚀

2/ AdventureERC721 was designed to extend traditional NFT functionality with gameplay functionality. Standard ERC721 contracts have a limited set of actions you can perform that satisfy their original use cases. Adding gameplay functionality requires extending the standard.

3/ The traditional NFT mechanics are kept intact, and gameplay functionality is entirely opt-in. This means that holders primarily interested in collecting can expect the same user experience as before. The fun only happens when you opt into an adventure.

4/ An adventure is represented as a smart contract, and it contains the rules that govern how a game can manipulate the NFTs that have opted in. Representing adventures as smart contracts is important because it allows players to transparently see what they might want to opt into

5/ For security, all adventures must be whitelisted by the NFT contract owner before players can be opted in to prevent phishing. For an adventure contract to manipulate an NFT, it will need to be approved by both the contract owner as well as the token owner for added protection

6/ An approved adventure has the permission to transfer, burn, stake and unstake the tokens of a player that has opted into it. Tokens can be staked into Quests. Based on the gameplay mechanics of an adventure, being in a quest can have the ability to lock transfers of a token.

7/ AdventureERC721 was written with both ON-CHAIN AND OFF-CHAIN GAMING in mind and the adventures are where these boundaries will be defined on a game by game basis with little modification.

8/ The state of a player's quests is stored locally in the AdventureERC721 contract rather than in the adventures, which is important for gas optimization in the case of many concurrent adventures and quests.

9/ AdventureERC721 uses a custom permissioning system, separate from the built in ERC721 system. approve and setApprovalForAll are used by traders to approve operators such as marketplaces to transfer tokens during a sale.

10/ Adventure approval is separate and does not grant transfer/sale authorization to any address that is not a whitelisted adventure. Similarly, granting standard ERC721 approvals does not implicitly opt a player into adventures.

11/ Q: Why can adventures burn and transfer my tokens?
A: To facilitate interesting gameplay mechanics to those that opt in. Some quests will require staking one or more tokens that are burned in exchange for something new. These quests will burn NFTs and reduce supply.

12/ Other quests will transfer tokens so that they may be re-circulated to new players. Many other quests will neither burn nor transfer, and players will be rewarded for staking for a set amount of time and retain ownership of their NFT after the quest has been completed, etc.

13/ Q: What is the relationship between adventures and quests?
A: An adventure is always a smart contract. Adventure contracts support at least one quest, but in many cases, a single adventure will include many possible quests.

14/ Q: Can I participate in more than one adventure or quest?
A: AdventureERC721 allows players to participate in multiple adventures and quests at the same time, and the smart contracts have been designed for expansion to support as many as 100 simultaneous quests per adventure

15/ For example, a player could actively participate in adventures A, B and C. They could be participating in 50 quests on Adventure A, 100 quests on Adventure B, and 75 quests on Adventure C

16/ Q: Can I still transfer or sell my tokens while staked?
A: It depends - some adventures are designated in the whitelist as “blocking” adventures. When a token is staked in a quest that is part of a blocking adventure, it will be non-transferrable while staked.

17/ When a token is staked in a quest that is part of a non-blocking adventure, it can be transferred while staked.

18/ Q: What happens if an adventure gets removed from the whitelist? Won’t my token be stuck forever?
A: No, userExitQuest and userExitAllQuests have been provided so that the user can always safely unstake their tokens if an adventure is removed from the whitelist.

19/ However, players should not unstake this way under normal circumstances, as they will lose their staking progress without receiving a reward. It is best to complete the adventure/quest workflow as intended.

20/ Q: Does Quest staking transfer my tokens?
A: No, AdventureERC721 staking still leaves your NFTs in your own wallet, with the exception of DigiDaigaku Genesis which is a standard ERC721.

We are sure you'll have more questions as this rolls out but we wanted to share a more detailed explanation about the Adventure Questing System! 😎