🧪 Setting Up a Test Modpack / Environment

To test the Easy NPC mod efficiently, you should create a dedicated test environment using the * CurseForge Launcher*. This ensures a clean setup and minimizes compatibility issues.

🛠️ Prerequisites

• 🧩 CurseForge Launcher: Download and install from the CurseForge website.
• 🎮 Minecraft Java Edition: Make sure it’s installed and working.

📋 Typical Version and Modloader Combinations

The Easy NPC mod supports different Minecraft versions and modloaders. Here’s a quick overview:

Minecraft Version	Fabric	Forge	NeoForge
1.18.2	✅	✅	❌
1.19.2	✅	✅	❌
1.20.1	✅	✅	❌
1.21.1	✅	✅	✅

✅ Step 1: Create a Test Modpack

If you don’t already have a test modpack:

1. Open the CurseForge Launcher and go to the Minecraft tab.
2. Under My Modpacks, click the Create button.
3. Name your profile (e.g., Easy NPC Test - 1.18.2 Forge).
4. Choose the correct Minecraft version (e.g., 1.18.2, 1.19.2, 1.20.1).
5. Select the appropriate Modloader (Forge, Fabric, or NeoForge).
6. Optional: Set a custom image for easier identification.
7. Click Create and wait for the base game and profile to be created.

▶️ Step 2: Start the Modpack

Run the modpack once to complete setup:

1. Go to the Minecraft tab.
2. Select your newly created modpack under My Modpacks.
3. Click the Play button to start it.
4. Let it fully load, then exit Minecraft and return to the launcher.

📦 Step 3: Install the Mod

There are two ways to install the Easy NPC mod: via the CurseForge interface or manually. Most of the time, you can use the interface. However, Alpha versions may require manual installation if not yet visible.

🚀 Release and Beta Versions (Using CurseForge)

1. Go to Minecraft > your modpack.
2. Click on the Add More Content button.
3. In the search bar, type 559312 and click Install to add the Easy NPC Core mod.
4. Then search for 1214728 and click Install to add the Easy NPC Config UI mod.

🔧 Alpha Versions (Manual Installation)

If the mod is in Alpha and not visible in the CurseForge interface, you need to install it manually.

🗂️ Open the Mods Folder

1. Go to the Minecraft tab in the CurseForge Launcher.
2. Click on your modpack in the My Modpacks section.
3. Click the ⋮ button next to Play and select Open Folder.
   • This opens the modpack folder in your file explorer.
   • If you don't see any folders, start the modpack at least once first.

📥 Download and Install the Mod

1. Visit Easy NPC - Files and use the Filter by option to select the correct Minecraft version and Modloader.
2. Click the ⋮ button next to the correct file (e.g., easy_npc-forge-1.18.2-6.0.3.jar) and choose Download File.
3. Locate the downloaded .jar file in your downloads folder.
4. Move it into the mods folder of your modpack.
5. Repeat the same process at Easy NPC Config UI - Files to download the matching Config UI .jar.

✅ After downloading both files, you should now have two .jar files in your mods folder.

📌 Note: Alpha files and manually installed mods may not be visible in the CurseForge interface.

💡 If you see multiple versions of the same mod in the folder, delete the older versions to avoid conflicts.

🔄 Step 4: Start the Modpack Again

1. Return to the Minecraft tab.
2. Click on your modpack under My Modpacks.
3. Press the Play button to launch it.

This time, the modpack should start with the Easy NPC mod installed and ready to test.

🧪 Step 5: Extra Mods for Testing (Optional)

For easier testing, you may want to install additional helpful mods:

• 🧾 Just Enough Items (JEI) – Easily browse all items and recipes.
• 🔍 Jade – Display item/block information in-game.
• 🗺️ Xaero’s Minimap – Navigate worlds easily with a minimap.
• 📊 Spark – Analyze and monitor performance issues.

These mods are not required but can greatly assist during testing.

They are usually available in the CurseForge interface and do not require manual installation.

📌 Note: If your modpack fails to load after adding mods, try removing them one by one to identify the conflicting mod.

🌍 Step 6: Set Up a Test World

To test the Easy NPC mod effectively, create a world with the following settings:

• Game Mode: Survival
• Difficulty: Normal
• Allow Cheats: Enabled

Inside the test world, you can:

• Hold down F3, then press F4 to toggle between Creative, Survival, and Spectator modes.

💡 Final Tips

• 🔄 Use separate modpacks for each Minecraft version and Modloader.
• 🧪 Create different worlds for focused tests (e.g., dialog, combat, trade).
• ⚠️ Only install the mods you need—avoid large modpacks unless testing compatibility.

Happy testing! 🎉