Skip to content

Gmast2662/Gem-Clicker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

110 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ’Ž Gem Clicker

An addictive idle mining game where you click to mine gems, upgrade your tools, and build an automated gem empire!

๐ŸŽฎ Play Now!


๐ŸŒŸ About

Gem Clicker is an incremental idle game where your goal is to mine as many gems as possible! Start by clicking the gem to mine manually, then purchase upgrades and hire workers to automate your gem empire. With a prestige system, achievements, and offline progress, there's always something to strive for!


โœจ Features

Core Gameplay

  • ๐Ÿ’Ž Click to Mine - Every click mines precious gems
  • โ›๏ธ Tool Upgrades - Upgrade from pickaxes to laser drills
  • ๐Ÿ‘ท Automated Mining - Hire miners and build advanced facilities
  • โœจ Multiplier System - Powerful click & generator multipliers
  • โญ Prestige System - Reset for permanent bonuses (scaling difficulty)
  • ๐Ÿ”ฎ Rebirth System - Ultimate prestige for massive multipliers
  • โญ Prestige Shop - Spend prestige points on permanent upgrades!

Content & Progression

  • ๐Ÿ† Achievements - 16+ achievements to unlock with progress bars
  • ๐ŸŒŸ Milestones - Permanent bonuses at major thresholds
  • ๐ŸŽฐ Lucky Events - 9 random event types (Golden Gem, Time Warp, Gem Goblin, etc.)
  • ๐Ÿช Shop System - Organized into Gameplay/Features/Automation categories
  • ๐Ÿค– Automation - Auto-buy generators, auto-prestige, auto-claim rewards

Customization

  • ๐ŸŽจ Themes - 10 premium themes (Ocean, Emerald, Halloween, Winter, etc.)
  • ๐Ÿ’Ž Gem Skins - 4 faceted gem designs (Ruby, Sapphire, Emerald, Amethyst)
  • โœจ Particles - 10 particle effects (Rainbow, Fire, Cosmic, Electric, etc.)
  • ๐ŸŽต Sound Packs - 9 sound packs + Premium pack with real audio files
  • ๐Ÿ”ข Number Formats - Choose Suffix, Scientific, Engineering, or Full display

Quality of Life

  • ๐Ÿ’พ Auto-Save - Progress saved every 5 seconds
  • ๐ŸŒ™ Offline Progress - Earn gems while away (up to 48 hours!)
  • ๐Ÿ“ฑ Mobile Optimized - Full touch support with responsive design
  • โŒจ๏ธ Keyboard Shortcuts - Quick navigation (0-9 keys, Space to click)
  • ๐Ÿ”” Smart Notifications - Get notified of prestige/upgrades
  • ๐Ÿ“ค Share Features - Share achievements & stats to clipboard
  • ๐ŸŽฎ Tips System - In-game strategy guide
  • ๐Ÿ“‹ Changelog - Track all updates in-game

๐ŸŽฎ How to Play

Getting Started

  1. Click the gem in the center to mine gems manually
  2. Purchase upgrades in the "Click Upgrades" tab to mine more gems per click
  3. Buy generators in the "Generators" tab to mine gems automatically
  4. Watch your gem count grow!

Early Game Tips

  • Focus on click upgrades first to get more gems per click
  • Buy your first Miner (costs 15 gems) as soon as you can
  • Each generator produces gems automatically every second
  • Balance between click upgrades and generators for optimal growth

Mid Game Strategy

  • Start diversifying your generators - each one is more powerful than the last
  • Crystal Caves and Deep Shafts provide massive production boosts
  • Keep upgrading your mining tools for better manual clicking
  • Watch for achievements to track your progress!

Late Game & Prestige

  • When progress slows down, consider Prestiging
  • Prestige requires 1 million total gems earned (scales up each time!)
  • You'll lose all gems and generators BUT gain Prestige Points
  • Each Prestige Point gives a permanent +5% bonus to ALL gem production
  • NEW: Spend prestige points in the Prestige Shop for permanent upgrades!
  • Your first prestige is the biggest boost - don't be afraid to reset!

