━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚡ INFAMOUS ATM SKIMMER

PhantomNET Edition — v1.0.0 

video: https://youtu.be/JNoRAOslK7U?si=WeGnLDXjJVoKLWIA

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

A fully server-authoritative criminal enterprise system for QBCore. Plant skimmers on any ATM in the city, passively harvest encrypted card data, and sell through an underground fence with a dynamic, fluctuating market economy. Five tiers of progression. Custom hacker NUI. Full database persistence.

🟢 CORE FEATURES

─────────────────────────────────

🖥️ Server-Authoritative Capture Engine

All capture logic runs server-side with randomized intervals. Each tick rolls a detection chance. Zero client-side manipulation possible.

📊 5-Tier Skimmer Progression

Basic → Modified → Advanced → Military-Grade → Ghost. Each tier scales speed, capacity, and stealth. Reputation-gated at the broker.

💹 Dynamic Market Economy

Fence payouts fluctuate between cold (0.40x) and hot (2.20x) on a configurable timer with mean-reversion modeling. Sell high or hold and gamble.

🎯 QB-Target ATM Installation

Walk up to any ATM with a skimmer in your pocket. Installs via QB-Target with tier-scaled ox_lib skill checks.

💰 Black Money Payouts

Fence pays in black_money items — integrates directly with your server's existing laundering systems.

📱 PhantomNET Custom NUI

Matrix rain, CRT scanlines, hacker terminal aesthetic. Three tabs: Dashboard, Skimmers, and Market with live data and integrated sell controls.

🗄️ Full OxMySQL Persistence

Three indexed database tables. Skimmers, reputation, and market state all survive restarts.

🛡️ HARDENING & LIMITS

─────────────────────────────────

✅ Max active skimmers per player (configurable, default 3)

✅ Install cooldown timer (configurable, default 60s)

✅ One skimmer per ATM — global enforcement across all players

✅ Server-side input validation on all transactions

✅ Config validation on startup — catches bad values before they cause issues

🎮 GAMEPLAY LOOP

─────────────────────────────────

1️⃣ BUY — Visit the Broker NPC. Purchase a skimmer + tablet. Cash only.

2️⃣ INSTALL — Walk to any ATM. Pass the skill check. Device goes in.

3️⃣ WAIT — Skimmer passively captures data. Get notified on each tick.

4️⃣ EXTRACT — Return to the ATM. Pull captures as stackable data cards.

5️⃣ SELL — Visit the Fence or use your tablet. Payout depends on market.

6️⃣ UPGRADE — Earn rep from sales. Unlock higher tier skimmers.

🔁 Retrieve skimmers at any time — device returns to your inventory for reuse.

⚠️ RISK SYSTEM

─────────────────────────────────

🔴 DETECTION — Every capture tick rolls a % chance the skimmer gets found. Device is permanently lost. Uncollected captures vanish.

🟡 BURNOUT — Every skimmer has a max capture limit. When full, it stops and the hardware is consumed.

Better tiers = lower detection + higher capacity. But nothing is guaranteed.

📈 SKIMMER TIERS

─────────────────────────────────

⬜ Tier 1 — Basic Skimmer

Speed: 120–240s | Cap: 30 | Detect: 6.0% | ~1hr | ~$4.5k | $2,500

🟩 Tier 2 — Modified Skimmer

Speed: 90–180s | Cap: 60 | Detect: 4.0% | ~2hrs | ~$9k | $7,500

🟦 Tier 3 — Advanced Skimmer

Speed: 60–120s | Cap: 120 | Detect: 2.5% | ~2.5hrs | ~$18k | $18,000

🟪 Tier 4 — Military-Grade

Speed: 45–90s | Cap: 200 | Detect: 1.2% | ~3hrs | ~$30k | $45,000

🟨 Tier 5 — Ghost Skimmer

Speed: 30–60s | Cap: 300 | Detect: 0.4% | 3hrs+ | ~$45k | $100,000

💹 MARKET ECONOMY

─────────────────────────────────

Rates shift every 15 minutes with mean-reversion modeling:

❄️ Cold — 0.40x — $60/card

🔵 Cool — 0.65x — $97/card

⚪ Neutral — 1.00x — $150/card

🟠 Warm — 1.55x — $232/card

🔥 Hot — 2.20x — $330/card

📱 PHANTOMNET NUI

─────────────────────────────────

Custom hacker terminal accessible from the Skimmer Tablet item.

◈ DASHBOARD — Live rep, data card count, lifetime earnings, active skimmer summary

◇ SKIMMERS — Device management with extract + retrieve buttons (proximity enforced)

◆ MARKET — Live rates, trend indicator, integrated sell controls with payout estimator

Visual effects: Matrix rain canvas, CRT scanlines, screen flicker, boot animation, glitch transitions

🔧 ADMIN COMMANDS

─────────────────────────────────

/skimmerreset — Wipe all active skimmers server-wide

/skimmermarket — Force an immediate market update

/skimmersetrep [id] [amount] — Set a player's skimmer reputation

✨ QUALITY OF LIFE

─────────────────────────────────

📍 Tier-colored minimap blips for active skimmers

🔔 Real-time notifications for captures, detection, and burnout

🌍 Localization-ready — all player-facing strings in config

🖨️ Branded startup banner with config validation summary

🎬 Animation preloading — no first-use stutter

🐛 Debug mode with full server console logging

📦 WHAT'S INCLUDED

─────────────────────────────────

✅ Full source code (client, server, config, NUI)

✅ SQL schema (3 tables + seed data)

✅ Item definitions (7 items, copy-paste ready)

✅ Professional README with full install guide

✅ Config reference with every option documented

✅ Changelog + License

⚙️ DEPENDENCIES

─────────────────────────────────

• qb-core

• qb-inventory

• qb-target

• ox_lib (v3.0+)

• oxmysql

Also requires black_money as an existing item in your items.lua.

📋 INSTALLATION

─────────────────────────────────

1. Import sql/install.sql into your database

2. Add item definitions from items_add_to_qbcore.txt to your items.lua

3. Add inventory images (7 PNG files)

4. Set Broker + Fence NPC coordinates in config.lua

5. ensure infamous-atm-skimmer in server.cfg

6. Restart. Done.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Built with precision by Infamous Development.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━