What's new

Phone System

Status
Not open for further replies.

Thekillergreece

Donator
Joined
Jan 28, 2017
Messages
4,840
Location
idek, prolly in Greece

logo.png
Mu9GV4F.png

FEATURE DOCUMENTATION
Phone System


Development OverviewFeature Name: Phone System
Script Author(s): Alec, TommyB
Documentation By: Thekillergreece
Special Thanks: N/A
Feature Version: Multiple versions


IntroductionThe Phone System has been written several times during the development with numerous additions, changes and so on. Players with a phone in their disposal are able to call other players, send a sms message, a group sms message, save contacts, use the GPS and many more! Thanks to this system, players are able to communicate with each other even if one is at the other side of the County.


Using the phoneIn order to use the phone, make sure it's powered on by typing the command /phoneon (/pon). To turn it off, simply type /phoneoff (/poff).

To access the phone menu, you can do so by typing the command /phone. A menu will show up with various choices such as; Manage Contacts, View SMS History, GPS Navigation, Group Chats, Turn On / Off, Set Lock Code, Phone Details. Your phone number will also be displayed.
zKUjDzR.png


Choosing "Manage Contacts" will open a new window. There you can:
- Create New Contact
This will allow you to create new contact by inputting Name following by a "|" and phone number and then save it. For example: John|1234567890
- View All Contacts
This will allow you to view all contacts you created and saved.
- Delete A Contact
This will allow you to delete a contact. This is not a reversible action.
- Edit A Contact
Allows you to edit a contact's name only. It does not edit the phone number of the contact.


Choosing "View SMS History" will open a new window of which it will list all PERSONAL SMS history, messages that you received and sent.


Choosing "GPS Navigation" will list a wide array of choices such as:
- Set Destination
This option brings up a list of important areas including jobs, banks and etc. Selecting a location on this list will route the player straight to the selected location. This list is designed to be handy to new players.
- Navigate to Location
This option can be used to navigate to any house, business or building (townhalls, banks) based on user defined search terms. Simply enter part of a location's name and any property with a similar or matching name will be sent to you. The results can then be navigated to from the dialog.
- View Opened Businesses
If a business is open, it will be listed there for you to navigate.
- View Points of Interest
This option can be seen as a slight extension to the Set Destination option. It contains a list of every static interior on the server that is marked to show up on the GPS. This includes locations such as the Hopi Cave, for example.
- Saved Locations
If you saved a location before, you can choose it to navigate.
- Navigate to Checkpoint
This option is useful for jobs which add checkpoints to the player's minimap. When a valid checkpoint is set, this option can be used to efficiently route you to your checkpoint's location.

Alternatively, you can directly use the GPS by using the commands; /gps (this will list the same menu form from "GPS Navigation") and /navto *TEXT* (this will allow you to navigate to a location you desire, provided you type down the address, etc, similarly to "Navigate to Location").
Once you choose a location to navigate, a checkpoint will be placed on your minimap. It will be shown as red circle on-screen within distance. You can cancel it by choosing "End GPS Routing" of which it will kill the checkpoint.


Choosing "Group Chats" will allow you to create a Group SMS Chat and manage one or more. Scroll down to "Personal SMS / Group SMS" for a detailed guide.


Choosing "Turn On / Off" is self-explanatory, this will switch your phone on or off.


Choosing "Set Lock Code" will allow you to put a PIN code to your phone. Players who do not know your phone PIN code will not be able to use your phone at all. Your phone cannot be used in any way until you unlock it. Once it's locked, type /lockphone and input your PIN code to unlock it.
NOTE: If you forget your lock code, your phone will never be used anymore as admins cannot recover the lost code of your phone. Treat lock codes with caution.


Choosing "Phone Details" will list you your phone information such as the owner of the phone, phone number, battery life and so on.



Calling / Handling calls
There are two ways to call a player; through your /phone or directly by /call *NUMBER / CONTACT NAME*.
To do the first method, you have to type the command /phone then choose "Manage Contacts" and then "View All Contacts". You can then choose the contact you wish to call by choosing the "CALL *NUMBER*" option. This will prompt your character to call the player, if they are online and/or their phone is powered on.

To do the second method, you simply have to type /call and type the phone number and/or the contact's name.
For example;
If the player's phone number is 12345, simply /call 12345.
If the contact's name is John, simply /call John.

Calling a player is FREE, it does not consume your phone credits.
Your character will enter calling animation. You can clear it by typing /clear. Your phone's model will be visible as well.

To hang up, you can simply type /h or /hangup.

If you are getting called by a player, you can either accept the call by typing /p or hang it up by typing /h.
To talk quietly, use the command of /lp. To put your phone on loudspeaker for nearby players to listen, use the command of /loudspeaker.
You will be notified which phone number is calling you or contact name.

