Introduction

Resourceful Sheep on Github : https://github.com/Mathmout/Resourceful-Sheep

Welcome to the Resourceful Sheep 1.3 Mini Wiki!

This mod lets you raise sheep that produce different resources from simple stone to the Nether Star. This guide explains how to set up the mod using JSON files.

Resourceful Sheep is fully customizable. It adds new types of sheep to Minecraft. Each sheep is linked to a resource and can be bred to higher tiers. Higher tiers produce more resources. You can also create your own sheep types, define mutations, and control where they spawn. The mod has full JEI integration, so you can easily see recipes and information in-game.

Configuration Files

All config files are located in config/resourceful_sheep/ inside your Minecraft instance.

They use the JSON format and are loaded at game start. ⚠️ Every change needs a full restart of the game, a /reload is not enough.

---

1. Sheep Types

This is the main configuration file. Each file defines a "Resource" type (like Copper or Coal), and creates variants based on Tiers.

Global Settings, applied to all tiers :

• Resource : UNIQUE resource ID, example: "cobblestone", "refined_glowstone".
• EggColorBackground: Hex color for the spawn egg background, example: "#88771f".
• EggColorSpotsNTitle: Hex color for the egg spots and the item name hover text.
• FireImmune: true or false. If true, the sheep cannot be hurt by fire or lava.
• ImmuneEffects: A list of potion effects that cannot affect the sheep, example: ["minecraft:poison", "minecraft:wither"].
• FoodItems: A list of items used to tempt or breed the sheep.
• You can use item IDs: "minecraft:carrot"
• You can use Tags, start with #: "#minecraft:leaves"
• EtableBocksMap : A list of rules defining what the sheep eats and what the block becomes.
  • Format : "Block_To_Eat": "Block_Result"
  • Tags : You can use tags but only for the input block, exemple : "#c:cobblestone": "minecraft:air".
  • Destruction : Use "minecraft:air" as the result to destroy the block completely, like eating short grass.

Tiers & Drops Settings

In the SheepTier list, you define the progression. Each tier creates a unique sheep variant, example: andesite_tier_1.

• Tier : An integer defining the tier level.
• DroppedItems : A list of items dropped when sheared. You can have multiple different items per tier.
  • ItemId : The item ID, example: "minecraft:diamond".
  • MinDrops / MaxDrops : The quantity range.

Texture Generation

Textures are generated automatically based on the drops. The mod analyzes the colors of items and blocks defined in the DroppedItems list to create weighted color palette.

Wool color coverage increases by 10% per tier. Maximum coverage is 60%. If a sheep type has more than 6 tiers, the coverage scales proportionally but never exceeds 60%.

---

2. Mutations

These files define breeding recipes for new sheep.

• MomId: ID of the first parent, example: "iron_tier_1".
• DadId: ID of the second parent.
• ChildId: ID of the new sheep.
• Chance: Integer 1 to 100 is the chance of success.

👉 If you define multiple possible mutations for the same parents, their total chance must be ≤ 100. Otherwise, some mutations will be ignored.

If no mutation happens or it fails, there is a 50/50 chance to get either parent instead.

---

3. Spawning

Here you define how sheep appear in the world.

• sheepId: Sheep ID, example: "netherrack_tier_1".
• minCount / maxCount: Size of the sheep group.
• densityRadius / maxNearby: Control how often sheep spawn. Roughly maxNearby sheep every densityRadius blocks.
• requireSeeSky: If set to true, the sheep will only spawn if there are no solid blocks above it.
  • Use true for Overworld surface sheep.
  • Use false for cave sheep or Nether sheep.
• Biomes: List of biomes where the sheep can spawn, example: ["minecraft:plains", "minecraft:wooded_badlands"].
  • If empty, the sheep will spawn wherever vanilla Minecraft sheep spawn.

⚠️ Experimental Settings Warning

When creating a new world, Minecraft may show a warning about experimental features. This happens because the mod injects a dynamic datapack at runtime to handle sheep spawning in specific biomes without overwriting other mods. Minecraft flags any dynamic modification of WorldGen settings as "experimental". It is safe to ignore and proceed. This system allows for flexible spawning configuration.

---

Conclusion

Thanks for reading! Don’t forget, the base config includes several examples to help you understand the new structure.

Please note that this mod is still in active development. Feel free to suggest ideas, report bugs, or give feedback to help improve the mod!