๐Ÿ—๏ธ Generators (Buildings)

Unlock increasingly powerful mining operations:

Generator Cost Production/sec Description
๐Ÿ‘ท Miner 15 gems 0.1/sec Manual worker
๐Ÿ›ค๏ธ Mine Cart 100 gems 1/sec Transports gems
๐Ÿ”๏ธ Gem Mine 1.1K gems 8/sec Dedicated operation
๐Ÿ”ท Crystal Cave 12K gems 47/sec Natural formations
๐Ÿ•ณ๏ธ Deep Shaft 130K gems 260/sec Deep underground mining
๐Ÿ—๏ธ Drilling Rig 1.4M gems 1.4K/sec Industrial extraction
๐ŸŒ€ Gem Portal 20M gems 7.8K/sec Dimensional summoning
โฐ Time Rift 330M gems 44K/sec Ancient gems
โš›๏ธ Quantum Excavator 5.1B gems 260K/sec Atomic creation
โœจ Stellar Forge 75B gems 1.6M/sec Starlight conversion

โ›๏ธ Click Upgrades (Tools)

Upgrade your mining power:

Upgrade Cost Power Boost Description
โ›๏ธ Iron Pickaxe 10 gems +1 per click Basic mining tool
๐Ÿ”จ Mining Drill 100 gems +5 per click Powered drilling
๐Ÿšœ Excavator 1K gems +25 per click Heavy machinery
๐Ÿ”ฆ Laser Drill 10K gems +100 per click Precision technology

๐Ÿ† Achievements

Unlock achievements to show off your mining prowess:

  • ๐Ÿ’Ž First Gem - Mine your first gem
  • ๐Ÿ“ฆ Gem Collector - Mine 100 gems
  • ๐Ÿ‘ท Mining Boss - Hire your first Miner
  • ๐Ÿ’ฐ Gem Millionaire - Mine 1 million gems
  • ...and more to discover!

โญ Prestige System

When to Prestige?

  • You can prestige after earning 1 million total gems (all-time)
  • Each prestige grants Prestige Points based on your total gems earned
  • Formula: โˆš(total earned / 1,000,000) = Prestige Points
  • Each point gives a permanent +1% bonus to all production

Prestige Examples:

  • 1M gems earned โ†’ 1 Prestige Point โ†’ +1% bonus
  • 4M gems earned โ†’ 2 Prestige Points โ†’ +2% bonus
  • 9M gems earned โ†’ 3 Prestige Points โ†’ +3% bonus
  • 100M gems earned โ†’ 10 Prestige Points โ†’ +10% bonus

Tip: Your first prestige happens around 1M gems and gives you +1% forever. The bonus compounds with each prestige!


๐Ÿ’พ Save System

Auto-Save

  • Your game saves automatically every 5 seconds
  • Progress is stored in your browser's local storage

Export/Import

  • Export: Click "Export" to copy your save data
  • Save the text somewhere safe (notepad, etc.)
  • Import: Click "Import" and paste your save data
  • Great for transferring between devices or backing up!

Reset

  • Completely wipe all progress (including prestige)
  • Cannot be undone - use with caution!

๐ŸŒ™ Offline Progress

  • The game calculates earnings while you're away
  • Offline earnings are calculated for up to 24 hours
  • Only generators (not clicks) count toward offline progress
  • When you return, you'll see how many gems you earned!

๐Ÿ“ฒ Install as App (NEW!)

Gem Clicker is now a Progressive Web App (PWA)!

On Mobile (Android/iOS):

  1. Visit https://gmast2662.github.io/Gem-Clicker/
  2. Tap the "Share" button
  3. Tap the "Add to Home Screen" button
  4. App installs like a native app!
  5. Opens in fullscreen (no browser UI)
  6. Works offline!

On Desktop (Chrome/Edge):

  1. Visit the game
  2. Click the โŠ• Install icon in address bar
  3. App installs as standalone window!
  4. Works offline!

