Team city-building on Telegram
Reputation and medals, the tier ladder, the Estate track, recruiting, and your in-game identity.
Reputation is the main progression gate between tiers. You can't grind it with gold — you earn it by playing actively.
| Source | Amount | When |
|---|---|---|
| Gather action fires | +2–4 | Random amount each tick a queued gather executes |
| Active tick bonus | +1 | Any tick where at least one action fired |
| Library bonus | +1 × level | Active players in cities with a Library — scales with the Library's level (L1 +1, L2 +2, L3 +3 …) |
| Wilderness medals | +5–10 | One-time: First Expedition (+5), Packed and Ready (+5), Roughing It (+5), Off the Grid (+10), Civilized (+10) |
| Medal: First Gather | +5 | One-time, on your first successful city gather |
| Medal: Full Queue | +5 | One-time, when you fill all your city queue slots |
| Medal: Builder | +10 | One-time, when a project completes and you contributed |
| Medal: Artisan | +5 | One-time, when your first workbench craft completes |
| Build project completion | up to +25 | Proportional to your contribution; top contributor gets max |
| Recruiting | +50 | When someone you recruited reaches Citizen tier |
Medals are one-time events — the bot will message you when you unlock one. One gather action fires per hour, earning a random +2–4 ⭐ Reputation plus +1 activity bonus — so +3–5/hr base, or +4–6/hr in a city with a Level 1 Library (more at higher Library levels — the bonus scales with level). Citizen (100 ⭐ Reputation) takes roughly 20–33 hours of active play depending on luck and your city's Library level.
The table above is not a complete list — more medals exist throughout the game, tied to buildings, trades, tools, and activities not covered here. You'll discover them as you play.
Want the full catalogue? Open 🏅 Medals in the bot menu, or send /medals. It lists every medal by category, and for the ones that climb through tiers — 🥉 Bronze up to 🔮 Mythic — it shows the tier you're on, what the next tier asks for, and how close you are.
🤫 Not every medal is on the list. A few secret medals exist — they only reveal themselves the moment you earn them. How do you find one? Play your way.
Tiers unlock capabilities and queue depth. Promotions happen automatically at the end of each tick once you meet all conditions. Citizen is a permanent floor — once earned, you can never fall below it.
| Tier | Identity | Requirements | Unlocks |
|---|---|---|---|
| Settler | You showed up | Default starting tier | Work, earn wages, join a city, gather resources |
| Citizen | You belong here | 1,000 gold + 100 reputation | City roles, +1 queue slot. Permanent once earned. |
| Developer | You're building the city | 2,500 gold + 250 reputation | Deeper city infrastructure access, +1 queue slot |
| Entrepreneur | You're running the economy | 5,000 gold + 500 reputation + completed trade route | Found cities, run trade routes, away wage bonus, +1 queue slot |
| Tycoon | You keep the realm's luxury flowing | 2,000 reputation + premium visits in 5 distinct cities + 25 total premium visits + the Townhouse tier on your Estate track | Luxury Trade — import luxury to keep other cities' premium buildings stocked; Tycoon prestige rank; +1 queue slot |
👑 Tycoon is a permanent tier — no maintenance cost, no demotion. There's no gold requirement to reach it, so never be afraid to spend on your way up. As a Tycoon you become a licensed luxury importer: buy prepaid credits with a queued Market Run, specialize in luxuries other Tycoons aren't covering, and earn from every premium visit you keep open. See /tycoon once you arrive.
Every player can own a personal home, purchased with gold — the Estate track, an eight-rung ladder from Tent all the way up to the Estate. Your home does two things: it shows on your /profile as a visible mark of investment, and it contributes treasury to your city every tick — whether you're active or idle. A higher Estate-track tier means a larger passive city contribution.
/house still works as an alias.)
/house upgrade still works.)
| Tier | Cost | City treasury/hr |
|---|---|---|
| ⛺ Tent | 250g | +2 |
| 🏚 Shack | 2,000g | +4 |
| 🛖 Cabin | 6,000g | +6 |
| 🏡 Cottage | 18,000g | +8 |
| 🏘 Townhouse | 45,000g | +10 |
| 🏠 House | 90,000g | +12 |
| 🏛 Manor | 175,000g | +16 |
| 🏰 Estate | 350,000g | +20 |
🏙 The city contribution fires every single hour — even when your queue is empty. An idle player with a Manor still chips in 16 treasury to the city while they sleep.
You don't have to keep checking whether you've saved enough: the first hour your gold reaches the cost of your next tier, your hour report gives you a one-time heads-up ("🏠 You can now afford a Cabin (6,000g) — upgrade with /estate"). It won't nag you while you sit on the gold, and re-arms whenever you cross the threshold fresh — after you upgrade, or if you spend down and save back up.
Once you own a Cottage or better, your /estate panel opens a second door: customization. Buy pets, paint, plants, decorations, and vehicles with your personal gold — a common pet is an afternoon's savings, a legendary one is a real project. There's no separate currency for any of it: everything is priced straight in gold, so rarer pieces simply cost more.
Your Estate tier decides how many of each you can display at once. You can own more than you can show — the rest sit safely in your collection, waiting for the day your house is big enough. Nothing you buy is ever lost or taken away, and swapping what's on display costs nothing and can be done as often as you like.
| Estate tier | Cost | 🐾 Pets | 🎨 Paint | 🪴 Plants | 🖼 Decor | 🚗 Vehicles |
|---|---|---|---|---|---|---|
| ⛺ Tent | 250g | — | — | — | — | — |
| 🏚 Shack | 2,000g | — | — | — | — | — |
| 🛖 Cabin | 6,000g | — | — | — | — | — |
| 🏡 Cottage | 18,000g | 1 | ✓ | 1 | — | — |
| 🏘 Townhouse | 45,000g | 2 | ✓ | 2 | 1 | — |
| 🏠 House | 90,000g | 4 | ✓ | 3 | 2 | — |
| 🏛 Manor | 175,000g | 8 | ✓ | 4 | 4 | 1 |
| 🏰 Estate | 350,000g | 16 | ✓ | 5 | 8 | 2 |
Pets double at every rung — each upgrade is a real jump, not a nudge. Decorations open up at a Townhouse, and Vehicles wait for a Manor. Paint is a swap rather than a slot: you always have exactly one colour on the walls, and it's the range of colours you can buy that widens as your home grows.
Give a pet a name and it'll show up that way everywhere your Estate is visible — on your /profile, your /estate panel, and your public player page.
🦸 Special Flair works differently. It isn't bought with gold — it's earned. Join the community chat and you're given the Community Cape for good, and you wear it no matter what home you have — Tent, Estate, or no home at all. It's yours forever, whether you're still in the chat or not.
Bring in new players and earn reputation for it. Recruits only count once they reach Citizen tier — so quality matters more than quantity.
When someone joins via your link and later reaches Citizen, you receive +50 reputation and your recruiter title advances:
| Recruits | Title |
|---|---|
| 1 | Scout |
| 5 | Recruiter |
| 15 | Talent Broker |
| 30 | City Architect |
By default, UrbanPact uses your Telegram display name everywhere — in the bot, on the website leaderboard, in the activity feed, and on city pages. You can customize this with a nickname and control what strangers see on the website.
Set an in-game name that shows instead of your Telegram name everywhere in the game. Useful if your Telegram name is long, awkward, or just not the persona you want to play as.
Your nickname appears everywhere: bot greetings, tick reports, AI advice, the website leaderboard, city member lists, and the activity feed. It does not affect your Telegram identity in any way.
Tap ⚙️ Settings in the menu or send /settings to open your preferences panel. Each option is a toggle — tap the button to flip it on or off. Changes take effect immediately.
If you don't see the ⚙️ Settings button yet, send /menu to refresh your keyboard.
| Setting | Effect |
|---|---|
| 🔇 Quiet tick | Suppresses the hourly tick report entirely. You still receive medal unlocks and level-up notifications. |
| 📋 Compact tick | Replaces the full report with a single summary line — city name, what happened, and wages earned. |
| 💡 Hide advice | Removes the AI-generated tip from the bottom of each tick report. |
| 🏛 Hide visit stories | Suppresses the short story that follows a building visit. Visit result (rep & prestige earned) still appears in your tick report; only the narrative follow-up is hidden. |
| Setting | Effect |
|---|---|
| 🔕 Quiet wilderness | Suppresses quest completion DMs unless exactly 1 quest remains in your queue — so you only hear from it when it's time to queue more. |
| Setting | Effect |
|---|---|
| 🔕 Quiet crafting | Suppresses craft completion notifications unless you have exactly 1 craft remaining in queue — so you only hear from it when it's time to queue more. |
When private profile is on, your Telegram @username is hidden on all public website pages — only your in-game name (nickname or Telegram name) is shown. Your profile is still fully viewable; only the @username is suppressed.
| Setting | Effect |
|---|---|
| 🔒 Private profile | Hides your Telegram @username from the website leaderboard, your player profile, city member lists, and the activity feed. |
You can also toggle privacy directly with /privacy on or /privacy off — these open the settings panel so you can see the full picture.