Emerald Essentials

Multi-loader ✦ Balanced Progression ✦ Vanilla-faithful
Emerald tools, balanced armor, subterranean flora, and amethyst enchantments for Minecraft 1.21.1 on Fabric and NeoForge.

About ✦ Features ✦ Installation ✦ Usage ✦ Architecture ✦ Contributing

---

About

Emerald Essentials brings purposeful utility to emeralds, amethysts, and rubies in modern Minecraft.

While vanilla emeralds serve primarily as trading currency and amethysts remain largely decorative, Emerald Essentials integrates them directly into survival progression through carefully balanced gear, subterranean flora, alchemy, and unique mechanics without overshadowing endgame tiers.

The mod functions across both Fabric and NeoForge using a single shared codebase with native 1.21.1 data-driven mechanics.

Philosophy

"Meaningful utility without power creep."

This is a Devil Doll Entertainment project, part of the Sxnnyside Project.

Features

• Emerald Equipment: Complete tier of emerald tools, stealth daggers with backstab synergy, bows, shields, and high-enchantability armor.
• Ruby Mineral Tier: Subterranean ruby ore, blocks, tools, armor with knockback resistance, and geothermal transmutation.
• 13 Magical Flora Blocks: Subterranean and dimensional flora with contact effects, soft luminescence, and alchemy paths.
• Dedicated Amethyst Altar: Standalone infusion table for infusing equipment with amethyst enchantments using shards and XP.
• Subterranean Fauna & Boss: Animated creatures (Emerald Scuttler, Amethyst Scarab, Mushroom Bup, Mantabu) and the seismic Emerald Titan boss.
• Endgame Artifacts: Legendary Crown of the Gem Lord, Earth Staff, Emerald Mirror, and Amethyst Resonator.
• Native Multi-Loader: Single shared :common engine running natively on Fabric and NeoForge 1.21.1.
• 18 Languages Supported: Full in-game translations and dual effect/lore tooltips across 18 languages.

Installation

Prerequisites

• Java 21 or later
• Minecraft 1.21.1
• Fabric Loader (>=0.16.0) with Fabric API, or NeoForge (>=21.1.0)

From Source

git clone https://github.com/devil-doll-entertainment/emerald-essentials.git
cd emerald-essentials

just build

The compiled mod JARs will be located in:

• Fabric: fabric/build/libs/emerald-essentials-fabric-1.1.0.jar
• NeoForge: neoforge/build/libs/emerald-essentials-neoforge-1.1.0.jar

Usage

# Verify environment, toolchain, and configure git hooks
just install

# Launch Fabric development client
just dev

# Launch NeoForge development client
just dev-neoforge

# Run full quality gate
just check

Architecture

emerald-essentials/
├── common/       # Shared game logic, registries, data packs, recipes, and assets
├── fabric/       # Fabric Loader entrypoint, Fabric API integration, client rendering
└── neoforge/     # NeoForge entrypoint and event bus listeners

For a detailed breakdown, see ARCHITECTURE.md.

Contributing

Contributions are accepted. See CONTRIBUTING.md for guidelines.

Before contributing, read the Code of Conduct.

License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Emerald Essentials — A Devil Doll Entertainment Project
© 2025 Sxnnyside Project