Bestie
Your local-first Tibia progression, hunt-analysis, and objective-planning companion.
Open Bestie · Report a bug
Tibia spreads a character's progression across the Cyclopedia, Quest Log, achievements, titles, the Task Board, and hunting analytics. Bestie brings those systems into one character record, learns realistic kill rates from the player's own Hunt Analyzer sessions, and turns the combined information into practical estimates and plans.
It is not an automatic Tibia profile mirror. The player owns and records the progress; the application preserves it, connects it, and helps answer:
- What has this character completed?
- What remains unfinished?
- Which measured hunt advances the Bestiary most efficiently?
- What can be completed in the time available?
- How long will a Bounty or Weekly Kill Task take at this character's measured rate?
Repository guide
Product model
The application keeps three kinds of information separate:
| Layer | Meaning | Examples |
|---|
| Character progress | Persistent truth about one character | Achievements, Bestiary kills, Bosstiary stages, unlocked charms, discovered areas, quests, titles |
| Hunt evidence | Performance measured from one copied Hunt Analyzer | Duration, creatures killed, kill rate, respawn mode, date, route notes |
| Decision support | Calculations built from progress and evidence | Completion estimates, Opportunities, session comparison, Charm Points Plan, task estimates |
This separation is important. A Hunt Analyzer measures how quickly a creature was killed; it does not replace the character's Bestiary total. A Bestiary total entered once is shared by every session, Opportunity, comparison, and plan for that character.
Feature reference
Dashboard
The Dashboard summarizes the current character record using the same calculations as the individual trackers. It provides direct entry points to Achievements, Bestiary, Bosstiary, Charms, Measuring Tibia, Quests, and Titles.
Achievements
Purpose: Tracks completed achievements and achievement-point progression.
The tracker covers 570 achievements with:
- earned state;
- achievement points and grade;
- category;
- secret status;
- community rarity;
- the requirement or spoiler text;
- bookmarks.
Earned count and achievement points are reported separately. Achievements in the Removed category remain searchable but are excluded from obtainable totals. Achievements awarded by completing Measuring Tibia areas are derived automatically instead of being recorded twice.
Bestiary
Purpose: Tracks the character's Bestiary progress and charm points across creatures. This is the current progression state used by Bestiary analysis, Opportunities, comparison, and planning.
The tracker currently covers 833 creatures and records:
- Tibia's visible Bestiary stage:
?, 0/3, 1/3, 2/3, or complete;
- an exact kill count when the player has one;
- kills remaining and completion percentage;
- charm points earned on completion;
- Echo Warden progress and its additional charm-point reward;
- Animus Mastery;
- bookmarks.
An exact kill count takes precedence over a stage. When only a stage is known, the application uses the minimum kill count implied by that stage and labels resulting estimates as bounds rather than pretending the exact total is known.
Tibia awards the normal Bestiary charm-point reward when the third detail stage is completed. Echo Warden rewards are tracked separately in the Bestiary totals while still contributing to the character's available charm-point budget.
Bosstiary
Purpose: Tracks the character's Bosstiary progress across bosses.
The tracker covers 316 bosses and follows Tibia's three Bosstiary progress levels:
- Prowess — makes the boss eligible for a boss slot;
- Expertise — unlocks the boss for a Podium of Vigour;
- Mastery — provides the additional boss-slot equipment-loot bonus.
Bosses retain their Bane, Archfoe, or Nemesis category, because those categories determine the kill thresholds. The tracker records kills, current and next level, kills remaining, boss points earned, and bookmarks. Boss points are awarded at each reached progress level, so partial Bosstiary completion can already contribute points.
Charms
Purpose: Tracks the progression of unlocking Major and Minor charms using the currencies connected to Bestiary progression, while keeping charm effects and costs available for reference.
The tracker covers 25 charms, each with three unlock or upgrade stages:
- Major Charms spend charm points earned through Bestiary and Echo Warden progression.
- Unlocking and upgrading Major Charms generates Minor Charm Echoes.
- Minor Charms spend Minor Charm Echoes, not charm points.
- A promoted character receives an additional Minor Charm Echo allocation in Tibia.
For every charm, the application shows its type, current stage, effect, amount spent, next-stage cost, total cost, status, and bookmark. It keeps the two currencies separate and compares recorded Major Charm spending with the charm points earned in the Bestiary tracker.
Measuring Tibia
Purpose: Tracks Measuring Tibia Quest and Cyclopedia Map area progression, including the subareas required to complete each area.
The tracker covers 20 areas and 171 subareas. It records discovered subareas, groups them by area, shows how many Bestiary creatures are associated with each subarea, and derives:
- area completion;
- overall map progress;
- the achievement awarded by a completed area.
Since Tibia's 2026 discovery update, subareas are active automatically and fully discovered areas also contribute to the character's area speed bonus. The application tracks the discovery completion state; it does not simulate point-of-interest locations.
Quests
Purpose: Tracks quest completion states for the character and keeps questlog group and reward information searchable.
The current dataset contains 237 quests, with 93 named questlogs and 104 ungrouped quests. The tracker records whether each quest is completed, not completed, or not yet reviewed, plus bookmarks. It also shows the related questlog and reward information.
Current boundary: Tibia's Quest Log can expose individual missions inside a questline, but this application currently tracks completion at the quest level; it does not yet model arbitrary mission-by-mission progress.
Titles
Purpose: Tracks character titles and whether they are currently unlocked.
The tracker covers 113 titles and records earned state and bookmarks. It also shows each title's requirement and whether the title is permanent or can be lost when its condition is no longer met. This distinction matters because Tibia awards and removes some titles dynamically when the character logs in.
Shared tracker tools
All seven trackers use the same progress framework:
- search, sorting, filters, status, and bookmarks;
- paged, density-preserving entry lists;
- explicit distinction between not recorded and a confirmed zero/no;
- CSV import and export;
- TibiaDraptor JSON progress import for Bestiary and Bosstiary;
- entry details without leaving the tracker;
- immediate undo for progress edits, including
Cmd+Z or Ctrl+Z.
Record progress (/) searches every tracker and updates one value without making the player navigate away from the current task.
The detailed manual-entry contract is documented in Tracker Data Entry UX.
Bestiary planning and Hunt Analyzer sessions
Hunt Analysis
Hunt Analysis reads experience, raw experience, hourly rates, loot, supplies, profit/loss, damage, healing, creature kills and looted items from the shared Hunt Analyzer archive. Missing measurements remain unavailable. Rates and balance are calculated only from valid source totals and identified as calculated. Performance comparisons use the same respawn mode.
Results use the last successfully processed text. Editing a draft, navigating or reloading does not change that evidence; invalid reprocessing keeps the previous result. Older saved sessions need one explicit reprocess to add full measurements.
Bestiary Session
Purpose: Converts one copied Hunt Analyzer into a Bestiary completion estimate using the active character's actual progress.
Processing a session:
- reads the session duration;
- reads the creature kills between
Killed Monsters: and Looted Items:;
- matches creature names against the bundled Bestiary dataset;
- calculates each matched creature's measured kill rate;
- combines that rate with the character-wide Bestiary total;
- estimates kills remaining, time remaining, and charm-point efficiency.
Each session also stores a name, hunt date, notes, selected creatures, and whether it was measured under Regular or Rapid Respawn conditions.
Bestiary Sessions
Purpose: Presents the Bestiary estimates from all processed sessions in one workspace.
If the same creature appears in several sessions, it remains one candidate per session because each hunt may have a different measured rate. Every candidate reads the same character-wide Bestiary progress. The player selects which session should represent an objective so the same completion reward is not intentionally planned twice.
For the combined summary, creatures inside one session progress simultaneously, while separate sessions consume time sequentially.
Charm Points Plan
Purpose: Helps players plan and optimize Bestiary progression using current Bestiary progress, measured Hunt Analyzer rates, charm-point rewards, available time, and current spawn conditions.
The plan accepts time such as 90 min, 1.5 h, 2h 30min, or 2:30. It then:
- considers only selected Bestiary entries;
- filters sessions by
Regular or Rapid Respawn mode;
- allows a taken or otherwise unavailable spawn to be ignored temporarily;
- treats time spent in one session as progress for all selected creatures in that session;
- treats time across different sessions as sequential;
- awards charm points in the plan only when a Bestiary entry reaches completion;
- searches the feasible session allocations for the most charm points within the time budget, counting each creature reward once even when sessions overlap;
- prefers the plan that uses less time when equal rewards are possible;
- returns the entries that fit and an ordered recommended route.
Partial progress is never discarded. It simply does not produce the immediate charm-point reward until the Bestiary entry is completed.
Opportunities
Purpose: Identifies unfinished Bestiary progression opportunities and surfaces creatures and locations that remain useful candidates for future hunting.
Opportunities crosses the entire Bestiary dataset with character progress and the fastest measured rate for each creature. It provides four complementary views:
- Finishable Now — unfinished creatures with a stored measured rate, ranked by projected charm points per hour;
- Quick Wins — started entries closest to completion, whether or not a session covers them;
- Where To Go — locations ranked by the charm points still unclaimed among their creatures;
- Started And Dropped — unfinished progress for which no stored session currently provides a rate.
This is intentionally broader than session analysis: creatures that have never appeared in a saved Hunt Analyzer can still be valuable opportunities.
Session History, management, and comparison
Purpose: Preserves measured Hunt Analyzer sessions for later reference, comparison, correction, and planning.
Session History stores every session's:
- name and hunt date;
- raw Hunt Analyzer text and duration;
- recorded respawn mode;
- matched and selected creatures;
- notes about route, party, boosts, or other conditions;
- calculated charm points and charm rate;
- task creature and target.
The history can be searched across session names, notes, and creatures; filtered by respawn mode; sorted by any displayed measurement; reopened; renamed; edited; or deleted.
Compare Sessions ranks analyzed Bestiary sessions using the same summaries shown inside those sessions:
- charm points remaining in the selected entries;
- longest completion time within the session;
- projected charm points per hour.
Weapon Proficiency
Weapon Proficiency is a dedicated page in Planning & Sessions. It reuses the active character's Hunt Analyzer sessions, the canonical Bestiary creature difficulty and the canonical Bosstiary boss category to calculate weapon Proficiency XP, XP/h, kills, duration, and sortable per-row contributions. Regular creatures are rewarded by difficulty (Harmless 1 through Challenging 240) and bosses by category (Bane 500, Archfoe 5,000, Nemesis 15,000); a session may contain both, and every row contributes to the same total. Normal character/creature experience, boss points and Bestiary completion do not enter the formula.
Session History exposes total proficiency, proficiency rate and kills; Proficiency opens a session's complete breakdown. Compare Sessions includes a separate proficiency ranking with the best complete measured rate highlighted, independently of charm rate.
Players can maintain multiple named weapon plans per character with current XP and manual target XP. Remaining XP, estimated time, equivalent sessions and optional single-creature kills are derived from the selected session. Official weapon milestone thresholds are not bundled; the app does not invent them. XP is not automatically credited to a weapon because the Hunt Analyzer does not identify which weapon received each kill.
Unknown creatures, unknown bosses, missing difficulty or boss category and invalid kill data produce an explicitly partial result. Invalid/zero duration leaves the hourly estimate unavailable. Partial results cannot win the ranking or drive session-based weapon projections. See Weapon Proficiency architecture for data boundaries, compatibility and verification.
Task Sessions and Task Estimate
Purpose: Organizes and estimates creature-kill objectives—particularly Bounty Tasks and Weekly Kill Tasks—using performance measured from corresponding Hunt Analyzer sessions.
The task flow is separate from Bestiary thresholds and charm calculations. For each session, the player chooses one observed creature and enters the desired kill target. The application reports:
- kills already measured in the session;
- measured kills per hour;
- target kills;
- kills remaining;
- estimated remaining time and total time;
- the respawn mode under which the rate was measured.
This applies to creature-kill objectives. Tibia's Weekly Delivery Tasks are not kill-rate estimates and are therefore outside this feature.
Calculation contract
Per-creature Bestiary estimate
kill rate per minute = session kills / session duration
kills remaining = max(0, unlock target - character total kills)
time remaining = kills remaining / kill rate per minute
charm rate per hour = charm-point reward / time remaining × 60
The per-creature rate is annualised to one hour without capping it at the reward. For example, completing a 15-point entry in 30 minutes is correctly reported as 30 charm points/h.
Session summary
session charm points = sum of rewards for selected, incomplete entries
session time = longest remaining time among those entries
session charm rate = session charm points / session time × 60
The longest time is used because creatures killed in the same spawn advance together.
All-session summary
combined time = sum of each participating session's longest time
combined charm rate = selected charm points / combined time × 60
Task estimate
kill rate per hour = session creature kills / session duration × 60
kills remaining = max(0, target kills - session creature kills)
remaining time = kills remaining / measured kill rate
All projections assume the measured rate can be sustained. Competition, route changes, party composition, boosts, fatigue, and respawn conditions can change the real result.
Data ownership and persistence
| Information | Owner | Persistence |
|---|
| Tracker progress | Character record | Browser local storage |
| Bestiary exact kills/stages | Character | Shared by every session and plan for that character |
| Hunt Analyzer text and measured rate | Session | Session History |
| Session name, date, notes, and respawn mode | Session | Session History |
| Bestiary creature selection | Session | Browser local storage |
| Task creature and target | Session | Browser local storage |
| Available play time and plan eligibility | Character record | Browser local storage |
| Sort, search, filters, paging, open panels | View state | Intentionally temporary |
The application is static and requires no account or backend. Data is stored in browser localStorage, so it survives tab closure and browser restarts but remains local to that browser profile.
Whole-workspace JSON export includes every character. Restore validates the file, previews record counts, and downloads a recovery backup before replacement. Unsupported backup versions and malformed files are rejected. Storage failures are reported, and corrupt saved JSON is preserved rather than overwritten.
Individual trackers support CSV export and reviewed CSV import. Exports preserve confirmed zero/no answers with a Reviewed column; older CSV files remain importable. Malformed counts, boolean values, duplicate entries, and broken quoting are rejected before review. Bestiary and Bosstiary also accept TibiaDraptor JSON progress imports. Hunt sessions and planning state persist automatically in the current browser profile.
The application does not request Tibia credentials or connect to a Tibia account.
Running locally
This is a dependency-free static application.
python3 -m http.server 4173 --bind 127.0.0.1
Open:
http://127.0.0.1:4173/src/
Python's basic server can leave JavaScript modules cached. After source changes, use a hard reload (Cmd+Shift+R or Ctrl+Shift+R) or use the no-cache server documented in CONTRIBUTING.md.
Automated verification
With Node.js 22 or newer (no package installation required):
npm test
npm run lint
npm run build
lint checks JavaScript syntax, module paths, JSON, HTML IDs and local assets. build stages the static entry points in ignored dist/; production remains the unchanged GitHub Pages static deployment. This JavaScript repository has no TypeScript typecheck configuration.
Accepted Hunt Analyzer shape
Session: 01:30h
Killed Monsters:
250x Rotworm
500x Cyclops
Looted Items:
The parser currently expects Session: HH:MMh and creature lines formatted as <count>x <name> between the killed-monster and looted-item headings.
Repository structure
src/
├── app/
│ ├── features/ # parser, Bestiary analysis, comparison, opportunities, plans, tasks
│ ├── services/ # read-only dataset repositories
│ ├── state/ # character records, sessions, progress, persistence, transfer, undo
│ ├── trackers/ # tracker-specific rules, controls, totals, and transfer formats
│ ├── ui/ # shared and feature-specific renderers
│ └── main.js # application state orchestration and browser events
├── data/ # bundled Tibia metadata snapshots
├── styles/ # design tokens and application styles
└── index.html # application entry point
The important boundaries are:
- game metadata is read-only;
- saved files store player-owned progress rather than duplicated derived totals;
- tracker definitions own their rules and totals;
- shared renderers keep tracker behavior consistent;
- sessions own hunt evidence, not character-wide Bestiary progress;
- planning and comparison consume the same session calculations shown to the player;
- Measuring Tibia derives area achievements instead of duplicating completion state.
See Repository Structure, Product Journey, and UX Journey System for deeper implementation and product context.
Bundled datasets
Imported progress never replaces canonical thresholds, rewards, costs, categories, or other bundled game metadata.
Official Tibia references
The product language and rules in this README were checked against CipSoft's documentation and announcements:
- 2026 Echo Wardens and discovery-system changes
- Achievements, grades, and achievement points
- Bestiary and Charms introduction
- Bestiary, Bosstiary, Charms, Cyclopedia, and Cyclopedia Map guide
- Bosstiary progress levels, categories, boss points, and boss slots
- Bounty and Weekly Tasks
- Character titles
- Cyclopedia Map areas and subareas
- Major Charms, Minor Charms, and Minor Charm Echoes
- Party Hunt Analyser and Bestiary Tracker
- Quests, missions, Quest Log, and Quest Tracker
Current boundaries
- The application is a manual progress workspace, not a live account synchronizer.
- The Charms tracker calculates Minor Charm Echoes generated by recorded Major Charm stages; it does not yet know whether the character is promoted and therefore does not add Tibia's separate 100-echo promotion grant.
- Hunt Analyzer parsing expects the documented English text structure.
- Quest entries currently track completion, not individual mission steps.
- Task estimates cover creature-kill targets, not Weekly Delivery Tasks.
- Projections reuse measured performance; they cannot guarantee future hunting conditions.
- The bundled game data is a snapshot and must be updated when Tibia content changes.
- This is an unofficial fan project and is not affiliated with CipSoft.
Bestie roadmap
The original Bestie repository defined a broader character-focused Tibia product direction. That direction is preserved here rather than being overwritten by the migrated application's current scope.
Everything in the Feature reference describes the implemented application. The capabilities below are planned unless that feature reference says otherwise.
Product direction
Bestie is intended to organize the character experience into six connected areas:
- Dashboard — a presentation layer over relevant character, progression, hunting, analysis, Market, and tool data;
- Tracking — Achievements, Bestiary, Bosstiary, Charms, Measuring Tibia, Quests, and Titles;
- Analysis — measured-session analysis, comparison, Charm and hunt decisions, and task planning;
- Data — automatically maintained, curated, and browser-local datasets;
- Tools — focused Tibia calculations, parsers, and file utilities;
- Data Management — direct control over locally stored Bestie data.
A future repository configuration may identify one Tibia character. Bestie can then use TibiaData to resolve public character information and the character's World while keeping personal progress and imported Hunt Analyzer sessions browser-local.
Dashboard expansion
The Dashboard is planned to bring together:
- progression across the implemented trackers;
- recent Character History;
- Hunt Analyzer and Session History information;
- analysis results and recommended next actions;
- monitored Market items;
- shortcuts to Bestie's primary functions.
The Dashboard should remain a presentation layer over owned data rather than creating a competing source of truth.
Analysis expansion
Charmwise
Use current Charms, available Charm Points, Bestiary progression, creature information, and hunting context to help decide which Charms to unlock, prioritize, and use.
Full Hunt Analysis
Implemented in Hunt Analysis, using the shared session archive. Supported measurements when present include:
- Experience and XP/h;
- Loot, Supplies, and Profit;
- Damage and Healing;
- creature kills and Drops;
- session duration and related performance measurements.
Hunt Planner
Implemented in Tools → Hunt Planner. Filter by level, vocation, party and hunting context, then compare raw XP/h or profit/h. Reference observations and explicitly linked local sessions are ranked separately; measured rates are weighted by duration and separated by respawn mode.
Hunt Grounds performance should remain separate from Bestiary and Task calculations: hunting-place XP/h is not a substitute for the measured creature kill rates those estimates require.
Data expansion
Character History
Automatically build a history for the configured character using TibiaData, potentially including:
- Experience and Level evolution;
- Highscores history;
- Death history;
- other observable character changes.
This information can be presented through charts, tables, timelines, and summary statistics without requiring manual entry.
Hunt Grounds
The bundled Hunt Grounds snapshot includes 880 current TibiaPal vocation/hunt entries with source level minima, combat context, raw XP/h, market-based profit and available video links. Missing rates and unspecified team composition remain explicit. Source/import contract.
Hunt Grounds can support Hunt Planner while remaining independent from Bestiary progress and Task kill-rate estimates.
Market Watch
Allow players to select Tibia Market items to monitor for the configured character's World. TibiaData can resolve the World and TibiaMarket.top can supply the selected item data. Market values may also support features such as Imbuement cost calculations.
Session History
The implemented Session History remains the browser-local evidence archive for pasted or imported Hunt Analyzer sessions. Future analysis features should consume that same history rather than introducing separate session stores.
Tools (implementation status)
Elemental Damage
Implemented in Tools → Elemental Damage. Calculates mixed attack components using bundled creature HP and damage-received percentages. Missing resistances stay unknown; armor, mitigation and other combat mechanics are explicitly excluded.
Imbuements
Calculate material requirements, costs, duration, and value. Monitored Market data may provide current material prices for the configured character's World.
Minimap Markers
Implemented in Tools → Minimap Markers. Manage marker files locally, including:
- merging personal
minimapmarkers.bin data with community markers;
- matching markers by map coordinates;
- preserving a personal marker when personal and community data share a coordinate;
- converting between
minimapmarkers.bin and supported structured formats such as JSON;
- creating backups and merge information.
Morning Tibia
Implemented in Tools → Morning Tibia. Parse copied World Board and Guide dialogue for an explicitly observed World and date. Partial evidence remains unknown, unverified wording stays tentative, and manual corrections remain labelled. Invalid drafts preserve the previous processed observation. All text stays in the current character’s browser-local workspace.
Stamina
Implemented in Tools → Stamina. Projects usage, remaining hunting time, the 39:00/42:00 recovery thresholds, and a ready time after a planned hunt with an explicit remaining logout delay.
XP & Level
Implemented in Tools → XP & Level. Supports exact current XP or a level-start approximation, target requirements, partial level progress, and time from an observed XP/h rate. Tool inputs stay with the current character and are included in backups. Formula and source contracts are in calculator-sources.md.
Data Management expansion
Bestie is planned to provide explicit controls to:
- export browser-local Bestie data;
- import or restore a Bestie backup;
- clear selected local datasets;
- clear all browser-local Bestie data;
- migrate local data between Bestie versions.
Automatically maintained repository data—such as Character History and refreshed Market information—should remain separate from browser-local Data Management.
Planned data model
Repository configuration
Character name
|
v
Automatic updates
TibiaData
-> Character information
-> Character World
-> Character History
TibiaMarket.top
-> Selected Market items
-> World-specific Market data
Curated reference data
Multiple hunting sources
-> Hunt Grounds
Browser-local data
Tracking
Session History
|
v
Data Management
-> Export
-> Import
-> Clear
All relevant data
|
v
Analysis + Dashboard
Planned data sources and integrations
- TibiaData for character and World information;
- TibiaMarket.top for Market data;
- TibiaPal and other relevant sources for Hunt Grounds reference data;
- TibiaMaps.io for community minimap markers and marker-format reference information.
Additional sources can be incorporated when they improve coverage and data quality. Tracking progress and imported Hunt Analyzer sessions should remain in the player's browser unless the player explicitly exports them.
Automation
- CI checks the required static-application structure and validates every bundled JSON dataset.
- GitHub Pages deploys the application from
main.
License
Released under the terms of the LICENSE.
