Threads and Silks

Description

About The Project

Threads and Silks is designed to be an immersive clothing mod for Minecraft! It adds a number of textiles, including burlap (made from wheat), wool fabric (made from wool blocks), and silk (made from string). It includes >30 individually dyeable garments using the leather armor dyeing system, and some of these garments (such as the belt and cloak) can be layered on top of others that occupy the same slot by combining them in a crafting table! The mod also includes 16 "custom" sets of equipment that you can design yourself by including your own resource pack.

Getting Started

Installation

To install, copy the ".jar" file into the "mods" folder for your minecraft installation on both the client and server sides.

Making your First Textiles

Once you've loaded up your world, just play Minecraft like normal! Clothing and fabric recipes will unlock as you play through the game, and everything you need to know should be covered in your recipe book.

If you need a little more help, the basic ingredients for your textiles are wheat (which makes burlap), wool blocks (which makes wool fabric), and string (which makes silk). Some recipes also require leather fabric (which can be made from cow leather) and buttons (which can be made from gold or iron nuggets or from copper ingots). To unlock all major recipes in the mod, you'll need to find wheat, white wool, string, leather, a copper ingot, and blue dye.

Clothing can be dyed using the same method as leather armor. Combine the item with any number of dyes at the crafting table make your desired color. A couple items can't be dyed.

To layer clothing, take two items that go in the same slot (currently just the chest or shoes slots) and combine them at the crafting table. One item needs to be an "over" layer (such as the jacket, belt, apron, cloak, coat, puffed sleeves, or shoes) and one needs to be an "under" layer (such as a shirt, blouse, sack, or socks). The color of the item will be reset, but you'll be able to redye the under layer as normal. If you want the over layer to have a particular color, you can add a dye to this recipe to lock the over layer's color to be something other than the default. For example, blue dye + belt + wool shirt will make a layered chest item with a gray wool shirt and a blue belt. Further attempts to dye the item will change the color of the shirt, but the belt will stay blue.

Holiday Items

Threads and Silks now has a set of holiday equipment! You can craft these with a piece of golden equipment plus a firework, jack o' lantern, spruce sapling, and egg. There's also a bonus hat that is crafted from a leather helmet plus the same four items. When worn, the texture of the equipment will match your players current holiday. You can set your player's current holiday textures to the spooky variant with the command

\holiday @s spooky

You can also select 'festive', 'spring', and 'beach'. If you wish to add custom holidays in your own resource pack, you can do so by including the 'holiday_#layer_1.png' and 'holiday#_layer_2.png' files in your 'textures/models/armor' folder. Replace the '#' with 1-8 for up to 8 custom holidays.

Advanced Usage

If you want to include your own clothing into the mod, all you need to do is create a resource pack! The 16 custom sets are titled "custom_#", so to create a custom set of clothing, you might create the "custom_1_layer_1.png" and "custom_1_layer_2.png" file (which are the typical armor texture files). Copy the files into your resource pack under "assets/minecraft/textures/models/armor/", and load up the resource pack in the game. You can also create your own inventory models by placing them into "assets/threads/textures/models/item/" with the names "custom_1_helmet.png", "custom_1_chestplate.png", "custom_1_leggings.png", and "custom_1_boots.png". There is a default recipe for these custom clothing items, but you could use a datapack to overwrite them. The default recipe files are called "custom_1_helmet.json", etc., and would be placed in the "data/threads/recipes/" folder of a datapack.

If you want to specify an overlay layer (a layer that can't be dyed, which is overlaid on the rest of the texture), you can do so by adding "_overlay" to the end of the png texture file (for example, "custom_1_layer_1_overlay.png").

For examples of how to generate custom clothing, check out the accompanying resource packs here.

FAQ

Is there any mechanical advantage to wearing clothing instead of armor?

Yes! It turns out that silk is easier to enchant than diamonds (who knew?). Also, villagers might occasionally be impressed by your dapper looks and might throw you some gifts on occasion.

I love the style of the clothing, but why do I have to choose between fashion and armor?

You don't! This mod is perfectly compatible with the Cosmetic Armor mod. Go give them, and the developers of Trinkets, some love for their excellent work!

Can I request a new article of clothing?

Sure! I'd love to know what clothing people would like to see added to the mod. If this mod gains a lot of traction, I'll definitely be willing to add more items, so it'll be helpful to see what people want. Be aware that I also work a (more than) full-time job, so I tend to be pretty busy.

Just for reference, my background stems mostly from western European/american roots, and I want to be respectful of other cultures. If you want to see garments from your own culture represented, please reach out to me, and photographs of the kinds of clothing you'd like to see would be helpful! I'd love to work with you to generate something that will help tell your own stories.

What about jewelry/capes/accessories?

That goes a bit beyond what this mod is intended to handle. Check out the Trinkets mod for things like that!

I'm a texture artist, and I'd love to contribute to this project! What can I do?

That's great! I'd really love to compile a series of resource packs that extend the capability of this mod! If you could make a custom resource pack using the features I described up in the Advanced Usage section, that would be amazing! You're welcome to distribute them on your own page, or I'd be happy to add some custom resource packs here on CurseForge!

Help! I can't layer my own custom clothing!

Unfortunately, that's just how the mod works. >_< The layered combinations are pre-compiled before the .jar file is built so that the code doesn't have to do a lot of image processing when Minecraft starts up. This feature is only available for the default clothing options, but as the default options expand, there should be more layering combinations (to an extent)!

Can I use this in my modpack/server/channel/etc.?

Absolutely! I'd love to see what content you all can create with this mod! If you feature it somewhere, I'd greatly appreciate a shout-out, but no pressure.

Are you planning on making the mod work with Forge/other versions of Minecraft?

Probably not. I pretty much exclusively play Fabric mods. I'll be trying to keep the mod updated going forward, but that's probably as much as I'll be able to devote to this mod. This mod does use the ArmorRenderLib mod by CleverNucleus, which is currently only available out to 1.19.2. When that updates, I should be able to update this mod as well.

License

Distributed under Creative Commons. See LICENSE for more information.

Acknowledgments

• [https://github.com/CleverNucleus/ArmorRenderLib/tree/1.19](CleverNucleus Armor Render Lib)
• [https://www.youtube.com/@ModdingByKaupenjoe](Kaupenjoe's Modding Tutorials)
• [https://github.com/othneildrew/Best-README-Template](othneildrew's Readme Template)

What means Verified?

• Compatibility: The mod should be compatible with the latest version of Minecraft and be clearly labeled with its supported versions.
• Functionality: The mod should work as advertised and not cause any game-breaking bugs or crashes.
• Security: The mod should not contain any malicious code or attempts to steal personal information.
• Performance: The mod should not cause a significant decrease in the game's performance, such as by causing lag or reducing frame rates.
• Originality: The mod should be original and not a copy of someone else's work.
• Up-to-date: The mod should be regularly updated to fix bugs, improve performance, and maintain compatibility with the latest version of Minecraft.
• Support: The mod should have an active developer who provides support and troubleshooting assistance to users.
• License: The mod should be released under a clear and open source license that allows others to use, modify, and redistribute the code.
• Documentation: The mod should come with clear and detailed documentation on how to install and use it.

How to Install