Player Clan Finder
A command-line utility that tracks Roblox players across Pet Simulator 99 clans using the game's public API. Built to help clan leaders identify and track players who engage in scamming or other malicious activities.
Tags
Technologies Used
The Story Behind the Project
In early 2024, I was part of a top-tier Pet Simulator 99 clan called LEGIT. Our clan was known for its strong community and fair play. However, everything changed when one of our clan members was scammed by another member, losing all their valuable pets and items.
The incident sparked a massive internal conflict. The victim was devastated, and the clan leadership was determined to ensure justice. We spent countless hours warning other clans about this scammer, trying to prevent them from joining other top clans where they could continue their malicious activities.
During this process, I realized there was a need for a tool that could help clan leaders track players across different clans. Pet Simulator 99 has a public API that allows you to check a player's clan information, so I decided to build a simple command-line utility to automate this process.
Key Features
Player Tracking
Input a Roblox user ID and instantly see which clan they currently belong to
Command Line Interface
Simple CLI tool that can be easily integrated into clan management workflows
Anti-Scam Protection
Help clan leaders identify and track players with malicious intent across the game
Community Safety
Contribute to a safer gaming environment by sharing information about scammers
About Pet Simulator 99
Click to visit the game
The Game That Inspired the Tool
Pet Simulator 99 is a popular Roblox game developed by BIG Games that features pet collection, trading, and clan systems. Players can collect various pets with different rarities, trade them with other players, and join clans to participate in group activities and events.
The need of a tool to track players across different clans because of what happened in ours inspired the creation of Player Clan Finder.
Technical Implementation
The Player Clan Finder is built as a simple Python command-line utility that leverages Pet Simulator 99's public API. The tool takes a Roblox user ID as input and makes HTTP requests to the game's API endpoints to retrieve clan information.
The implementation is straightforward but effective - it uses the requests library to make API calls and parses the JSON responses to extract clan data. The tool can be run from any terminal and provides immediate results.
While the technical complexity is low, the impact was significant. This tool became an essential part of our clan's security protocol and was shared with other clan leaders to help protect their communities.
Core Technology
APIs & Integration
Code Example
Installation & Usage
The Player Clan Finder is a simple Python script that requires minimal setup. Just clone the repository and run the script with a Roblox user ID.
Quick Start
- 1Clone:
git clone https://github.com/leafranger/PlayerClanFinder.git - 2Install:
pip install requests - 3Run:
python clan_finder.py 123456789
Example Output
Player 123456789 is in clan: LEGIT Role: Member
Impact & Results
The Player Clan Finder proved to be an invaluable tool for our clan and the broader Pet Simulator 99 community. Here's what we achieved:
Immediate Results
- • Successfully tracked the scammer across multiple clans
- • Warned 15+ clan leaders about the malicious player
- • Prevented further scams in other top clans
Community Impact
- • Shared tool with other clan leaders
- • Established a network of clan security
- • Created awareness about player tracking
Skills & Technologies Learned
Future Improvements
While the current tool serves its purpose well, there are several potential enhancements that could make it even more useful:
Technical Enhancements
- • Batch processing for multiple players
- • Historical clan tracking
- • Web interface for easier access
- • Database integration for persistent data
Community Features
- • Shared blacklist database
- • Clan leader network integration
- • Automated alerts for known scammers
- • Community reporting system
Other Side Projects
LegitBot
A Discord bot designed for Pet Simulator 99 clans to track diamond donations and manage clan activities. Built for the LEGIT clan, it featured real-time donation tracking, automated announcements, and clan management tools.
Pet Sim 99 Autofish
A Python utility tool that uses image recognition to automatically position the cursor on whirlpools in Pet Simulator 99's fishing minigame for optimal loot. Paired with an external autoclicker to maintain activity and prevent disconnection.
Arise Crossover Tools (Website)
A comprehensive web platform for tracking periodic dungeons and events in the Roblox game Arise Crossover, featuring real-time timers, weapon price calculators, and community features.