Fluid Skills

A library mod that allows configuring player interactions with fluids through a skill system implemented in KubeJS scripts. Similar functionality to Ore Stages, but focused on fluids instead of blocks, with integration into JEI/REI for hiding recipes that use fluids, complementing Item Skills capabilities.

Mod Concept

The mod closely integrates with Player Skills, creating and using skill-based restrictions. By default, it's possible to restrict the ability to extract fluid from the world, use in crafting, visibility in JEI or REI, as well as display in tooltips. Also provides a function to replace fluids in the world with air or another fluid (for example, making crude oil appear and function like lava). Additionally available is configuration of fluid finiteness (for example, making water finite or lava infinite).

Features and Limitations

1. Setting replacement restrictions for common fluids (for example, turning water in the Overworld into lava) can cause significant lag in Forge when skills change, which may lead to single-player game crashes with insufficient memory.

2. Only picking up fluid can be prevented using unbucketable, as there's no guaranteed access to bucket contents without losing compatibility with similar items from other mods. To prevent placing fluid, use Item Skills restrictions for the bucket item.

3. To display replacements in the world, Block Skills must be installed.

4. Integration with JEI does not remove recipes related to the unconsumable flag. It hides recipes when right-clicking on the ingredient, but doesn't remove the recipe itself — only unproducible does that. That is, a resourceful player can view the recipe for creating an item, then right-click on the created item to see recipes where it can be used.

Additional Information

Documentation, examples, and additional information are available in the readme on Github.