Skip to the content.
D&D Bot Avatar

D&D Adventurer's Tome D&D Adventurer's Tome

Your ultimate D&D 5e companion on Telegram. Browse the entire compendium, manage your characters, and run live party sessions — all without leaving your chat. Il tuo compagno D&D 5e definitivo su Telegram. Esplora l'intero compendio, gestisci i tuoi personaggi e avvia sessioni party dal vivo — tutto senza uscire dalla chat.

Python 3.10+ Telegram Bot D&D 5e i18n EN/IT

What Can This Bot Do? Cosa Può Fare Questo Bot?

📖

D&D 5e Encyclopedia

Enciclopedia D&D 5e

Look up spells, monsters, classes, races, equipment and more — all 11 categories of the official D&D 5e compendium, browsable with inline buttons right inside Telegram.

Cerca incantesimi, mostri, classi, razze, equipaggiamento e altro — tutte le 11 categorie del compendio ufficiale D&D 5e, navigabili con bottoni inline direttamente in Telegram.

Learn more → Scopri di più →
⚔️

Character Sheet

Scheda Personaggio

Create and manage full D&D characters: HP, armor, abilities, spells, inventory, dice rolls, conditions and much more. Everything is saved automatically.

Crea e gestisci personaggi D&D completi: HP, armatura, abilità, incantesimi, inventario, tiri di dado, condizioni e molto altro. Tutto viene salvato automaticamente.

Learn more → Scopri di più →
🛡️

Live Group Party

Party di Gruppo Live

Start a party session in your Telegram group. See everyone’s HP bars, armor class, conditions and dice rolls in a single, auto-updating message.

Avvia una sessione party nel tuo gruppo Telegram. Vedi le barre HP, classe armatura, condizioni e tiri di dado di tutti in un unico messaggio che si aggiorna da solo.

Learn more → Scopri di più →

📖 D&D 5e Encyclopedia Enciclopedia D&D 5e

Need to quickly check a spell during a session? Wondering what abilities a monster has? The bot gives you instant access to the entire D&D 5e System Reference Document — directly inside Telegram.

📂 11 Content Categories

Tap a category and start browsing:

  • 🧙 Spells
  • 👹 Monsters
  • 🏹 Classes
  • 🧝 Races
  • ⚔️ Equipment
  • 🌀 Conditions
  • ✨ Magic Items
  • 🌟 Feats
  • 📜 Rules
  • 📖 Backgrounds
  • 🗡️ Weapon Properties

🗺️ Deep Navigation

Each entry lets you drill deeper. Select a class and explore its proficiencies, saving throws, spells and subclasses. Pick a race to see traits, languages and subraces. Every connection is automatically discovered and browsable.

💡 Tip: You never leave Telegram. Everything happens through inline buttons — no links, no browser tabs.

Hai bisogno di controllare un incantesimo durante una sessione? Ti chiedi quali abilità ha un mostro? Il bot ti dà accesso istantaneo all’intero System Reference Document D&D 5e — direttamente dentro Telegram.

📂 11 Categorie di Contenuto

Tocca una categoria e inizia a navigare:

  • 🧙 Incantesimi
  • 👹 Mostri
  • 🏹 Classi
  • 🧝 Razze
  • ⚔️ Equipaggiamento
  • 🌀 Condizioni
  • ✨ Oggetti Magici
  • 🌟 Talenti
  • 📜 Regole
  • 📖 Background
  • 🗡️ Proprietà Armi

🗺️ Navigazione Profonda

Ogni voce ti permette di approfondire. Seleziona una classe ed esplora competenze, tiri salvezza, incantesimi e sottoclassi. Scegli una razza per vedere tratti, lingue e sottorazze. Ogni connessione viene scoperta automaticamente ed è navigabile.

💡 Suggerimento: Non esci mai da Telegram. Tutto avviene tramite bottoni inline — niente link, niente browser.

⚔️ Character Sheet Scheda Personaggio

Think of it as a full digital character sheet that lives in your pocket. Create as many characters as you want, switch between them anytime, and every change is saved automatically — even if the bot restarts.

🧙 Create & Manage Characters

