docs
how to talk to iteverything happens by mentioning @trefworld on x in plain words. no slash commands. the bot reads mentions every minute, replies with a card when it matters and with text when it does not.
commands
| say | what happens | reply | limit |
|---|---|---|---|
| hatch / i want one / give me a tref | a creature seeded from your username hatches at the village | hatch card | one per person |
| feed it tacos (anything) | hunger reset, +10 xp, it reacts in its own voice | feed card | every 2h |
| train atk / def / spd, make it faster | +1 stat, +5 xp | text | every 6h |
| send it to the swamp / bog / lava / ruins / ice / forest / void, go explore | expedition starts. watch it walk on the map | text with eta, card on return | one trip at a time |
| recall / come home | comes back early with half the loot | text | - |
| status / how is it | sprite, level, stats, hunger, items, where it is | status card | - |
| diary | its latest diary entry about you | diary card | - |
| evolve | if the requirements are met it grows a stage | evolution card, or what is missing | - |
| cheer (during a raid) | +10% damage for your creature for 20s | none, it just counts | - |
| sell | sells common items for gold | text | - |
| anything else | it talks back in character and remembers up to 8 facts about you | text | - |
zones
| zone | also called | base trip | danger | loot flavor |
|---|
trip time scales with spd (fast creatures go faster) and hungry creatures walk 30% slower. on the way it finds items, meets other creatures in the same zone (a bond, recorded for both), fights wild things (never fatal: worst case it comes home with 1 hp) and sometimes gets lost, which halves the loot.
species
evolution
| stage | needs | stats | sprite |
|---|---|---|---|
| 1 | hatch | x1.0 | 24px |
| 2 | level 10 + one rare item (consumed) | x1.4 | 32px, markings |
| 3 | level 25 + one epic item + 3 bonds | x1.9 | 40px, accessory |
levels come from xp: feeds 10, train 5, expeditions 40 to 200, raid damage share x100. level n needs 20 x (n-1)^2 xp. hunger decays over 8h; a starving creature deals 50% raid damage and walks slower. it never dies.
raids
| mechanic | what it does |
|---|
every hour a boss opens with a 20s countdown, then a fight at 5 ticks a second for up to 180s. each tick every creature at home hits for atk x stage x (1 + cheer) x roll(0.8..1.2) minus boss def. the boss swings once a second at a random creature; at 0 hp it is downed for this raid. boss hp scales with the number of creatures at home (village regulars fill in below 4). boss defeated: top 10 by damage share get loot, the mvp can roll a mythic. timeout: a common for everyone who hit it. the raid card goes to the mvp on x once per raid.
items
| rarity | chance | sell value |
|---|
x api cost
the x api is pay per use. at default caps (400 reads, 100 writes per day) the worst case is 400 x $0.005 + 100 x $0.015 = $3.50 a day, about $105 a month. the poller stops when a cap is hit and resumes the next utc day. cards are only posted for hatch, feed, status, diary, evolve, expedition return and one raid card per raid; everything else is text and cheers are not answered at all.