Skip to content

Med-Echbiy/UnlockIt

Repository files navigation

๐ŸŽฎ UnlockIt - Ultimate Achievement Tracker

License: MIT Made with Tauri Built with React TypeScript Rust Version

The ultimate achievement tracking application for PC gamers. Track your progress, monitor playtime, unlock achievements, and enhance your gaming experience with detailed statistics and insights.

๐Ÿ“ธ Screenshots

๐Ÿ  Home Dashboard

Home Page

๐ŸŽฎ My Games Library

My Games

๐Ÿ“Š Game Details & Achievements

Game Details

๐Ÿ”” Achievement Notifications

Test Notification

๐ŸŒŸ Features

๐Ÿ† Achievement Tracking

  • Real-time Achievement Monitoring: Automatically tracks and unlocks achievements as you play
  • Universal Emulator Support: Works with ALI213, RUNE, CODEX, ONLINE FIX, Goldberg, TENOKE, and Steam Config
  • Advanced Scoring System: Comprehensive point-based ranking with 6-tier rarity system (Common to Mythic)
  • Progress Visualization: Beautiful progress bars and statistics for each game
  • Achievement Details: View achievement descriptions, unlock dates, and rarity information
  • Bulk Achievement Management: Reset, sync, or manage achievements in bulk

๐ŸŽฎ Game Management

  • Steam Integration: Seamlessly integrates with Steam games and metadata
  • Game Library: Organize and manage your entire game collection
  • Playtime Tracking: Automatic playtime monitoring for all your games
  • Game Statistics: Detailed insights into your gaming habits

๐Ÿ“Š Analytics & Insights

  • HowLongToBeat Integration: Get estimated completion times for your games
  • Gaming Statistics: Track your overall gaming progress and achievements
  • Visual Progress: Beautiful charts and graphs of your gaming journey
  • Completion Tracking: Monitor your game completion percentages

๐Ÿ… Advanced Scoring System

UnlockIt features a comprehensive scoring system that rewards players based on achievement rarity and gaming milestones:

Achievement Tier System

  • Mythic (0-0.5% unlock rate): 1,000 base points - Ultra-rare achievements that few players have unlocked
  • Legendary (0.5-3% unlock rate): 500 base points - Extremely rare and prestigious achievements
  • Epic (3-10% unlock rate): 100 base points - Challenging achievements requiring skill or dedication
  • Rare (10-25% unlock rate): 50 base points - Moderately difficult achievements
  • Uncommon (25-50% unlock rate): 25 base points - Standard achievements with some challenge
  • Common (50-100% unlock rate): 10 base points - Basic achievements most players earn

Player Ranking System

Progress through 7 distinct ranks based on your total score and completion percentage:

  • Novice (0+ points, 0%+ completion): Just starting your gaming journey
  • Explorer (1,000+ points, 20%+ completion): Beginning to explore gaming achievements
  • Hunter (5,000+ points, 40%+ completion): Active achievement hunter
  • Master (10,000+ points, 60%+ completion): Skilled player with solid achievements
  • Legend (25,000+ points, 75%+ completion): Legendary achievements and high completion rates
  • Grandmaster (50,000+ points, 90%+ completion): Elite gaming mastery
  • Touch Grass (200,000+ points, 98%+ completion): Ultimate gaming mastery achieved. Time to go outside!

Bonus Multipliers

  • Rarity Bonuses: Extra points for unlocking rare achievements within specific timeframes
  • Completion Streaks: Bonus points for completing multiple games consecutively
  • Speed Bonuses: Rewards for achieving 100% completion in record time
  • Difficulty Multipliers: Enhanced scoring for games with notoriously challenging achievements (souls like games, etc.)

๐Ÿ”” Notifications & Alerts

  • Achievement Notifications: Get instant notifications when you unlock achievements
  • Custom Sounds: Personalize notification sounds (Xbox, PlayStation, etc.)
  • Visual Celebrations: Animated achievement unlock celebrations
  • Progress Milestones: Notifications for important gaming milestones