A guided wizard walks you through character creation: pick a name, choose one of the 12 D&D 5e classes (or type your own), set a subclass and starting level. You can create multiple characters on the same Telegram account and switch between them freely.

❤️ Hit Points & Armor Class

Track your health in real time. Set max HP, apply damage, heal, or set HP directly. Take a short rest to recover class resources, or a long rest to fully restore your health.

  • ⬆️ Set max HP
  • 📉 Apply damage
  • 💚 Heal
  • 🎯 Set current HP directly
  • 🌙 Short rest
  • ☀️ Long rest (full HP + resource reset)
  • 🛡️ Armor Class: base + shield + magic bonuses, calculated automatically

📊 Ability Scores & Skills

Set your six ability scores (STR, DEX, CON, INT, WIS, CHA) and the bot calculates modifiers automatically. All 18 D&D 5e skills are included — toggle proficiency, see your computed bonus, and roll skill checks with a single tap.

  • Acrobatics
  • Animal Handling
  • Arcana
  • Athletics
  • Deception
  • History
  • Insight
  • Intimidation
  • Investigation
  • Medicine
  • Nature
  • Perception
  • Performance
  • Persuasion
  • Religion
  • Sleight of Hand
  • Stealth
  • Survival

🔮 Spells & Spell Slots

A complete spell management system. Learn spells with a quick-add flow, edit every detail (casting time, range, components, duration, description), and cast them by consuming spell slots. The bot tracks concentration for you — only one concentration spell at a time, with automatic saving throw checks.

  • Fuzzy search — type a partial name and get instant results
  • Pin favourite spells to your character summary
  • Browse by level or as a flat list (configurable)
  • Manage spell slots independently — add, use, restore

🎒 Inventory

Carry everything your adventurer needs. Items are organised into six types, each with dedicated fields:

📦Generic
Name, quantity, weight, description
🗡️Weapon
Damage dice, type, properties
🛡️Armor
AC value, stealth disadvantage
🔰Shield
AC bonus
🧪Consumable
Effect description
🔧Tool
Tool type

Equip armor and shields to automatically update your AC. Equip multiple weapons at once. Adjust quantities on the fly.

💰 Currencies

Track all five D&D coin types — Copper, Silver, Electrum, Gold and Platinum — with add, subtract and automatic conversion.

✨ Special Abilities

Add passive or active abilities with usage limits and a restoration type (short rest, long rest, or manual). Spend and restore uses with a tap.

🔀 Multiclassing

Full multiclass support. Add additional classes, set subclasses, level up or down — class resources like Ki, Rage and Bardic Inspiration are recalculated automatically. Resting restores the right resources for each class.

🎲 Dice Roller

Roll any die from d4 to d100 with a configurable count (1–10). Results are saved in your roll history (last 50 rolls). A dedicated Initiative button rolls 1d20 + your DEX modifier with a single tap.

🌀 Conditions

Toggle all 14 official D&D 5e conditions on your character with one tap. Exhaustion has a level system (0–6). Every change syncs in real time with the party message.

  • 😵 Blinded
  • 💕 Charmed
  • 🔇 Deafened
  • 😨 Frightened
  • 🤝 Grappled
  • 🚫 Incapacitated
  • 👻 Invisible
  • 💀 Paralyzed
  • 🗿 Petrified
  • 🤢 Poisoned
  • ⬇️ Prone
  • ⛓️ Restrained
  • 😵‍💫 Stunned
  • 😴 Unconscious
  • 😩 Exhaustion (0–6)

✨ Heroic Inspiration

Based on the D&D 5e 2024 rules. One tap to grant or spend your inspiration token. When active, it shows up in your character summary.

📝 Notes & Voice Memos

Jot down text notes or record voice memos directly in Telegram. Voice messages are saved and can be retrieved anytime.

🗺️ Maps

Upload images or documents as maps, organised by zone name. Pull up any map from your character sheet whenever you need it.

📜 Change History

Every important change is logged automatically — HP, AC, spells, inventory, conditions, dice rolls and more (up to 50 events). Browse your history as a paginated list or clear it with a single button.

⚙️ Settings

Customise how spells are displayed (by level or flat list) and choose which character appears in group party sessions.

