Team city-building on Telegram
The public companion website and the full command reference.
UrbanPact has a public companion website at urban-pact.com. No login required — everything is read-only and visible to anyone.
| Page | What you'll find |
|---|---|
Rankings / |
Top cities by City Score. The home page shows the top 3 city cards (including prestige when earned) and a full rankings table with a ✨ prestige column. Click any city to open its full profile. |
| City Profile | Stockpile amounts, per-tick production, buildings with levels, active project progress, city bonuses (Market wage %, Bank dividend), and the full citizen roster with tiers and roles. |
Players /leaderboard.php |
All players ranked by reputation, gold, total gathered, or recruits. Click any player to open their profile. |
| Player Profile | Tier, stats, Estate track, tools with XP bars, medals earned and locked, and city link. Click any medal to see everyone who has earned it and who got it first. @username shown unless the player has privacy enabled. |
Activity /feed.php |
A live event log: players joining cities, cities completing builds, players reaching new tiers, and tool level-ups. Paginated, 30 events per page. |
Herald /herald.php |
The Realm Herald — a short daily story of what happened across every city: new cities and newcomers, tier promotions, buildings raised, big hauls, lucky scratches, and hunting trophies. A new chapter each day, with the full archive to browse. A preview is also posted to the community group daily. |
Buildings /buildings.php |
Full encyclopedia of every building: what it produces per level, what it costs, bonuses, and a population cost calculator. Adjust the population slider to see scaled material requirements for your city size. |
Stats /stats.php |
Global game statistics: total players, resources gathered, gold in circulation, tier distribution, and records (top gatherer, top reputation, highest-scoring city). |
Guide /guide.php |
This page. |
🔗 Player and city links throughout the site use internal IDs — no Telegram username ever appears in a URL, even for public profiles.
Open /settings in the bot (or tap ⚙️ Settings) to tune how much the game talks to you. Every option is a simple on/off toggle, and some only appear when they're relevant to you — for example, the hunting and wilderness options. New here and feeling the notifications? The game now points you to these controls the first time crafting or hunting starts pinging you, and there's a reminder on your /objectives screen — but you can open /settings and quiet anything at any time.
| Setting | What it does |
|---|---|
| 🔇 Quiet tick | Suppress the hourly tick report entirely. Medals and level-ups still come through. |
| 📋 Compact tick | Replace the full hourly report with a single-line summary. |
| 💡 Hide advice | Remove the AI tip from the bottom of your tick reports. |
| 📋 Show queue | List your action queue at the end of every hourly tick report, in the order it will actually run — so you always know what's coming next without opening the Queue panel. Off by default. |
| 🏛 Visit stories | Turn off the short story that arrives as a follow-up after one of your building visits fires. (City players.) |
| 🔕 Quiet crafting | Only notify you when 1 craft remains in your workbench queue. |
| 🔕 Quiet hunting | Only notify you when 1 hunt is left in your queue. (City players with a Hunter's Lodge.) |
| 🔕 Quiet wilderness | Mute even the low-quest refill ping — your camp panel still updates silently. (Wilderness & camping players.) |
| ⚖️ Metric units | Show animal weights in kilograms instead of pounds. |
| 🎰 Always let it ride | New Bingo cards auto-ride every tier straight to Blackout with no Take/Ride prompt. High-roller mode — a card that runs out of time before Blackout forfeits any lower win. Off by default. See Take or Ride. (City players.) |
| 🔒 Private profile | Hide your Telegram @username on the website leaderboard and player page. |
| Command | Who | What it does |
|---|---|---|
/start | Anyone | Register and enter the wilderness. Add ref_<id> from a referral link to credit a recruiter. City invite links (inv_...) skip the wilderness entirely. |
/camp | Wilderness & camping players | Wilderness home base. Shows housing tier, resource stockpile, quest queue, and inline buttons to send on quests, fill all slots, upgrade housing, or refresh the panel. Disabled once you join a city (unless camping mode is active). First visit shows a numbered tutorial; camping-mode players see a "🏕 Camping Trip" header instead. |
/gocamping | City players | Spend 300g to enter camping mode and work toward wilderness medals. If your city has a Hunter's Lodge (Town Hall 2), a free hunting option also appears — or use the 🏹 Hunt button in your navigation menu to go straight to hunting without the camping prompt. A Bow is required to hunt. Tap "🏙 Return to City" when done. |
/objectives | Anyone | Twelve-step beginner checklist across two phases (5 wilderness, 7 city). Shows your next hint and marks each goal complete as you reach it. The Goals button disappears from the keyboard once all twelve are done. |
/profile | Anyone | Your tier, personal gold, reputation, recruiter title, and current nickname/privacy settings. Also works in the community group, where it posts a short showcase instead — your name, tier, reputation, your estate and everything you have on display, your medal count and your home city. Your gold, wages, loyalty, queue and settings stay private to you. |
/stats | City players | Your lifetime statistics — totals for gathering, crafting, gold earned, projects, and more. |
/huntstats | City players | Your lifetime hunting record — total hunts, pelts banked, biggest catch, and rarest animal taken. |
/passport | Anyone | Your Player Passport — a travel log of every premium landmark you've visited, with realm-wide completion stats and travel medals. Also opens from the 🛂 button on /profile. |
/nickname <name> | Anyone | Set an in-game nickname (2–32 chars) shown instead of your Telegram name everywhere in the bot and website. Use /nickname clear to remove it. |
/settings | Anyone | Open the preferences panel — tick report style, quiet crafting/hunting/wilderness, visit stories, Bingo always-ride, units, and privacy. See Settings & Preferences above for the full list. Also accessible via the ⚙️ Settings keyboard button. |
/privacy on|off | Anyone | Toggle whether your Telegram @username appears on the website. Opens the full settings panel — same as /settings. |
/city | City members | Your city's resources, buildings, members, active project, and prestige score with wage bonus (when earned). Mayors get a ✏️ Rename City button (changes the display name for 500💸). |
/cities | Anyone | Lists all public non-starter cities. |
/rankings | Anyone | Top cities by score. Four tabs: Daily, Weekly, All-Time, and ✨ Prestige (rolling 14-day visitor prestige). Also visible on the website rankings page — click any city to see its full profile. |
/visit | Citizen+ | Open the visit panel to tour other cities' premium landmarks. Away visits earn you ⭐ Reputation and City Score for your home city; each landmark has a 24-hour cooldown. See Premium Landmarks. |
/join <handle> | Anyone | Join a city. Free from the wilderness (leftover resources → gold). Costs 50g bus pass when switching between real cities. |
/found <handle> [Name] [private] | Settlers+ | Found a new city. Costs 2,000g. Free from wilderness (no bus pass). Bus pass also charged if leaving a real city. You become mayor. |
/queue | Anyone | View your action queue and slot count. |
/queue gather <resource> | Anyone | Add a gather action to your queue. |
/queue work <city> <resource> | Anyone | Queue one tick of work at a remote city. Uses their building multiplier; 10% of yield stays there, 90% goes home. |
/queue_oddjobs | Anyone | Queue an odd jobs action — earns 50–100g personal gold that tick. No rep, no city resource contribution. Keeps your queue streak going. (/oddjobs still works as an alias.) |
/craft_planks /craft_bricks /craft_iron etc. | Anyone (Workbench) | Shortcut to start a workbench craft for that recipe. Same as tapping the recipe button in /craft. |
/queue_planks /queue_bricks /queue_iron /queue_steel /queue_rope /queue_charcoal | Developer+ (Workbench 5) | Queue a crafting action for that recipe. Fires once per tick, consumes city stockpile ingredients, outputs to city stockpile. Output scales with your tool level. Also accessible via the 🔨 Craft Resources button in /queue. |
/scratch | Anyone | Buy a 50g scratch ticket. Win gold or Tier 1/2 resources (or both). Resource prizes go to your city stockpile. No cooldown — limited only by gold. Prize odds are not disclosed. |
/crates | Anyone | View your Prize Crate stash and lifetime stats. Open one or open all — each crate pays a little gold plus Bingo Balls for /bingo. |
/bingo | Citizen+ (Trading Post) | Play Bingo: buy a card (500g), draw balls from your banked stash, and Take-or-Ride up the prize ladder toward Blackout. See Bingo & Prize Crates. |
/queue clear | Anyone | Clear your entire queue. |
/build | City members | View active project progress or list buildable options. |
/build <slug> | Mayor / Minister of Urban Development | Start a build project. |
/build cancel | Mayor / Minister of Urban Development | Cancel active project. 50% of consumed materials refunded. |
/resources | City members | Tabbed panel — 📦 Stock (amounts + per-hour production), 🏗 Needs (your build project, any districts under construction, and what's holding new families back from moving in), 🔄 Trade (active trade agreements), and 📉 Forecast (next-tick draw). |
/visitors | City members | A running log of who has visited your city's premium landmarks — the version of the hourly "Visitors to your city" line you can look back at. Also shown as ✨ Recent Visitors on the city's public web page. |
/trade | City members (negotiating: Mayor / Trade Minister) | View your city's trade deals. Leaders can offer, counter, accept, decline, and end deals. See Trade Between Cities. (/trades still works as an alias.) |
/craftworks | City members (manage: Mayor / Minister of Manufacturing) | View Craftworks worker assignments. The Mayor or Minister of Manufacturing can toggle recipes on/off — workers split evenly across active recipes, producing 1 unit/hr per worker. Requires Craftworks building (Town Hall 3). |
/export | Mayor / Minister of Exports | Manage your city's Customs House export orders — enable resources and set a per-resource reserve; surplus above the reserve sells for Treasury each tick. See the Export Market. |
/tycoon | Tycoons | The Tycoon Luxury Trade panel — queue Market Runs to buy Letters of Credit, manage your luxury specializations, and track your Tycoon rank. See Tycoon Luxury Trade. |
/roles | Mayor only | Open the role assignment panel. Member-first button flow — tap a member, then tap a role to assign it. Transfers automatically from any previous holder. |
/visibility public|private | Mayor only | Toggle city open or invite-only. |
/invite | City members | Get a direct invite link for your city. Invitees join immediately, no bus ticket. |
/linkgroup | Mayor only (in group) | Link a Telegram group to your city for live announcements. Bot must be admin. Also generates the group join link shown on /city and /profile. |
/unlinkgroup | Mayor only (in group) | Disconnect the city's Telegram group. |
/synctitles | Mayor only | Re-sync role titles in the city group after role changes. |
/feedback <message> | Anyone | Send feedback or a suggestion to the team. Works in private chat or the community group. Tip: reply to any message with /feedback (optionally with your note) to send feedback about that specific message — the team sees what you were reacting to. Even easier (private chat only): just reply to one of the bot's messages with a plain note — no /feedback needed — and it's saved automatically, with an Undo button in case you didn't mean to. (This auto-capture does not apply in the community group.) Spotted a bug in a screenshot? Send the screenshot with /feedback your note as its caption (private chat or community group), or in private chat just reply to one of the bot's messages with the screenshot — it's attached to your report so the team can see exactly what you saw. |
/myfeedback | Anyone | See the feedback you've sent and its status (🆕 new, 🗓 planned, 🔨 in progress, ✅ done, 🚫 declined). When the team resolves an item with a reply you get a DM — tap 👍 Got it to acknowledge it. Every idea that ships earns you a rung on the Contributor medal (Bronze → Diamond) as a thank-you. |
/medals | Anyone | View all medals — completed ones show the date earned, locked ones show what's required. (/milestones still works as an alias.) |
/refer | Anyone | Get your referral link. |
/estate | Anyone | View your current tier on the Estate track (your personal home) and upgrade cost. (/house still works as an alias.) |
/estate upgrade | Anyone | Purchase the next Estate-track tier. (/house upgrade still works.) |
/craft | City members | Open crafting panel. Shows all recipes, current stock, and queue. Requires Workbench. Shows ⏩ Rush boost countdown when active; tap "Activate Rush Token" to burn a token for a 2-hour 50%-faster boost. |
/use <item> | Anyone | Use a consumable from your inventory. Supports rush_token (activates the 2-hour craft speed boost — 50% faster; active crafts are sped up immediately) and hired_help (adds 5 crafting slots for 2 hours; requires Workbench 5). |
/vendor | Anyone | Browse the city Trading Post. Lv1: tools. Lv2: consumables (Queue Boost, Rested Potion, Rush Token, Hired Help). Lv3: Luxury Goods section visible to Mayor and Minister of Treasury — spend 500💸 per unit of any Tier 3 resource. Once your city has a Customs House, the luxury goods section is replaced by production (specialty buildings produce Tier 3 goods each tick). |
/tools | Anyone | View your owned tools, levels, and XP progress. |
/menu | Anyone | Show the navigation keyboard (Profile, City, Queue, Build, Tools, etc.). Useful if you dismissed it. |
/wiki <topic> | Anyone | Links you straight to the right section of this guide for a topic — e.g. /wiki master's charter, /wiki hunting, /wiki tycoon. Free-text: partial words and phrases work. /wiki on its own lists the popular topics. |
/changelog [days] | Anyone | The last few days of updates as compact plain text, right in the chat — a quick way to catch up without opening the website. Defaults to the last week; pass a number for a wider window (e.g. /changelog 30). Long windows are trimmed to fit. For the full, styled, paginated history see the website changelog. |
/credits | Anyone | Who made UrbanPact — the creator, the tools it was built with, and a thank-you roll-call of the players whose feedback shapes the game (that could be you). |
/help | Anyone | Quick command list in the bot. Includes a 💡 Get AI Tips button for personalized advice cached per hour (admins can refresh freely). |