---

💎 IdleCraftBasic

A high-performance, lightweight Minecraft plugin that bridges the gap between sessions by granting offline mining and farming rewards. Designed for survival and economy servers that value player retention without sacrificing performance.

---

🧩 Compatibility

• Version: Minecraft 1.21.1+
• Platform: Paper
• Java: 21+
• Build Tool: Maven

---

📦 Features

• ⛏️ Passive Resource Accumulation: Earn materials based on session length and logout duration.
• 🌾 Automated Farming: Simulates crop growth and harvesting while players are away.
• ⚙️ Granular Configuration: Fine-tune reward rates, time caps, and specific item drops.
• 💾 Optimized Footprint: Uses asynchronous calculations to ensure zero impact on MSPT (Milliseconds Per Tick).
• 🔐 Plug-and-Play: Works out of the box with sensible defaults—no permission nodes required.

---

📥 Installation

1. Download the latest idlecraft-basic-1.0.0.jar.
2. Move the file into your server's /plugins/ directory.
3. Restart your server to generate the configuration files.

---

🛠 Developer & Build Instructions

If you want to contribute to the code or compile the JAR yourself using Maven, follow these steps:

1. Clone the Repository

git clone https://github.com/Senpi-Station/IdleCraftBasic.git
cd IdleCraftBasic

2. Build with Maven

Ensure you have Maven installed and your JAVA_HOME points to Java 21.

mvn clean package

3. Locate the JAR

Once the build is successful, your compiled plugin will be found in the target directory: target/idlecraft-basic-1.0.0.jar

---

⚙️ Configuration

The plugin generates a folder at /plugins/IdleCraftBasic/.

config.yml

general:
  max-offline-minutes: 120   # Maximum time rewards accumulate
  reward-multiplier: 1.0     # Global boost for all drops

mining:
  cobblestone-per-minute: 2.0
  coal-per-minute: 0.05

farming:
  items-per-minute: 2.0
  default-crop: WHEAT

players.yml

This file tracks player logout timestamps and pending rewards. Do not edit while the server is running.

---

🎮 How It Works

IdleCraftBasic is designed to be "invisible" to the user until they return:

1. Activity: Players engage in normal gameplay.
2. Logout: The plugin timestamps their exit.
3. Calculation: Upon login, the plugin calculates the time elapsed (up to the max-offline-minutes cap).
4. Reward: A summary message appears, and items are added to the inventory.

---

🛠 Management & Maintenance

Permissions

There are no permissions to manage. The plugin is active for all players by default to maintain a "Basic" and lightweight profile.

Resetting Data

To wipe progress or fix a specific player's data:

1. Stop the server.
2. Open players.yml and remove the player's UUID entry.
3. Restart the server.

---

🎯 Ideal For

• Casual SMPs: Helps players who can't play 24/7 keep up.
• Economy Servers: Provides a steady floor for resource inflation.
• Vanilla+: Adds a "quality of life" feature without breaking immersion.