Dappmon Documentation

1. Introduction

1.1 Overview

The Dappmon Application is an innovative blockchain-based platform that combines the nostalgic appeal of virtual pet games with modern decentralized technologies. By leveraging the power of smart contracts and onchain data storage, Dappmon allows users to own, care for, and, coming soon, battle with unique digital monsters (Dappmon) in a persistent, onchain world. Unlike traditional games, Dappmon is entirely onchain, ensuring that every aspect of gameplay, from monster ownership to interaction, is transparent, secure, and decentralized. The application is currently deployed on the Base Network.

1.2 Mission and Vision

The mission of the Dappmon Application is to create a decentralized, player-owned ecosystem where users can engage with their Dappmon in meaningful ways, ensuring true ownership and longevity of their digital assets. The vision is to enhance the collectible digital monster genre by integrating it with onchain technologies, creating a platform where players have full control and transparency over their digital experiences. Dappmon is for everyone.

2. Game Concept

2.1 Core Gameplay Mechanics

Dappmon is built around the idea of nurturing, training, and battling with digital monsters. Key gameplay elements include:

• Care System: Players must regularly interact with their Dappmon to keep them healthy, happy, and strong. This includes feeding, cleaning, and training them, all of which are actions recorded onchain.
• Training and Battling (COMING SOON): Dappmon can be trained to enhance their abilities and compete in battles against other players' Dappmon. Battles are governed by smart contracts, ensuring fairness and transparency.
• Item System: Various items, which are also onchain assets, can be used to heal, strengthen, or evolve Dappmon. Each item’s effects are determined by smart contracts, providing predictable and transparent outcomes.
• Skills (COMING SOON): Each Dappmon has unique attack, healing, and buff/debuff skills that can be developed over time. These skills are an essential part of the battle mechanics and are stored onchain.

2.2 Collectible Creatures

The Dappmon are inspired by the collectible creatures of the 90s, featuring retro anime-style designs. Each Dappmon is unique, with different stats and evolutions, all represented as non-fungible tokens (NFTs) on the blockchain. While some may look the same, this ensures that no two Dappmon are alike, and their attributes and history are permanently recorded onchain.

2.3 Blockchain Integration

Dappmon leverages blockchain technology to ensure that each Dappmon is a truly unique digital asset, owned by the player. The game’s entire logic, from ownership to care and evolutions, is managed by smart contracts on the Ethereum blockchain. This allows for true ownership, where players can trade, sell, or transfer their Dappmon with confidence in the security and transparency provided by the blockchain. All assets are the full responsibility of their owners.

3. Technical Architecture

3.1 Blockchain and Smart Contracts

The Dappmon Application is entirely onchain, meaning all game mechanics are executed via smart contracts on the Ethereum blockchain. Key functionalities include:

• Ownership and Trading: Smart contracts manage the ownership and transfer of Dappmon between players. Each Dappmon is an NFT, ensuring unique ownership and verifiable provenance.
• Game Mechanics: Core gameplay functions, such as battles, item usage, and evolutions, are governed by smart contracts to ensure fairness and transparency. Every action taken by players is recorded onchain, creating a fully auditable history of each Dappmon.
• Onchain Data Storage: All critical game data, including Dappmon stats, items, and skills, are stored onchain to ensure persistence and immutability. This design eliminates reliance on centralized servers and ensures that the game can continue to operate as long as the blockchain exists.

3.2 Frontend and Backend Technologies

• Frontend: The application frontend is built using React, TypeScript, and Tailwind CSS, providing a responsive and user-friendly interface. The frontend interacts with the blockchain through Web3 libraries, enabling seamless integration with onchain data.
• Backend: The backend leverages the MUD.dev framework to manage onchain interactions and state management, ensuring seamless communication between the frontend and the blockchain. The backend is primarily focused on facilitating interactions with smart contracts and managing game logic.

3.3 Security Considerations

The Dappmon Application places a strong emphasis on security, implementing best practices in smart contract development, such as:

• Audited Smart Contracts: All smart contracts undergo rigorous auditing to prevent vulnerabilities and ensure the safety of player assets.
• Decentralized Data Storage: Utilizing decentralized storage solutions for game assets and data, ensuring that the game is not dependent on any single point of failure.

4. Mechanics

4.1 How to Play

Playing Dappmon revolves around the core activities of acquiring, caring for, training, and battling with Dappmon. Here's a breakdown of how to play:

1. Acquiring Dappmon:
   • Players can acquire Dappmon by connecting to our application and minting a Starter Package, or later through special events and collaborative releases. Each Dappmon is an NFT, representing a unique digital asset.
   • Once acquired, the Dappmon is owned by the player and stored in their digital wallet.
2. Caring for Dappmon:
   • Players need to maintain their Dappmon’s hunger, training, and cleanliness through regular interactions.
   • Actions such as feeding, cleaning, and care are performed using items. Each action impacts the Dappmon’s stats and is recorded onchain.
3. Training and Battling (COMING SOON):
   • Dappmon can be trained to improve their effort and stats. Training sessions are also recorded onchain, contributing to the Dappmon’s effort.
   • Players can engage in battles with other players' Dappmon. Battles are strategic, with the outcome depending on the Dappmon's stats, skills, and the player’s choices during combat.
4. Using Items:
   • Items are onchain assets that can be used to enhance or heal Dappmon. The main items available include:
     • Food: Increases hunger and weight by 1. Essential for keeping your Dappmon well-fed and strong.
     • Protein: Increases effort by 1 and weight by 2. Used to enhance your Dappmon’s training and evolution potential.
     • Medicine: Cures sickness, ensuring that your Dappmon remains healthy and capable of battling.
     • Bandage: Cures injury, restoring your Dappmon’s ability to train and fight without hindrance.
