Team Store #

Overview #

Team Stores lets teams spend currencies on items and upgrades from their shared wallet. Team members can browse and purchase items while admins manage the team’s spending power, and you can boost engagement with time-limited promotions and personalized store experiences for different players.

Capabilities #

The following operations are possible with Team Store:

• List: View available store items and active promotional modifiers for the team.
• Purchase: Spend team currencies to buy items and receive rewards
• Custom Rewards: Override default purchase rewards with custom logic for special promotions.

Example: Clan Upgrade Shop #

Your teams earn shared currencies through weekly tournaments and daily activities. Create a team store where members can spend these currencies on clan-wide upgrades like expanded storage, faster resource generation, or exclusive cosmetic banners.

During special events like holidays or tournaments, activate reward modifiers that give bonus value—maybe “Double Rewards Weekend” where all purchases give 50% extra items for 48 hours. Different team members can see personalized selections: newer players might see starter packs and tutorials, while veteran members see advanced upgrades and rare cosmetics.

Team admins control the currency flow by earning and depositing funds into the shared wallet, but any member can make purchases. You can also implement special purchase logic through custom reward functions—like “buy 3 upgrade packs, get 1 free” during promotional periods, or member-role-specific bonuses where team leaders get discounts on leadership tools.

Reward Modifiers #

Team Store supports time-based promotional events that temporarily boost purchase rewards without changing base item costs. These modifiers run independently of individual player promotions and apply to all team members during active periods.

Creating Promotional Events #

Reward modifiers can multiply item rewards, add bonus currencies, or include extra items for limited time periods. Use reward modifiers for:

• Seasonal events that encourage team spending during specific periods
• Tournament rewards that activate when teams achieve milestones
• Weekend promotions that boost team activity during off-peak times
• Member recruitment bonuses that reward teams for adding new players

Scheduling and Management #

Modifiers activate and expire automatically based on configured time windows. The system filters expired modifiers from store listings in real-time, so teams only see currently active promotions. Plan modifier schedules carefully since there’s no automatic notification when promotions expire—consider implementing countdown timers in your client to create urgency.

Key Terms #

• Team Currencies: Shared funds managed through the Teams Wallet system that any member can spend but only admins can deposit or grant.
• Disabled vs Unavailable Items: Disabled items are completely hidden from store listings, while unavailable items appear but cannot be purchased (useful for “coming soon” displays).
• Personalized Configurations: Different team members can see customized store contents, pricing, and availability based on player progression or external rules.

Technical Considerations #

Time Synchronization #

Reward modifiers use server time for all activation and expiration calculations. Ensure your client and server clocks are synchronized to avoid confusion about when promotions become active or expire.