๐ŸŽจ User Experience

  • Modern UI: Clean, intuitive interface built with React and Tailwind CSS
  • Smooth Animations: Framer Motion powered animations for a delightful experience
  • Dark/Light Themes: Support for both dark and light theme preferences
  • Responsive Design: Perfect experience across different screen sizes

โš™๏ธ Configuration

Steam Integration

  1. Obtain a Steam Web API key from here
  2. Open UnlockIt settings
  3. Enter your Steam API key
  4. Start adding games to your library

๐Ÿ“– Guide

Supported Emulators

UnlockIt currently supports the following Steam emulators for achievement tracking:

  • ALI213 - Full support for achievement tracking and playtime monitoring
  • RUNE - Compatible with most games and features
  • CODEX - Works with achievement unlocking and progress tracking (dual location support)
  • ONLINE_FIX - Supports online features and achievement synchronization
  • Steam Config - Native Steam configuration file support
  • Goldberg SteamEmu - JSON/INI format support for comprehensive game compatibility
  • TENOKE - ๐Ÿ†• Latest addition with TENOKE.ini configuration file support

Adding Games with Emulators

Method 1: Direct Game Addition

  1. Launch UnlockIt
  2. Click "Add Game" or use the "+" button
  3. Navigate to your game's installation folder
  4. Select the game executable
  5. UnlockIt will automatically detect supported emulators

Method 2: Emulator Compatibility Fix

If your game doesn't appear or isn't working properly with UnlockIt:

Step 1: Use SteamAutoCracker Tool

  1. Download SteamAutoCracker from: https://github.com/BigBoiCJ/SteamAutoCracker/releases/tag/2.2.1-gui
  2. Extract the downloaded archive to a convenient location
  3. Run SteamAutoCracker.exe as administrator
  4. In the application:
    • Browse and select your game's executable file
    • Choose ALI213 as the crack type
    • Click "Crack" to apply the emulator files
  5. The tool will automatically generate and place the necessary files:
    • steam_api.dll
    • steam_api64.dll
    • valve.ini or steamConfig.ini

Step 2: Test Game Launch

  1. Try launching your game
  2. If the game launches successfully, you can now add it to UnlockIt
  3. UnlockIt should now be able to track achievements and playtime

Step 3: Rollback if Needed If the game fails to launch after applying the crack:

  1. Delete the generated emulator files:
    • steam_api.dll
    • steam_api64.dll
    • valve.ini or steamConfig.ini
  2. Rename steam_api.dll.bak back to steam_api.dll
  3. This means the game is not currently supported ๐Ÿ˜ข

Troubleshooting

Game Not Detected

  • Ensure you're pointing to the correct game executable

Achievements Not Tracking

  • Make sure UnlockIt is running before launching the game
  • Check that the game is added to your UnlockIt library

Game Won't Launch

  • Follow the rollback steps above to restore original files
  • Try running the game as administrator
  • Check Windows Defender or antivirus settings (emulator files might be flagged)
  • Ensure SteamAutoCracker was run as administrator

Live Notifications Not Appearing

  • โš ๏ธ Important: Avoid playing games in fullscreen mode to receive live achievement notifications
  • Use Borderless Window or Windowed mode instead
  • Fullscreen applications prevent Windows notifications from appearing on top
  • This is a Windows limitation, not an UnlockIt issue
  • You can change display mode in your game's graphics settings

Best Practices

  1. Always backup original files before applying any emulator cracks
  2. Use SteamAutoCracker as administrator for best results
  3. Test one game at a time when applying emulator changes
  4. Keep UnlockIt running while playing games for proper tracking
  5. Check compatibility before purchasing ๐Ÿ˜‚ or installing new games

About

๐Ÿ† Achievement tracker for PC gamers supporting 6+ Steam emulators. Features scoring system, real-time tracking, HowLongToBeat integration.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors