# 📱 NexusPhone — The Ultimate Roleplay Smartphone Mod
**NexusPhone** is a highly advanced, premium, and feature-rich smartphone mod built from the ground up for **NeoForge 1.21.1**. Heavily inspired by modern iOS designs, it ditches clunky, traditional menus for a fluid, full-screen, responsive mobile interface that does **NOT** pause your game.

Every single byte of data—from contacts, dynamic gallery photos, messages, to bank accounts—is bound directly to the item's NBT data. If you lose your physical phone or pass it to another player, they get your phone data, making it the perfect asset for immersive Economy and Hardcore Roleplay servers!

---

## 🚀 Core Features & Built-In Apps

### 🔒 Phone Security & Hardware Mechanics
* **Drop Protection:** Never accidentally lose your premium device; dropping the phone requires a deliberate double-tap confirmation.
* **Passcode & Face ID:** Secure your phone with a 4-to-6-digit PIN. If you are the true owner of the device, the phone utilizes an advanced automatic **Face ID scanning animation** to unlock instantly.
* **Anti-Brute-Force:** Protect your device against thieves! 3 failed login attempts lock the phone screen with an exponential cooldown timer.

### 📞 Advanced Cellular & Messaging Overhaul
* **Realistic Dynamic Numbers:** No more messy strings—all phones are assigned clean, realistic Austrian-style phone numbers (e.g., `+43 664 XXX XXXX`).
* **iOS Calling Overlay & Group Calls:** Features a global, non-intrusive calling bar with clean Accept/Decline overlays that persist across other apps. Supports **Multi-Party Group Calls** by seamlessly bridging server-side voice channels via the *Simple Voice Chat API*, bypassing standard proximity volume caps during active calls.
* **Spam & Block Protection:** Easily toggle an active block list on contacts to instantly deny unwanted calls and incoming texts.
* **Messenger with Live Media Previews:** Chat with friends or quick-select contacts. Sent photos render as scaling visual chat bubble thumbnails directly inside the chat window.

### 📸 Next-Gen Camera & Gallery App
* **Cinematic F1 Viewport:** Opening the camera app completely hides the Minecraft HUD (hotbar, chat, scoreboards) while maintaining full character walking/running movement.
* **Clean Texture Capturing:** The shutter isolates the viewport frame perfectly—saving clean photos to your local disk without baking the phone buttons or UI overlays into the picture.
* **Targeted AirDrop:** Share contact cards or photos from your Gallery app wirelessly. Recipients receive an interactive prompt to Accept or Decline, and data is transferred securely via a chunk-reassembly network pipeline to avoid file fragmentation.

### 🏦 Advanced Apple Wallet & Banking (*Create: Numismatics Required*)
* **Physical Card Wallet (Shift+Right-Click):** Access a hidden 10-slot internal cardholder inside your physical phone item. Drop your actual *Create: Numismatics* bank cards right into the phone.
* **Live Multi-Account Balance:** The Bank App dynamically reads the specific cards in your wallet, displaying their exact names (e.g., Gold Card, Business Account) and tracking balances with server-side auto-refreshing network packets.
* **Target-Safe Transfers:** Wire specific quantities of **Cogs** or **Spurs** seamlessly. Inputting a recipient's phone number auto-scans their wallet, letting you select exactly which account/card of theirs you want to fund. Supports setting up automated **Standing Orders (Daueraufträge)** based on Minecraft day-cycles.

---

## 🏛️ Government & Coded Corporate Apps (Private)
Unlock premium, hidden server-side applications by inputting long, unbruteforcable secure cryptographic codes inside the App Store:

* **👮 Police Department App:** Scan nearby player ID cards instantly to review licenses or active warrants. Issue automated citations with a "Violation Reason" field that instantly debits Cogs or Spurs directly from the perpetrator's personal bank account. Includes a master server toggle for "Wanted" status.
* **🆔 Immutable ID Cards ("Personalausweis"):** Upon first activation, permanently lock in your character’s immutable identity details. Tracks state-issued licenses, including specialized permits for Vehicles (Car, Truck, Aircraft) and Weapons.
* **🏗️ Construction Office & Approvals ("Bauamt"):** File geometric building requests that auto-capture your live XYZ coordinates, prompting fields for project descriptions and estimated completion time frames. Government officials gain access to an exclusive approval dashboard to globally [Approve] or [Reject] real-time builds.
* **🛠️ Admin Master Dashboard:** Allows server administrators to alter character identities, retrieve lost passwords, or manually grant or revoke custom license flags on the fly.

---

## 📦 Dependencies & Setup
To unlock the full potential of NexusPhone's economy and communication hooks, the following mods are highly recommended on your server:
* **NeoForge 1.21.1** (Targeting version `21.1.228+`)
* **Simple Voice Chat** (For cellular calling systems)
* **Create: Numismatics** (For the physical card wallet and bank account economy)

*Ringtones can be fully customized by players by dropping a `ringtone.mp3` file directly into their client-side phone config directories!*