{"id":27042592,"url":"https://github.com/gitbolt/shapeseeker","last_synced_at":"2025-04-05T04:29:31.522Z","repository":{"id":283821482,"uuid":"953006254","full_name":"GitBolt/shapeseeker","owner":"GitBolt","description":"🟣 A Reddit game where users hide a shape among random shapes for others to find","archived":false,"fork":false,"pushed_at":"2025-03-23T17:01:10.000Z","size":545,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-23T17:33:57.031Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GitBolt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-22T10:58:20.000Z","updated_at":"2025-03-23T17:14:59.000Z","dependencies_parsed_at":"2025-03-23T17:44:41.243Z","dependency_job_id":null,"html_url":"https://github.com/GitBolt/shapeseeker","commit_stats":null,"previous_names":["gitbolt/shapefinder","gitbolt/shapeseeker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GitBolt%2Fshapeseeker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GitBolt%2Fshapeseeker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GitBolt%2Fshapeseeker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GitBolt%2Fshapeseeker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GitBolt","download_url":"https://codeload.github.com/GitBolt/shapeseeker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247289392,"owners_count":20914463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-05T04:29:30.907Z","updated_at":"2025-04-05T04:29:31.505Z","avatar_url":"https://github.com/GitBolt.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shape Seeker\n\nShape Seeker is a Reddit game where players create and find a hidden shape within a visually complex background made up of other random shapes.\n\n![Shape Seeker Game](assets/title_text.png)\n\n## Table of Contents\n- [Quick Start](#quick-start)\n- [Game Overview](#game-overview)\n- [Features](#features)\n- [Detailed Usage](#detailed-usage)\n  - [Game Creation](#game-creation)\n  - [Playing Games](#playing-games)\n  - [Game Results and Statistics](#game-results-and-statistics)\n- [Technical Architecture](#technical-architecture)\n- [Development Setup](#development-setup)\n- [Contributing](#contributing)\n\n## Quick Start\n\n### Game Creators\n1. Open the pinned Hub post and click **Create Game**\n2. Select a shape, color, and size for your hidden target\n3. Place your shape strategically on the canvas\n4. Generate background shapes to create visual complexity\n5. Click \"Create Game\" to publish your puzzle to the subreddit\n\n### Players\n1. Find the hidden shape described in the post (e.g., \"Find the Blue Square\")\n2. Tap where you think it's located within the 5-second time limit\n3. See your results compared to other players' performance\n\n## Game Overview\n\nShape Seeker operates through a central Hub post where new games are created and shared. Each game is a Reddit post on its own and consists of a single hidden target shape that players must locate within a complex visual background. Games track metrics such as:\n\n- Success rate (average of players who found the shape)\n- Time to find the shape\n- Distance from the target for incorrect guesses\n\nOne player can only attempt a game once\n\n## Detailed Usage\n\n### Game Creation\n\n1. **Creating the Hub Post (Moderator Only)**\n    - From the subreddit menu, click on \"🎮 Create Shape Seeker Hub\"\n    - This creates a pinned post that serves as the control center for all Shape Seeker games\n    - The Hub post contains a guide, finding a game by id, stats, and the \"Create Game\" button\n    - Only moderators can create the Hub, but any user in the subreddit can create games\n\n2. **Start Game Creation from the Hub**\n   - Navigate to the Hub post pinned at the top of the subreddit\n   - Click the **Create Game** button to open the game creation interface\n   - The creation interface provides a complete set of tools for designing your puzzle\n   \n3. **Design Your Puzzle**\n   - **Shape Selection**: Choose from four different shapes (square, circle, triangle, and star)\n   \n   - **Color Selection**: Pick from five distinct colors (red, blue, green, yellow, and purple)\n   \n   - **Size Adjustment**: Use the slider to set your shape's size (range: 30-60 pixels)\n   \n   - **Background Generation**: Create complex visual noise:\n     - Click \"Generate Background Shapes\" to create a random field of shapes\n     - Each generation creates 50-100 random shapes of various colors and sizes.\n     - Generate as many times as needed to achieve desired complexity\n     - Shapes have a little opacity, allowing overlap that ensures two shapes do not combine to form a whole new solid shape, which may hide the target shape completely, making it impossible to find it.\n   \n   - **Cleanup and Refinement**:\n     - Click \"Remove Repeated Shapes\" to ensure your target shape is unique\n     - This tool scans the canvas and removes any shapes identical to your chosen target\n     - This step is necessary to avoid confusion about which shape is the target. When you click \"Generate Background Shapes,\" it automatically creates a background where no shape matches the type and color of the shape you want to hide. However, if you change the type or color of the shape to be hidden after generating the background, there's a chance that the background already contains a shape with the same type and color as the new hidden shape. In that case, you'll need to clean up the background to ensure the target remains distinct\n\n4. **Shape Placement**\n   - Click anywhere on the canvas to place your target shape\n   - Strategic placement considerations:\n     - Near edges: Makes the shape harder to find\n     - Near similar colors: Creates natural camouflage\n     - Behind other shapes: Partial occlusion increases difficulty\n   - You can reposition your shape as many times as needed before publishing\n\n5. **Publish Your Game**\n   - Click \"Create Game\" to publish to the subreddit\n   - Your game post will automatically include:\n     - A title describing what to find (e.g., \"Find the Blue Square\")\n     - The generated canvas with hidden shape\n     - Statistics of number of people who tried to guess and percentage of them who succeeded\n     - Play button for users to begin the challenge\n\n### Playing Games\n\n1. **Exploring Games**\n   - Browse the subreddit for Shape Seeker game posts\n   - Game posts are tagged with [Shape Seeker] and indicate the target shape\n   - Alternatively, players can \"find\" a particular game using it's ID by going to the pinned Hub post and clicking the \"Find Game by ID\" button\n\n2. **Find the Shape**\n   - Game posts clearly indicate what to find (e.g., \"Find the Blue Square\")\n   - Click \"Play\" to begin the challenge\n   - A 5-second timer starts automatically when the game loads\n   - The target shape is displayed in the corner as a reference\n   - Carefully scan the canvas for the hidden shape\n   - Tap/click where you believe the shape is located\n   - Remember: There is exactly one instance of the target shape in the puzzle\n\n3. **Game Interface Elements**\n   - **Timer**: Prominently displayed countdown showing remaining seconds\n   - **Target Display**: Clear visual indicator of which shape/color to find\n   - **Stats Display**: Shows current success metrics (players who found it, average time)\n   - **Canvas**: The main game area where the puzzle is displayed\n\n4. **Results and Feedback**\n   - Immediately after submitting your guess, you'll see your results:\n     - **Success/Failure Indicator**: Clear visual feedback on whether you found the shape\n     - **Distance Metric**: If you missed, shows how far away your guess was (in pixels)\n     - **Time Used**: Displays how many seconds (to 2 decimal places) you took to find the shape\n     - **Target Reveal**: Shows the actual location of the hidden shape\n     - **Your Guess**: Highlights where you clicked/tapped\n   \n   - Results are persistent and accessible by:\n     - Returning to the game post\n     - Refreshing the page after playing\n     - Checking your player profile (coming soon!)\n\n### Game Results and Statistics\n\n1. **Individual Game Results**\n   - Each game post transforms into a results page after you've played\n   - Results show:\n     - Whether you found the shape successfully\n     - Your reaction time (how quickly you found the shape)\n     - Distance from target (if you missed)\n     - A simplified game board that shows where you tapped and where target shape location was\n\n2. **Community Statistics**\n   - Each game displays aggregated statistics:\n     - Success rate: Percentage of players who found the shape\n     - Average find time: How long it takes most players to find the shape\n     - Heat map: Visual representation of where players clicked (coming soon!)\n\n3. **Player Statistics** (coming soon!)\n   - Personal dashboard showing:\n     - Games played and success rate\n     - Average reaction time\n     - Performance trends over time\n     - Achievements and badges\n     - Comparison with community averages","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitbolt%2Fshapeseeker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitbolt%2Fshapeseeker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitbolt%2Fshapeseeker/lists"}