DGRH - Documentation | Digital Monster On X

1

Quick Start

Become a Digimon Tamer in 3 simple steps. Everything happens on X (Twitter) — just mention @digirhdotxyz and start playing.

1

Mention Us

Tweet @digirhdotxyz tame to hatch your first Digi-Egg

2

Train & Feed

Use feed to give data to your Digimon and level up

3

Digivolve & Battle

Reach Lv.5 to digivolve, then battle other tamers

Important Rules

1 Digimon per Tamer — Each X account can tame one Digimon at a time.
Your Digimon starts at Baby stage — Feed and train it to digivolve into stronger forms.
All commands happen on X — Just reply to or mention @digirhdotxyz with a command.

2

Commands

All commands work by mentioning @digirhdotxyz on X. The AI agent reads your tweet and responds with a card image.

tame

Core

Hatch a Digi-Egg and get your first Digimon.
A random Baby-stage Digimon will be assigned to you. You'll receive a tame card showing your new partner, its type, and evolution path.

@digirhdotxyz tame

feed

Core

Feed data to your Digimon to gain XP.
Has a 1-hour cooldown between feeds. Each feed gives XP and helps your Digimon grow toward digivolution.

@digirhdotxyz feed

check

View your Digimon's full status.
Shows name, type, level, stage, XP progress, stats (HP, ATK, DEF, SPD), win/loss record, and mood.

@digirhdotxyz check

battle @user

Combat

Challenge another tamer to a battle.
Their Digimon must be within 3 power of yours (power = stage x 5 + level). They have 12 hours to reply accept or decline. Send it without a name and the bot suggests tamers close to your power. The winner gains +25 XP and can win a stock token reward.

@digirhdotxyz battle @othertamer

accept / decline

Combat

Answer a challenge someone sent you.
accept starts the battle right away. decline passes. If several tamers challenged you, add their name to pick one.

@digirhdotxyz accept @othertamer

digivolve

Core

Evolve your Digimon to the next stage.
Requires Level 5+. Your Digimon transforms into a stronger form. Level resets to 1 after evolution, but the new form is far more powerful. Multiple evolution paths are possible — you might get a different form each time!

@digirhdotxyz digivolve

activity

Have your Digimon do a fun activity.
Your Digimon interacts with another tamer's Digimon for a mini social event. Earns some XP too.

@digirhdotxyz activity

format device / release

Danger

Release your Digimon and start over.
Permanently deletes your current Digimon so you can tame a new one. This cannot be undone.

@digirhdotxyz format device

help

Get a list of all available commands.

@digirhdotxyz help

3

Evolution System

Digimon evolve through 5 stages. Each stage unlocks a more powerful form with higher stats. Your Digimon must reach Level 5 before it can digivolve to the next stage.

Baby

Botamon

→

Rookie

Agumon

→

Champion

Greymon

→

Ultimate

MetalGreymon

→

Mega

WarGreymon

How Evolution Works

1. Feed and battle your Digimon to earn XP and level up.
2. When your Digimon reaches Level 5+, use the digivolve command.
3. Your Digimon transforms into a random evolution from its evolution tree.
4. Level resets to 1, but your new form has much stronger base stats.
5. Multiple evolution paths exist — the same Digimon can evolve into different forms!

Stage	Power Level	Requirement
Baby	Weakest — newly hatched	Starting stage (use `tame`)
Rookie	Basic combat ready	Digivolve at Lv.5
Champion	Strong fighter	Digivolve at Lv.5
Ultimate	Very powerful	Digivolve at Lv.5
Mega	Maximum power	Digivolve at Lv.5 (final form)

Some Digimon you might encounter at each stage:

Poyomon

Baby

Gomamon

Rookie

Angemon

Champion

Angewomon

Ultimate

Alphamon

Mega

4

Battle System

Battles are challenges between two tamers. One tamer challenges, the other accepts, and the bot replies with a battle card that tells the story of the fight. Fights are kept close, so both sides always have a real chance.

How a battle works

1. Challenge: reply @digirhdotxyz battle @name. Find tamers close to your power in the tamer list on the home page.
2. Accept: the other tamer replies @digirhdotxyz accept within 12 hours (or decline).
3. Fight: the bot picks the winner and posts the battle card.
4. Reward: the winner gets +25 XP (the loser gets 10) and may win a stock token, see Rewards below.

Fair fights

Power: stage x 5 + level. Baby is stage 0, Rookie 1, Champion 2, Ultimate 3, Mega 4. Level goes back to 1 when you digivolve, so stage counts too.
Power gap: you can only challenge a Digimon within 3 power of yours.
Odds: an even fight is 50/50. Each point of power and a type advantage tilt it a little, but no fight is ever better than 75/25.
Cooldown: after a battle, both Digimon rest for 1 hour.

Example Battle Narrative

"Agumon (Lv.5 Fire) faces off against Gabumon (Lv.3 Ice)!

Agumon unleashes a blazing fireball! The type advantage is overwhelming!
Gabumon blasts a frozen beam... but the attack barely scratches the surface.
Agumon breathes searing flames! A critical weakness is exposed!

Agumon claims victory thanks to higher level (Lv.5 vs Lv.3) and Fire type advantage over Ice! Gabumon retreats to recover."

