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:

Raft Flotsam – Valkyrien Skies Compatibility

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:

Raft Flotsam – Valkyrien Skies Compatibility

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.

Raft Flotsam - Ocean Salvage