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.