Custom Item Interactions
by ACGaming
Custom Item Interactions lets a server owner define right-click and consumption rules that swap one item for another when it meets a fluid or is eaten.
What it does
Each rule is set in the config file and names an input, an output and an optional list of commands. Holding an input item and right-clicking a fluid replaces the item with the output, much as a vanilla bucket fills with water. Consumable items work the same way: once eaten or drunk, the input is replaced by the output. The author describes uses such as a custom mug that returns an empty mug like a vanilla glass bottle, or cooked chicken that leaves bones behind.
The optional commands run after an interaction and can play sounds, spawn particles or grant advancements. Commands run as the player who triggered them and accept common command variables such as the player selector. Config edits take effect while a world is running, since the Forge Mod Options screen lets a tester adjust values live. The mod targets Forge and is published for 1.12.2 only, under the MIT License, and it is open source with a public source code repository and issue tracker.
Key features
Fluid right-click rules
An item held in hand can be swapped for another when the player right-clicks a chosen fluid, such as water or lava.
Consumable item rules
A food or drink item can be replaced by another item after it is used up, for example to return an empty container.
Post-interaction commands
Optional commands run after each interaction to play sounds, spawn particles or grant advancements.
Live config updates
Values are adjustable in the Forge Mod Options screen during play, so a change can be checked without a restart.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Custom containers
A server can add a mug that fills with beer or water and returns an empty mug, similar to vanilla glass bottles.
Crafted interactions
Items created with ContentTweaker can be given fluid or food interactions through the config alone.
Soaking and fluid recipes
A book can be turned into paper by water, with a sound played as the interaction completes.
Who it’s for: Server owners and modpack authors on Forge 1.12.2 who want item behaviour changed through configuration rather than code. Players only see the results of the rules the server sets.
Questions
Does Custom Item Interactions need to be installed on the client?
Which Minecraft version and loader does the mod support?
Can the commands in the config use player variables?
In the catalog
Custom Item Interactions is one of 29,952 Game mechanics mods on ModsFinder, and one of 13,316 Game mechanics mods for Forge. 2,920 mods support Minecraft 1.12.2.
More from ACGaming
Similar mods
What the author says
A simple mod that applies custom functionality to right-click interactions with fluids, similar to filling a bucket with water, and using items, such as eating and drinking. Have you ever wanted to make a custom mug that fills with water for beer when you right click water? Or filling a bowl with lava? Now you can!…
Official listing
- Modrinth page
- modrinth.com/mod/cii
- Owner
- ACGaming
- Published
- 2025-07-28
- Updated on Modrinth
- 2025-07-28
- Facts verified
- 2026-10-15