calls

Last updated on

A player presses H to open a centred hologram with their contacts and recent calls, and calls someone from it. The callee hears the game's incoming-call sound and the hologram pops up; they answer with Y or refuse with X (X also hangs up a live call or withdraws a call you placed). During a call both players' eyes carry the game's blue holocall glow and they share a voice channel. A third player can be added. Contacts are swapped face to face through a row on the target eye; only contacts appear in the hologram. The server owns every call; the client only asks.

• Contacts only. A call or a join needs the target's citizen id in the caller's contacts; anyone else is refused notContact, checked before anything about the target, so the refusal says nothing about who that id is or what they are doing. Strangers swap contacts face to face first.
• Offering your contact to the same player again is refused for 30 s (contactTooSoon); the floor is cleared when either player leaves.
• Reach first for a contact offer. Out of CONTACT_RANGE the only answer is tooFar, before anything is said about the target (down, loading, on a call), so an offer cannot probe a stranger from across the map.
• Contacts can be deleted. Each contact row in the hologram has DELETE, which takes two presses (SURE?); Contact deleted. The row names a reference the server made for that list (k1, k2…), never a citizen id.
• A full list is refused, not trimmed. At MAX_CONTACTS, sending a contact offer or accepting one is refused with contactsFull (Your contact list is full. Delete a contact to make room.). The offer stays open, so the player can delete a contact and then accept.
• Offline contacts are listed greyed as offline, with no server id to call.
• One player is in at most one call, with at most one invite out and one waiting.
• An invite has a kind, decided by the server: call (start a call), join (the sender is in a call; accepting adds you) or contact (swap contact rows; no call).
• invite, accept, decline and hangup are each limited to one per REQUEST_MS per player; a refusal is shown as a toast.
• A call is dropped when a participant disconnects, leaves the world or is no longer alive (checked every SCAN_MS and on life-state changes). When one of three leaves, the other two are told who hung up. A failed host read no longer ends live calls.
• Names only for contacts. Every card, toast ("X joined / hung up / declined / did not answer") and recent-call row names a person only to a viewer who has them in their contacts; anyone else reads Unknown caller. A contact offer names its sender, never the person it was offered to. See Privacy.
• A contact offer tells its sender offered, declined or not answered, without the other person's name; the panel says Offering your contact....
• No toast repeats the hologram: X is calling you. and Calling X... are gone. The outcomes (answered, declined, no answer) are still toasts.
• An invite that rings out, or is answered just as it dies, updates the caller's screen and files a missed call on both sides. A disconnect while ringing: the callee gets a missed call, the caller reads "The call could not go through" and an unanswered row.
• Going down closes the hologram.
• Hanging up (and stopping the module) puts the voice route back to proximity.
• Audit entries: calls.invite, calls.accept, calls.decline, calls.cancel, calls.hangUp, calls.contact, calls.forget, calls.unanswered, calls.eyes, calls.voice.
• No commands.

Key bindings

Y and X are shared, and a press goes to one owner (key contest, ranks in KEY_PRIORITY):

• X: a cancelable progress bar > a ringing call (decline) > your outgoing call (withdraw) > a carried crate > your emote > a call in progress (hang up). Cancelling an eat during a call no longer hangs up.
• Y: while a call rings, Y answers and the hotbar peek stays silent; otherwise Y peeks.
• H, Y and X do nothing while chat or a form holds the keyboard. Escape closes the hologram only when it is the top layer.

Configuration

config/calls.lua sets OPX.Config.MODULES.calls. Shared script. Numbers are clamped to the ranges shown.

Refusal codes

Shown to the player as calls.error.<code>.