RP Voice Additions

RP Voice Additions

RP Voice Additions expands Simple Voice Chat with immersive communication systems designed for roleplay servers.

Use configurable speaking ranges, make private phone calls, contact emergency services, communicate over radio channels and optionally build a functional cellular network. All communication is routed through Simple Voice Chat while normal proximity voice remains active.

Features

Configurable speaking ranges

Switch between several server-configurable voice modes:

• Quiet
• Normal
• Shout
• Scream

Simple Voice Chat's native whisper mode remains available and is not replaced.

The active speaking mode and its range can be displayed in the communication HUD.

Mobile phones

Players can use a mobile phone item to communicate over long distances.

Phone features include:

• Direct calls by player name or phone number
• Persistent personal phone numbers
• Contacts
• Incoming and outgoing calls
• Answering, declining and ending calls
• Private receiver mode
• Spatial speaker mode
• Cellular coverage status
• Compact phone HUD
• Dedicated portrait phone interface

During a call, nearby players can still hear the local speaker normally.

In receiver mode, the remote voice is private. When speaker mode is enabled, nearby players can hear the remote caller spatially from the phone owner's position.

Emergency calls

Server owners can configure their own emergency numbers and responder groups.

Emergency calls can be routed to available players belonging to configured scoreboard teams, such as:

• Police
• Fire department
• Emergency medical services
• Dispatch centers

Numbers, display names and responsible teams are configured server-side.

Handheld radios

The radio system provides configurable channels for organizations and civilian communication.

Radio features include:

• Configurable channels
• Push-to-talk transmission
• RX, TX and power status
• Optional channel permissions
• Optional maximum transmission range
• Optional same-dimension requirement
• Local radio volume control
• Dedicated technical radio interface
• Radio status HUD

Restricted channels can use vanilla scoreboard teams, allowing the system to work without another roleplay or permission mod.

Optional cellular infrastructure

Servers can enable a simulated cellular network.

When enabled, phone calls require coverage from a placed cellular tower. Removing towers or leaving their coverage area can interrupt active calls.

The infrastructure simulation can be:

• Fully enabled
• Configured with a custom tower range
• Completely disabled

Configurable device items

The items used as phones and radios are configurable.

Multiple item IDs can be assigned to each device type. Invalid or unavailable item IDs are ignored safely, with a fallback to the built-in RP Voice Additions items.

HUD and controls

A compact HUD can display:

• Current speaking mode and range
• Incoming or active calls
• Caller information
• Speaker status
• Cellular coverage
• Current radio channel
• RX and TX state

All controls are registered in Minecraft's key binding settings.

Default controls include:

• Grave accent: cycle speaking range
• P: open phone
• R: open radio
• Left Alt: radio push-to-talk

Additional call and speaking-mode controls can be assigned by the player.

Optional TerraNexus integration

TerraNexus support is completely optional.

When TerraNexus is installed and compatibility is enabled, RP Voice Additions can:

• Expose TerraNexus functions through the phone
• Use TerraNexus institution memberships for radio permissions
• Map institutions to configurable radio channels

When TerraNexus is absent or incompatible, the integration is disabled automatically. Phone calls, radios, emergency numbers and scoreboard-based permissions continue to work normally.

There is no required TerraNexus dependency.

Requirements

RP Voice Additions requires:

• Minecraft 1.21.8
• Fabric Loader
• Fabric API
• Simple Voice Chat
• Java 21

The mod must be installed on both the server and participating clients.

Simple Voice Chat must also be installed and configured correctly on both sides.

Configuration

Configuration files are generated in:

config/rp-voice-additions/

Available configuration areas include:

• Speaking modes and ranges
• Phone behavior
• Emergency numbers
• Radio channels and permissions
• Cellular infrastructure
• Phone and radio item assignments
• HUD visibility and position
• Client-side radio volume
• Optional TerraNexus compatibility
• Institution-to-radio-channel mappings

Most communication decisions are validated by the server. Clients cannot choose arbitrary recipients, permissions, ranges or cellular coverage.

Basic usage

Right-click with a configured phone or radio item to open its interface.

The systems can also be controlled through key bindings and commands:

• /rpvoice
• /phone
• /radio
• /celltower

Administrative reload and tower-management commands require the appropriate operator permission level.

Deutsch

RP Voice Additions erweitert Simple Voice Chat um immersive Kommunikationssysteme für Roleplay-Server.

Die Mod ergänzt konfigurierbare Sprechreichweiten, Mobiltelefone, Notrufe, Funkkanäle und ein optionales Mobilfunknetz. Die normale räumliche Kommunikation bleibt während Telefonaten und Funkübertragungen weiterhin aktiv.