Benefits:

  • โœ… Works completely offline after first load
  • โœ… Faster loading (cached resources)
  • โœ… Fullscreen experience
  • โœ… App icon on home screen
  • โœ… No browser UI clutter

๐Ÿ“‹ Changelog

Version 1.6.0 (Latest) - November 14, 2024

  • ๐Ÿ“ฑ Progressive Web App - Install on mobile & desktop, play offline!
  • ๐ŸŽฐ 5 Lucky Event Types - Golden Gem, Gem Rush, Meteor Shower, Lucky Streak, Gem Tornado
  • โš™๏ธ Configurable Events - Add custom events in config.json
  • ๐Ÿ”ง Admin Event Controls - Dropdown to trigger any event
  • ๐Ÿช 3 New Shop Items - Achievement Hunter (progress bars), Lucky Charm (2x event chance), Gem Magnet (+20% production)
  • โœจ Transcendence System - Beyond rebirth (5x multiplier per point)
  • ๐Ÿ‘ผ Ascension System - Beyond transcendence (10x multiplier per point)
  • ๐ŸŽฏ Achievement Progress Bars - See your progress toward each achievement
  • โญ 2 New Particles - Star particles, Heart particles
  • ๐ŸŽต Sound Packs - Retro 8-bit sounds, Soft gentle sounds (cosmetic)
  • ๐Ÿ’Ž Improved Gem Shapes - Classic diamond cut with pointed top/bottom
  • ๐Ÿ“ Easy Editing - tips.json & changelog.json for simple updates
  • ๐Ÿ”ง Live Admin Updates - Panel updates in real-time
  • ๐Ÿญ Better Generator Display - Shows base production before purchase

Version 1.5.0 - November 13, 2024

  • ๐ŸŽจ NEW: Cosmetics System - Separate tab for themes, skins, and particle effects
  • ๐Ÿ’Ž Animated Gem Skins - 4 octagonal diamond-shaped gems with shimmering effects
  • โœฆ Sparkle Effects - Pulsing star animations on all gem skins
  • ๐ŸŒŠ 4 Premium Themes - Deep Purple, Ocean Blue, Emerald Forest, Sunset Orange
  • โ„๏ธ 6 Particle Effects - Rainbow, Golden, Ice, Fire, Nature, Default
  • โš™๏ธ Settings Integration - Mix and match cosmetics via dropdowns
  • ๐Ÿ”ง Admin Panel - New cosmetics unlock/reset buttons
  • โš–๏ธ Economy Rebalance #2 - Major changes:
    • Multipliers nerfed: 2x โ†’ 1.2x, 2.5x โ†’ 1.3x (additive instead of multiplicative growth)
    • All multiplier costs increased 5-10x
    • Auto-clicker cost increased 10x
    • Prestige requirement: 1M โ†’ 2.5M
    • Max levels reduced further (15 โ†’ 8, 10 โ†’ 6)
  • ๐Ÿ“Š Fixed Average Clicks - Now shows actual clicks/sec instead of total
  • โŒจ๏ธ Updated Shortcuts - Cosmetics on '5', Settings on '0'
  • ๐Ÿ“– New Documentation - COSMETICS_GUIDE.md for adding custom items

Version 1.2.0

  • ๐Ÿ”ข Better Number Formatting: Large numbers now show as K/M/B/T (e.g., 1.5M instead of 1500000)
  • โญ Prestige Scaling: Each prestige is now 1.5x harder than the last (prevents prestige spam)
  • โš–๏ธ Major Economy Rebalance: Slowed progression significantly for better gameplay
    • Generator costs increased 2-5x with higher multipliers (1.15 โ†’ 1.8)
    • Multiplier costs increased 5-50x
    • Shop items 2-10x more expensive
    • Prestige requirement increased from 100K to 1M
  • ๐Ÿ”ง Bug Fixes: Fixed multipliers causing infinity, shop upgrades not applying, offline earnings, countdown timers
  • ๐ŸŽจ UI Improvements: Fixed prestige icon display, better dark mode text visibility
  • ๐Ÿช New Shop Items: Golden Touch (2x clicks), Overdrive (1.5x production), Prestige Master (2x prestige), Bulk Discount (10% cheaper)
  • ๐Ÿ›ก๏ธ Safety Features: Added max levels to multipliers, infinity prevention

