Readme

ThreadSquare 🎮

A subreddit-specific community experience app where you express yourself with your unique Snoo avatar while interacting with other community members in real-time like never before!

ThreadSquare transforms your subreddit into a vibrant, interactive meeting space built on Reddit's Devvit platform. It's a whole new way to connect, socialize, and hang out with your community!

What is ThreadSquare?

ThreadSquare is a real-time social experience designed for your subreddit community. Unlike traditional Reddit interactions, ThreadSquare lets you:

  • 🎨 Express yourself with YOUR Snoo - Your personalized Reddit avatar comes to life in a shared virtual space
  • 🚶 Move and explore together - Walk around a beautifully generated tile-based world
  • 💬 Chat in real-time - See messages appear as floating chat bubbles above avatars, just like in social games
  • 😀 React with emojis - Express your feelings instantly with emoji reactions visible to everyone
  • 👥 Hang out with your community - See who's online and interact with them in ways never possible before on Reddit
  • Invite friends - Send direct invitations to other users to join you in the space
  • �🔍 Discover and socialize - Zoom, pan, and explore the shared space while meeting fellow community members

Why ThreadSquare?

This is more than just a Reddit post - it's a community hangout space!

ThreadSquare brings a completely new dimension to subreddit interaction. Instead of just reading and commenting on posts, your community members can:

  • Actually see each other with their unique Snoo avatars
  • Move around and gather in different areas of the shared space
  • Have spontaneous conversations through real-time chat bubbles
  • Express themselves instantly with emoji reactions
  • Feel present in their community in a way that traditional Reddit simply can't offer

Perfect for gaming communities, fan clubs, support groups, or any subreddit that wants to foster deeper, more personal connections among members.

For Moderators 🛡️

ThreadSquare comes with powerful moderation tools built-in:

  • Report System: Users can report inappropriate messages directly to your moderation team
  • Instant Ban Capability: Ban users in real-time from chat or their profile
  • Immediate Enforcement: Banned users are kicked instantly and cannot rejoin
  • Flexible Bans: Choose permanent or temporary bans with custom messages
  • Reddit Integration: Works seamlessly with Reddit's native moderation system
  • Safe by Design: All content is reportable and actionable

Your community's safety is our priority!

Features

Real-Time Interaction

  • Live Movement: Users move their Snoo avatars across a 50x50 grid in real-time
  • Chat System: Messages appear as floating chat bubbles above avatars and fade after a duration
  • Emoji Reactions: Express yourself with emoji reactions visible to all users
  • Invite Feature: Send invitations to other users to join you in ThreadSquare
  • Member List: See who's currently in the space with their coordinates

Environment

  • Procedurally Generated Map: Static 50x50 grid with grass, mushrooms, and rocks
  • Smart Spawning: New users automatically spawn on empty tiles
  • Collision Detection: Users can't walk through rocks, mushrooms, or other players

User Experience

  • Zoom & Pan: Interactive controls to navigate the space
  • All Chat Panel: View message history from all participants
  • User Profiles: Click on members to view their Reddit profiles

🛡️ Moderation & Safety Features

ThreadSquare includes comprehensive moderation tools to keep your community safe:

For All Users:

  • 🚩 Report Messages: Report inappropriate chat messages directly to moderators
    • Click the report button on any message (except your own)
    • Choose from predefined report reasons or enter custom details
    • Reports are sent directly to subreddit moderators via Modmail

For Moderators:

  • 🔨 Ban Users: Multiple ways to ban rule-violating users

    • Ban directly from chat messages
    • Ban from user profile modal
    • Choose permanent or temporary bans (1-999 days)
    • Add custom ban reasons and messages
    • Banned users are immediately kicked from ThreadSquare
  • ⚡ Real-Time Enforcement: Banned users are instantly removed from the space

    • No need to refresh - all users see the removal in real-time
    • Banned users cannot rejoin the space
    • Clear error messages shown to banned users
  • 🔐 Automatic Protection:

    • Banned users are checked on join attempt
    • Moderator status is automatically detected
    • Only moderators see ban and moderation tools

Safety by Design:

  • All user-generated content is reportable
  • Moderators can take immediate action
  • Integration with Reddit's native moderation system
  • Full audit trail through Reddit's mod logs
  • Compliant with Devvit content safety requirements

Quick Start Guide

For Users:

  1. Join: Click to enter your subreddit's ThreadSquare
  2. Move: Click anywhere on the map to walk to that location
  3. Chat: Type messages that appear above your Snoo avatar
  4. React: Use emojis to express yourself
  5. Explore: Zoom, pan, and meet other community members
  6. Report: Click 🚩 on any inappropriate message to report it

For Moderators:

  1. Monitor: Watch the All Chat panel for community interactions
  2. Report Review: Check Modmail for user reports
  3. Take Action:
    • Click 🔨 on messages to ban users
    • Click usernames → "Ban User" for profile-based bans
  4. Choose Ban Type: Permanent (0 days) or Temporary (1-999 days)
  5. Enforce: Banned users are immediately removed from the space

Technical Details

  • Platform: Built on Reddit's Devvit web platform
  • Real-time: Uses Devvit's realtime channels for instant updates
  • Storage: Redis for state management
  • API: Integrates with Reddit API for user data and moderation
  • Capacity: Supports up to 2,000 concurrent users per room
  • Map Size: 50x50 procedurally generated tile grid

Made with ❤️ for the Reddit community

About this app