⚔️ Features & Custom Items

Every item introduces a unique mechanic or utility, shifting how players fight and farm:

• 🪚 Chisel – Tool for builders. Right-click to cycle supported blocks through their decorative variants (Sneak + right-click to cycle backward).
• 🌾 Scythes (Iron/Dia/Neth) – Ultimate farming tools. Automatically harvests and replants ripe crops in an area from 3x3 up to 7x7.
• 🌬️ Wind Blades (Iron/Dia/Netherite) – High-mobility weapons with an active dash ability on right-click.
• 🏰 Greatswords (Iron/Dia/Neth) – Two-handed rhythm weapons. Well-timed swings build stages, unlocking wide sweeping cuts and frontal defense. Requires empty off-hand.
• 🗡️ Katana – High-skill defensive weapon. Right-click triggers a brief parry window that blocks melee and reflects projectiles. Requires empty off-hand.
• 🏹 Crescent Bow – Moon-themed bow firing a 3-arrow horizontal volley. Deals bonus damage at night under open sky.
• 🔱 Crescent Spear – Moon-themed combo weapon. Hits charge a meter; at 100%, the next strike triggers 3 rapid follow-up attacks. Deals bonus damage at night under open sky.
• 🩸 Crimson Sword - A legendary weapon that grows stronger through combat, feeding on the blood of its enemies.

📌 All custom weapons, tools, and mechanics are designed to strictly respect standard region claims and anti-grief plugins.

📂 Looking for Crafting Recipes and Command IDs? Check out the comprehensive ITEMS.md guide on GitHub for full technical details!

---

💾 Installation

1. Download the latest pepeforge-X.Y.Z.jar.
2. Place the JAR file in your server's plugins/ folder.
3. Restart your server to generate the configuration files.
4. Set up the Resource Pack (see below) and enjoy!

---

🎨 Resource Pack & Localization

Pepe's Forge uses a custom Resource Pack for item models, textures, and client-side translations.

Where to get it?

You can always find the matching resource pack in the Assets section of our latest release on GitHub Releases or directly on Modrinth.

⚠️ Critical Note on Client-Side Translations

If translations.use_client_side is enabled in your config.yml, players must have the resource pack loaded. Otherwise, custom item names and lore will appear as raw translation keys (e.g., item.pepeforge.crimson_sword.name).

Recommended setup for server owners:

• To ensure a seamless experience, we highly recommend forcing or automatically distributing the pack via dedicated plugins like ResourcePackManager / ForceResourcePack.

---

⚙️ Configuration

Edit plugins/PepeForge/config.yml to customize your experience.

• Enable or disable specific custom items and recipes.
• Fine-tune localization options.
• Each custom item and its recipe can be configured completely independently.

---

💻 Commands & Permissions

Command	Description	Permission	Default
/pepeforge items	Opens an in-game GUI menu to preview all items.	pepeforge.items	OP
/pepeforge give <item> <player>	Gives a specific custom item to a player.	pepeforge.give	OP

---

🛠️ Issues & Support

While all mechanics and items are thoroughly tested, undiscovered edge cases, exploits, or balancing issues may still occur.

• Found a bug? Please open an issue on the GitHub Issue Tracker.
• Feedback? Suggestions and feature requests are always welcome! Feel free to contribute or share your ideas on GitHub.

---

🚀 Upcoming Content & Roadmap

PepeForge is actively developed, and future updates will expand the selection of tools and weaponry:

• 🔦 Belt Lantern – A wearable, hands-free light source for explorers and miners, illuminating your path without taking up an item slot.
• ☀️ Solar Shield – A sun-infused defensive option. Harness solar energy to unleash radiant counters, perfectly complementing our existing moon-themed weaponry.
• 🔥 More Custom Items – New highly specialized utilities and unique combat gear are currently on the drawing board to further expand your playstyle.