📖 Getting Started

Minimum Requirements

• RAM: 6GB allocated to Minecraft (8GB system RAM)
• CPU: Intel i5 or AMD equivalent
• GPU: Dedicated graphics card recommended
• Storage: 5GB free space
• Java: Java 17 or newer

Recommended Specifications

• RAM: 8-10GB allocated to Minecraft (16GB system RAM)
• CPU: Intel i7 or AMD Ryzen 5+
• GPU: GTX 1060 / RX 580 or better
• Storage: SSD with 10GB free space

Method 1: Modrinth Launcher (Recommended)

1. Download and install the Modrinth App
2. Open the Modrinth App
3. Click "Browse" and search for "Emerald Nights"
4. Click "Install" on the modpack
5. Wait for the download to complete
6. Click "Play" to launch!

Method 2: Manual Installation

1. Download the Emerald_Nights_1_0_1.mrpack file
2. Open your Minecraft launcher (supports Modrinth, Prism, ATLauncher, etc.)
3. Import the .mrpack file
4. The launcher will automatically set up everything
5. Launch the profile when ready

Method 3: CurseForge/MultiMC

1. Install Fabric Loader 0.18.4 for Minecraft 1.20.1
2. Extract the modpack files to your instance folder
3. Place mods in the mods folder
4. Place resource packs in resourcepacks
5. Place shader packs in shaderpacks

For optimal performance, allocate at least 6GB of RAM to Minecraft:

In Minecraft Launcher:

1. Go to Installations
2. Click the three dots next to Emerald Nights profile
3. Select Edit
4. Click More Options
5. Find the -Xmx argument (usually -Xmx2G)
6. Change it to -Xmx6G (or higher if you have the RAM)
7. Click Save

🎮 Initial Setup

• First launch will take longer - Mods need to initialize
• Configure video settings - Lower render distance if needed
• Enable shaders - Press ESC → Options → Video Settings → Shaders
• Check controls - New keybinds have been added by various mods

⚙️ Performance Optimization

If you experience lag, try these settings:

• Lower render distance to 12-16 chunks
• Set max framerate to 60 FPS
• Disable shaders or use lighter shader packs
• Turn off mipmapping in Video Settings
• Reduce particle effects to "Minimal"

🌙 Survival Tips

Emerald Nights adds new challenges and features:

• Gather resources quickly - Night is more dangerous with new mobs
• Build a shelter - Find or create a safe place before dark
• Explore carefully - New structures contain valuable loot but also dangers
• Craft better weapons - Check the Crafting page for enhanced weapon recipes
• Guard Villagers - Some villages have guards that will help protect you

🗺️ Key Early Game Goals

1. Establish a base near resources
2. Create basic tools and weapons
3. Find a village for trading
4. Explore nearby structures for loot
5. Prepare for the Nether - enhanced with new content

❌ Game Won't Launch

• Verify you have Java 17 or newer installed
• Check that you have Fabric Loader 0.18.4
• Ensure Minecraft version is 1.20.1
• Try allocating more RAM

⚠️ Crashing Issues

• Check crash logs in the crash-reports folder
• Disable shaders if crashes occur with them enabled
• Update graphics drivers
• Remove any additional mods you added

🐌 Low FPS / Lag

• Allocate more RAM (8-10GB recommended)
• Lower video settings (render distance, particles, etc.)
• Disable shaders or use lighter ones
• Close other applications while playing
• Use Sodium's video settings for fine-tuning