By simply typing /call will show you a list of choices;
911 - Emergency services (Police, EMS, Fire)
726 - News
444 - Taxi services
927 - Elite Trucking
118 - Mechanic services



Personal SMS / Group SMS
PERSONAL SMS

It functions in similar manner to calling a player. You can utilize the sms system either through the /phone command (and choose contacts, SMS, etc) or just directly type the command /sms *PHONE NUMBER / CONTACT* *TEXT*.

For the second method;
If the player's phone number is 12345, simply /sms 12345 *TEXT*.
If the contact's name is John, simply /sms John *TEXT*.

If someone has texted you, you can easily type the command of /smsback (/textback) *TEXT* to quickly text back without having to type the contact's name and/or phone number.

Personal SMS will cost some of your phone credits.

GROUP SMS

Setting up a group chat is different from simply creating a contact but once you set a group up, it can function in similar manner of personal sms except everyone in the group will receive the message at the same time. Treat it as IRL Messenger!

Choosing "Group Chats" will open a new window form where you can create a group chat by choosing "Create Group Chat". You can create as many groups as you want! Once you have created group chats, the form should look like that.
3ryF0SJ.png


Clicking either of the group chat, in this case, Pineapple and Carrot, will show you a new form with wide array of choices.
vN30Hcr.png


- Change Active Status
This sets your group chat active or inactive. If you set it as active, you will be able to chat through the group chat by using the command /gtxt. If inactive, you can't.
- View Message History
This allows you to see the Message History of the group chat.
- View Members
Lists your group chat's members. Depending the circumstance, they may be displayed in names (if they are saved in your contract) or in numbers (if not saved and/or are strangers). As owner, your membership's name will always be in your phone number.
- Leave Group Chat
Leaving the group chat will wipe the group from existence. All its history, membership will be removed. This action is not reversible.
- Add Phone Number
This allows you to add members to your group chat by typing their phone numbers.
- Remove Phone Number
Removes the phone number from your group chat thus removing their membership. You cannot remove yourself!

To send a SMS to your group chat, make sure you have set that group chat as active by choosing the "Change Active Status". Once you have done that, you can freely text through that group chat by the command /gtxt *TEXT*.

For example, you have set Pineapple / Carrot as ACTIVE group chat. You can then text;
/gtxt Hi.
This will send a message to every member of the group chat even though they may have set the group chat as Inactive. They will still read the messages but they won't be able to reply until they set the group chat where you sent the message to to Active.

The Group Chat SMS notification should look like this:
kVkP9f2.png


If you save the phone numbers into your contact and rename them, they will not be displayed as phone numbers but contact's name.

Group Chat SMS will cost some of your phone credits. The Group Chat SMS will not work if none of the members in your group chat is online.


Other
All mobile phones can be purchased through Electronic Shops only. They will always cost $300.
Purchasing phone credits will give your phone the ability to send messages. Without credits, you can only call. They cost at variable prices, depending how many credits you want.
e.g $300 for 300 phone credits.

All phones can be recharged at either houses or in Electronic Shops. You can recharge phones in vehicles but you need the Phone Car Charger Adapter which costs $395.

Initially, your phone's model will be GTA SA default ones. You can change it by using the command of /phonetype *NUMBER* (from /phonetypes). Use the /phonetypes so you can see which mobile phone colour you can use and replace your current phone's model.


Related Commands
  • /call (/dial) - By typing only the command will list you useful phone numbers for you to dial. By typing it with contact's name and/or random phone number will prompt your character to call them, if they are available.
  • /callback - If someone called you recently, you can type the command to directly call them back without typing their phone number and/or contact's name.
  • /contacts - This will directly show you your phone's contacts.
  • /getnumber (/getnum /number /phonebook) - This will help you locate someone's name through phone number, provided they have put their number on phonebook.
  • /gsms (gtxt) - Group Chat SMS.
  • /hangup (/h) - Hangs up your phone, ceasing any contact.
  • /lockphone - Locks your phone with a code PIN.
  • /loudspeaker - Puts your phone on loudspeaker, allowing nearby players to listen.
  • /lp - Allows your character to talk quietly, minimizing the chat range to nearby players.
  • /phone - Shows your phone main menu or closes it.
  • /phoneinfo (/pinfo) - Shows your phone's details.
  • /phoneoff (/poff) - Switches your phone off.
  • /phoneon (/pon) - Switches your phone on.
  • /phoneshow - Whether you should let your phone number to be shown on phonebook or not.
  • /phonetype - Allows you to change your phone's type.
  • /phonetypes - Lists you a number of phone's type colour choices.
  • /pickup (/p) - Accepts an incoming call.
  • /recharge - Recharges your phone to full battery.
  • /text (/sms) - Sends a SMS message to a phone number or phone's contact name.
  • /textback (/smsback) - Quickly sends a SMS message back to whoever send you a SMS recently.

 
Status
Not open for further replies.
Top