Raft Receiver

Raft Receiver brings the iconic Receiver navigation setup from Raft into Minecraft Java 1.20.1.

Build a Receiver table, place three Antennas around it, enter a valid 6-digit destination code, and use the radar screen to navigate toward configured locations. When the setup is valid, the Receiver shows the target direction and distance directly on its in-world monitor.

The mod is designed to fit naturally into a Raft-inspired ocean survival experience, especially when used together with mods such as Raft Hook, Raft Flotsam, Raft Shark, boats, ships, ocean exploration mods, or custom world generation.

Features

• Adds a detailed Receiver block inspired by Raft.
• Adds tall Antenna multiblocks required for navigation.
• Receiver is placed as a 2-wide, 1-deep, 2-tall table.
• Requires three correctly placed Antennas to activate destination tracking.
• Enter 6-digit codes through the Receiver screen.
• Valid codes reveal configured coordinates.
• The Receiver remembers the last typed code and shows it on the in-world display.
• The left monitor renders a radar with:
  • A blue target marker for the active destination.
  • A distance readout.
  • Optional green nearby destination markers.
  • Compact distance labels for nearby signals.
• Green radar markers represent other configured locations detected nearby.
• Nearby locations are detected within a configurable radius, 2500 blocks by default.
• Radar direction is relative to the Receiver’s facing direction.
• Antenna lights turn green when correctly connected and red when invalid.
• Supports multiplayer-safe server-side code validation.
• Includes translated strings into all languages supported by Minecraft.
• Fully configurable through config/raft_receiver.toml.
• Includes commands to reload, add, overwrite, and delete destination codes.

How it works

1. Place the Receiver.
2. Place three Antennas around it.
3. Make sure the Antennas are within the allowed distance range.
   • By default, they must be at least 3 blocks away from the Receiver.
   • By default, they must be at most 15 blocks away from the Receiver.
   • These values can be changed in the config file.
4. Each valid Antenna lights up one marker under the Receiver table.
5. When all three markers are green, the Receiver is ready to use.
6. Green radar markers represent other configured locations detected nearby.
7. Right-click the Receiver and enter a 6-digit code.
8. If the code exists in the server config, the Receiver activates that destination.
9. Follow the blue marker on the radar to navigate toward the target.

If the code is wrong, malformed, or the Antenna setup is invalid, the Receiver will not reveal the destination.

Commands

Reload the config:

/raftreceiver reload

Add or overwrite a code:

/raftreceiver code add <code> <x> <y> <z> [dimension] [label]

Delete a code:

/raftreceiver code delete <code>

Configuration

The config file is generated at:

config/raft_receiver.toml

You can configure:

• Valid destination codes.
• Target coordinates and dimensions.
• Destination labels.
• Antenna distance rules.
• Antenna scan interval.
• Whether distance uses 3D distance or horizontal X/Z distance.
• Nearby signal detection.
• Nearby signal detection radius.

A default sample destination is included in the generated config.

Requirements

• Minecraft Java 1.20.1
• Java 17
• Architectury API 9.2.14 or newer for 1.20.1

Optional Valkyrien Skies support

If you want the Receiver radar to work correctly while placed on a Valkyrien Skies ship, install the optional compatibility add-on:

• Raft Receiver - Valkyrien Skies Compatibility

That add-on makes the Receiver use the real moving and rotating position of the ship when calculating radar direction and distance.

🧪 Testing Status

This mod requires further testing before it can be considered fully stable for all environments.

Feedback from server testing is highly appreciated.

🇪🇸 ESPAÑOL

Raft Receiver

Raft Receiver trae a Minecraft Java 1.20.1 el icónico sistema de navegación con Receptor de Raft.

Construye una mesa de Receptor, coloca tres Antenas a su alrededor, introduce un código de destino válido de 6 dígitos y usa la pantalla de radar para navegar hacia ubicaciones configuradas. Cuando la instalación es válida, el Receptor muestra la dirección del objetivo y la distancia directamente en su monitor dentro del mundo.