Pensalo come una scheda personaggio digitale completa che vive nella tua tasca. Crea quanti personaggi vuoi, passa dall’uno all’altro in qualsiasi momento, e ogni modifica viene salvata automaticamente — anche se il bot si riavvia.

🧙 Crea e Gestisci Personaggi

Un wizard guidato ti accompagna nella creazione del personaggio: scegli un nome, seleziona una delle 12 classi D&D 5e (o scrivi la tua), imposta una sottoclasse e il livello iniziale. Puoi creare più personaggi sullo stesso account Telegram e passare liberamente dall’uno all’altro.

❤️ Punti Ferita e Classe Armatura

Tieni traccia della tua salute in tempo reale. Imposta gli HP massimi, applica danni, cura o imposta gli HP direttamente. Fai un riposo breve per recuperare risorse di classe, o un riposo lungo per ripristinare tutta la salute.

  • ⬆️ Imposta HP massimi
  • 📉 Applica danno
  • 💚 Cura
  • 🎯 Imposta HP correnti
  • 🌙 Riposo breve
  • ☀️ Riposo lungo (HP pieni + reset risorse)
  • 🛡️ Classe Armatura: base + scudo + bonus magici, calcolata automaticamente

📊 Punteggi Abilità e Skill

Imposta i sei punteggi abilità (FOR, DES, COS, INT, SAG, CAR) e il bot calcola i modificatori automaticamente. Tutte le 18 skill D&D 5e sono incluse — attiva la competenza, vedi il bonus calcolato e tira prove di abilità con un solo tocco.

  • Acrobazia
  • Addestrare Animali
  • Arcano
  • Atletica
  • Inganno
  • Storia
  • Intuizione
  • Intimidire
  • Investigazione
  • Medicina
  • Natura
  • Percezione
  • Intrattenere
  • Persuasione
  • Religione
  • Destrezza di Mano
  • Furtività
  • Sopravvivenza

🔮 Incantesimi e Slot

Un sistema di gestione incantesimi completo. Apprendi incantesimi con un flusso rapido, modifica ogni dettaglio (tempo di lancio, gittata, componenti, durata, descrizione) e lanciali consumando slot incantesimo. Il bot traccia la concentrazione per te — un solo incantesimo di concentrazione alla volta, con tiri salvezza automatici.

  • Ricerca fuzzy — digita un nome parziale e ottieni risultati istantanei
  • Fissa gli incantesimi preferiti nel riepilogo del personaggio
  • Naviga per livello o come lista piatta (configurabile)
  • Gestisci gli slot indipendentemente — aggiungi, usa, ripristina

🎒 Inventario

Porta con te tutto ciò che serve al tuo avventuriero. Gli oggetti sono organizzati in sei tipi, ognuno con campi dedicati:

📦Generico
Nome, quantità, peso, descrizione
🗡️Arma
Dado danno, tipo, proprietà
🛡️Armatura
Valore CA, svantaggio furtività
🔰Scudo
Bonus CA
🧪Consumabile
Descrizione effetto
🔧Strumento
Tipo strumento

Equipaggia armature e scudi per aggiornare automaticamente la CA. Equipaggia più armi contemporaneamente. Modifica le quantità al volo.

💰 Valute

Tieni traccia di tutte e cinque le monete D&D — Rame, Argento, Electrum, Oro e Platino — con addizione, sottrazione e conversione automatica.

✨ Abilità Speciali

Aggiungi abilità passive o attive con limiti di utilizzo e tipo di ripristino (riposo breve, lungo o manuale). Spendi e ripristina usi con un tocco.

🔀 Multiclasse

Supporto multiclasse completo. Aggiungi classi aggiuntive, imposta sottoclassi, sali o scendi di livello — le risorse di classe come Ki, Furia e Ispirazione Bardica vengono ricalcolate automaticamente. Il riposo ripristina le risorse giuste per ogni classe.

🎲 Lanciatore di Dadi

Tira qualsiasi dado dal d4 al d100 con quantità configurabile (1–10). I risultati vengono salvati nello storico (ultimi 50 tiri). Il pulsante Iniziativa dedicato tira 1d20 + modificatore DES con un solo tocco.