Version 1.1.0

  • โฑ๏ธ Lucky Events: Random golden gem (10x clicks) and gem rush (2x production) events
  • ๐ŸŽฏ Milestones: Permanent production bonuses at gem milestones
  • ๐Ÿค– Auto-Clicker: Automated clicking system
  • ๐ŸŽ Daily Rewards: Streak-based reward system
  • ๐Ÿ”ฎ Rebirth System: Ultimate prestige for massive multipliers
  • ๐Ÿช Shop System: One-time permanent upgrades
  • โŒจ๏ธ Keyboard Shortcuts: Quick navigation with number keys
  • ๐ŸŒ“ Theme Switcher: Light/Dark mode options

Version 1.0.0

  • ๐ŸŽฎ Initial Release
  • ๐Ÿ’Ž Click to mine gems
  • โ›๏ธ 4 click upgrade tiers
  • ๐Ÿ‘ท 10 generator types
  • โญ Prestige system
  • ๐Ÿ† 16 achievements
  • ๐Ÿ’พ Auto-save system
  • ๐ŸŒ™ Offline earnings

๐ŸŽฏ Pro Tips

  1. Early game: Focus on getting your first few generators
  2. Don't hoard gems: Spend them on upgrades to earn more!
  3. Balance is key: Mix click upgrades with generators
  4. Prestige early: Your first prestige gives a huge relative boost
  5. Check achievements: They guide your progression
  6. Let it idle: This is an idle game - let it run in the background!

๐Ÿ–ฅ๏ธ Browser Compatibility

Gem Clicker works on all modern browsers:

  • โœ… Chrome / Edge (recommended)
  • โœ… Firefox
  • โœ… Safari
  • โœ… Opera

Requirements:

  • JavaScript enabled
  • LocalStorage enabled
  • Modern browser (2020+)

๐Ÿ†• What's New in v1.6.5

Latest update brings TONS of new content!

โญ Prestige Shop

Spend prestige points on permanent upgrades that persist through prestige:

  • Eternal Click Power (+50% per level)
  • Eternal Production (+25% per level)
  • Head Start (1K starting gems per level)
  • Passive Clicking (+1 auto-click/s per level)
  • Lucky Fortune (+10% event chance per level)

๐Ÿค– Automation System

Set it and forget it:

  • Auto-Buy Generators (buys cheapest when affordable)
  • Auto-Prestige (when you can gain 5+ stars)
  • Auto-Claim Daily (claims rewards automatically)

๐ŸŽฒ More Random Events

9 event types now including:

  • Time Warp (3x everything!)
  • Treasure Chest (instant gems)
  • Black Hole (10x production)
  • Gem Goblin (steals then gives more back)

๐ŸŽจ More Customization

  • 10 premium themes (added Halloween, Winter, Crimson, etc.)
  • 10 particle effects (added Cosmic, Electric, Confetti)
  • 9 sound packs + Premium pack with real MP3 files
  • 4 number format options (Suffix, Scientific, Engineering, Full)

๐Ÿ“ค Share Your Progress

  • Share Achievements button
  • Share Stats button
  • Copy to clipboard and show off!

๐Ÿ› ๏ธ For Developers

Want to customize the game or understand how it works?

Check out SETUP.md for:

  • Complete customization guide
  • Configuration options
  • Balancing tips
  • How to modify the code
  • Creating your own theme

๐Ÿ“ Credits

Created by Gmast2662

Built with:

  • Vanilla JavaScript
  • CSS3
  • HTML5

๐Ÿ“œ License

Free to play, free to modify, free to share!


๐ŸŽฎ Ready to Mine?

Start Playing Now!

Happy mining! ๐Ÿ’Žโ›๏ธโœจ

About

๐Ÿ’Ž Gem Clicker - An addictive idle mining game where you click to mine gems, upgrade your tools, and build an automated gem empire! Features prestige system, achievements, and offline progress.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors