Raft Flotsam - Ocean Salvage

Bring Raft-inspired ocean flotsam to Minecraft! Collect floating debris, barrels and crates while sailing, swimming or exploring the open sea.

Raft Flotsam – Ocean Salvage

Bring Raft-inspired ocean salvage to Minecraft!

Collect floating debris, barrels and crates while sailing, swimming or exploring the open sea.

Raft Flotsam recreates the iconic flotsam system from Raft and brings it to Minecraft. Travel across the ocean and discover floating resources, collectible barrels and rare crates full of valuable loot.

Designed for both singleplayer and multiplayer, with support for Fabric, Forge and optional Valkyrien Skies (Forge/Fabric) integration.


Features

  • 🌊 Raft-inspired floating debris system
  • 🪵 Floating logs, sticks, stone and dirt
  • 🛢 Floating barrels with Raft-inspired loot
  • 📦 Floating crates with rare rewards
  • ⛵ Supports swimming, vanilla boats and Valkyrien Skies rafts/ships (with add-on)
  • 🚢 Optional Valkyrien Skies support
  • 👥 Multiplayer-friendly shared spawn lanes
  • âš¡ Automatic cleanup and entity cap systems
  • âš™ Fully configurable through JSON
  • 📋 Data-driven loot tables for modpacks

How It Works

As you travel through the ocean, the mod generates a dynamic flotsam lane ahead of your movement direction.

By default, flotsam only appears in ocean biomes and can contain:

  • Oak Logs
  • Sticks
  • Stone
  • Dirt
  • Barrels
  • Crates

The system tracks real movement direction and includes direction locking to prevent abuse from rapid spinning or zig-zagging.

Nearby players share a single flotsam lane to prevent duplicated loot generation.


Collection

Flotsam can be collected by:

  • Touching it directly
  • Driving through it with a vanilla boat
  • Catching it with a hook from the Raft Hook Mod

Barrels and crates generate loot once when collected and then disappear.


Multiplayer Friendly

Nearby players and boats are grouped together and share a single spawn lane.

This prevents players travelling together from generating double or triple the intended loot while keeping the experience balanced for servers and multiplayer worlds.


Optional Valkyrien Skies Support

Install the optional Valkyrien Skies addon:

Entire ships generate a shared flotsam lane based on ship velocity instead of player movement.

This prevents large crews from generating duplicated loot while sailing together.


📊 Floating Spawn Chances

Flotsam Type Default Chance
Oak Log 30%
Stick 25%
Stone 22%
Dirt 18%
Barrel 4%
Crate 1%

All values are configurable.


🛢 Barrel Loot Table

Barrels perform 2–3 loot rolls.

Item Chance Per Roll
Oak Log 37.73%
Sugar Cane 18.87%
Coal 14.15%
Iron Nugget (1–4) 9.43%
String 7.08%
Stone 6.13%
Carrot 3.30%
Potato 3.30%

Inspired by the original Raft barrel loot system and adapted to Minecraft.


📦 Crate Loot Table

Crates perform 3–5 loot rolls.

Item Chance Per Roll
Oak Log 17.0%
Stone 14.0%
Dirt 13.0%
String 11.0%
Coal 8.0%
Flint 6.0%
Wheat 5.0%
Bamboo 4.5%
Sugar Cane 4.5%
Raw Iron 3.5%
Raw Copper 3.0%
Ink Sac 2.0%
Prismarine Shard 1.5%
Vanilla Saplings 2.0% total
Raw Gold 2.0%
Ender Pearl 1.2%
Emerald 0.8%
Enchanted Book 0.6%
Diamond 0.4%

The enchanted book uses vanilla fishing-style enchantments.


Commands

Reload Configuration

/raftflotsam reload

Reloads the configuration without restarting the server.

Permission Level: 2


âš™ Configuration

Configuration file:

config/raft_flotsam.json

General Settings

Option Default Description
enabled true Enables or disables the mod.
spawnIntervalTicks 20 Spawn attempt interval.
spawnChancePerInterval 1.0 Chance a spawn attempt succeeds.
spawnDistanceMin 130 Minimum spawn distance ahead.
spawnDistanceMax 166 Maximum spawn distance ahead.
cleanupDistanceMargin 10 Extra cleanup distance beyond spawn range.
spawnLaneHalfWidth 25 Maximum sideways lane width.
groupRadiusBlocks 64 Radius used to group nearby players.
minHorizontalSpeed 0.04 Minimum movement speed required.
entityLifetimeTicks 1800 Entity lifetime (90 seconds).
maxActiveFlotsamPerGroup 500 Maximum active flotsam per group.
oceanBiomesOnly true Restrict spawning to ocean biomes.

Direction Protection

Option Default Description
directionLockTicks 100 Lock duration after accepting a direction change.
directionTurnThresholdDegrees 35 Angle threshold for large turns.
directionStabilityTicks 60 Stability time before accepting large turns.

Spawn Weights

Type Weight
Log 30
Stick 25
Stone 22
Dirt 18
Barrel 4
Crate 1

Set any weight to 0 to disable it.


âš¡ Performance & Technical Details

Raft Flotsam includes several systems designed to remain server-friendly:

  • Shared multiplayer spawn lanes
  • Nearby player grouping
  • Automatic cleanup of abandoned flotsam
  • Configurable entity lifetime
  • Active entity caps
  • Oldest-entity replacement
  • Server-side authoritative spawning
  • Server-side loot generation

When a lane reaches its maximum entity count, the oldest tracked flotsam is automatically replaced by new spawns instead of allowing unlimited entity growth.

Flotsam left behind by players or ships is automatically cleaned up once it exceeds the configured cleanup distance.

These systems help maintain performance even on busy multiplayer servers.


📦 Dependencies

This mod requires the following dependency to function correctly:

  • Architectury API (required)

Architectury API is used to provide cross-platform compatibility between Fabric and Forge, allowing the mod to share the same core logic across both mod loaders.

Without Architectury API installed, the mod will not load.


🧪 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 Flotsam – Ocean Salvage

¡Lleva el sistema de recolección oceánica inspirado en Raft a Minecraft!

Recoge escombros flotantes (flotsam), barriles y cajas mientras navegas, nadas o exploras el océano abierto.

Raft Flotsam recrea el icónico sistema de residuos flotantes de Raft y lo lleva a Minecraft. Viaja por el océano y descubre recursos flotantes, barriles coleccionables y cajas raras llenas de valioso botín.

Diseñado tanto para un jugador como para multijugador, con soporte para Fabric, Forge e integración opcional con Valkyrien Skies (Forge/Fabric).


Características

  • 🌊 Sistema de residuos flotantes inspirado en Raft
  • 🪵 Troncos, palos, piedra y tierra flotando en el océano
  • 🛢 Barriles flotantes con botín inspirado en Raft
  • 📦 Cajas flotantes con recompensas raras
  • ⛵ Compatible con natación, barcos vanilla y balsas/barcos de Valkyrien Skies (con complemento)
  • 🚢 Soporte opcional para Valkyrien Skies
  • 👥 Carriles de aparición compartidos para multijugador
  • âš¡ Sistemas automáticos de limpieza y límite de entidades
  • âš™ Totalmente configurable mediante JSON
  • 📋 Tablas de botín basadas en datos para modpacks

Cómo Funciona

Mientras viajas por el océano, el mod genera un carril dinámico de residuos flotantes delante de tu dirección de movimiento.

Por defecto, los residuos solo aparecen en biomas oceánicos y pueden incluir:

  • Oak Logs
  • Sticks
  • Stone
  • Dirt
  • Barrels
  • Crates

El sistema rastrea la dirección real del movimiento e incluye un bloqueo de dirección para evitar abusos mediante giros rápidos o movimientos en zigzag.

Los jugadores cercanos comparten un único carril de residuos para evitar la generación de botín duplicado.


Recolección

Los residuos flotantes pueden recogerse de las siguientes formas:

  • Tocándolos directamente
  • Pasando sobre ellos con un barco vanilla
  • Atrapándolos con un gancho del Raft Hook Mod

Los barriles y las cajas generan su botín una única vez al ser recogidos y luego desaparecen.


Compatible con Multijugador

Los jugadores y embarcaciones cercanos se agrupan y comparten un único carril de aparición.

Esto evita que los jugadores que viajan juntos generen el doble o el triple del botín previsto, manteniendo una experiencia equilibrada para servidores y mundos multijugador.


Soporte Opcional para Valkyrien Skies

Instala el complemento opcional:

Los barcos generan un carril compartido de residuos flotantes en función de la velocidad del barco en lugar del movimiento de los jugadores.

Esto evita que las tripulaciones numerosas generen botín duplicado mientras navegan juntas.


📊 Probabilidades de Aparición de Residuos Flotantes

Tipo de Residuo Probabilidad por Defecto
Tronco de Roble 30%
Palo 25%
Piedra 22%
Tierra 18%
Barril 4%
Caja 1%