Funktionen

Konfigurierbare Sprechreichweiten

Spieler können zwischen mehreren serverseitig konfigurierbaren Sprachmodi wechseln:

• Leise
• Normal
• Rufen
• Schreien

Das native Flüstern von Simple Voice Chat bleibt unverändert erhalten.

Mobiltelefone

Das Telefonsystem bietet:

• direkte Anrufe über Spielername oder Rufnummer
• persistente persönliche Rufnummern
• Kontakte
• eingehende und ausgehende Anrufe
• Annehmen, Ablehnen und Auflegen
• privaten Hörermodus
• räumlichen Lautsprechermodus
• Anzeige der Mobilfunkabdeckung
• eigenes Telefon-HUD
• hochkantige Handyoberfläche

Im Hörermodus hört nur der Telefonbesitzer die Gegenstelle. Im Lautsprechermodus wird die entfernte Stimme räumlich für umstehende Spieler wiedergegeben.

Die normale Stimme des lokalen Spielers bleibt für Personen in seiner Nähe hörbar.

Notrufsystem

Serverbetreiber können eigene Notrufnummern, Anzeigenamen und zuständige Scoreboard-Teams konfigurieren.

Damit lassen sich beispielsweise Polizei, Feuerwehr, Rettungsdienst oder Leitstellen abbilden.

Funkgeräte

Das Funksystem unterstützt:

• konfigurierbare Funkkanäle
• Push-to-Talk
• RX-, TX- und Ausschaltzustand
• geschützte Organisationskanäle
• optionale Reichweitenbegrenzung
• optionale Dimensionsbegrenzung
• lokale Funklautstärke
• eigene technische Funkgeräteoberfläche
• Funkstatus im HUD

Geschützte Kanäle können über Vanilla-Scoreboard-Teams verwaltet werden. Eine zusätzliche Permission- oder Roleplay-Mod ist nicht erforderlich.

Optionales Mobilfunknetz

Auf Wunsch funktionieren Telefone nur innerhalb der Reichweite platzierter Mobilfunkmasten.

Reichweite und Aktivierung der Infrastruktur werden serverseitig konfiguriert. Beim Verlust der Netzabdeckung kann ein aktives Gespräch getrennt werden.

Die Netzsimulation kann vollständig deaktiviert werden.

Konfigurierbare Geräteitems

Serverbetreiber können festlegen, welche Item-IDs als Handy oder Funkgerät verwendet werden.

Mehrere Items pro Gerätetyp werden unterstützt. Ungültige oder nicht installierte Items werden sicher ignoriert. Sind keine gültigen Einträge vorhanden, verwendet die Mod ihre Standarditems.

HUD und Keybinds

Das konfigurierbare HUD zeigt unter anderem:

• aktuellen Sprachmodus und Reichweite
• eingehende und aktive Anrufe
• Gesprächspartner
• Lautsprecherstatus
• Netzabdeckung
• Funkkanal
• RX- und TX-Zustand

Alle Steuerungen erscheinen in den Minecraft-Tasteneinstellungen.

Standardbelegung:

• Akzenttaste: Sprachmodus wechseln
• P: Handy öffnen
• R: Funkgerät öffnen
• Linkes Alt: Funk-Push-to-Talk

Weitere Tasten für Telefonfunktionen und direkte Sprachmodi können frei belegt werden.

Optionale TerraNexus-Kompatibilität

Die TerraNexus-Integration ist vollständig optional.

Wenn TerraNexus installiert und die Kompatibilität aktiviert ist, können TerraNexus-Funktionen in das Handy eingebunden und Institutionsmitgliedschaften automatisch Funkkanälen zugeordnet werden.

Ohne TerraNexus werden keine entsprechenden Verknüpfungen angezeigt. Telefon, Funk, Notruf und Scoreboard-Berechtigungen funktionieren weiterhin eigenständig.

Voraussetzungen

• Minecraft 1.21.8
• Fabric Loader
• Fabric API
• Simple Voice Chat
• Java 21

Die Mod muss auf dem Server und auf den teilnehmenden Clients installiert sein.

Konfiguration

Die Konfigurationsdateien werden unter folgendem Pfad angelegt:

config/rp-voice-additions/

Dort können Sprachreichweiten, Telefonverhalten, Notrufnummern, Funkkanäle, Geräteitems, Mobilfunkmasten, HUD-Einstellungen und optionale Integrationen angepasst werden.

Alle sicherheitsrelevanten Entscheidungen wie Empfänger, Kanalrechte, Reichweiten und Netzabdeckung werden serverseitig geprüft.