Create app.py

app.py

@@ -0,0 +1,142 @@
+import gradio as gr
+import requests
+import time
+import threading
+import json
+import os
+import itertools
+import string
+
+# --- CONFIGURATION ---
+CHARS = string.ascii_lowercase + string.digits + "_"
+DELAY_SECONDS = 2.0  # Safe delay to prevent IP bans from APIs
+STATE_FILE = "hunter_state.json"
+
+# Generate all 50,653 combinations deterministically
+ALL_COMBOS = ["".join(c) for c in itertools.product(CHARS, repeat=3)]
+TOTAL_COMBOS = len(ALL_COMBOS)
+
+# --- STATE MANAGEMENT ---
+def load_state():
+    if os.path.exists(STATE_FILE):
+        try:
+            with open(STATE_FILE, "r") as f:
+                return json.load(f)
+        except:
+            pass
+    return {"index": 0, "available_names": [], "is_running": True}
+
+def save_state(state):
+    with open(STATE_FILE, "w") as f:
+        json.dump(state, f)
+
+# Global state loaded into memory
+app_state = load_state()
+
+# --- BACKGROUND WORKER ---
+def background_scanner():
+    while app_state["index"] < TOTAL_COMBOS:
+        if not app_state.get("is_running", True):
+            time.sleep(5)
+            continue
+
+        current_name = ALL_COMBOS[app_state["index"]]
+        
+        try:
+            # Using PlayerDB to avoid direct Mojang IP rate-limits
+            response = requests.get(
+                f"https://playerdb.co/api/player/minecraft/{current_name}", 
+                timeout=10
+            )
+            
+            # 404 or success=false means the player does not exist (Name is available)
+            if response.status_code == 404 or (response.status_code == 200 and not response.json().get("success")):
+                if current_name not in app_state["available_names"]:
+                    app_state["available_names"].append(current_name)
+                    print(f"[FOUND] {current_name} is available!")
+            
+            # If we hit a rate limit, back off for a minute
+            elif response.status_code == 429:
+                print("[RATE LIMIT] Sleeping for 60 seconds...")
+                time.sleep(60)
+                continue # Retry same index
+                
+        except Exception as e:
+            print(f"[NETWORK ERROR] {e}. Retrying in 10s...")
+            time.sleep(10)
+            continue # Retry same index
+
+        # Move forward and save
+        app_state["index"] += 1
+        
+        # Save to disk every 10 checks to minimize disk I/O but ensure persistence
+        if app_state["index"] % 10 == 0:
+            save_state(app_state)
+            
+        time.sleep(DELAY_SECONDS)
+
+    # Final save when complete
+    app_state["is_running"] = False
+    save_state(app_state)
+
+# Start the background thread (daemon=True means it dies when the app dies)
+scanner_thread = threading.Thread(target=background_scanner, daemon=True)
+scanner_thread.start()
+
+# --- UI FUNCTIONS ---
+def get_dashboard_stats():
+    idx = app_state["index"]
+    percent = (idx / TOTAL_COMBOS) * 100
+    names = app_state["available_names"]
+    
+    status_msg = "🟢 Running in Background" if idx < TOTAL_COMBOS else "✅ Scan Complete"
+    
+    stats_markdown = f"""
+    ### 📊 Scanner Status: {status_msg}
+    * **Progress:** {idx:,} / {TOTAL_COMBOS:,} ({percent:.2f}%)
+    * **Available Names Found:** {len(names)}
+    * **Currently Checking:** `{ALL_COMBOS[min(idx, TOTAL_COMBOS-1)]}`
+    """
+    
+    names_list = "\n".join(names) if names else "No names found yet. Check back later!"
+    return stats_markdown, names_list
+
+# --- GRADIO UI ---
+with gr.Blocks(theme=gr.themes.Soft(primary_hue="indigo"), title="3-Letter MC Hunter") as demo:
+    gr.Markdown(
+        """
+        # 🕵️‍♂️ Autonomous 3-Letter Name Hunter
+        This tool runs continuously in the background checking all 50,653 combinations of A-Z, 0-9, and _. 
+        You can safely close this tab; the server will keep scanning.
+        """
+    )
+    
+    with gr.Row():
+        with gr.Column(scale=1):
+            stats_display = gr.Markdown(value="Loading stats...")
+            refresh_btn = gr.Button("🔄 Refresh Dashboard", variant="primary")
+            
+        with gr.Column(scale=2):
+            gr.Markdown("### 💎 Available Names Vault")
+            names_display = gr.TextArea(
+                label="Available Names (Copy & Paste)", 
+                interactive=False, 
+                lines=15
+            )
+
+    # Wire up the refresh button
+    refresh_btn.click(
+        fn=get_dashboard_stats,
+        inputs=[],
+        outputs=[stats_display, names_display]
+    )
+    
+    # Run once on load
+    demo.load(
+        fn=get_dashboard_stats,
+        inputs=[],
+        outputs=[stats_display, names_display]
+    )
+
+if __name__ == "__main__":
+    demo.launch()