DIGI - Documentation | Digital Monster On X

1

Quick Start

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

1

Mention Us

Tweet @Digimon_on_x 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 @Digimon_on_x with a command.

2

Commands

All commands work by mentioning @Digimon_on_x 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.

@Digimon_on_x 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.

@Digimon_on_x 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.

@Digimon_on_x check

battle @user

Combat

Challenge another tamer's Digimon to battle.
Battles are determined by level, type advantage, and some luck. The winner gains +25 XP. Battle results are shown as a narrative story — no HP numbers, just the action.

@Digimon_on_x battle @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!

@Digimon_on_x 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.

@Digimon_on_x 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.

@Digimon_on_x format device

help

Get a list of all available commands.

@Digimon_on_x 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 narrative-driven — you'll see a story of what happened, not raw numbers. The outcome is determined by your Digimon's level, type advantage, and a bit of luck.

Battle Mechanics

Level Matters: A higher-level Digimon deals more damage and has more health.
Type Advantage: Some types are super effective against others (2x damage).
Narrative Log: Battles describe what your Digimon does — fire blasts, ice storms, shadow strikes — and explain why the winner won.
Winner Reward: The winning Digimon earns +25 XP.
Max 10 Rounds: If neither Digimon falls, the one with more remaining strength wins.

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

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

6

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!

7

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

8

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.

9

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 #DIGI when you digivolve or win battles
Help new tamers — explain commands and type advantages

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