Todos los valores son configurables.


🛢 Tabla de Botín de Barriles

Los barriles realizan 2–3 tiradas de botín.

Objeto Probabilidad por Tirada
Tronco de Roble 37.73%
Caña de Azúcar 18.87%
Carbón 14.15%
Pepita de Hierro (1–4) 9.43%
Hilo 7.08%
Piedra 6.13%
Zanahoria 3.30%
Patata 3.30%

Inspirado en el sistema original de botín de barriles de Raft y adaptado a Minecraft.


📦 Tabla de Botín de Cajas

Las cajas realizan 3–5 tiradas de botín.

Objeto Probabilidad por Tirada
Tronco de Roble 17.0%
Piedra 14.0%
Tierra 13.0%
Hilo 11.0%
Carbón 8.0%
Pedernal 6.0%
Trigo 5.0%
Bambú 4.5%
Caña de Azúcar 4.5%
Hierro en Bruto 3.5%
Cobre en Bruto 3.0%
Saco de Tinta 2.0%
Fragmento de Prismarina 1.5%
Brotes Vanilla 2.0% total
Oro en Bruto 2.0%
Perla de Ender 1.2%
Esmeralda 0.8%
Libro Encantado 0.6%
Diamante 0.4%

El libro encantado utiliza encantamientos estilo pesca vanilla.


Comandos

Recargar Configuración

/raftflotsam reload

Recarga la configuración sin reiniciar el servidor.

Nivel de Permisos: 2


⚙ Configuración

Archivo de configuración:

config/raft_flotsam.json

Ajustes Generales

Opción Valor por Defecto Descripción
enabled true Activa o desactiva el mod.
spawnIntervalTicks 20 Intervalo entre intentos de aparición.
spawnChancePerInterval 1.0 Probabilidad de que un intento tenga éxito.
spawnDistanceMin 130 Distancia mínima de aparición por delante.
spawnDistanceMax 166 Distancia máxima de aparición por delante.
cleanupDistanceMargin 10 Distancia adicional de limpieza más allá del rango de aparición.
spawnLaneHalfWidth 25 Anchura lateral máxima del carril.
groupRadiusBlocks 64 Radio utilizado para agrupar jugadores cercanos.
minHorizontalSpeed 0.04 Velocidad mínima necesaria para generar residuos.
entityLifetimeTicks 1800 Tiempo de vida de las entidades (90 segundos).
maxActiveFlotsamPerGroup 500 Máximo de residuos activos por grupo.
oceanBiomesOnly true Restringe la aparición a biomas oceánicos.

Protección de Dirección

Opción Valor por Defecto Descripción
directionLockTicks 100 Duración del bloqueo tras aceptar un cambio de dirección.
directionTurnThresholdDegrees 35 Umbral angular para giros pronunciados.
directionStabilityTicks 60 Tiempo de estabilidad antes de aceptar giros grandes.

Pesos de Aparición

Tipo Peso
Log 30
Stick 25
Stone 22
Dirt 18
Barrel 4
Crate 1

Establece cualquier peso en 0 para desactivarlo.


⚡ Rendimiento y Detalles Técnicos

Raft Flotsam incluye varios sistemas diseñados para mantener un buen rendimiento en servidores:

  • Carriles compartidos de aparición para multijugador
  • Agrupación de jugadores cercanos
  • Limpieza automática de residuos abandonados
  • Tiempo de vida configurable para las entidades
  • Límites de entidades activas
  • Sustitución de las entidades más antiguas
  • Aparición controlada por el servidor
  • Generación de botín controlada por el servidor

Cuando un carril alcanza su número máximo de entidades, los residuos más antiguos registrados son sustituidos automáticamente por nuevas apariciones en lugar de permitir un crecimiento ilimitado de entidades.

Los residuos abandonados por jugadores o barcos se eliminan automáticamente cuando superan la distancia de limpieza configurada.

Estos sistemas ayudan a mantener el rendimiento incluso en servidores multijugador muy activos.


📦 Dependencias

Este mod requiere la siguiente dependencia para funcionar correctamente:

  • Architectury API (obligatoria)

Architectury API se utiliza para proporcionar compatibilidad entre Fabric y Forge, permitiendo que el mod comparta la misma lógica base en ambos cargadores de mods.

Sin Architectury API instalado, el mod no se cargará.


🧪 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.

The Raft Flotsam - Ocean Salvage Team

profile avatar
Owner
  • 1
    Followers
  • 4
    Projects
  • 67
    Downloads

More from Menuk