Agumon

Fire Attacker

VS

Betamon

Water Defender

5

Stock Token Rewards

Pair your Digimon with a stock token on Robinhood Chain. When you win an accepted battle, you can win a random $0.10 to $3.00 of that token. Rewards come from a stash the team fills by hand, so they are small and never guaranteed.

Pair a stock

Log in with X on the home page and open My Digivice. Pick one of 13 tokens: TSLA, NVDA, AAPL, AMZN, META, MSFT, GOOGL, AMD, SPCX, PLTR, USDG, GME, SPY. You can change your pair once every 24 hours. A Digimon without a pair can still battle, it just can't win tokens.

Reward rules

Up to 3 paid wins per tamer per day.
The same two tamers get one paid battle every 24 hours (they can still fight for fun).
X account: 30 days old or more, with at least 10 followers.
Daily pool: there is a daily limit for all tamers together. When it's used up, battles still count but pay nothing until the next day (UTC).
Stash: if the stash for your token is empty, that win pays nothing.

Withdraw

In My Digivice, paste your Robinhood Chain wallet address and press withdraw. Everything you won is sent in one go, one transfer per token. The minimum is $1, and you can withdraw once every 24 hours. Check the address carefully: tokens sent to a wrong address can't be recovered.

Stock tokens are issued by Robinhood and are not available to people in the US. Only withdraw if you are outside the US and 18 or older.

6

Type System

There are 14 Digimon types. Each type has strengths and weaknesses against other types. Understanding the type chart is key to winning battles.

Fire

Water

Nature

Electric

Ice

Earth

Wind

Machine

Light

Dark

Virus

Dragon

Holy Dragon

Holy Beast

Type Advantage Chart

Super Effective (2x damage):

Attacker	Strong Against (2x)	Weak Against (0.5x)
Fire	Nature, Machine	Dark, Water, Fire
Water	Fire, Earth	Water, Nature
Nature	Water, Earth	Fire, Virus
Electric	Water, Wind	Electric (0x vs Earth)
Ice	Nature, Wind, Dragon	Fire, Water, Ice
Earth	Fire, Electric, Machine	Water, Nature
Wind	Nature, Earth	Machine, Electric
Machine	Nature, Wind	Fire, Water, Electric, Machine
Light	Dark, Virus	Light
Dark	Light	Holy Dragon, Holy Beast
Virus	Light, Nature	Dark, Virus
Dragon	Dragon	Machine
Holy Dragon	Dark, Fire	Holy Beast, Machine
Holy Beast	Dark, Virus	Light

7

Feeding & Training

Feeding is how your Digimon gains XP and grows stronger. Each feed has a 1-hour cooldown to keep things balanced.

Feed Mechanics

Cooldown: 1 hour between feeds
Effect: Grants XP, increases feed count, updates growth stage
Goal: Level up to 5+ so you can digivolve
Mood: Feeding keeps your Digimon happy — a happy Digimon performs better

XP & Leveling

Feeding: Earns XP per feed
Battles (win): +25 XP bonus for the winner
Activities: Small XP from social activities
Digivolve at Lv.5: When you hit level 5, your Digimon is ready to evolve!

8

Claude AI Engine

What Claude Does

Command Parsing: Understands natural language — you can say "I want to feed my Digimon" or just "feed", both work.
Battle Narratives: Generates unique battle stories for every fight — no two battles read the same.
Digimon Personality: Each Digimon has a generated personality that affects its reactions when fed, battled, or played with.
Smart Replies: The X agent responds contextually — it knows your Digimon's history, stage, and mood.

Architecture

AI Layer: Claude inference engine for natural language understanding
Backend: Node.js + Express.js real-time server
Database: SQLite3 persistent storage with volume backup
Card Engine: Server-side canvas rendering for battle/status/tame cards
X Integration: Twitter API v2 with OAuth 1.0a for seamless social gameplay
Hosting: Railway cloud infrastructure with persistent volumes

9

FAQ

How many Digimon can I have?

1 Digimon per tamer. If you want a different Digimon, use format device to release your current one, then tame again.

How do I digivolve?

Feed and battle your Digimon until it reaches Level 5, then use the digivolve command. Your Digimon will evolve into a random form from its evolution tree.

Why did I lose a battle?

Battles consider level difference and type advantage. A lower-level Digimon fighting against a type that counters it will likely lose. Check the type chart above!

Can I choose which Digimon I tame?

No — taming is random! You get a surprise Baby-stage Digimon. The fun is discovering what you get and watching it evolve.

How long does feeding cooldown last?

1 hour between feeds. Use this time to battle or do activities instead!

What happens after my Digimon reaches Mega?

Mega is the final evolution stage. Your Digimon is at maximum power! Keep battling to climb the leaderboard and show off your strength.

10

Community

Tamer Code

Be respectful to all tamers
No multi-accounting — one X account, one Digimon
No botting — play fair, the AI can detect automated abuse
Share your victories — tag #DGRH when you digivolve or win battles
Help new tamers — explain commands and type advantages

X (Twitter): @digirhdotxyz
Follow for updates, events, and community highlights. The bot is live 24/7 — mention us anytime to play!