# Exports

## **Server Exports** 🖥️

### **➤ AddSimCard**

📌 Adds a new SIM card for a player.

```lua
exports["nrg_simcard"]:AddSimCard(id, register, phoneNumber)
```

* **id** *(number)* – Player ID.
* **register** *(boolean)* – `true` (registered) or `false` (unregistered).
* **phoneNumber** *(number)* – Phone number. if you left the phoneNumber **empty**, the number will be generated automatically

✅ **Example:**

```lua
exports["nrg_simcard"]:AddSimCard(1, true, 5551234)
```

➡️ Adds a **registered** SIM card with **number 5551234** to player **ID 1**.

***

### **➤ GetPlayerSimCards**

📌 Retrieves all SIM cards owned by a player based on their license.

```lua
PlayerSimCards = exports["nrg_simcard"]:GetPlayerSimCards(license)
```

* **license** *(string)* – Player's license.
* **Returns:** *(table)* – List of SIM cards.

✅ **Example:**

```lua
local simCards = exports["nrg_simcard"]:GetPlayerSimCards("license:123456")
print(json.encode(simCards))
```

➡️ Displays all SIM cards owned by the player with **license:123456**.

***

### **➤GetPlayerBySimCardNumber**

📌 Checks which player owns a specific phone number.

```lua
NumberOwnedBy = exports["nrg_simcard"]:GetPlayerBySimCardNumber(phoneNumber)
```

* **phoneNumber** *(number)* – Phone number to check.
* **Returns:** *(string or nil)* – Player's **license** or `nil` if the number is unregistered.

✅ **Example:**

```lua
local ownerLicense = exports["nrg_simcard"]:GetPlayerBySimCardNumber(5551234)
print(ownerLicense or "Number is unregistered.")
```

➡️ Checks who owns **number 5551234**.

***

### **➤ GetAllActiveNumbers**

📌 Retrieves a list of all active phone numbers.

```lua
AllActiveNumbers = exports["nrg_simcard"]:GetAllActiveNumbers()
```

* **Returns:** *(table)* – List of active phone numbers.

✅ **Example:**

```lua
local activeNumbers = exports["nrg_simcard"]:GetAllActiveNumbers()

for _, number in pairs(activeNumbers) do
    print("Active number: " .. number)
end
```

➡️ Displays all active phone numbers.

***

## **Client Exports** 📱

### **➤ GetActiveNumber**

📌 Retrieves the player's currently active phone number.

```lua
ActiveNumber = exports["nrg_simcard"]:GetActiveNumber()
```

* **Returns:** *(number)* – The active phone number or `0` if no SIM card is active.

✅ **Example:**

```lua
activeNumber = exports["nrg_simcard"]:GetActiveNumber()
print(activeNumber ~= 0 and "Your number: " .. activeNumber or "No active SIM card.")
```

➡️ Displays the active phone number or informs the player if no SIM is active.

### **➤** OpenActivePhone

📌 Opens the active phone without having to use it through the inventory

```lua
exports["nrg_simcard"]:OpenActivePhone()
```