ATLAS

The premium phone OS for QBCore.

Built different. By one dev. For the streets.

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

Most FiveM phones are bloated, generic, or both. Atlas isn't. Eight functional apps, a native gang framework, a built-in sportsbook, device-bound security, and a phone-to-ear animation system that makes calls feel real. No third-party APIs. No phone-home. No bloat.

Atlas treats your phone as a real device. Each inf_phone item carries a unique serial in its inventory metadata. Lose your phone, lose your data. Pick up someone else's, you'd better know their PIN.

One developer. No team. Premium quality. End of story.

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

WHAT MAKES ATLAS DIFFERENT

🎯 NATIVE GANG FRAMEWORK BUILT INTO THE PHONE

No more wrestling with qb-gangs. Players create their own crews — names, tags, 12-color themes, treasury, chat, 9-permission rank system. Nearby-player invites (no typing citizenids). Leader auto-succession on inactivity. Your gang's chat follows them everywhere.

🎰 BUILT-IN SPORTSBOOK

Three sports rotating live. Volume-weighted odds drift. Parlay support. Season leaderboards. Anti-exploit rate limiting. Runs Atlas-only or with an NPC bookie.

🔐 DEVICE-BOUND SECURITY, DONE RIGHT

The PIN locks the phone hardware, not your account. Theft means cracking the PIN. Your contacts, your call log, your number — all tied to the inf_phone item. Lose it, lose them.

📞 PHONE-TO-EAR ANIMATION

When a call connects, your character lifts the phone to their ear with a smooth cross-fade. When the call ends, the phone returns to your hand. No more glued-to-hand calls.

🎵 ATLAS SOUND v2.0 COMING — FREE TO ALL v1 OWNERS

Premium audio brand inside Atlas. Personal library, crew-synced playback, 3D spatial audio. Already built — shipping when the underlying audio service is bulletproof.

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

THE 9 APPS

📱 PHONE

Voice calls via pma-voice. Real-time call states. Phone-to-ear animation. Emergency hangup keybind. Per-device call history.

💬 MESSAGES

SMS threading. Group chats. Read receipts. Delivery confirmations. Server-pushed real-time — no polling, no lag.

💰 BANK

PIN-gated transfers above your threshold. Auto-detects qb-banking, qb-management, okokBanking. Cash-in-hand transfers between players via phone.

🎰 BETZONE

Football, basketball, boxing. Live odds. Parlay support. Anti-exploit rate limiting. Season-based leaderboards. Built-in.

🚗 GARAGE

Vehicle list with location tracking. Pay impound from the phone. Auto-detects qb-garages, qs-advancedgarages, jg-advancedgarages.

📝 NOTES

Personal notes that survive across devices. Account-bound, not device-bound — your notes follow you even if you lose your phone.

👥 CREWS

Native gang framework. Names, tags, 12 colors, treasury, chat, ranks. Independent of qb-gangs.

⚙️ SETTINGS

8+ animated wallpapers. 6 background swatches. 5 ambient glow colors. Configurable PIN security. 3 ringtone packs. Sub-100ms tap feedback (Tick / Soft / Glass).

🎵 ATLAS SOUND

Coming v2.0. Free to all v1 owners.

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

POLISH THAT MATTERS

▸ Synthesized tap feedback — three sub-100ms styles, professionally calibrated to -16dBFS

▸ Three original ringtone families with separate incoming/outgoing variants

▸ Phone-in-hand prop animation with flag-49 upper-body looping — walk while using your phone

▸ Animated wallpapers (embers, rain, diamonds, nebula and more) with density controls

▸ 2-step "armed-confirm" pattern on every destructive action — no native modals, no CEF freezes

▸ Premium audio for every interaction

▸ Cinematic boot animation

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

REQUIREMENTS

▸ QBCore (latest)

▸ ox_lib

▸ oxmysql

▸ qb-target

▸ qb-inventory (or compatible inventory with metadata support)

▸ pma-voice (required for voice calls)

▸ MySQL 5.7+ or MariaDB 10.4+

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

AUTO-DETECTED COMPATIBILITY

BANKING:  qb-banking · qb-management · okokBanking

GARAGE:   qb-garages · qs-advancedgarages · jg-advancedgarages

DISPATCH: ps-dispatch · cd_dispatch · qb-dispatch

No adapter configuration needed. Atlas detects what you've got and routes accordingly.

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

INSTALLATION

1. Drop inf-atlas into your resources/ folder

2. Run db/install.sql in your MySQL client — one file, idempotent, safe to re-run

3. Register the inf_phone item in qb-core/shared/items.lua (snippet in README)

4. Copy the included phone image to your inventory's images folder

5. Add ensure inf-atlas to your server.cfg

6. Restart your server

Atlas is live.

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

WHAT YOU CAN CUSTOMIZE

One file — config.lua — covers everything you'd want to tune:

▸ Keybind and slash command

▸ Phone-in-vehicle, phone-while-driving, slow-walk behavior

▸ Bank PIN threshold

▸ Crew creation fee, member caps, default rank permissions

▸ BetZone sport rotation, betting limits, season type, parlay rules

▸ PIN length, lockout duration, retry limits

▸ Service dispatch options (police, EMS, mechanic, taxi)

Everything else has sensible QBCore defaults. The values marked ⚠️ CHANGE THIS are the few things that need your attention.

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

WHAT'S COMING IN v2.0

ATLAS SOUND. Premium audio brand inside Atlas. Your library, your moment, your crew.

▸ YOUR LIBRARY — Import playlists, play instantly

▸ SHARED LISTENING — Your crew, one frequency. The only phone OS where your gang has its own soundtrack.

▸ 3D SPATIAL AUDIO — Player, vehicle, headphones modes

Free to all v1 owners when it ships. The teaser tile is already live in your phone.

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

SUPPORT

Discord:  discord.gg/bh77yjDegd

YouTube:  @InfamousDevelopment

Store:    infamous.tebex.io

Atlas is built and supported by one developer. Replies are personal. Setup help, bug reports, feature requests — all welcome in Discord.

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

Scripts built different. By one dev. For the streets.

— Infamous Development