# Server Event

### Adding stock market coins

source : Player ID\
coinid : In gksphone\config.lua there is a coinid in "Config.Crytos".\
amount : Coin amount

```lua
local cryptoadd = exports["gksphone"]:cryptoadd(source, coinid, amount)
print(cryptoadd) => as true or false
```

### Remove coins from stock market

source : Player ID\
coinid : In gksphone\config.lua there is a coinid in "Config.Crytos".\
amount : Coin amount

```lua
local cryptoremove = exports["gksphone"]:cryptoremove(source, coinid, amount)
print(cryptoremove) => as true or false
```

### Find player id from phone number <a href="#find-player-id-from-phone-number" id="find-player-id-from-phone-number"></a>

```lua
local FindSource = exports["gksphone"]:GetSourceByPhone("PhoneNumber")
print(FindSource)
```

### Find phone number with source

```lua
-- src => Player's ID
local src = source
local FindPhoneNumber = exports["gksphone"]:GetPhoneBySource(src)
print(FindPhoneNumber)
```

### How to use phone notification?

title : Notification title\
message : Notification message\
img : You can use icons from the phone or use .png or .jpg in a photo\
duration : To set how long the notification stays (You must type the millisecond value) - default duration 5000

```lua
-- src => Player's ID
local src = source
local NotifData = {
    title = "Notification header", 
    message = "Notification Message", 
    img    = '/html/static/img/icons/messages.png', 
    duration = 5000
}
exports["gksphone"]:SendNotification(src, NotifData)
```

#### **If you want a button with notification**

buttonactive : Set to true to enable button\
button : buttonEvent : Which client will be triggered\
button : buttonData : data to add to button

```lua
-- src => Player's ID
local src = source
local NotifData = {
    title = "Notification header", 
    message = "Notification Message", 
    img= '/html/static/img/icons/messages.png', 
    duration = 5000,
    buttonactive = true, 
    button = {
        buttonEvent = "clientevent", 
        buttonData = "Test"
    }
}
exports["gksphone"]:SendNotification(src, NotifData)
```

### Send Mail

```lua
-- src => Player's ID
local src = source
local MailData = {
  sender = 'GKSHOP',
  image = '/html/static/img/icons/mail.png',
  subject = "GKSPHONE",
  message = 'TEST'
}
exports["gksphone"]:SendNewMail(src, MailData)
```

### Send Offline Mail

```lua
-- PlayerId => ESX Identifier
local PlayerId = source
local MailData = {
  sender = 'GKSHOP',
  image = '/html/static/img/icons/mail.png',
  subject = "GKSPHONE",
  message = 'TEST'
}
exports["gksphone"]:SendNewMailOffline(PlayerId, MailData)
```

### Specific Number

This function is an event that works for the phone numbers you specify "Config.SpecificNumber" in config.lua.

```lua
RegisterNetEvent('gksphone:server:specificNumber', function(source, phoneNumber)
    ---- You can add the function you want to do to this part
end)
```

### New Billing

```lua
-- src => Player's ID
-- label => Billing description
-- society => By which job the billingwas created
-- senderBilling => Who is the person sending the billing?
-- senderID => ESX Identifier of the billing originator
-- amount => Billing price
local src = source
local label = "Excessive Speed"
local society = "police"
local senderBilling = "GKSHOP XENKNIGHT"  -- Player Name
local senderID = "char1:4b110a7811" -- xPlayer.identifier
local amount = 500
exports["gksphone"]:NewBilling(src, label, society, senderBilling, senderID, amount)
```

### Changing Phone Number

Changing the player's phone number

```lua
-- src => Player's ID
-- newNumber => new phone number (phone number must be string)
local src = source
local newNumber = "5555555"
exports["gksphone"]:NumberChange(src, newNumber)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gkshop.org/gksphone-v1/esx/developers/server-event.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.