⚔️ Custom Weapons & Tools

Every item in Pepe's Forge introduces a unique mechanic or utility, shifting how players fight and farm. Click on any item below to expand its details:

🪚 Chisel – Block Cycler

Tool for builders. Right-click to cycle supported blocks through their decorative variants (Sneak + right-click to cycle backward).

🌾 Scythes (Iron/Dia/Neth) – Area Harvest

The ultimate farming tool. Automatically harvests and replants ripe crops in an area (from 3x3 up to 7x7 depending on tier) in a single click.

🌬️ Wind Blades (Iron/Dia/Neth) – Speed & Dash

High-mobility weapons. Grants a passive speed boost while held, speed bursts on hit, and a right-click dash ability (5-second cooldown).

🏰 Greatswords (Iron/Dia/Neth) – Two-Handed Rhythm

A heavy two-handed sword. Time your swings rhythmically to build momentum, unlocking wide sweeping attacks, bonus damage to nearby enemies, and a frontal shield deflection. Requires your off-hand to be empty.

🗡️ Katana – Parry & Reflect

A high-skill defensive sword. Right-click at the perfect moment to block incoming melee attacks and reflect arrows or other projectiles back at attackers. Requires your off-hand to be empty.

🏹 Crescent Bow – Spread Volley

A moon-themed bow that fires a 3-arrow horizontal spread volley while consuming only 1 arrow. Deals less damage during the day, but gains +2 bonus damage under the open night sky.

🔱 Crescent Spear – Rapid Combo Strikes

A combo weapon. Land hits to charge your spear; at 100%, your next attack triggers 3 rapid follow-up strikes. Deals bonus damage under the open night sky.

☀️ Solar Shield – Sun-Charged Counter

A legendary defensive shield. Automatically charges up to 3 times while held in direct sunlight. Blocking a hit consumes a charge to ignite your attacker and blind them with a solar flashbang.

🩸 Crimson Sword – Combat Progression & Lifesteal

A legendary sword that levels up through combat. Feeding on enemies increases its damage, grants passive lifesteal, and unlocks a blood-draining aura.

⚓ Anchor – Snare & Pull

A heavy marine weapon. Left-click attacks apply a Snare effect to freeze targets, wrapping their feet in coral. Right-click throws the anchor to pull yourself to blocks or pull enemies towards you.

🗡️ Throwing Knife – Consumable Ranged Weapon

A consumable ranged weapon perfect for finishing off fleeing enemies or opening a fight from a distance. Can be thrown rapidly with a short cooldown.

📌 All custom weapons, tools, and mechanics are designed to strictly respect land claims and anti-grief protections.

📂 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. Drop it into your server's plugins/ folder.
3. Restart the server to generate configurations.
4. Set up the Resource Pack (see below) and play!

---

🎨 Resource Pack & Language

Since version 1.2.0, Pepe's Forge uses Minecraft's modern model system. It is compatible with most Minecraft plugin server engines (Paper, Purpur, Spigot, Folia, etc.) on version 1.21.11+.

• Mandatory Resource Pack: Players must have the resource pack loaded. Because custom items use a dedicated visual namespace, they will render as purple-black missing texture cubes without it.
• 📥 Download Resource Pack: Get the resource pack ZIP from the latest release assets on Modrinth or GitHub.
• Paper / Purpur / Folia (Client-side translation): Item names and descriptions automatically match each player's Minecraft client language. Note: If you do not have the resource pack loaded on Paper, text will show up as raw translation keys (like item.pepeforge.katana.name).
• Spigot / CraftBukkit (Server-side translation): Item names and descriptions will display directly in the server's default language (defined in configurations), even if a player does not have the resource pack loaded.

---

🔄 Updates & Configuration

• Updates are safe: When updating from older versions, all existing items in chests and inventories will be automatically updated on the fly.
• Configurable: Edit plugins/PepeForge/config.yml to toggle specific items, disable recipes, or customize language settings.

---

💻 Commands

Command	Description	Permission	Default
/pepeforge items	Opens an in-game GUI menu to preview all items.	pepeforge.items	OP
/pepeforge config	Opens an in-game GUI menu to toggle items and recipes.	pepeforge.config	OP
/pepeforge reload	Reloads the plugin configuration.	pepeforge.reload	OP
/pepeforge give <item> <player>	Gives a specific custom item to a player.	pepeforge.give	OP
/pepeforge setlevel <level>	Sets the level of the Crimson Sword in hand.	pepeforge.setlevel	OP

---

❓ FAQ

Q: Will my items break when I update the plugin? A: No! The plugin automatically modernizes existing items on the fly.

Q: Does client-side translation work on Spigot? A: No. Spigot and CraftBukkit do not support client-side translations. For these platforms, item names will display in the server's default language.

Q: Does the Resource Pack conflict with other texture packs? A: No. Because our pack uses the modern model system, it completely avoids overwriting vanilla items. This makes it highly compatible with other texture packs!

---

🛠️ Support & Community

While all items are thoroughly tested, issues may still occur.

• Found a bug? Please report it on our GitHub Issue Tracker.
• 💡 Suggestions & Feedback: Share your ideas in Pepe's Forge on Discord.
• 💬 Community & Support: Join us on Discord: https://discord.gg/uPbSacDx4k

Every suggestion and bug report helps improve Pepe's Forge.