Euphoria Patches Properties Files

What Are These Files?

These .properties files help Euphoria Patches recognize blocks, items, entities, and dimensions from different mods. By contributing to these files, you help improve compatibility for everyone!

Current Total Modded Blocks: 43.79K | All Supported Mods: List

⚠️ IMPORTANT REMINDERS ⚠️

• Please use the templates provided below!
• Always document your additions in addedMods.md!
• Only do changes to the latest version from GitHub!

How to Contribute

There are two easy ways to contribute:

1. Submit a Pull Request on GitHub (preferred method) - See detailed instructions below
2. Share your changes on Discord - Post the modified property file on our Discord server

We encourage everyone to try the GitHub method when possible, as it makes tracking and reviewing changes easier!

Getting Started (Step-by-Step)

1. Find the property file you want to modify (block, item, entity, or dimension)
2. Follow the template provided at the top of each file (see examples below)
3. Add your mod entries
4. Document your changes in addedMods.md
5. Submit your contribution (be happy)

Important Templates

Each properties file has a specific format. Click to see the template you need:

📦 block.properties template (click to expand)

Template for Modded Blocks:

# Description of the block ID
block.XXXXX = vanillaId1 vanillaId2 vanillaId3 ... \
\
modName1:modId1 modName1:modId2 modName1:modId3 ... \
\
modName2:modId1 modName2:modId2 modName2:modId3 ... \
\
...
lastModInThisIDName:modId1 lastModInThisIDName:modId2 lastModInThisIDName:modId3

# Description of the Next block ID
block.YYYYY = ...

Important Notes:

• Group IDs by mods (each mod on its own line)
• Use a backslash \ at the end of each line EXCEPT the last line of an entry
• Always add a blank line with just \ between different mods

🧰 item.properties template (click to expand)

Template for Modded Items:

# Description of the item ID
item.XXXXX = vanillaId1 vanillaId2 vanillaId3 ... \
\
modName1:modId1 modName1:modId2 modName1:modId3 ... \
\
modName2:modId1 modName2:modId2 modName2:modId3 ... \
...
lastModInThisIDName:modId1 lastModInThisIDName:modId2 lastModInThisIDName:modId3

# Description of the Next item ID
item.YYYYY = ...

Important Notes:

• Group IDs by mods (each mod on its own line)
• Use a backslash \ at the end of each line EXCEPT the last line of an entry
• Always add a blank line with just \ between different mods

🐑 entity.properties template (click to expand)

Template for Modded Entities:

# Description of the Entity ID
entity.XXXXX = vanillaId1 vanillaId2 vanillaId3 ... \
\
modName1:modId1 modName1:modId2 modName1:modId3 ... \
\
modName2:modId1 modName2:modId2 modName2:modId3 ... \
...
lastModInThisIDName:modId1 lastModInThisIDName:modId2 lastModInThisIDName:modId3

# Description of the Next Entity ID
entity.YYYYY = ...

Important Notes:

• Group IDs by mods (each mod on its own line)
• Use a backslash \ at the end of each line EXCEPT the last line of an entry
• Always add a blank line with just \ between different mods

🌎 dimension.properties template (click to expand)

Template for Modded Dimensions:

dimension.world-1 = vanillaId1 vanillaId2 \
\
modName1:modId1 modName1:modId2 modName1:modId3 ... \
\
modName2:modId1 modName2:modId2 modName2:modId3 ...

dimension.world1 = ...

Important Notes:

• Group IDs by mods (each mod on its own line)
• Use a backslash \ at the end of each line EXCEPT the last line of an entry
• Always add a blank line with just \ between different mods

Documenting Your Changes

After adding your mod entries, please update the addedMods.md file with your additions:

📝 How to document your changes (click to expand)

Add a new line like this to addedMods.md:

| [ModName](https://link-to-mod) | Mod's Version | Status Definitions | # Optional comments about what's included

Example:

| [Applied Energistics 2](https://modrinth.com/mod/ae2) | 15.0.8 | Fully Added | # All blocks and items added

Version Information

• Each properties file has its own version number
• Version increases ONLY when vanilla components change
• Adding mod entries doesn't change the version number
• These files are always up-to-date with Euphoria Patches dev versions

Helpful Tools

These tools make contributing easier:

• Euphoria Companion: Get a complete list of all blocks in your current game and which ones are missing in the properties files and much more!
• ItemStackExporter: Export many blocks at once from JEI/REI or inventory

Advanced Tips

• Debug Worlds: If Euphoria Companion isn't available for your version, hold Alt while selecting world type in world creation menu to create a debug world containing every block the game knows about

• Color Coded Programs:

  1. Go to "Other" tab in the Shader Settings and enable "Color Coded Programs"
  2. This reveals how blocks are rendered by coloring them based on their render program:
     • Green: Solid blocks (gbuffers_terrain)
     • Dark Blue: Translucent blocks (gbuffers_water)
     • Yellow: Block entities (gbuffers_block)
     • Red: Entities (gbuffers_entities)
     • Other colors: Various other programs

• Finding Missing Block Properties:

  1. Enable Color Coded Programs
  2. Hold a spider eye in one hand
  3. Blocks with missing properties will appear as magenta/black striped pattern
  4. Hold spider eyes in both hands to disable the color coding

• Block States: Not all blockstates need to be added separately

  • For many blocks (like facing directions), you only need the base ID
  • Some blocks only need specific states differentiated (like powered=true vs powered=false)

Need Help?

• GitHub Help:
  • How to fork a repository
  • How to create a pull request
• Ask questions on our Discord

Frequently Asked Questions

Q: Do I need to know coding to contribute?
A: No! Just follow the templates and add the mod IDs you want to include.

Q: How do I find mod and block IDs?
A: Use the F3 screen when and the Targeted Block info on the right side, or F3+H in-game to show advanced tooltips, additionally use the recommended tools (ItemStackExporter or Euphoria Companion).

Q: How can I use the GitHub version of these files in game to test my additions?
A: You can download and test as follows:

1. Download the files from this GitHub repository - big green <> code button and then download zip. The zip file contains all files of this repository.
2. Navigate to your Minecraft instance folder
3. Go to the shaderpacks folder
4. Find the Euphoria Patches folder
5. Inside, go to the shaders folder
6. Replace the existing properties files with your downloaded versions
7. Reload shaders in-game with F3+R or by re-selecting the shader pack

Note: Supplemental Patches is a third-party mod that extends Euphoria Patches with even more modded functionality.