Fluid Shell Extensions

Fluid Shell Extensions

Fluid Shell Extensions is an addon mod for [Create Big Cannons] that expands the fluid shell system with a flexible custom effect framework. Through simple JSON configuration files, you can add rich explosive effects to any fluid without writing a single line of code. Whether it's placing fluid sources, spawning items, applying potion effects, creating explosions, or generating particles—everything is under your control.

Features

• Fully Data-Driven – All effects are configured via JSON files. No mod code modifications required.
• Multi-Stage Effects – Trigger different effects based on the amount of fluid inside the shell.
• Multiple Effect Types – Place fluid source blocks, spawn item entities, apply potion effects, create explosions, emit particles.
• Soft Dependency Support – Set conditions based on whether specific mods are loaded for cross-mod integration.
• Detailed Logging – Easy debugging and effect tracing.

Requirements

• Minecraft 1.20.1
• Forge 47.0.0 or higher
• Required mods:
  • [Create] 6.0.0+
  • [Create Big Cannons] 5.10.2+

Configuration

Configuration files go in config/fluid_shell_extensions/effects/:

• Singleplayer: .minecraft/config/fluid_shell_extensions/effects/
• Server: server-root/config/fluid_shell_extensions/effects/

Each fluid requires its own JSON file. Naming it after the fluid's registry name (e.g., create_chocolate.json) is recommended.

Configuration File Structure

{
  "fluid": "modid:fluid_name",
  "condition": {
    "mod": "required_mod_id"
  },
  "effects": [
    {
      "type": "effect_type",
      "properties": {
        // Effect-specific properties
      }
    }
  ]
}

Field Descriptions

Effect Types

Place Fluid

{
  "type": "place_fluid",
  "properties": {
    "fluid": "modid:fluid_name",
    "radius": 3,
    "density": 0.5
  }
}

Spawn Items

{
  "type": "spawn_items",
  "properties": {
    "items": [
      {
        "item": "modid:item_name",
        "count": 1,
        "chance": 0.5
      }
    ],
    "velocity": 2.0
  }
}

Apply Potion Effect

{
  "type": "potion_effect",
  "properties": {
    "effects": [
      {
        "effect": "minecraft:effect_name",
        "amplifier": 1,
        "duration": 200
      }
    ],
    "radius": 5
  }
}

Explosion

{
  "type": "explosion",
  "properties": {
    "power": 3.0,
    "fire": false,
    "break_blocks": true
  }
}

Particle Effect

{
  "type": "particles",
  "properties": {
    "particle": "minecraft:particle_name",
    "count": 100,
    "speed": 0.5
  }
}

Examples

Water

{
  "fluid": "minecraft:water",
  "effects": [
    {
      "type": "place_fluid",
      "properties": {
        "fluid": "minecraft:water",
        "radius": 2,
        "density": 0.8
      }
    },
    {
      "type": "particles",
      "properties": {
        "particle": "minecraft:splash",
        "count": 50,
        "speed": 0.3
      }
    }
  ]
}

Lava

{
  "fluid": "minecraft:lava",
  "effects": [
    {
      "type": "place_fluid",
      "properties": {
        "fluid": "minecraft:lava",
        "radius": 2,
        "density": 0.6
      }
    },
    {
      "type": "explosion",
      "properties": {
        "power": 2.0,
        "fire": true,
        "break_blocks": false
      }
    },
    {
      "type": "particles",
      "properties": {
        "particle": "minecraft:flame",
        "count": 80,
        "speed": 0.4
      }
    }
  ]
}

FAQ

Q: How do I install extensions?
A: Install the mod, run the game once, place your JSON files in config/fluid_shell_extensions/effects/, then restart the game or server.

Q: How do I create custom extensions?
A: Follow the writing guide above.

Q: How do I set this up on a multiplayer server?
A: Both server and clients need the same configs. Place files in the server's serverconfig/fluid_shell_extensions/effects/ directory (server-side configs take priority).

Q: How do I report a bug or suggest a feature?
A: Please leave a comment on the mod's discussion page. Including the full log and reproduction steps helps a lot.

Summary

Fluid Shell Extensions transforms fluid shells from mere ammunition into highly customizable projectiles, adding more fun and strategy to your gameplay.