Frequently Asked Questions
FAQ
đ Getting Started
đŻ How Does This Work?
Township Cards is your automatic trading partner finder for Playrix Township card collections. Here's how it works:
-
1
Set Up & Maintain Your Inventory: Mark which cards you have (and how many) and which cards you need. Keep it updated as you get new cards! The more accurate your inventory, the better matches you'll get.
-
2
We Find Matches Automatically: Our matching engine searches through all players and finds people who have cards you need AND need cards you have. No more scrolling Reddit or Discord!
-
3
Connect & Trade: Copy their friend code, add them in Township, and coordinate the trade. You can even mark trades as complete right here to keep track!
-
4
Stay Updated: Get daily email notifications when new matches appear, and track your trading history with friends!
The best part? It's completely free, has no ads, and works automatically in the background. Set up your inventory, keep it updated as you get new cards, and we'll keep finding you new trading partners as the community grows! Both givers and receivers can now update their inventory automatically when trades are confirmed!
Why am I being asked to complete my profile?
To access features like My Collection, Matches, Friends, Trades, and Messages, you need to complete your profile with your Game Name and Friend Code. This helps other players identify you when trading and ensures everyone can connect properly in Township.
If you see a message saying "Please complete your profile with your game name and friend code to access this feature," simply click the link to go to your profile page and fill in those fields. Once done, all features unlock automatically!
Why do I need to verify my email to send friend requests or messages?
Email verification is required for outbound social actionsâsending friend requests, creating trades, and sending messages. This protects our community from spam and helps ensure interactions come from real accounts.
Good news: You can still receive and respond to friend requests, confirm trades sent to you, and read messagesâall without email verification. Verification is only required when you're the one initiating the action.
To verify your email, check your inbox for the verification email we sent when you signed up. Click the link to verify instantly. If you can't find it, you can request a new verification email from your profile page.
Can I view profiles and leaderboards without completing my profile?
Yes! You can browse other players' public profiles and view leaderboards even if you haven't completed your own profile yet. This lets you explore the community and see what's possible before committing to setting up your trading profile.
What is the timezone setting for?
Setting your timezone makes all dates and times appear in your local time! Instead of seeing confusing UTC times, you'll see when messages were sent, when trades happened, and when users joinedâall in your own timezone.
We'll try to detect your timezone automatically from your browser. If we can't, we'll default to UTC and show a reminder banner asking you to set it. You can always change your timezone in your profile settings.
Bonus feature: When both you and another player have set your timezones, you'll see a time offset indicator (like "+3h" or "-5h") showing how many hours ahead or behind they are. This helps when coordinating trades across different time zones!
đ Inventory Management
Do I need to update my inventory after trading?
It's easier now! When you mark a trade complete, you'll see a "Still have more?" prompt asking if you still have extras of the card you just gave. Simply click "Yes, I have more" or "No, that was my last" and your inventory updates automatically.
The prompt is smartâit pre-selects the most likely answer based on how many you had. If you had 3 copies and gave one, "Yes, I have more" will be highlighted. If you only had 1, "No, that was my last" will be highlighted.
For cards you receive: After confirming you received a card, you'll see a prompt asking if you want to add it to your inventory. Simply click "Yes, add to inventory" and your inventory updates automatically! If you prefer to update manually later, click "No, I'll update later" and you can adjust your inventory from the Inventory page anytime.
What happens if I make a mistake on the "Still have more?" prompt?
If you accidentally clicked the wrong option, you can cancel the trade (if the recipient hasn't confirmed yet) and your inventory will be restored. Then mark the trade complete again and choose the correct option.
Alternatively, you can always manually adjust your inventory from the Inventory page at any time.
How do I know when I've completed a collection?
When you own at least one copy of every card in the active collection, you'll see a celebration modal with confetti animation! The system automatically detects completion when you view your inventory page.
After dismissing the celebration, you'll see a "Collection Complete!" badge at the top of your inventory page showing which completion round you're on (1st, 2nd, 3rd, etc.). Your progress bar will also turn amber/gold to indicate completion.
You'll also receive a congratulatory email celebrating your achievement! The email includes your completion round number and a link to view your collection.
What happens after I complete a collection?
When you complete a collection, the system records your completion and shows you a celebration. Your completion is tracked with a round number (1st completion, 2nd completion, etc.).
Start a new round: After completing a collection, you'll see a "đ Start New Round" button in the completion badge. Click it to reset all your cards to 0 and start collecting again! This matches the in-game behavior where collections repeat.
Your matches will continue to work normallyâyou can still trade cards even after completing the collection!
How do I reset my collection and start a new round?
After completing a collection, you'll see a "đ Start New Round" button in the completion badge at the top of your inventory page. Click it to see a confirmation modal that shows:
- The next round number (e.g., "Round 2")
- A warning that all your cards will be reset to 0
- Confirmation that your previous completion records are preserved
Click "Reset & Start Fresh" to confirm, or "Cancel" to keep your current progress. Once reset, you'll start with 0 cards and can begin collecting again. You'll receive an email notification confirming the reset and encouraging you to start collecting!
Note: You can only reset if you've completed the collection. The reset button only appears when you have a completion record and currently own all cards in the collection.
What happens to my previous completion when I reset?
Your previous completion records are permanently preserved! When you reset, only your card quantities are set to 0âyour completion history remains intact. This means:
- All your previous completion records (Round 1, Round 2, etc.) are kept
- The round number shown on your inventory page is calculated from your completion history
- Future features like completion badges will use this historical data
When you complete the collection again, a new completion record will be created for the next round automatically.
Can I reset a collection that has ended?
No, you cannot reset collections that have ended. The reset button only appears for active collections. Once a collection ends, it becomes read-only and you cannot modify your inventory or reset it.
If you try to reset an ended collection, you'll see an error message. This prevents accidental resets and preserves historical data for completed collections.
What happens when a new collection is released?
When Playrix releases a new card collection in Township, we update our system with the new collection data. Here's what happens:
- The new collection becomes active â You'll see the new cards on your inventory page
- Your old collection data is preserved â All your cards, trades, and completion records from the previous collection remain in the system
- Matches update automatically â The system recalculates matches based on the new collection
Important: Your inventory for the old collection is NOT deleted. You can browse your historical data anytime from the Collection History page—just click "Collection History" at the top of your inventory.
Will I lose my cards when a new collection starts?
No! Your card inventory from previous collections is permanently preserved. When a new collection launches:
- All your UserCard records (what cards you owned and how many) remain in the database
- Your completion records stay intact (if you completed the collection)
- Your trading history with partners is preserved
The old collection simply becomes inactive, and the new collection takes over as the active one. This mirrors how Township handles collection seasons.
How do I view my past collection history?
Click "Collection History" at the top of your inventory page to see all the collections you've participated in. You'll see:
- Progress bars showing how many cards you collected in each collection
- Completion badges (bronze, silver, gold) for collections you completed
- Card-level detail — click any past collection to browse sets and see which cards you had
Past collection views are read-only—you can't change your inventory for ended collections, but all your data is preserved and browsable.
Do I need to do anything special to get the completion celebration?
No! The system automatically detects completion when you view your inventory page. Just make sure you've marked all cards as owned (quantity ⼠1) in your inventory. The celebration will appear automatically the next time you visit the inventory page after completing your collection.
If you complete your collection but don't see the celebration right away, try refreshing the inventory page. The detection happens in real-time when you load the page.
đ Finding & Understanding Matches
How do I find trading partners?
After you add your card inventory (marking which cards you have and which you need), our matching engine automatically finds other players who are compatible traders. Visit the Matches page to see all your potential trading partners!
What are mutual vs one-way matches?
Mutual matches mean both you and another player can help each other. You have cards they need AND they have cards you need. These are ideal for trading!
One-way matches mean only one direction works. Either you can give them cards they need, OR they can give you cards you need (but not both). You can still trade with one-way matches. It just means you'll need to find other partners for the reverse direction.
How do I filter my matches?
At the top of the matches page, you'll see filter buttons that let you narrow down your trading partners:
- All: Show all matches (default)
- Mutual: Show only partners where you can trade both directions
- I Give: Show partners where you have cards they need (one-way)
- I Receive: Show partners who have cards you need (one-way)
- All Stars: Show matches for all card rarities
- 3+ Stars: Show only matches involving 3, 4, or 5 star cards
- Any TZ / Same TZ / Within 2h / Within 4h: Filter partners by timezone proximity (requires a saved timezone)
- Anyone / Friends / Not Friends: Filter partners by friend status â see only friends, only non-friends, or everyone
Combine filters: You can use all filters together! For example, select "Mutual" + "3+ Stars" + "Friends" to see only mutual trading partners who are friends and have high-value cards.
Timezone filters: If you've set your timezone in your profile, you can filter to partners in the same zone or within 2â4 hours of your time.
Friend status filters: Use "Friends" to focus on partners you already trust, or "Not Friends" to discover new trading partners you might want to add.
Filters are preserved in the URL, so you can bookmark filtered views or share links with specific filters applied.
How are matches sorted?
Use the sort dropdown at the top of the Matches page to choose how partners are ordered:
- Best Match (default): Partners ranked by a compatibility score based on the star value of matched cards. Mutual partners get a 2x score boost, and friends rank higher than non-friends at the same score.
- Newest: Partners with the most recently created matches appear first
- Name: Alphabetical by game name
The Best Match score rewards high-value mutual trades, so partners you can exchange rare cards with bubble to the top. Combined with filters, sorting makes it easy to find your ideal trading partner.
What do the match card indicators mean?
The Matches page includes a quick legend that explains card tile indicators like New (recent matches) and Pending (a trade or agreement already in progress).
If you see a Pending tile, it means either a trade is awaiting confirmation or a trade agreement is awaiting a response. Itâs a helpful way to avoid starting duplicate trades.
What if I don't see any matches?
If you don't see any matches on the Matches page, the page will show helpful information based on your situation:
- No inventory yet: You'll see a prompt to set up your inventory first
- Inventory but no matches: You'll see an encouraging message that matches will appear as more players join, along with a summary of your available cards
- Unverified email: You'll see a reminder to verify your email to receive match notifications
The matching system works automatically - just make sure your inventory is up to date and verified users will be able to find you!
Can I filter matches to a specific friend?
Yes! You can filter the Matches page to show only matches with a specific friend. There are two ways to do this:
- From the Friends Hub: Click "Find trading opportunities" on any friend card to go directly to matches filtered to that friend
- Direct URL: Add
?friend_id=123to the matches URL to filter to a specific friend
When filtering by friend, you'll see a green banner at the top showing "Showing matches with @FriendName" with a "Show All" link to clear the filter. All your existing type and star filters still work when combined with the friend filter!
How do I quickly find trading opportunities with a friend?
Go to the Friends Hub and find the friend you want to trade with. On their friend card, you'll see either:
- Trade summary: If you've traded before, you'll see stats like "3 given ¡ 2 received" with a link to "View Trade History"
- "Find trading opportunities": If you haven't traded yet, click this link to jump to Matches filtered to just that friend
This makes it easy to focus on one friend at a timeâperfect when you're coordinating a specific trade in Township!
đ¤ Trading & Trade Tracking
How do I trade cards?
When you find a match, copy their friend code and add them in Township. Then coordinate the trade in-game! This tool helps you find partners. The actual trading happens in Township itself.
What are Trade Preferences?
Trade Preferences let you tell other players your trading style. You can set them in your Profile Settings:
- Mutual Only: You only accept trades where both sides exchange cards
- Equal Value: You prefer trading cards of the same star value
- Generous Trader: You're happy to give higher-value cards without expecting equal value back
- Star Range: Specify which star levels you're interested in trading (e.g., only 3-5â cards)
These preferences show as badges on your profile and when others view you.
Preferences are now enforced on trade proposals. If a player has "Mutual Only" enabled and you don't have a mutual match with them, the proposal will be blocked. Other preferences (Equal Value, Star Range) show as warnings but still allow the trade.
What is Daily Send tracking?
Township allows 3 card sends per day during collection events. Daily Send tracking lets you keep track of how many sends you have left without leaving the app.
Enable tracking in your Profile Settings, then use the quick controls on the Matches page to log sends and reset at the start of each day. Your remaining sends (e.g., "2/3") show on your profile and in match views.
Can I see other players' trade preferences?
Yes! When viewing another player's profile or proposing a trade, you'll see their trade preferences displayed as badges. This helps you understand their trading style before reaching out.
If they're tracking daily sends, you'll also see how many sends they have left today (e.g., "đ¤ 2/3 sends")âuseful for knowing if they can send right now or if you should wait.
What is a trade agreement?
A trade agreement is a simple 1-for-1 trade proposal between you and a friend. It creates a shared page where you can both: agree on which two cards are being exchanged, mark your card as sent, and confirm receipt once it arrives.
Itâs designed to reduce âwhoâs sending what?â confusionâespecially when youâre coordinating in chat while the in-game mail is happening.
How do I propose a trade agreement?
Go to Matches, find the trading partner, and (if youâre already friends) click âPropose Tradeâ. Youâll pick:
- Card I want: the card theyâll send you
- Card Iâll give: the card youâll send them
Trade proposals are limited to mutual matches in the active collection (so both sides are cards you can actually trade).
Do we have to be friends to propose a trade?
Yes. Trade agreements are only available with confirmed friends. If youâre not friends yet, send a friend request first, then come back to Matches and youâll see the âPropose Tradeâ button once the friendship is accepted.
Can I counter-propose instead of accepting?
Yes. If you receive a proposal, you can Accept, Decline, or click âCounter-Proposeâ to send a new 1-for-1 proposal back (linked to the original).
Can I amend a trade agreement?
Yes. Once an agreement is accepted (and before both sides have sent), you can propose an amendment to change the cards. Amendments are a new proposal linked to the original agreement.
If the amendment is accepted, the original agreement is automatically marked as superseded so you can focus on the updated deal.
Can I see pending trades on a player's profile?
Yes! When you visit another player's profile, you'll see a "Pending Trades" section if you have any active trade agreements or unconfirmed trades with them. This shows:
- Trade Agreements: Proposed or in-progress agreements with Accept/Decline buttons inline
- Pending Trades: Trades that have been sent but not yet confirmed by the receiver
This makes it easy to quickly respond to trade proposals without navigating away from the profile. You can also see the status of each item (e.g., "Waiting for response", "Needs your response", "In Progress").
Can I see my trade history with another player?
Yes! When you visit another player's profile, you'll see a "Trade History" section showing all confirmed trades between you. It includes:
- Summary stats: Cards you've given, cards you've received, and total trade count
- Trade entries: Each trade with card name, direction (given/received), date, and status badge
- Manual trade indicator: Trades logged manually show a "Manual" badge
The section shows the 10 most recent trades. If you've traded more, click "View all trades" to see the full history (friends only). The section is collapsed by defaultâclick to expand.
Can I cancel a trade agreement?
You can cancel an agreement as long as it's still Proposed or Accepted and both sides haven't sent yet. This helps avoid accidental trades if plans change.
Do we have to accept before sending cards?
Not necessarily. An agreement lets either side mark their card as sent even while the proposal is still pending (some players like to send first to show good faith).
Tip: only send early if youâre comfortable with the riskâacceptance is still the âofficialâ acknowledgement of the deal.
How do we mark cards as sent and confirm receipt?
Open the agreement (from the Trades page, then the Agreements tab). After you send the card in Township, click âI Sent Itâ. When you receive a card, click âConfirm Receiptâ.
Once both sides have been received and confirmed, the agreement is automatically marked Completed.
Will I get notified about trade agreements?
Yes. Proposals and responses show up in your Messages inbox. You can also enable/disable trade agreement emails from Email Preferences.
What is the Trades page?
The Trades page is your central hub for managing all your trades. It has two tabs:
- Pending: See trades awaiting actionâsplit into "Awaiting Your Action" (trades you need to confirm) and "Awaiting Their Confirmation" (trades you sent)
- History: View all your confirmed trades in chronological order, showing who you traded with and when
You can access the Trades page from the navigation menu. If you have pending trades, you'll see a badge count showing how many need attention!
How do I see all my pending trades in one place?
Click "Trades" in the navigation menu and select the Pending tab. You'll see:
- Awaiting Your Action: Trades where someone sent you a card and you need to confirm receipt. These show a pulsing indicator and a "Confirm" button.
- Awaiting Their Confirmation: Trades where you sent a card and are waiting for the recipient to confirm. These show a "Pending" badge and a "Cancel" option.
The Trades page shows trades from all your trading partners in one convenient list, rather than having to check each partner individually on the Matches page.
What's the difference between Matches and Trades?
Think of them as two stages of the trading process:
- Matches: "Who can I trade with?" â Discovery and initiating trades with potential partners
- Trades: "What trades am I doing?" â Managing active trades and viewing your trading history
Use Matches to find new trading partners and start trades. Use Trades to track what's in progress and see your history.
How do I track trades?
When you're ready to mark a trade as complete, simply click on the card you're giving in the "You can give them" section. You'll see a confirmation dialog where you can add optional notes (like "traded via Reddit"). Once confirmed, the trade is marked as complete and the card will show a "Pending" status until your trading partner confirms they received it.
For cards you receive: When someone marks a trade complete with you, you'll see a "Pending" indicator on that card. Click it to confirm you received the card, which completes the trade for both parties. After confirming, you'll be asked if you want to add the card to your inventoryâchoose "Yes" to update automatically or "No" to update manually later.
You can view all your trades (both given and received) in the "Trades You Gave" and "Trades You Received" sections on each partner's match card. Pending trades can be undone if needed, but once confirmed by the recipient, they're permanent.
How do I log a trade that happened outside matches?
Use the "Log Trade" button on the Trades page or on a friend's profile (only visible when you are friends). You'll choose whether I sent or I received, select the card, and optionally add notes.
Manual trades are recorded as confirmed immediately and appear in your History. No match is required.
What happens after I confirm a received card?
After confirming (or logging) a received card, you'll be asked if you want to update your inventory right away:
- Yes, add to inventory: We increment the card count and recalculate matches.
- No, I'll update later: No inventory changes are made.
Do manual trades send notification emails?
No. Manual trade entries do not send trade emails. This prevents accidental spam to your trading partner (or yourself) when you're just logging history.
What does "Pending" mean on a trade?
A trade shows "Pending" status when one person has marked it complete, but the other person hasn't confirmed yet. This gives both parties a chance to verify the trade happened before it's marked as fully confirmed.
- If you gave a card: It shows "Pending" until the recipient clicks to confirm they received it. You'll see an "Undo" button if you need to cancel before they confirm.
- If you received a card: You'll receive an email notification with a "Confirm Receipt" button. You can also confirm directly from the matches page by clicking the "Pending" indicator.
Once both parties have confirmed, the trade shows as "Confirmed" and cannot be undone. This helps prevent accidental cancellations and keeps your trading history accurate.
Can I undo a trade?
Yes, but only if the other person hasn't confirmed yet. If you marked a trade complete but need to undo it (maybe you made a mistake or the trade fell through), you can click the "Undo" button next to pending trades in the "Trades You Gave" section.
Important: Once the recipient confirms they received the card, the trade cannot be undone. This protects both parties and keeps trading history accurate.
đ§ Notifications & Emails
Will I get notified about new matches?
Yes! We send a daily email digest whenever you have new matches. Important: You must verify your email address to receive match notifications. If you haven't verified your email yet, you'll receive a reminder email instead of the full match details (to protect privacy).
Once verified, the email organizes matches into three categories:
- ⨠Mutual Trades: Partners you can trade with in both directions
- đĽ Cards You Can Receive: Partners who have cards you need
- đ¤ Cards You Can Give: Partners who need cards you have
Each section shows the partner's game name, friend code, and specific cards involved. Emails are sent once daily at 10 AM PST. You'll only receive an email if you have new matches!
Why do I need to verify my email?
Email verification protects your privacy and the privacy of other players. Until you verify your email, we won't show you detailed match information (like partner names and friend codes) in emails. Instead, you'll receive a reminder to verify your email so you can see your matches.
After verifying, clicking the verification link will automatically take you to your matches page if you have any waiting matches. If you don't have matches yet, you'll be taken to your profile page.
Will I get notified when someone marks a trade complete with me?
Yes! When someone marks a trade complete and gives you a card, you'll receive an email notification immediately. The email includes:
- The card name, star rating, and set name
- The giver's game name and friend code
- A "Confirm Receipt" button that takes you directly to the confirmation page
- A link to view all your matches
Click the "Confirm Receipt" button in the email to confirm you received the card. This helps track successful trades and builds trust in the community. You can also confirm trades directly from the matches page if you prefer.
Note: You must have a verified email address to receive trade notifications. If your email isn't verified, you'll need to check the matches page manually to see pending trades.
What are trade confirmation reminders?
If someone gives you a card and you haven't confirmed you received it after 48 hours, you'll get a friendly reminder email. This helps keep trades from getting stuck in "awaiting confirmation" status.
- Reminders are sent at most once every 3 days per trade
- You'll receive a maximum of 3 reminders per tradeâthen we stop
- Each reminder includes a direct "Confirm Receipt" button
- You can turn off reminders from your Email Preferences
Can I turn off email notifications?
Yes! You can control which emails you receive from the Email Preferences page. You can toggle:
- Daily Match Digest: The daily email summarizing new trading opportunities
- Trade Confirmation Reminders: Reminder emails when trades are waiting for your confirmation
- New Message Notifications: Emails when friends send you messages (coming soon)
To access your email preferences, go to your Profile and click "Email Preferences". Changes take effect immediately.
Note: Even if you turn off the Daily Match Digest, you'll still receive verification reminder emails if your email isn't verified yet. This ensures you can complete verification to access full features.
How do I access my email preferences?
There are two ways to access your email preferences:
- From your Profile page, click the "Email Preferences" link
- Click "Manage email preferences" at the bottom of any daily match digest email
Your preferences are saved automatically when you toggle themâno need to click a save button!
đĽ Friends & Profiles
What is the Friends Hub?
The Friends Hub is your central location for managing friendships. It has three tabs:
- Pending: See incoming friend requests you can accept or decline, and outgoing requests you're waiting on
- Friends: View all your confirmed friends with their friend codes and when you became friends
- Find Friends: Discover new players to trade with, search by game name, and see match potential before connecting
You can access the Friends Hub from the navigation menu. It shows badge counts for pending requests so you never miss a new connection!
How do I find new trading partners?
Use the Find Friends tab in the Friends Hub to discover other players. You can:
- Browse all players who have set up their profiles
- Search by game name to find specific players
- See match potential badges showing how many cards you could trade
- Send friend requests directly from the discovery list
- Click on any player to view their full profile
Players you're already friends with, or have pending requests with, won't appear in the discovery listâso you'll only see new potential connections!
How do Friends filters and sorting work?
Both Friends and Find Friends use match-style filters to help you focus on the best trading partners:
- All / Mutual / I Need / They Need: Quickly narrow by trade direction
- Trusted Trader (Find Friends): Show verified, high-trust partners
- Never Traded (Friends): Find connections you have not traded with yet
- Any TZ / Same TZ / Within 2h / Within 4h: Filter by timezone proximity (requires a saved timezone)
Use the search box to filter by game name. The default sort highlights the best trade matches first, and you can switch to A-Z, Most Trades, Cards for Me, or Cards for Them from the dropdown.
What can I see on player profiles?
Click on any player's name to view their public profile. You'll see:
- Player info: Game name, friend code, and when they joined
- Match Potential: How many cards they have that you need, and how many you have that they need
- Active Collection Progress: Their inventory for the current collection, organized by set
- Card Details: Expand any set to see exactly which cards they need, have, or have extras of
- Friends: See their friends list with mutual friends highlighted first
- Past Collections: Summary of their completion rates on previous collections
You can send friend requests or manage your friendship status directly from their profile page!
Can I see who someone's friends are?
Yes! When viewing a player's profile, you'll see a Friends section showing their connections. Here's what you can see:
- Friend count: Total number of friends they have
- Mutual friends: Friends you have in common are highlighted with a "Mutual Friend" badge and shown first
- Match potential: When logged in, see how many cards you could trade with each of their friends
- Quick navigation: Click any friend to view their profile
The section is collapsed by default to save spaceâclick to expand it. If the player has no friends yet, the section won't appear.
On your own profile: You'll see a "My Friends" section with a link to your full Friends page for easier management.
How does the friend request system work?
The friend request system helps you track which trading partners you've added as friends in Township. On each match card or profile, you'll see friend request buttons:
- "Send Request" - Click this after you send a friend request in Township
- "Already friends in game?" - Use this if you're already friends in the game
After you mark a request as sent, the other player will see it on their end and can confirm by clicking "I Accepted" once they accept your request in Township. Once confirmed, you'll both see a green "Friends â" badge.
Why track friendships? Knowing who you're already friends with helps you prioritize trades and builds trust in the community. You can filter matches by friend status using the "Friends" and "Not Friends" buttons on the Matches page!
Will I get notified about friend requests?
Yes! You'll receive email notifications for friend request activity:
- When someone sends you a request: You'll get an email with their game name and friend code so you can add them in Township
- When your request is accepted: You'll get a confirmation email when someone confirms your friendship
- When someone connects you as friends: If someone marks you as "already friends," you'll get notified
Each email includes a direct link to your matches page where you can respond or start trading. Notifications are sent immediatelyâno waiting for a daily digest!
Privacy note: Emails only show game names and friend codesânever email addresses.
Can I re-send a friend request after being declined?
Yes! If someone declines your friend request (or if you decline theirs), they'll reappear in your Find Friends list. This allows you to re-request if circumstances changeâmaybe they were busy or it was accidental.
Similarly, if you remove a friend, they'll appear in Find Friends again if you want to reconnect later.
đŹ Messaging
How do I send a message to another player?
You can send messages to your friends from two places:
- From their profile: Visit a friend's profile page and click the blue "Message" button next to their "Friends â" badge
- From match cards: On the matches page, click the "Message" button that appears next to the "Friends â" badge on any friend's match card
You'll be taken to a message compose form where you can type your message (up to 2,000 characters) and send it.
Who can I message?
You can only send messages to confirmed friends. This means:
- You need to have an accepted friendship with the player
- Players with pending friend requests cannot be messaged yet
- Players you're not connected with won't show a Message button
This helps protect everyone's privacy and ensures you're only communicating with people you've connected with.
Is my email address shared when I message someone?
No, never! Your email address is never exposed to other players. Messages are sent through our platform only. Recipients see your game name and friend code, but never your email address.
This privacy-first approach lets you coordinate trades safely without revealing personal contact information.
What is the message character limit?
Messages can be up to 2,000 characters long. The compose form shows a character counter so you can see how much space you have left as you type.
Messages are plain text with support for card @mentionsâtype @ to reference any card from the current collection.
Where can I see messages I've received?
Click "Messages" in the navigation menu to open your inbox! You'll see:
- All your conversations grouped by trading partner
- Unread message count badges for each conversation
- Preview of the last message in each conversation
- Conversations sorted by most recent message first
Click any conversation to see the full message thread and reply directly!
How do I reply to a message?
Open a conversation from your inbox and you'll see the full message thread with a reply form at the bottom. Just type your message and click "Send"!
Messages appear in chronological orderâyour sent messages appear on the right in blue, and received messages appear on the left. Each message shows the timestamp so you can follow the conversation flow.
What does the unread badge in the navigation mean?
The number next to "Messages" in the navigation shows how many unread messages you have across all conversations. When you view a conversation, those messages are automatically marked as read.
Real-time updates: The badge and your conversations update in real-time! New messages appear instantly without refreshing the page.
Can people see when I read their messages?
If you have Show Read Receipts enabled, the sender will see a small checkmark on the last message in a sent group once you open the conversation. You can disable this anytime in your preferences if you'd rather keep read status private.
What are typing indicators?
When you're in a conversation, you'll see an animated typing bubble when your trading partner is actively typing a message. This works just like popular messaging appsâyou'll see three bouncing dots appear below the messages.
Typing indicators are real-time and only visible to friends you're chatting with. They automatically disappear after a few seconds of inactivity or when the message is sent.
Do messages update in real-time?
Yes! Messages appear instantly as they're sentâno need to refresh the page. When your trading partner sends a message, it slides right into the conversation in real-time. The same goes for your inbox, which updates automatically with new messages and unread counts.
Do I get email notifications for new messages?
You can opt in to Message Notifications from your profile settings under Email Preferences. When enabled, you'll receive an email whenever a friend sends you a message so you never miss a trade coordination opportunity.
Message email notifications are off by default to avoid inbox overload. You can toggle them on anytime from your profile.
How do I mention a card in a message?
Type @ followed by a card name in any message to search cards from the current collection. An autocomplete dropdown will appear showing matching cards with their set name and star rating.
- Type @ to start a card mention
- Continue typing to filter cards by name
- Click a card or use arrow keys + Enter to select
- The card appears as a styled chip in your message showing the card name, set, and stars
Card mentions make it easy to discuss specific cards with trading partners without any confusion about which card you mean!
đ Leaderboards
What are the leaderboards?
The Leaderboards show the top traders, most connected players, and strongest co-ops in our community! There are eight leaderboards across two categories:
Individual Rankings:
- Most Cards Traded: Total trading activity (cards given + cards received)
- Most Cards Received: Cards you've received from other players
- Most Cards Given: Cards you've generously given to others
- Most Friends: Players with the most accepted friendships in our community
- XP: Total experience points earned across all activities
Co-Op Rankings:
- Co-Op Trades: Total trade participations by all co-op members
- Co-Op XP: Combined XP earned across all co-op members
- Co-Op Members: Co-ops ranked by registered member count on Township Cards
Each leaderboard shows the top 10 traders with gold, silver, and bronze medals for the top 3 positions.
How do I get on the leaderboard?
Simply trade cards! Every confirmed trade counts toward your leaderboard ranking. When you give a card to someone and they confirm receipt, it counts toward your "Cards Given" total. When you receive a card and confirm it, it counts toward your "Cards Received" total. Both count toward your "Cards Traded" total.
What if I'm not in the top 10?
If you're logged in but not in the top 10, you'll see a "Your Position" section below the leaderboard. This shows your current rank along with the players just above and below you, so you can see how close you are to climbing the ranks!
How are ties handled?
We use standard ranking for ties. If two players have the same number of trades, they share the same rank, and the next rank skips. For example, if two players are tied for 2nd place, the next player would be ranked 4th (not 3rd).
Do I need to be logged in to see the leaderboards?
No! Leaderboards are public and anyone can view them. However, if you're logged in, your row will be highlighted so you can easily spot your position, and you'll see the "Your Position" section if you're outside the top 10.
How does the Friends leaderboard work?
The Friends leaderboard shows the most connected players in our community, ranked by accepted friend count. Each accepted friendship counts for both users involvedâso if you and another player are friends, you both get +1 to your friend count.
Only accepted friendships count. Pending friend requests don't appear on the leaderboard. This encourages community building and helps you find active, engaged trading partners!
What is the XP leaderboard?
The XP leaderboard ranks players by total experience points earned across all activities. XP is calculated from four sources:
- Trades: 10 XP per confirmed trade
- Card Value: 5 XP per star on cards you've traded
- Friends: 25 XP per accepted friendship
- Collections: 100 XP per completed collection
You can see a detailed XP breakdown on your profile showing exactly how much XP you've earned in each category.
How do the co-op leaderboards work?
Co-op leaderboards rank co-ops rather than individual players. There are three co-op rankings:
- Co-Op Trades: Total trade participations by all members. Each confirmed trade counts once per member side—so intra-co-op trades count as 2 participations for the co-op.
- Co-Op XP: Combined XP across all members, using the same formula as individual XP.
- Co-Op Members: Ranked by registered member count on Township Cards.
If you're in a co-op, your co-op's row is highlighted on co-op leaderboards. If your co-op isn't in the top 10, you'll see a "Your Co-Op" section showing your co-op and its nearest neighbors. Click any co-op name to visit its profile page.
đĄď¸ Trust & Safety
How do I report a user?
If you experience harassment, abuse, or trade fraud from another user, you can report them directly from their profile page. Look for the "Report User" link in the profile header (below the friend code).
When you click "Report User", a modal will appear where you can:
- Select a category: Harassment, Abuse, or Trade Fraud
- Optionally link evidence (a recent trade or message with that user)
- Add additional details describing what happened
After submitting, you'll see "Already reported" on their profile, and our team will review the report.
What happens after I report someone?
Your report is added to our admin review queue. Our team reviews each report and may take action including warnings or account restrictions. We take all reports seriously and work to keep the community safe for everyone.
Note: You can only have one pending report per user. Once your report is reviewed and resolved, you can submit a new report if needed.
What counts as trade fraud?
Trade fraud includes situations where a user agrees to trade but doesn't follow throughâfor example, receiving your card but never sending theirs in return. If you experience this, report the user with the "Trade Fraud" category and link the relevant trade as evidence.
Tip: Trading with friends you've built a relationship with reduces the risk of trade fraud. Use the messaging system to coordinate trades before sending cards in-game!
What does "Trade Restricted" mean?
If you see a "Trade Restricted" badge on a user's profile or next to their name on the matches page, it means that user has been temporarily restricted from receiving trades due to community guideline violations.
Trade-restricted users can still log in, view matches, and message friendsâbut other users cannot send trades to them until the restriction expires. The badge shows the expiry date so you know when they'll be able to trade again.
Why can't I send a trade to this user?
If you see "Blocked" on a Give card or receive the message "This user is currently restricted from receiving trades", the user has been temporarily trade-restricted by our moderation team.
This protection exists to prevent bad actors from continuing to receive cards from the community while their behavior is being addressed. You can still message them and be friendsâtrading will resume when their restriction expires.
I was trade-restricted. What happened?
If you received an email about a trade restriction, it means our moderation team reviewed reports about your account and determined that a temporary restriction was warranted. The email explains the reason and duration of the restriction.
During a trade restriction, you can still:
- Log in and use the site
- View your matches and inventory
- Message friends and send friend requests
- Give cards to other users
However, other users cannot send trades to you until the restriction expires. Repeated violations may result in longer restrictions or permanent account suspension.
My account was suspended. What can I do?
Account suspensions are reserved for serious or repeated violations of our community guidelines. If your account has been permanently suspended, you will not be able to log in.
If you believe this was a mistake, an appeal system is coming soon. Until then, please be patient as we build out that feature.
What are the badges I see next to usernames?
We've introduced trust badges to help you make informed decisions about who to trade with. Badges appear next to usernames throughout the siteâon profiles, matches, friends lists, messages, and leaderboards.
There are two types:
- đĄď¸ Trusted Trader (green shield) â This trader has a proven track record of successful trades and is generally safe to trade with.
- â ď¸ Warning badges (colored pills) â These indicate something to be aware of before trading with this user.
What does the green shield icon mean?
The đĄď¸ green shield next to a username indicates a Trusted Trader. These users have completed multiple successful trades with good confirmation rates and participate actively in both giving and receiving cards.
Tip: Trading with Trusted Traders is generally safer, but always use good judgment and communicate before sending valuable cards!
How do I become a Trusted Trader?
The Trusted Trader badge is earned automatically based on your trading activity. To qualify, you need to:
- Complete several successful trades
- Maintain a good confirmation rate (confirm when you receive cards!)
- Participate in both giving and receiving trades
- Have no outstanding issues with your account
Just keep trading fairly, confirm your receipts, and the badge will appear automatically once you qualify!
What does "Under Review" mean?
The â ď¸ Under Review badge means this user's account is currently being reviewed by our moderation team due to reports from multiple community members.
You can still trade with them, but you may want to exercise extra cautionâperhaps trade lower-value cards first or wait until the review is complete.
What does "Trade Caution" mean?
The ⥠Trade Caution badge indicates this user has a lower-than-average trade confirmation rate. This could mean they're slow to confirm trades, inactive, or have had issues completing trades in the past.
Tip: Consider messaging them first to confirm they're active before sending cards. Start with lower-value trades to build trust.
What does "New Account" mean?
The đ New Account badge simply means this user joined recently. It's not a warningâeveryone starts somewhere! It just lets you know they don't have an established track record yet.
New users can still be great trading partners. Consider starting with smaller trades to help them build their reputation.
Why don't I see any badge on a user?
Not everyone has a badge! If a user doesn't show any badge, it means:
- They haven't completed enough trades yet to qualify for Trusted Trader
- Their account is older than 7 days (so no "New Account" badge)
- They don't have any warning conditions
No badge is neutralâit's neither good nor bad. Use your judgment and communicate with potential trading partners!
đ Achievements
What are achievements?
Achievements are milestones you earn by being active in the Township Cards community. They track your progress across five categories:
- Trades: First Trade, Active Trader (10), Veteran Trader (25), Trade Master (50), Trade Legend (100)
- Cards Given: Generous (10), Benefactor (50), Philanthropist (100)
- Friends: Social Butterfly (5), Popular (25), Celebrity (50)
- Collections: Collector (1), Expert Collector (3), Master Collector (5)
- Agreements: Reliable (5), Dependable (15), Pillar of Trust (30)
Where can I see my achievements?
Your achievements appear on your profile page in a collapsible "My Achievements" section. Click to expand and see all your earned badges grouped by category. You'll also see "Next Up" hints showing how close you are to your next achievement in each category.
Can other players see my achievements?
Yes! When anyone visits your profile, they'll see your earned achievements in the "Achievements" section. This is a great way to show off your trading milestones. However, the "Next Up" progress hints are only visible to you on your own profile.
How are achievements awarded?
Achievements are awarded automatically in real time as you use the site. When you confirm a trade, make a new friend, complete a collection, or honor an agreement, a background job checks whether you've hit any new milestones and awards them instantly. You don't need to do anything special—just keep trading, making friends, and completing collections!
Do I get notified when I earn an achievement?
Yes! When you earn a new achievement, you'll see a flash notification the next time you load any page. You'll also receive a congratulations email with details about the achievement you just earned. You can turn achievement emails on or off in your Email Preferences.
What are achievement badges?
Each achievement has an AI-generated visual badge that appears on your profile and on the achievement detail page. Badges are generated automatically and feature unique designs for each achievement. Admins can regenerate badges at any time for a fresh look.
What is the Achievements page?
The Achievements page shows all available achievements grouped by category. Click any achievement to see its detail page with the criteria to earn it, how many players have unlocked it, and a rarity tier (Common, Rare, Epic, or Mythic) based on how many players have earned it. You can also see your own progress toward locked achievements.
What are rarity tiers?
Each achievement has a rarity tier based on the percentage of players who have earned it:
- Mythic: Fewer than 1% of players (or no one yet!)
- Epic: 1–10% of players
- Rare: 10–50% of players
- Common: More than 50% of players
Rarity tiers update dynamically as more players earn achievements.
đď¸ Co-Ops
How do I join or set my co-op?
Go to Edit Profile and start typing your co-op name or tag in the co-op field. As you type, matching co-ops will appear in a dropdown. Select yours, or if it doesn't exist yet, it will be created automatically when you save. You can also leave the field blank if you're not in a co-op.
What is a co-op tag?
A co-op tag is a short alphanumeric identifier (like "FARM" or "TOP10") that makes your co-op easy to find. Tags are optional but helpful. They appear next to your co-op name on profiles and in search results. Tags are unique across the site and are automatically uppercased.
What is the co-op detail page?
Each co-op has a public detail page showing its members, tag, and member count. If you're a member, you can edit your co-op's details like join type (open, closed, or by request), requirements, and contact info. Your co-op is also shown on your public profile so other players can see which team you're on.
What is the Co-Op Ads Board?
The Co-Op Ads Board is a public page where co-ops can post recruiting ads to attract new members. Any co-op member can create or update their co-op's ad. Ads show the co-op name, tag, member count, and a custom message. You can also search ads by co-op name or tag to find a co-op to join.
How does co-op deduplication work?
When you type your co-op name, the system uses fuzzy matching to find existing co-ops with similar names or tags. This prevents duplicate entries like "Farm Friends" and "FarmFriends" from being created as separate co-ops. If a close match is found, you'll see it in the dropdown and can select it instead of creating a new one.
đ° Activity Feed
What is the Activity Feed?
The Activity Feed is your homepage when you log in. It shows a real-time stream of what's happening in the community—trades completed, new friendships, achievements earned, and collections completed. Switch between Friends (activity from people you're connected with) and Global (public activity from everyone) using the filter tabs at the top.
What activity types are shown?
The feed tracks four types of activity:
- Trades Completed: When a trade is confirmed between two players (visible to friends)
- New Friendships: When two players become friends (visible to friends)
- Achievements Earned: When a player unlocks a new achievement (visible to everyone)
- Collections Completed: When a player finishes an entire collection (visible to everyone)
What's the difference between Friends and Global?
The Friends tab shows all activity from your friends, including friends-only events like trades and new friendships. The Global tab shows only public events (achievements and collection completions) from all players on the site. Your own activity does not appear in your Friends feed.
I see a match banner on my Activity Feed. What does it mean?
If you have potential trading matches for the current collection, a banner appears at the top of your Activity Feed (and on the Inventory page) showing how many matches are available. Click it to go directly to the Matches page and start trading. A NEW badge highlights matches you haven't seen yet.
â General Questions
Is this tool free?
Yes! Township Cards is 100% free with no ads and no paywall. It's a fan-made community tool to help Township players find trading partners more easily.
Is this affiliated with Playrix?
No, this is a fan-made tool and is not affiliated with or endorsed by Playrix. Township is a trademark of Playrix.
Roadmap
â Recently Completed
- â Admin Collection Management: Full admin UI for creating, editing, and deleting collections, sets, and cards—plus YAML import, activation/deactivation controls, and deletion safeguards
- â Collection History & Archive: Browse all past collections you've participated in from the Collection History page—see progress bars, completion badges (bronze/silver/gold), and drill into any collection to view your read-only card inventory
- â Active Collection UI: Active collection badge, archived collections accordion on inventory page, and dedicated archive browse views with muted read-only styling
- â XP System & Co-Op Leaderboards: Earn XP for trades, card value, friends, and collections—see your XP breakdown on your profile and compete on the XP leaderboard. Plus three new co-op leaderboards ranking co-ops by trades, XP, and members
- â Achievements & Gamification: Complete achievement system with event-driven awards, email notifications, AI-generated badges, detail pages with rarity tiers, admin management, and polished profile display
- â Activity Feed: Real-time activity timeline as your new homepage—see trades, friendships, achievements, and completions from friends or the whole community, with filter tabs and match notification banner
- â Co-Op Management: Set your co-op from your profile with fuzzy autocomplete, view co-op detail pages with member lists, edit co-op promotion details, and browse the Co-Op Ads Board to recruit or find a co-op
- â Co-Op Deduplication: Fuzzy name and tag matching prevents duplicate co-ops from being createdâsimilar names are surfaced in the autocomplete dropdown
- â Co-Op Ads Board: Public board where co-ops can post recruiting ads with search, member counts, and one ad per co-op
- â Trade Confirmation Reminders: Automatic email nudges when trades have been waiting for your confirmation for 48+ hoursârate-limited, capped at 3 per trade, with opt-out in email preferences
- â Profile Trade History: See confirmed trade history with any player directly on their profileâsummary stats, direction indicators, status badges, and "View all trades" link
- â Dark Mode: Full dark theme with light, dark, and system preference optionsâtoggle from any page with instant switching and no flash of wrong theme
- â Real-Time Messages: Messages appear instantly in conversations and inbox without refreshingâpowered by Turbo Streams and ActionCable with typing indicators
- â Trade Preference Enforcement: Mutual Only preference now blocks trade proposals when no mutual match exists; Equal Value and Star Range preferences show warnings
- â Completion Badges: Tiered bronze, silver, and gold badges on profiles based on how many times you've completed a collection, with round tracking
- â Match Sorting & Scoring: Sort trading partners by Best Match (compatibility score with 2x mutual multiplier), Newest, or Name
- â Profile Achievements: Earn and display achievements for milestones across trades, cards given, friends, collections, and agreementsâwith progress hints on your own profile
- â Card @Mentions in Messages: Type @ in any message to search and mention cards from the current collection, displayed as styled chips with set name and star rating
- â Mutual Trade Agreements: Propose 1-for-1 trades to friends, accept/decline/counter, amend or cancel, and track sent + receipt confirmations
đ§ Coming Next
- â Trade Reputation Metrics: Confirmation rate, trade balance ratio, and reputation scores to help you find reliable trading partners
đŽ Gamification (Coming Later)
- â Achievements: Earn badges for milestones across trades, cards given, friends, collections, and agreements
- â Achievement Notifications: Flash notifications and congratulations emails when you earn achievements
- â Achievement Badges: AI-generated visual badges for each achievement with rarity tiers
- â Achievement Detail Pages: Browse all achievements, see criteria, rarity tiers, and unlock percentages
- â Completion Badges: Display tiered completion badges on your profile for others to see
- â XP System: Earn XP for trades, completions, and community participation
- â Activity Timeline: See what's happening with your friends and the community
đŽ Future Ideas
- â Co-Op Support: Join your co-op, view co-op pages, ads board, and member lists
- â Screenshot OCR: Upload screenshots to auto-detect your cards
- â Mobile App: Native app with push notifications
Changelog
Version 1.40.0
February 22, 2026- Admin Collection CRUD: Create, edit, and delete collections with name and end date fields—plus a "Save and Activate" shortcut for immediate deployment
- Admin Set & Card Management: Add, edit, and remove sets and cards within any collection from the admin interface, with user data safeguards that prevent deletion of sets or cards players have in their inventory
- YAML Collection Import: Paste a YAML definition to bulk-create an entire collection with sets and cards in one step, with detailed validation error messages
- Collection Activation Controls: Activate or deactivate collections from the admin show page with confirmation dialogs—activating one collection automatically deactivates the previous
- Deletion Safeguards: Active collections and collections with user inventory data cannot be deleted—the delete button is visually disabled with an explanation
Version 1.39.0
February 21, 2026- Collection History Page: New "Collection History" link on your inventory page—browse every collection you've participated in with progress bars, completion counts, and percentage breakdowns
- Historical Collection Views: Click any past collection to see its sets and cards in a read-only view with your historical card quantities preserved
- Completion Badges in History: Tiered bronze, silver, and gold badges displayed on the history page for collections you completed, with round numbers and dates
- Active Collection Badge: Your current collection now shows a green "Active" badge at the top of the inventory page for clear visual distinction
- Archived Collections Accordion: Past collections appear in a collapsible accordion section on the inventory page with end dates and quick-browse links
- Archive Browse Views: Dedicated archive pages for browsing ended collections with muted styling, progress tracking, and read-only card grids
Version 1.38.0
February 19, 2026- XP System: Earn experience points for trades (10 XP), card star value (stars × 5 XP), friendships (25 XP), and collection completions (100 XP)—with a detailed breakdown on your profile
- XP Leaderboard: New "XP" tab ranks players by total experience points earned across all activities
- Co-Op Trade Leaderboard: See which co-ops have the most active traders, ranked by total member trade participations
- Co-Op XP Leaderboard: Co-ops ranked by combined XP earned across all members
- Co-Op Members Leaderboard: Co-ops ranked by registered member count on Township Cards
- Two-Row Tab Layout: Leaderboard tabs now organized in two rows—individual rankings (top) and co-op rankings (bottom) for easy navigation
- Co-Op Position Context: If your co-op isn't in the top 10, see a "Your Co-Op" section showing your co-op and its nearest neighbors
- Co-Op Profile Links: Click any co-op name on leaderboards to visit its profile page
Version 1.37.0
February 18, 2026- Event-Driven Achievements: Achievements are now awarded in real time via background jobs when you complete trades, make friends, finish collections, or honor agreements—no more waiting for a profile page load
- Achievement Emails: Receive a congratulations email when you earn a new achievement, with an opt-out toggle in Email Preferences
- AI-Generated Badges: Each achievement now features a unique visual badge generated by AI, displayed on profiles and detail pages
- Achievement Detail Pages: Click any achievement to see its criteria, how many players have earned it, and a rarity tier (Common, Rare, Epic, or Mythic) based on unlock percentage
- Achievements Index: New browsable page listing all achievements grouped by category with progress indicators and badge previews
- Achievement Flash Notifications: See a flash notification the next time you visit any page after earning an achievement
- Admin Achievement Management: Admins can create, edit, activate/deactivate achievements and regenerate badges from the admin dashboard
- Profile Display Polish: Improved achievement display on profiles with visual badges, better grouping, and highlight animations for newly earned achievements
Version 1.36.0
February 13, 2026- Activity Feed: New real-time activity timeline showing trades, friendships, achievements, and collection completions—now your homepage when you log in
- Friends & Global Tabs: Switch between friend-only activity (trades, friendships) and public global activity (achievements, completions) with persistent filter preference
- Activity Logging: Trades, friendships, achievements, and collection completions are automatically logged as they happen
- Match Banner on Feed: The "Potential Matches Found!" notification banner now appears on the Activity Feed alongside the Inventory page so you can discover trading partners from your homepage
- Homepage Redirect: Authenticated users now land on the Activity Feed instead of the Inventory page for a more engaging experience
Version 1.35.0
February 12, 2026- Co-Op Membership: Set your co-op from your profile with a fuzzy autocomplete that finds existing co-ops by name or tagânew co-ops are created automatically if no match exists
- Co-Op Deduplication: Trigram-based fuzzy matching prevents duplicate co-ops by surfacing similar names and tags during selection
- Co-Op Detail Pages: Public pages for each co-op showing members, tag, join type, and member countsâmembers can edit promotion details
- Co-Op Promotion Details: Members can set join type (open/closed/by request), Discord requirement, requirements summary, and contact method
- Co-Op Ads Board: Public board for co-op recruiting ads with search by name or tagâone ad per co-op, any member can post or update
- Co-Op on Profiles: Your co-op name and tag are displayed on your public profile and on the matches page
- Member Counts: Both site member count (automatic) and in-game member count (editable) displayed on co-op pages
Version 1.34.0
February 10, 2026- Trade Confirmation Reminders: Automatic email reminders when trades have been waiting for your confirmation for 48+ hours
- Smart Rate Limiting: At most one reminder every 3 days per trade, with a maximum of 3 reminders totalâno spam
- Email Preference: New "Trade Confirmation Reminders" toggle in email preferences to opt out if you prefer
- One-click "Confirm Receipt" button in each reminder email takes you directly to the confirmation page
- Background job runs daily to check for overdue confirmations
Version 1.33.0
February 10, 2026- Profile Trade History: New collapsible section on player profiles showing confirmed trade history between you and themâwith summary stats (given/received/total), direction indicators, status badges, and "View all trades" link for 10+ trades
- Achievement Progress Nouns: Progress hints now show category-specific context (e.g., "9 more trades to Active Trader" instead of "9 more to Active Trader")
Version 1.32.0
February 9, 2026- Dark Mode: Full dark theme across all pages with light, dark, and system preference toggleâpersists across sessions with no flash of wrong theme on load
- Theme Toggle: Three-button switcher (sun/monitor/moon) accessible from every page with keyboard and screen reader support
Version 1.31.0
February 8, 2026- Real-Time Messages: Messages appear instantly in conversations and inbox without refreshing, powered by Turbo Streams and ActionCable
- Typing Indicators: See animated typing bubbles when your trading partner is composing a message
- Messenger-Style Chat: Conversations now use a clean single-scrollbar layout with sticky compose area at the bottom
- Message Email Notifications: Opt in to receive email alerts when friends send you messages (off by default)
- New Message Indicator: When scrolled up in a conversation, a "New message" button appears to jump to the latest message
Version 1.30.0
February 8, 2026- Completion Round Tracking: See how many times you've completed each collection on user profiles, with counts on both active and past collections
- Completion Badges: Tiered bronze (1x), silver (2-3x), and gold (4+) badges on profiles based on how many times a collection has been completed
Version 1.29.0
February 7, 2026- Match Sorting: Sort trading partners by Best Match, Newest, or Name from a dropdown on the Matches page
- Best Match Score: Partners ranked by compatibility score â sum of matched card star values with a 2x multiplier for mutual partners and friend-priority tiebreakers
- Trade Preference Enforcement: Mutual Only preference now blocks trade proposals when no mutual match exists; Equal Value and Star Range preferences show warnings on the proposal form
Version 1.28.0
February 7, 2026- Friend Status Filter: Filter matches by Anyone, Friends Only, or Not Friends to focus on trusted partners or discover new ones
- Compound Filtering: Combine friend status with type, stars, and timezone filters for precise match discovery
- Smart Filter Hiding: Friend status filters automatically hide when viewing a single friend's matches
Version 1.27.0
February 6, 2026- Profile Achievements: Earn achievements for milestones across 5 categories: Trades, Cards Given, Friends, Collections, and Agreements
- 17 Achievement Badges: From First Trade to Trade Legend, Social Butterfly to Celebrity, Collector to Master Collector, and more
- Achievement Display: Collapsible section on profiles grouped by category with emoji badges and earned dates
- Progress Hints: See "Next Up" on your own profile showing how close you are to your next achievement in each category
- Public Achievements: Other players can see your earned achievements when visiting your profile
Version 1.26.0
February 5, 2026- Card @Mentions: Type @ in any message to search and mention cards from the current collection
- Autocomplete Dropdown: Matching cards appear instantly with set name and star rating as you type
- Styled Card Chips: Mentioned cards display as amber chips showing card name, set, and stars in the conversation
- Keyboard Navigation: Use arrow keys and Enter to select cards from the dropdown without leaving the keyboard
Version 1.25.0
February 4, 2026- Read Receipts: See when your last sent message was read in conversations
- Grouped Status: Read receipts only show on the last message in a consecutive sent group to keep threads clean
- Privacy Toggle: Disable read receipts anytime from your preferences
Version 1.24.0
February 2, 2026- Profile Friends List: See any player's friends directly on their profile page
- Mutual Friends First: Friends you have in common are highlighted with a "Mutual Friend" badge and sorted to the top
- Match Potential: See how many cards you could trade with each of their friends (when logged in)
- Collapsible Section: Friends section is collapsed by default to keep profiles cleanâclick to expand
- My Friends Link: On your own profile, quick link to your full Friends page for easier management
Version 1.23.0
February 2, 2026- Profile Pending Trades: See pending trade agreements and unconfirmed trades directly on player profiles
- Inline Actions: Accept or Decline trade proposals right from the profile without navigating away
- Status Badges: Clear indicators showing "Waiting for response", "Needs your response", or "In Progress"
- View Agreement Links: Quick links to view full agreement details from pending trades on the Trades page
Version 1.22.0
February 1, 2026- Trade Preferences: Set your trading style in Profile SettingsâMutual Only, Equal Value, Generous Trader, or Star Range
- Preference Badges: Your trade preferences display as badges on profiles, match cards, and trade proposals
- Daily Send Tracking: Track your 3 daily sends with controls right on the Matches page
- Quick Send Controls: Log sends with one click, reset at the start of each day, see remaining sends everywhere
- Partner Send Status: See how many sends trading partners have left (e.g., "2/3 sends") on their profiles
Version 1.21.0
January 31, 2026- Agreement Amendments: Propose updated cards after acceptance, with clear linkage to the original
- Agreement Cancellations: Cancel proposed or accepted agreements before both sides send
- Cancellation Messaging: In-app and email notifications keep both parties in sync
Version 1.20.0
January 31, 2026- Timezone Proximity Filters: New Same TZ / 2h / 4h filters on Matches, Friends, and Find Friends
- Match Card Indicator Legend: Always-visible legend with clearer Pending state on match tiles
- Agreement Availability Checks: Warnings now detect unavailable cards across all agreement items
- Reliability & Security: Fixed timezone offset edge cases, preserved filters in redirects, and hardened return URLs
Version 1.19.0
January 26, 2026- Mutual Trade Agreements: Propose a 1-for-1 trade to friends directly from Matches
- Counter-Proposals: Recipients can counter instead of accepting/declining
- Agreement Progress Tracking: Mark your card as sent, confirm receipt, and auto-complete when both sides are confirmed
- Agreements Inbox: View all received and sent agreements from the Trades â Agreements tab
- Notifications: In-app messages for proposals and responses, plus optional email notifications
Version 1.18.0
January 24, 2026- Friends Filters: All/Mutual/I Need/They Need plus Trusted Trader and Never Traded filters
- Friends Search: Search by game name on the Friends list
- Smarter Sorting: Default relevance sort and expanded sort options across Friends and Find Friends
- Match Potential Counts: Friend cards now show cards they need and cards you need
Version 1.17.1
January 18, 2026- Daily Match Digest Preview: Email now caps each section to 3 traders while keeping accurate totals
- Cleaner Teasers: Added âand X more tradersâ to avoid long walls of matches
Version 1.17.0
January 18, 2026- Manual Trade Entry: Log sent or received trades outside matches from the Trades page or friend profiles
- Instant History: Manual entries are confirmed immediately and show up in History
- Inventory Prompt: When you log a received card, choose whether to add it to inventory right away
- Searchable Selects: Type-to-search partner and card fields on the manual trade form
- Manual Trade Label: Manual entries are labeled in trade history
Version 1.16.0
January 17, 2026- Timezone Settings: Set your timezone in Profile Settings to see all times in your local time
- Browser Auto-Detection: Your timezone is automatically detected from your browser and pre-filled
- Timezone Offset Indicators: See "+3h" or "-5h" next to usernames showing the time difference from you
- Global Time Display: All timestamps across the site (messages, trades, profiles) now show in your timezone
- Email Times: Email notifications now show times in your timezone too
- Timezone Reminder: Friendly banner prompts you to set your timezone if you haven't yet
- Offset only shown when both you and the other user have timezones set
- DST-aware calculations ensure accuracy year-round
Version 1.15.0
January 16, 2026- Profile Completion Gate: New users must set game_name and friend_code before accessing core features
- Gated features: Matches, My Collection, Friends Hub, Trades, and Messages require profile completion
- Always accessible: Public profiles and leaderboards remain viewable without completing your profile
- Email Verification Gate: Verified email required for outbound social actions
- Outbound-only gating: Sending friend requests, creating trades, and sending messages require verification
- Inbound always works: Accept friend requests, confirm trades, and read messages without verification
- Simplified navigation: Incomplete profiles see only "Profile Setup" and "Log Out" until profile is complete
- Clickable leaderboards: Player names on leaderboards now link directly to their profiles
- Friendly flash messages guide users to complete profile or verify email when needed
Version 1.14.0
January 16, 2026- Trust Badges: Visual indicators to help you make informed trading decisions
- Trusted Trader: Green shield icon next to usernames for traders with proven track records
- Under Review Badge: Orange badge when multiple users have reported an account
- Trade Caution Badge: Yellow badge for users with lower confirmation rates
- New Account Badge: Gray badge for accounts less than 7 days old
- Badge Hierarchy: Only the most relevant badge shows (warnings take priority)
- Badges visible everywhere: profiles, matches, friends, messages, trades, leaderboards
- Hover tooltips explain what each badge means
- Admin kill switch to globally enable/disable badges if needed
Version 1.13.0
January 15, 2026- Ban System: Admins can now soft-ban (7/14/30 days) or hard-ban users who violate community guidelines
- Three Strikes Rule: Third soft-ban automatically escalates to permanent ban
- Trade Restricted Badges: Visual indicators on profiles and match cards for trade-restricted users
- Automatic Expiry: Soft-bans automatically lift when duration expires via background job
- Hard Ban Protection: Blocks friend code reuse to prevent ban evasion
- Email notifications sent when users are banned or unbanned
- Full audit trail for all ban/unban actions
Version 1.12.0
January 14, 2026- Admin Review Queue: Prioritized moderation queue sorted by reporter count and recency
- User Detail View: Comprehensive view showing flags, trade stats, recent trades, and messages
- Flag Resolution: Admins can dismiss flags with full audit trail logging
- Trade Statistics: See user's trades given, trades received, and confirmation rate
- All admin actions logged for accountability and transparency
Version 1.11.0
January 13, 2026- Report User: Flag users for harassment, abuse, or trade fraud directly from their profile
- Category Selection: Choose from Harassment, Abuse, or Trade Fraud with helpful descriptions
- Evidence Linking: Optionally attach a recent trade or message as evidence
- Notes Field: Add additional context describing what happened (up to 500 characters)
- Duplicate Prevention: One pending report per userâ"Already reported" shown if you've flagged them
- Admin dashboard now shows real-time count of flagged users pending review
- Reports preserved even if linked trade/message is later deleted
Version 1.10.0
January 11, 2026- Email Preferences: New settings page to control which emails you receive
- Daily Digest Toggle: Turn off daily match notification emails if you prefer to check manually
- Message Notifications Toggle: Control whether you get emails when friends message you (coming soon)
- Access preferences from your Profile page or via link in digest emails
- Instant saveâtoggle changes apply immediately with visual feedback
- Verification reminders still sent regardless of preferences (until you verify)
Version 1.9.0
January 11, 2026- Trades Page: New central hub for managing all your trades in one place
- Pending Tab: See trades split into "Awaiting Your Action" (incoming) and "Awaiting Their Confirmation" (outgoing)
- History Tab: View all confirmed trades chronologically with direction indicators and pagination
- Trades navigation item with pending count badge shows how many trades need attention
- Confirm incoming trades or cancel outgoing trades directly from the Pending tab
- Empty states with "Find Matches" CTA when no pending or confirmed trades exist
- Friend Trade History: See trade summary on friend cards in the Friends Hub
- Trade summary shows cards given, cards received, and total trade count with each friend
- Expandable trade history details load on-demand for performance
- "View Trade History" link on friends with previous trades
- "Find trading opportunities" link on friends with no tradesânow goes to filtered matches!
- Filter Matches by Friend: Narrow the Matches page to a specific friend
- Green filter banner shows "Showing matches with @FriendName" with "Show All" link
- Friend filter combines with existing type and star filters
- All filter links and pagination preserve the friend_id parameter
Version 1.8.0
January 9, 2026- Match Filters: Filter your trading partners by match type and card star rating
- Type filters: All (default), Mutual (two-way trades), I Give (one-way where you give), I Receive (one-way where you receive)
- Star filter: All Stars (default) or 3+ Stars to focus on high-value cards
- Combine filters with AND logic â e.g., "Mutual" + "3+ Stars" shows only mutual partners for 3+ star cards
- Filters preserved in URL params â bookmark filtered views or share specific filter links
- Filter buttons styled as pills with active state highlighting
- Filtered empty state shows "No matches for current filters" with "Clear Filters" button
- Pagination preserves filter params when navigating between pages
- Accessible filter UI with aria-labels for screen readers
Version 1.7.1
January 9, 2026- Friends Leaderboard: New "Friends" tab showing players ranked by accepted friend count
- Bidirectional counting: each friendship counts for both users (+1 for requester and +1 for addressee)
- Only accepted friendships countâpending requests don't appear on the leaderboard
- Type-aware UI: empty states, subtitles, and champion titles adapt to the leaderboard type
- Same ranking system as other leaderboards: top 3 get medals, ties share ranks
- "Your Position" section works for friends leaderboard when you're outside the top 10
- Public access: view friends rankings without logging in
Version 1.7.0
January 9, 2026- Leaderboards: See top traders in our community with three leaderboard types
- Most Cards Traded: Total trading activity (cards given + received)
- Most Cards Received: Cards received from other players
- Most Cards Given: Cards generously given to others (generosity metric!)
- Top 3 positions get gold, silver, and bronze medals with champion spotlight for #1
- Standard ranking system: ties share ranks, next rank skips
- "Your Position" section shows your rank if you're outside the top 10
- Public access: anyone can view leaderboards without logging in
- Your row is highlighted when logged in so you can easily spot your position
- Leaderboards link added to main navigation
Version 1.6.1
January 8, 2026- Security Update: Updated action_text-trix to fix XSS vulnerability
- Pagination Fix: Fixed missing ellipsis in pagination (e.g., "1 ... 4 5 6 ... 10" now shows both gaps)
- Dependency Upgrade: Upgraded pagy to v43 with new simplified API
Version 1.6.0
January 4, 2026- Message Inbox: View all your conversations in one place
- Conversations grouped by trading partner with last message preview
- Unread message count badges on each conversation and in navigation
- Conversations sorted by most recent message first
- Click into any conversation to see full message thread in chronological order
- Sent messages appear on the right (blue), received on the left (gray)
- Messages automatically marked as read when you view a conversation
- Inline reply form at bottom of conversationâno need to navigate away
- Empty states for inbox with no messages and conversations with no history
- "Messages" link added to navigation with unread badge (updates on page refresh)
Version 1.5.0
January 4, 2026- Messaging: Send messages to friends to coordinate trades privately
- Message button appears next to "Friends â" badge on profiles and match cards
- Compose form with character counter (max 2,000 characters)
- Messages are plain text only for email forwarding compatibility
- Privacy-first: email addresses are never exposed to other users
- Only confirmed friends can message each other (pending requests cannot message)
- Cancel button preserves your navigation context (returns you to where you came from)
- XSS protection on all message inputs
Version 1.4.0
January 3, 2026- Friends Hub: New central location for managing all your friendships
- Three tabs: Pending (incoming/outgoing requests), Friends (confirmed friends), Find Friends (discover new players)
- Search for players by game name in Find Friends tab
- Match potential badges show how many cards you could trade with each player
- Pagination for browsing large player lists
- Public User Profiles: Click any player's name to view their profile
- See player info: game name, friend code, join date
- View their complete inventory for the active collection, organized by set
- Expandable accordion shows card details: what they need, have, or have extras of
- Match potential section shows exactly what you could trade
- Past collection summaries show completion rates
- Send friend requests or manage friendship status directly from profiles
- Re-request friendships after rejectionâdeclined users reappear in Find Friends
- Turbo Stream updates for instant UI feedback on all friendship actions
Version 1.3.0
January 2, 2026- New Journey Collection: The Journey collection is now live with 15 sets featuring destinations around the world
- 15 themed sets: Greece, Tropics, Mexico, Mysterious East, Japan, Egypt, France, Brazil, China, Germany, Italy, Great Britain, USA, Vikings, and Africa
- 150 total cards ranging from 1-5 stars with gold (non-shareable) cards in later sets
- Collection runs until March 6, 2026
- Collection Transition System: Seamless transition when new collections are released
- Previous collection (Winter) is preserved but deactivated
- All your Winter collection cards, trades, and completion records remain in the database
- Matches automatically recalculate for the new Journey collection
- Activation/deactivation timestamps added for audit trail
- System logs collection transitions for debugging and monitoring
Version 1.2.0
January 2, 2026- Collection Reset: Reset your collection after completion and start a new round
- After completing a collection, see a "đ Start New Round" button in the completion badge
- Confirmation modal shows next round number and warns that all cards will be reset to 0
- Previous completion records are preservedâonly card quantities reset to 0
- Round number indicator updates automatically (e.g., "Round 2") based on completion history
- Receive an email notification when you reset, encouraging you to start collecting again
- Matches automatically recalculate after reset based on your new (empty) inventory
- Reset button only appears when you've completed the collection and currently own all cards
- Cannot reset ended collectionsâthey become read-only
- Modal can be dismissed with Cancel button or ESC key
- Reset is transactionalâeither succeeds completely or nothing changes
Version 1.1.0
January 2, 2026- Collection Completion Detection & Celebration: Automatic detection and celebration when you complete a collection
- See a beautiful celebration modal with confetti animation when you own all cards in a collection
- Collection completion badge shows on your inventory page with round number (1st, 2nd, 3rd, etc.)
- Progress bar turns amber/gold when collection is complete
- Receive a congratulatory email when you complete a collection (includes completion round number)
- Completion tracking records each completion round for future features
- Automatic detection happens when you view your inventory pageâno manual action needed
- Completion detection works in real-time and handles edge cases (gold cards, multiple sets, etc.)
- Celebration modal can be dismissed with "Awesome!" button or ESC key
- Backfill rake task available for users who completed collections before this feature launched
Versions 1.0.0 – 1.0.9
December 21, 2025 – January 1, 2026- Initial Launch: Card inventory tracking, automatic match finding, match dashboard with friend code copying
- Daily Email Digest: Daily match notification emails with partner info and card details
- Smart Empty States: Context-aware messages and email verification guards
- Friend Request System: Send, accept, and decline friend requests with real-time Turbo Stream updates
- Trade Tracking: Mark trades complete, confirm receipt, track status (pending/confirmed/cancelled)
- Inventory Prompts: Auto-update inventory after giving or receiving cards with smart defaults
- Trade & Friend Notifications: Instant email alerts for trades and friend requests
- Mobile-responsive design, user authentication, and profiles