🛒 CUSTOMERS NPC SYSTEM

CUSTOMERS NPC SYSTEM is a dynamic, fully automated NPC shop script for Minecraft built using Scarpet. Designed for survival worlds, farming setups, and multiplayer SMPs, it brings interactive customer NPCs that spawn on designated blocks, display floating holograms for requested items, and automatically trade goods for emeralds.

🔥 Key Features

• 👤 Dynamic NPC Spawning: Checks available Lime Wool blocks every 30 seconds with a 70% chance to spawn a unique customer NPC during daytime hours.
• 🏷️ Floating Hologram Displays: Displays clear, isolated text overlays above each NPC detailing the exact item, quantity requested, and offered emerald payout.
• 🤝 Automated Item & Emerald Trading:
  • Fulfill Requests: Throw the requested items near the customer; the NPC automatically detects the items, consumes them, and drops emerald rewards.
  • Decline Trades: Shift + Right-Click any active customer NPC to send them away if you don't wish to complete their trade.
• ☀️ Day/Night & Behavior Cycle: Customers arrive periodically during the day, look directly at nearby players, perform random animations (jumping/sneaking), and automatically leave at sunset.
• 🔊 Immersive Audio & Visuals: Custom villager sounds, level-up audio cues, and particle explosions upon trade completion or trade cancellation.

🛠️ How to Use

1. Place Lime Wool blocks anywhere in your world to create shop counters.
2. Wait for customer NPCs to arrive during daytime hours (spawns check every 30 seconds with a 70% chance).
3. Drop Items: Throw the requested quantity of items near the NPC to sell them for emeralds.
4. Shift + Right-Click: Sneak-interact with an NPC to reject the trade and despawn them.
5. Use built-in commands: /customers spawn, /customers despawn, or /customers info.

📌 Requirements

• Carpet Mod: Required to run the .sc Scarpet script.
• Player Command Permission: Requires /carpet commandPlayer true (handled automatically on script load).