Skip to content
Sylsatra edited this page Mar 8, 2025 · 1 revision

🌟 Fire Fear Mod – Build & Run Guide

📜 Table of Contents

  • Cloning the Mod
  • Setting Up the Development Environment
  • Running the Mod in Development
  • Building the Mod
  • Modifying the Code & Configuration
  • Troubleshooting

📞 Cloning the Mod

First, clone the Fire Fear Mod from GitHub.

Mac & Linux:

git clone https://github.com/Sylsatra/firefearmod.git
cd firefearmod

Windows (CMD or PowerShell):

git clone https://github.com/Sylsatra/firefearmod.git
cd firefearmod

⚙️ Setting Up the Development Environment

Before building the mod, you need to set up your development environment.

1️⃣ Install Java 17

Ensure you have Java 17 installed, as Forge 1.18.2 requires it.

2️⃣ Generate Minecraft Forge Workspace

Once Java 17 is installed, navigate to your mod folder and run:

Mac & Linux:

./gradlew genEclipseRuns

Windows (CMD or PowerShell):

gradlew genEclipseRuns

This sets up Forge and dependencies for development.


🚀 Running the Mod in Development

To test the mod in Minecraft without building a .jar file:

Run the Mod in a Dev Environment

Mac & Linux:

./gradlew runClient

Windows (CMD or PowerShell):

gradlew runClient
  • This launches Minecraft Forge with your mod installed.
  • Any code changes will take effect immediately after restarting the client.

📦 Building the Mod

When you’re ready to package your mod into a .jar file:

Mac & Linux:

./gradlew build

Windows (CMD or PowerShell):

gradlew build

Once finished, the .jar file will be located in: 📂 build/libs/firefearmod-1.18.2.jar


🛠️ Modifying the Code & Configuration

File What It Does Location
FireFearMod.java Main mod class src/main/java/com/example/firefearmod/
FireFearConfig.java Config file settings src/main/java/com/example/firefearmod/config/
FireFearEvents.java Handles entity AI registration src/main/java/com/example/firefearmod/
FireFearGoal.java Defines entity fleeing AI src/main/java/com/example/firefearmod/ai/
mods.toml Mod metadata & dependencies src/main/resources/META-INF/mods.toml
build.gradle Gradle build script Root folder (firefearmod/)

Editing Configuration

Modify FireFearConfig.java to:

  • Change scan cooldown (SCAN_COOLDOWN_TICKS).
  • Adjust fear radius for players & blocks.
  • Add new entities, blocks, and items that cause fear.

❓ Troubleshooting

1️⃣ Gradle Fails to Build

Error: Java Version Issue

If Gradle fails with a Java version error, check your Java version:

java -version

Ensure it's Java 17. If not, install it as shown earlier.

2️⃣ Game Crashes on Launch

Check your logs in: 📂 run/logs/latest.log

Common issues:

  • Incorrect dependency in mods.toml → Check versionRange.
  • Entities not fleeing from fire? → Add them to FLEEING_ENTITIES in FireFearConfig.java.

🎯 Conclusion

Now you can build, test, and modify the Fire Fear Mod with ease! 🚀🔥 If you have any issues, open an issue on GitHub.