Tutorial / Settings
Phone Book
Phone Book settings: the Phone License, voice calls, costs, ring time, groups; admins open every group and call.
What it does
Settings > Phone Book (v3.6.21.2) sets up the Phone Book: every player on the server in one list, private voice calls, texts, buddies, and groups with a group chat and a voice channel. Players open it with P (Settings > Keybinds), !phone, the F3 hub's Phone tab or a phone booth (World > Phone Booth).
Where to find it
Q menu > KGX's Admin Toolbox > Settings > Phone Book. Only superadmins change the settings.
The panel
Checkboxes apply at once. Sliders apply when you click Apply the numbers above.
| Option | What it does | Default | Range |
|---|---|---|---|
| Phone Book on | Off: no phone book, calls or booths. | On | |
| Players need the Phone License for their own phone book | Off: everyone has a phone. Booths never need it. Admins always have a phone. | On | |
| Calls and group channels are voice | Off: texts only. | On | |
| Private calls | Players standing near someone on the phone do not hear what they say into it. | Off | |
| Dead players may use the phone | Off: a call ends when you die. | Off | |
| Jailed players may use the phone | Off | ||
| A call | Paid by the caller when the call is answered. | 0 | 0-100000 |
| Each further minute of a call | Paid by the caller every minute after the first; no money ends the call. | 0 | 0-100000 |
| A text | 0 | 0-100000 | |
| A call from a phone booth | Instead of the call cost. | 0 | 0-100000 |
| Seconds a call rings | Then it is a missed call (a text says so). | 20 | 5-60 |
| Most minutes a call lasts | 0 = no limit. | 0 | 0-240 |
| Who makes groups | 0 nobody, 1 admins, 2 everyone. | 2 | 0-2 |
| Most members in a group | 24 | 2-128 | |
| Most groups one player owns | Admins have no limit. | 3 | 1-20 |
Money comes from the wallet; admins pay nothing. Costs take cents when Settings > Economy > Cents is on.
Open the phone book: Admin tab opens the phone book on its Admin tab: every group (who owns it, members, who is in voice, how many texts) and every call. Right-click a group to remove a member, read its chat or delete it; right-click a call to end it.
The phone book window
| Tab | What it has |
|---|---|
| Players | Everyone online (incognito admins only for admins): job, status, buddy, in a call, no phone. Double-click or Call; Text; Add buddy; right-click for more and Invite to a group. |
| Buddies | Your buddies (online first) and buddy requests to accept or decline. |
| Groups | Groups you may see. Join, leave, group chat, join or leave voice, invite, and for the owner and admins: settings, remove members, delete. |
| Messages | Your conversations (unread counts), New text to... a player or group, and the open conversation. Enter sends. |
| Admin | Admins: every group and call (above). |
The top bar shows your call (Answer, Hang up), group voice (Leave voice) and your status: Available, Buddies only or Do not disturb. Admins always get through.
Group types (who may join and see it): Everyone, Admins only (admins make these), Police only (jobs with the Police ability), Ranks (picked), Jobs (picked), Invite only (members invite players).
Console
kgxat_phone, kgxat_phone_license, kgxat_phone_voice, kgxat_phone_private, kgxat_phone_call_cost, kgxat_phone_call_minute, kgxat_phone_text_cost, kgxat_phone_booth_cost, kgxat_phone_ring, kgxat_phone_call_max, kgxat_phone_groups, kgxat_phone_group_max, kgxat_phone_groups_per_player, kgxat_phone_dead, kgxat_phone_jailed. Saved in data/kgx_admin_toolbox/phone.json (buddies, groups, the last 50 texts of each conversation). Conversations nobody wrote in for 30 days are forgotten, and at most 3000 are kept, so the file stays small.
Tips and limits
- Offline players only get texts from buddies and from players they have texted with before (admins can text anyone).
- After a declined or missed call, the caller waits 15 seconds before ringing that player again (admins do not).
- Calls end when a player dies, is jailed (unless allowed above), loses the Phone License, or walks away from the booth they call from (also while it rings).
- Muted players (Player Manager) are not heard on the phone either.