🌀 Condizioni

Attiva/disattiva tutte le 14 condizioni ufficiali D&D 5e sul tuo personaggio con un tocco. L’Esaurimento ha un sistema a livelli (0–6). Ogni modifica si sincronizza in tempo reale con il messaggio party.

  • 😵 Accecato
  • 💕 Affascinato
  • 🔇 Assordato
  • 😨 Spaventato
  • 🤝 Afferrato
  • 🚫 Incapacitato
  • 👻 Invisibile
  • 💀 Paralizzato
  • 🗿 Pietrificato
  • 🤢 Avvelenato
  • ⬇️ Prono
  • ⛓️ Trattenuto
  • 😵‍💫 Stordito
  • 😴 Privo di Sensi
  • 😩 Esaurimento (0–6)

✨ Ispirazione Eroica

Basata sulle regole D&D 5e 2024. Un tocco per ottenere o spendere il token ispirazione. Quando attivo, appare nel riepilogo del personaggio.

📝 Note e Memo Vocali

Annota note testuali o registra memo vocali direttamente in Telegram. I messaggi vocali vengono salvati e possono essere recuperati in qualsiasi momento.

🗺️ Mappe

Carica immagini o documenti come mappe, organizzate per nome zona. Recupera qualsiasi mappa dalla scheda personaggio quando ne hai bisogno.

📜 Storico Modifiche

Ogni modifica importante viene registrata automaticamente — HP, CA, incantesimi, inventario, condizioni, tiri di dado e altro (fino a 50 eventi). Sfoglia lo storico come lista paginata o cancellalo con un pulsante.

⚙️ Impostazioni

Personalizza come vengono mostrati gli incantesimi (per livello o lista piatta) e scegli quale personaggio appare nelle sessioni party di gruppo.


🛡️ Live Group Party Party di Gruppo Live

Playing D&D with friends on Telegram? The party feature creates a live dashboard for your entire group — updated automatically every time something changes.

🚀 How It Works

1

Send /party in your Telegram group

2

Choose Public (visible to everyone) or Private (GM-only view)

3

A live status message appears showing every character’s state

👥 Who Appears?

Each player marks a character as “Party Active” in their settings. If someone only has one character, they’re included automatically. The bot tracks who writes in the group so it knows who’s in the session.

🔄 Real-Time Updates

The party message refreshes instantly whenever someone changes their HP, armor class, conditions or makes a dice roll. No manual refresh needed.

📋 What You See

For each character: name and class/level, a colour-coded HP bar, current AC, active conditions, and their last dice roll. The header shows the group name and remaining session time (sessions last 48 hours, or end early with /party_stop).

Giochi a D&D con gli amici su Telegram? La funzione party crea una dashboard live per tutto il gruppo — aggiornata automaticamente ogni volta che qualcosa cambia.

🚀 Come Funziona

1

Invia /party nel tuo gruppo Telegram

2

Scegli Pubblica (visibile a tutti) o Privata (solo per il GM)

3

Appare un messaggio di stato live che mostra lo stato di ogni personaggio

👥 Chi Appare?

Ogni giocatore segna un personaggio come “Party Attivo” nelle impostazioni. Se qualcuno ha un solo personaggio, viene incluso automaticamente. Il bot tiene traccia di chi scrive nel gruppo per sapere chi fa parte della sessione.

🔄 Aggiornamenti in Tempo Reale

Il messaggio party si aggiorna istantaneamente ogni volta che qualcuno modifica HP, classe armatura, condizioni o fa un tiro di dado. Nessun aggiornamento manuale necessario.

📋 Cosa Vedi

Per ogni personaggio: nome e classe/livello, una barra HP colorata, CA corrente, condizioni attive e l’ultimo tiro di dado. L’intestazione mostra il nome del gruppo e il tempo rimanente della sessione (le sessioni durano 48 ore, oppure si terminano prima con /party_stop).


💬 Commands Comandi

/start

Opens the main menu with Wiki and Character options. Private chat only.

Apre il menu principale con Wiki e Personaggio. Solo chat privata.

/party

