Fusion (Connected Textures)
Fusion allows resource packs to use additional texture and model types such as connected textures!
About
Fusion Connected Textures
Fusion is a library for both Forge and Fabric which adds additional resource pack features such as connected textures and custom entity models to be used in resource packs and other mods! Integration with Fusion can be done optionally for a soft dependency.
📖 Wiki
For resource pack developers:
https://github.com/SuperMartijn642/Fusion/wiki#for-resource-packs
For mod developers:
https://github.com/SuperMartijn642/Fusion/wiki#for-mod-developers
Resource packs
Here's a list of resource packs available for Fusion.
Official resource packs:
- <img width='24' src='https://cdn.modrinth.com/data/ajcwQmG4/e5be78021a6029715b317ce2a368d3428bd3c081_96.webp'> <a href='https://modrinth.com/resourcepack/fusion-block-transitions'><u>Fusion Block Transitions</u></a>
- <img width='24' src='https://cdn.modrinth.com/data/2w5wDdfQ/da4a9fd3c5c7322ebb46d5048f7be022483e0acd.gif'> <a href='https://modrinth.com/resourcepack/fusion-connected-blocks'><u>Fusion Connected Blocks</u></a>
- <img width='24' src='https://cdn.modrinth.com/data/xuN3KzPl/a734b043c20527064ee42b01f80461f59f061106_96.webp'> <a href='https://modrinth.com/resourcepack/fusion-connected-glass'><u>Fusion Connected Glass</u></a>
- <img width='24' src='https://cdn.modrinth.com/data/anEmXbCW/1e2099e20823601b0db21231ce12aa6426d69b8e.gif'> <a href='https://modrinth.com/resourcepack/fusion-emissive-ores'><u>Fusion Emissive Ores</u></a>
- <img width='24' src='https://cdn.modrinth.com/data/d2NwuerS/ac7733a1d69c76e89e8f0cfe922b09ff3f2a4622.gif'> <a href='https://modrinth.com/resourcepack/fusion-stacking-items'><u>Fusion Stacking Items</u></a>
- <img width='24' src='https://cdn.modrinth.com/data/YCXs6v9u/51fabb7cce50131cc22ba8368eb9f9429afa40f0.gif'> <a href='https://modrinth.com/resourcepack/fusion-3d-items'><u>Fusion 3D Items</u></a>
Third-party resource packs:
- <img width='24' src='https://cdn.modrinth.com/data/7Po6Q0I2/233502b7051540e3d8f205401aa4b1df54ce0d28_96.webp'> <a href='https://modrinth.com/resourcepack/glowing-emissive-ores-fusion'><u>Glowing Emissive Ores - Fusion</u></a>
- <img width='24' src='https://cdn.modrinth.com/data/tO3CWuz1/1fa48588b3d39787d9ac2d33a04b7fe4ab99ea1e_96.webp'> <a href='https://modrinth.com/resourcepack/mt-bgs'><u></u>Midnighttigger's Better Grass</a>
- <img width='24' src='https://cdn.modrinth.com/data/TjOXlt9Y/d00e887b7f92fe414c6bc091dc42b6438ecb77d1.png'> <a href='https://modrinth.com/resourcepack/mt-ct-d'><u>Midnighttigger's Default Connected Textures</u></a>
- <img width='24' src='https://cdn.modrinth.com/data/nVen30Ks/f3b347cfddb70b1854c6644646afcb418fb5a0da.png'> <a href='https://modrinth.com/resourcepack/mt-ct-d-a'><u>Midnighttigger's Default Connected Textures Addons</u></a>
- <img width='24' src='https://cdn.modrinth.com/data/hgi0g54q/5e55cf6804001bbb63bffb02ab1439b8699b396a.png'> <a href='https://modrinth.com/resourcepack/snow-side-texture'><u>Snow Side Texture</u></a>
(This is not a comprehensive list. If you made a resource pack which is compatible with Fusion and would like it listed here, feel free to send me a message.)
Connecting textures
Connected textures are textures with a special layout which allows them to connect to other blocks when combined with the connecting model type. Fusion offers 7 different connecting texture layouts for different situations.
Here are examples of the full and compact layouts:
Scrolling textures
Scrolling textures are a type of animated texture which scrolls over an image. The scrolling can occur from any corner to any other corner of the texture, even diagonal! Here is an example of a conveyor belt:
<img width='300' src='https://cdn.modrinth.com/data/p19vrgc2/images/3dcde0711f815f3d20c9abc9d27b7af758816665.gif' alt='Scrolling texture conveyor example'> <img width='400' src='https://imgur.com/uFCxMjF.gif' alt='Scrolling texture conveyor belt'>
Continuous textures
Continuous textures allow creating textures which span multiple blocks!
<img width='400' src='https://cdn.modrinth.com/data/p19vrgc2/images/37b83e6e032ec50aea577d01b7ddf24504f521b2_350.webp' alt='Large stone bricks example'>📐 Block overlays
Using the features provided by the connecting model and connecting texture type, you can also create block overlays!
<img width='480' src='https://imgur.com/I6Whhhe.gif' alt='Sand overflow example'> <img width='360' src='https://cdn.modrinth.com/data/p19vrgc2/images/ff36183671ab0c6aaa01ab1304ccaa33bac0ba0a.png' alt='Grass overflow example'>Custom entity models
Custom entity models and entity model modifiers allow resource packs to change entity models and textures randomly or depending various conditions such altitude, biome, dimension, age, etc.
<img width='430' src='https://cdn.modrinth.com/data/p19vrgc2/images/2cb2daacd3bf8a16ea2bf95a3d942a3fcad9394f.png' alt='Custom chicken model'> <img width='410' src='https://cdn.modrinth.com/data/p19vrgc2/images/4fbd5adc5f9568952cc3f0e04c7ec86b01d0dc01_350.webp' alt='Taiga cow variant'>FAQ
Can I use Fusion in my modpack?
Yes, you are allowed use Fusion in your modpack
Do I need to install Fusion on the server?
No, Fusion is only required on the client and does nothing when installed on a server
Why does Fusion not work with Sodium?
If you are using a version of Sodium older than 0.6, you will also have to install Indium. Sodium replaces the vanilla rendering with their own which ignores the Fabric Rendering API. Indium patches Sodium to support the Fabric Rendering API
Discord
For future content, upcoming mods, and discussion, feel free to join the SuperMartijn642 discord server!
<img width='400' src='https://imgur.com/IG1us6p.png'>
Versions
### Fusion 1.2.12b - Fixed crash with CensoredASM ### Fusion 1.2.12a - Fixed handling of legacy square aspect ratio full layout connecting textures ### Fusion 1.2.12 - Fixed handling of connections key references in connecting models ### Fusion 1.2.11c - Fixed custom render types not working ### Fusion 1.2.11b - Fixed block model modifier outputting quads from `WeightedBakedModel`s for all render types ### Fusion 1.2.11a - Fixed the breaking texture not showing on blocks targeted by a block model modifier ### Fusion 1.2.11 - Added `show_breaking_overlay` option to block model modifiers to not show the breaking overlay for appended models - Fixed crash when modded model bakeries do not contain model modifiers' target models ### Fusion 1.2.10 - Fixed all Fusion models loaded after any Fusion model has an error being broken ### Fusion 1.2.9 - Fixed `pieced` layout when a quads' uv does not cover the entire sprite - Fixed connecting textures using connections for the wrong direction for rotated quads with mirrored uv in some cases ### Fusion 1.2.8 - Added Hungarian translations (thanks to bayi!) - Added compatibility for Vintagium and Relictium - Fixed quads with different render types being ordered randomly for `base` and `connecting` models - Fixed inverted vertical tile ordering for `continuous` textures - Fixed `DefaultConnectionPredicates#isFaceVisible` returning `is_same_block` predicate - Fixed `NotConnectionPredicate` serialization being invalid - Fixed `random` texture seed always being 0 for bottom side ### Fusion 1.2.7 - Fixed argument validation for `count` and `durability` item predicates ### Fusion 1.2.6a - Fixed model showing no quads when using `pane_culling_fix` ### Fusion 1.2.6 - Added data providers for block model modifiers and item model modifiers ### Fusion 1.2.5 - Fixed emissive quads not being quite as bright as they should be ### Fusion 1.2.4 - Fixed vertex permutations for rotated
### Fusion 1.2.12a - Fixed performance issues when resolving custom texture tinting with Sodium installed ### Fusion 1.2.12 - Fixed handling of connections key references in connecting models - Fixed texture references added through base model data builder having an extra '#' ### Fusion 1.2.11b - Fixed `enchantment` item model modifier predicate not working for enchanted books ### Fusion 1.2.11a - Fixed crash with Sodium ### Fusion 1.2.11 - Initial release of Fusion for Minecraft 1.21.11
### Fusion 1.2.12a - Fixed handling of legacy square aspect ratio full layout connecting textures ### Fusion 1.2.12 - Fixed handling of connections key references in connecting models ### Fusion 1.2.11c - Fixed custom render types not working ### Fusion 1.2.11b - Fixed block model modifier outputting quads from `WeightedBakedModel`s for all render types ### Fusion 1.2.11a - Fixed the breaking texture not showing on blocks targeted by a block model modifier ### Fusion 1.2.11 - Added `show_breaking_overlay` option to block model modifiers to not show the breaking overlay for appended models - Fixed crash when modded model bakeries do not contain model modifiers' target models ### Fusion 1.2.10 - Fixed all Fusion models loaded after any Fusion model has an error being broken ### Fusion 1.2.9 - Fixed `pieced` layout when a quads' uv does not cover the entire sprite - Fixed connecting textures using connections for the wrong direction for rotated quads with mirrored uv in some cases ### Fusion 1.2.8 - Added Hungarian translations (thanks to bayi!) - Added compatibility for Vintagium and Relictium - Fixed quads with different render types being ordered randomly for `base` and `connecting` models - Fixed inverted vertical tile ordering for `continuous` textures - Fixed `DefaultConnectionPredicates#isFaceVisible` returning `is_same_block` predicate - Fixed `NotConnectionPredicate` serialization being invalid - Fixed `random` texture seed always being 0 for bottom side ### Fusion 1.2.7 - Fixed argument validation for `count` and `durability` item predicates ### Fusion 1.2.6a - Fixed model showing no quads when using `pane_culling_fix` ### Fusion 1.2.6 - Added data providers for block model modifiers and item model modifiers ### Fusion 1.2.5 - Fixed emissive quads not being quite as bright as they should be ### Fusion 1.2.4 - Fixed vertex permutations for rotated textures being wrong and hence `pieced` layout not lo