CharmsBot
Discord bot for Tibia • Documentation & Changelog
🎯 Overview
CharmsBot is a comprehensive Discord bot designed for Tibia players to optimize their hunting experience. It provides advanced charm assignment calculations, element efficiency analysis, loot splitting, and utility tools to help players maximize their damage output and manage hunts efficiently.
🎯 Features
Character Management
- Charm Points Budget System: Set your total charm points and compute optimal assignments within your budget
- Multi-Level Charm Support: Level 1 (5%), Level 2 (10%), Level 3 (11%) proc rates
- Limits: Up to 15 characters per user, with 20 saved analyses and 20 saved bestcharms per character
Hunt Analysis Tools
- Optimal Charm Assignments: Hungarian Algorithm-based assignments
- Element Efficiency Analysis: See which elements deal bonus damage or are resisted
- Damage Calculations: Vulnerability, mitigation, and damage-per-proc breakdowns
Loot Management
- Split Loot Calculator: Equitable distribution with extra expenses support
- Transfer Instructions: Exact in-game transfers for settling debts
Utility Tools
- Weapon Proficiency XP Calculator
- Hot Cuisine Quest Calculator
🚀 Getting Started
Quick Start Guide
-
Create a Character
/character add
Enter name, level, max HP, max mana, and Total Charm Points (Tibia:Cyclopedia → Bosstiary & Charms → Charms), then select charms + levels. -
Analyze Your Hunt
/analysis
Select your character and paste Hunt Analyzer data. Optionally save it. -
Find the Best Charms
/bestcharms
Evaluates ALL damage charms, shows what you need and the reset cost.
🔧 Technical Details
Charm Damage Calculations
Elemental Charms (Enflame, Freeze, Zap, Poison, Curse, Wound, Divine Wrath):
- Base damage:
min(5% × creature_health, player_level × 2) - Final damage:
base_damage × vulnerability × (1 - mitigation/100)
Physical Charms (ignores vulnerability and mitigation):
- Overpower:
min(5% × max_hp, player_level × 2)capped at8% × creature_health - Overflux:
min(2.5% × max_mana, player_level × 2)capped at8% × creature_health
Charm Level Ratios
- 🔹 Level 1 — Proc Rate: 5% — Damage Multiplier: 0.5×
- ✨ Level 2 — Proc Rate: 10% — Damage Multiplier: 1.0×
- ⭐ Level 3 — Proc Rate: 11% — Damage Multiplier: 1.1×
Algorithm
The bot uses the Hungarian Algorithm (scipy.optimize.linear_sum_assignment) to solve the optimal assignment problem and maximize total output.
🛡️ Security Features
- Account Age Verification
- Rate Limiting (per-user and per-guild for heavy commands)
- Input Validation
- Creature Limits (prevents resource exhaustion)
📊 Supported Data
Creatures
- Health points
- Mitigation values
- Elemental vulnerabilities and resistances
Charms
All 9 damage charms are supported:
- Enflame
- Freeze
- Zap
- Poison
- Curse
- Wound
- Divine Wrath
- Overpower
- Overflux
🌐 Language Support
CharmsBot is available in English and is designed to support the international Tibia community.
🤖 Add to Your Server
Use the link below to add CharmsBot to your Discord server.
CharmsBot is a fan-made project and is not affiliated with or endorsed by CipSoft GmbH. Tibia is a registered trademark of CipSoft GmbH.