Starts a party session in your group. Choose public or private display.

Avvia una sessione party nel gruppo. Scegli visualizzazione pubblica o privata.

/party_stop

Ends the active party session in your group.

Termina la sessione party attiva nel gruppo.

/stop

Cancels the current action and returns to the menu. Private chat only.

Annulla l’azione corrente e torna al menu. Solo chat privata.

/about

Ask the bot to send you a link to this page.

Chiedi al bot di inviarti un link a questa pagina.


🚀 Quick Start Avvio Rapido

Want to run your own instance? You’ll need Python 3.10+ and a Telegram bot token from @BotFather.

1

Clone the repository and install dependencies

2

Create a .env file with your BOT_TOKEN

3

Run python -m bot.main and start playing!

💡 Tip: Add your Telegram chat ID as DEV_CHAT_ID in the .env to receive error reports directly in your DMs.

Vuoi eseguire la tua istanza? Ti servono Python 3.10+ e un token bot Telegram da @BotFather.

1

Clona il repository e installa le dipendenze

2

Crea un file .env con il tuo BOT_TOKEN

3

Esegui python -m bot.main e inizia a giocare!

💡 Suggerimento: Aggiungi il tuo chat ID Telegram come DEV_CHAT_ID nel .env per ricevere report degli errori direttamente nei tuoi DM.

🌍 Languages Lingue

The bot speaks Italian and English and automatically detects your Telegram language setting. Adding new languages is straightforward — just a YAML file.

Il bot parla Italiano e Inglese e rileva automaticamente la lingua impostata su Telegram. Aggiungere nuove lingue è semplice — basta un file YAML.


📜 The Story Behind the Bot La Storia del Progetto

This bot didn’t come out of nowhere — it has a story rooted in friendship, tabletop adventures and a passion for building things.

1 🕒 About 1 year ago — v1

🤝 Born at the Gaming Table

It all started with a friend and fellow party member. We both loved playing D&D, and since I enjoy writing Telegram bots, we decided to build one together: I wrote the code, he brought the ideas.

The result was the first version of the bot — rough around the edges but functional. You can still find it here: github.com/Cioscos/dnd_bot

Life got in the way — time ran short and inspiration faded — and the project was eventually shelved.

2 ✨ Today — v2

🤖 Reborn with AI

Fast-forward to today. Armed with AI assistance, I picked up the old codebase as a foundation and rebuilt the bot from the ground up — cleaner architecture, async-first design, full character management, live party sessions, bilingual support and a lot more.

What started as a fun side project between friends has grown into a fully-featured D&D companion for Telegram.

Questo bot non è nato dal nulla — ha una storia fatta di amicizia, avventure fantasy e voglia di costruire qualcosa di proprio.

1 🕒 Circa 1 anno fa — v1

🤝 Nato al Tavolo di Gioco

Tutto è cominciato con un amico e compagno di party. Condividevamo la passione per D&D e, dato che mi piace programmare bot Telegram, abbiamo deciso di crearne uno insieme: io scrivevo il codice, lui dava le idee.

Nacque così la prima versione del bot — acerba ma funzionante. Puoi ancora trovarla qui: github.com/Cioscos/dnd_bot

La vita si è messa di mezzo — il tempo scarseggiava e l’ispirazione era calata — e il progetto è stato accantonato.

2 ✨ Oggi — v2

🤖 Rinato con l’IA

Poi è arrivata l’intelligenza artificiale. Ripartendo dalle fondamenta di quel primo progetto, ho riscritto il bot da zero — architettura più pulita, design asincrono, gestione completa del personaggio, sessioni party live, supporto bilingue e molto altro ancora.

Quello che era un progettino nato per gioco tra amici è diventato un compagno D&D completo su Telegram.


📄 License Licenza

This project is for educational and personal use. D&D content comes from the D&D 5e API under the Systems Reference Document (SRD) licensed by Wizards of the Coast under the Open Game License v1.0a.

Questo progetto è destinato a uso educativo e personale. I contenuti D&D provengono dalla D&D 5e API sotto il Systems Reference Document (SRD) concesso in licenza da Wizards of the Coast sotto la Open Game License v1.0a.