El mod está pensado para encajar de forma natural en una experiencia de supervivencia oceánica inspirada en Raft, especialmente si se usa junto a mods como Raft Hook, Raft Flotsam, Raft Shark, barcos, naves, mods de exploración oceánica o generación de mundo personalizada.

Características

• Añade un bloque de Receptor detallado inspirado en Raft.
• Añade Antenas multibloque necesarias para la navegación.
• El Receptor se coloca como una mesa de 2 bloques de ancho, 1 de fondo y 2 de alto.
• Requiere tres Antenas correctamente colocadas para activar el seguimiento de destinos.
• Permite introducir códigos de 6 dígitos desde la pantalla del Receptor.
• Los códigos válidos revelan coordenadas configuradas.
• El Receptor recuerda el último código escrito y lo muestra en la pantalla del modelo.
• El monitor izquierdo muestra un radar con:
  • Un marcador azul para el destino activo.
  • Lectura de distancia.
  • Marcadores verdes opcionales para destinos cercanos.
  • Etiquetas compactas de distancia para señales cercanas.
• Los marcadores verdes del radar representan otras localizaciones configuradas detectadas cerca.
• Las localizaciones cercanas se detectan dentro de un radio configurable, 2500 bloques por defecto.
• La dirección del radar es relativa a la orientación del Receptor.
• Las luces de las Antenas se ponen verdes cuando están conectadas correctamente y rojas cuando no son válidas.
• Validación segura en servidor para multijugador.
• Incluye textos traducidos en todos los idiomas soportados por Minecraft.
• Totalmente configurable mediante config/raft_receiver.toml.
• Incluye comandos para recargar, añadir, sobrescribir y eliminar códigos de destino.

Cómo funciona

1. Coloca el Receptor.
2. Coloca tres Antenas a su alrededor.
3. Asegúrate de que las Antenas están dentro del rango de distancia permitido.
   • Por defecto, deben estar al menos a 3 bloques del Receptor.
   • Por defecto, deben estar como máximo a 15 bloques del Receptor.
   • Estos valores se pueden cambiar en el archivo de configuración.
4. Cada Antena válida ilumina un marcador debajo de la mesa del Receptor.
5. Cuando los tres marcadores están en verde, el Receptor está listo para usarse.
6. Los marcadores verdes del radar representan otras localizaciones configuradas detectadas cerca.
7. Haz clic derecho en el Receptor e introduce un código de 6 dígitos.
8. Si el código existe en la configuración del servidor, el Receptor activa ese destino.
9. Sigue el marcador azul del radar para navegar hacia el objetivo.

Si el código es incorrecto, no tiene el formato adecuado o la instalación de Antenas no es válida, el Receptor no revelará el destino.

Comandos

Recargar la configuración:

/raftreceiver reload

Añadir o sobrescribir un código:

/raftreceiver code add <code> <x> <y> <z> [dimension] [label]

Eliminar un código:

/raftreceiver code delete <code>

Configuración

El archivo de configuración se genera en:

config/raft_receiver.toml

Puedes configurar:

• Códigos de destino válidos.
• Coordenadas y dimensiones de destino.
• Etiquetas de destino.
• Reglas de distancia de las Antenas.
• Intervalo de escaneo de las Antenas.
• Si la distancia usa cálculo 3D o solo horizontal X/Z.
• Detección de señales cercanas.
• Radio de detección de señales cercanas.

La configuración generada incluye un destino de ejemplo.

Requisitos

• Minecraft Java 1.20.1
• Java 17
• Architectury API 9.2.14 o superior para 1.20.1

Compatibilidad opcional con Valkyrien Skies

Si quieres que el radar del Receptor funcione correctamente cuando está colocado sobre un barco de Valkyrien Skies, instala el add-on opcional:

• Raft Receiver - Valkyrien Skies Compatibility

Ese add-on permite que el Receptor use la posición real del barco en movimiento y rotación al calcular la dirección y distancia del radar.

🧪 Estado de las Pruebas

Este mod requiere más pruebas antes de poder considerarse completamente estable para todos los entornos.

Se agradece enormemente el feedback de pruebas en servidores.