5. Sleep and Poop Mechanics:
   • Dappmon have a sleep cycle of 12 hours awake and 12 hours asleep. During their awake hours, they will engage in various activities but will get tired over time.
   • Dappmon will poop approximately every 1.5 hours, requiring players to clean up after them to avoid care mistakes.
6. Neglect and Care Mistakes:
   • If a player neglects their Dappmon by not feeding, cleaning, or curing them, the Dappmon will accumulate care mistakes.
   • Accumulating 50 care mistakes will result in the Dappmon perishing and is permanent, emphasizing the importance of regular care. RIP.

4.2 Dappmon Stats

Each Dappmon has a set of stats that determine its capabilities in battles and other activities. Key stats include:

• Health (HP): Represents the Dappmon’s overall vitality. If a Dappmon’s HP drops to zero during a battle, it is defeated.
• Attack (ATK): Determines the damage a Dappmon can deal to opponents.
• Defense (DEF): Reduces the amount of damage taken from enemy attacks.
• Tech (TECH): Governs the Dappmon’s ability to use special skills and technological attacks.
• Tech Defense (TECH DEF): Reduces damage taken from tech-based attacks.
• Speed (SPD): Influences the order of actions during battles; faster Dappmon can act before slower ones.

Each Dappmon have hidden values with base stats and gains an additional random increase of 1-15 points in each stat upon hatching. These stats can be further improved through training, items, and evolution.

4.3 Evolution Mechanics

Evolution is a crucial part of the Dappmon experience. Here’s how it works:

1. Evolution Requirements:
   • A Dappmon typically needs to reach a certain level of effort, achieved through training, to evolve and time passed.
   • There are six stages: Egg, Baby, Child, Training, Battle, and Champion.
   • Specific items, like Protein, can increase effort and help meet the requirements for evolution.
   • Care Mistakes will also effect evolution.
   • Stage Timer is viewable in the Stats menu.
2. Evolution Process:
   • When the requirements are met, players can initiate the evolution process via the game interface.
   • The Dappmon undergoes a transformation, resulting in changes to its appearance, enhanced stats, and sometimes type changes.
   • The evolution is recorded onchain, ensuring that the process is permanent and verifiable.
3. Post-Evolution:
   • After evolving, the Dappmon’s new form is more powerful, with improved stats and potentially a new type.
   • The appearance of the Dappmon also changes, reflecting its evolved state.
   • Players can continue to care for, train, and battle with their evolved Dappmon, further developing its potential.

5. Features

5.1 Dappmon Ownership

Players have full ownership of their Dappmon, with each monster represented as an NFT on the blockchain. This allows for true player control over their assets, with the ability to trade, sell, or gift their Dappmon. Ownership data and all associated gameplay actions are permanently recorded onchain.

5.2 Care and Interaction

The Care component allows players to interact with their Dappmon in various ways, ensuring their health and happiness. Each interaction is recorded onchain, contributing to the Dappmon’s overall development and history. This system includes actions such as feeding, cleaning, and training, which are essential for maintaining the Dappmon's well-being.

5.3 Battling System (COMING SOON)

Dappmon can be pitted against one another in strategic battles, with the outcome determined by the Dappmon's stats, skills, and the player’s strategy. Winning battles can increase the Dappmon’s level, improve its stats, and potentially unlock new abilities.

5.4 Evolution and Growth

Dappmon can evolve into more powerful forms by meeting specific criteria, such as reaching a certain level of effort and the passing of time. This evolution enhances their stats, unlocks new types, and changes their appearance. The process is governed by smart contracts, ensuring that each evolution is transparent, secure, and immutable.

5.5 Trading and Marketplace

A decentralized marketplace allows players to buy, sell, and trade their Dappmon and items. The marketplace operates entirely onchain, ensuring transparency and security in all transactions. Each trade is executed via smart contracts, ensuring that ownership transfers are secure and recorded on the blockchain.

6. Roadmap

6.1 Current Development

• Core Mechanics Implementation: Completion of the core gameplay mechanics, including the Care system, evolution, and item use. Your Dappmon is a living onchain creature.

6.2 Future Plans

• Expansion of Dappmon: Introduction of new Dappmon with unique appearances and evolutions, expanding the diversity and strategic depth of the game. Collaborations with existing web3 companies to bring Dappmon to their communities.
• Battle System: Implement the full-functional onchain battle system. Coming soon with version 2.
• Cross-chain Integration: Exploring integration with other blockchain platforms to expand the Dappmon ecosystem and increase accessibility.

7. Conclusion

The Dappmon Application represents the next step in the evolution of digital monster games, combining the best aspects of collectible creatures with the power of blockchain technology. By providing true ownership, transparency, and security, Dappmon offers a unique and engaging gaming experience that is poised to set new standards in the genre.

8. Appendix

8.1 Smart Contract Specifications

World Contract: https://basescan.org/address/0x73a814bb4ee9fdd67568065ee928b84d2b724950

Dappmon Starter Package Contract: https://basescan.org/address/0x5f49521b54c7ebb32cfed5ee088eba36d8e35e0f

Dappmon NFT Contract: https://basescan.org/address/0x066d1050784e0d5d0f12dba1b5b2ab41c51c742f

Dappmon Items Contract: https://basescan.org/address/0xa4a03067f95c0574f755b1a02c83c306d65cfd27