Description

☢️ Contamination Core
A modular, highly configurable radiation framework for Minecraft.
Contamination Core introduces a flexible radiation system designed to work alongside vanilla Minecraft and other mods. Rather than relying on hardcoded lists of radioactive items and blocks, it uses Minecraft's tag system to determine what produces radiation.
This makes Contamination Core highly extensible: mod developers, modpack creators, and datapack authors can add their own radioactive content without needing to modify the Core itself.
Whether you're creating a post-apocalyptic survival experience, adding environmental hazards to an adventure modpack, or simply looking to introduce radiation into your world, Contamination Core provides the foundation.
🧩 Official Addons
Contamination Core is designed to be modular. The following official addons expand its functionality and provide additional content and compatibility.
|
Addon |
Description |
|---|---|
|
Provides default radiation classifications for vanilla foods and biomes. |
|
|
Adds compatibility with content from other mods through additional tag entries. |
|
|
(Soon) Contamination Essentials |
Provides additional radiation-related items, treatments, and equipment. |
All addons are optional unless otherwise specified. Contamination Core can function independently.
☢️ Radiation Tiers
Radiation sources are organized into three tiers:
- Low Radiation – Minor sources of radiation.
- Medium Radiation – More significant sources of radiation.
- High Radiation – Particularly strong sources of radiation.
Each tier has its own configurable radiation values. This allows you to determine how much radiation different sources produce and how strongly they affect players.
The tier system also makes it easy to categorize new content without having to configure every individual item separately.
🏷️ Tag-Based Compatibility
One of the main features of Contamination Core is its use of Minecraft's tag system.
Instead of maintaining a hardcoded list of supported items, the mod checks whether content belongs to one of its radiation tags.
Starting with v1.2+, Contamination Core will no longer come with vanilla biomes and items pre-tagged. Instead, there will be a seperate Addon to do this.
Food Tags
| Tag | Radiation Tier |
|---|---|
contaminationcore:lowradfoods |
Low |
contaminationcore:medradfoods |
Medium |
contaminationcore:highradfoods |
High |
Adding an item to one of these tags automatically makes it subject to the corresponding radiation mechanics.
(v1.0.1 and below) The mod comes with most food items already tagged.
Biome Tags
Biomes can also be assigned radiation levels using tags, just like food.
| Tag | Radiation Tier |
|---|---|
contaminationcore:lowradbiomes |
Low |
contaminationcore:medradbiomes |
Medium |
contaminationcore:highradbiomes |
High |
(v1.0.1 and below) Just like with foods, Contamination Core comes with most biomes already tagged.
You can also add biomes from other mods to these tags, allowing modded environments to have their own radiation levels.
Radiation Removal Tags (v1.2+)
Contamination Core includes four item tags for identifying items that can remove accumulated radiation.
| Tag | Radiation Removed |
|---|---|
contaminationcore:radremovaltier1 |
10% of maximum radiation |
contaminationcore:radremovaltier2 |
25% of maximum radiation |
contaminationcore:radremovaltier3 |
50% of maximum radiation |
contaminationcore:removesallrads |
100% (sets radiation to 0) |
Items added to these tags automatically receive their corresponding radiation-removal behavior.
The removal amounts are configurable through the common configuration. Other mods can contribute their own items to these tags, allowing compatibility addons and content mods to add radiation treatments.
These tags must be applied to an edible item to work.
Adding an item to all three tiers will cause their effects to stack, however it's suggested to just use one tag per item.
Creating Compatibility
Want to make an item from another mod radioactive?
Simply add its registry ID to the appropriate tag.
This also makes creating compatibility addons much easier. An addon can simply contribute additional tag entries for the content it supports.
Compatibility is not limited to mods specifically supported by Contamination Core. Any mod that exposes suitable registry entries can potentially be integrated through tags.
⚙️ Configuration
Contamination Core is designed to give modpack creators control over how radiation behaves.
Its configuration system provides control over radiation mechanics, allowing you to adjust the experience to suit your modpack.
You can customize things such as:
- Radiation exposure values.
- Minimum and maximum radiation amounts.
- Radiation scaling between tiers.
- Food radiation settings.
- Natural radiation decay.
- Client-side visual and interface settings.
The goal is to make the system adaptable rather than forcing every modpack to use the same radiation balance.
📉 Natural Radiation Decay
Radiation doesn't necessarily have to be permanent.
Contamination Core includes configurable natural radiation decay, allowing accumulated radiation to gradually decrease over time.
You can adjust the decay rate or disable natural decay entirely, depending on the kind of survival experience you want to create.
This also allows other mods to introduce their own radiation treatments and recovery mechanics.
🛡️ Radiation Resistance
Contamination Core includes a radiation resistance attribute.
contaminationcore:rad_resist
This provides a standardized way for other mods to modify how much radiation a player receives.
For example, another mod could introduce armor that increases radiation resistance, reducing incoming exposure without needing to implement its own radiation system.
This creates opportunities for equipment, upgrades, perks, and other forms of radiation protection.
🧩 Designed to Be Extended
Contamination Core is intended to serve as a foundation for other mods.
Rather than adding every possible radiation-related item and feature directly into the Core, the system is designed to let other projects build on top of it.
Possible integrations include:
- Food mods adding radioactive food.
- World-generation mods introducing contaminated environments.
- Equipment mods adding radiation-resistant armor.
- Survival mods introducing radiation treatments.
- Modpacks defining their own radiation balance.
The Core handles the underlying mechanics, while other projects can provide additional content.
🚧 Future Development
Contamination Core is designed to grow over time.
Potential future additions include:
- Radiation from nearby blocks.
- Additional radiation source categories.
- More advanced visual effects.
- UI improvements.
- Radiation infliction via entities.
- Expanded compatibility with other mods.
Features are not guaranteed until they are officially implemented and released.
📌 Important Stuff
Although the description for Contamination Core was written with some assistance from AI, the mod itself is 100% human-made and was developed using MCreator 2026.2.
AI assistance was used for writing in the description, not for creating the mod.
This mod was made because of a different mod I have been working on for the past few months; a Fallout mod. And since I thought the radiation mechanic was cool, I decided to make it it's own mod.
Thank you!! And have fun using Contamination Core!! :D




