SkiesFarming

# 🌾 SkiesFarming A feature-rich farming progression plugin for Minecraft servers that transforms farming into a rewarding skill-based system. Players gain experience from harvesting crops, level up their farming abilities, and unlock new crops as they progress. ## ✨ Features ### 🎯 **Progression System** - **XP-based leveling** - Gain experience by harvesting mature crops - **Customizable progression** - Choose between LINEAR, EXPONENTIAL, or CUSTOM growth modes - **Persistent data** - Player progress automatically saved to disk - **Visual feedback** - Action bar displays with progress bars and level-up notifications ### 🔓 **Crop Unlocking** Gate which crops a player can plant using one of two modes (`unlock-mode` in `config.yml`): - **`LEVEL`** (default) – players must reach a specific farming level to plant a crop. - **`PERMISSION`** – players must hold a permission node per crop (`skiesfarming.crop.<material>`). Without it, planting is blocked. Great for rank/donor-based progression with permission plugins like LuckPerms. | Crop | Unlock Level | Permission Node | XP per Harvest | |------|--------------|-----------------|----------------| | 🥕 Carrots | 0 | `skiesfarming.crop.carrots` | 4 | | 🥔 Potatoes | 10 | `skiesfarming.crop.potatoes` | 6 | | 🌾 Wheat | 20 | `skiesfarming.crop.wheat` | 8 | | 🌱 Beetroots | 50 | `skiesfarming.crop.beetroots` | 15 | | 🔴 Nether Wart | 100 | `skiesfarming.crop.nether_wart` | 24 | ### 🔄 **Auto-Refarm** - Automatically replants crops after harvesting - Configurable delay (default: 5 seconds) - Optional: Only activate when not using a hoe - Perfect for AFK farming setups ### ⏱️ **Growth Control** - **VANILLA mode** - Standard Minecraft crop growth mechanics - **FIXED mode** - Crops grow at a consistent, configurable rate - Ideal for server economy balancing ### 🛡️ **Crop Protection** - Prevents accidental breaking of immature crops - Requires a hoe to break crops that aren't fully grown - Helps players maximize their XP gains ### 🏆 **PlaceholderAPI Integration** Compatible with PlaceholderAPI for scoreboards, holograms, and more: - `%skiesfarming_level%` - Player's current farming level - `%skiesfarming_top_1%` to `%skiesfarming_top_10%` - Leaderboard entries (format: `PlayerName:Level`) ### 🎁 **Quality of Life** - Auto-pickup of harvested crops - Overflow protection (items drop if inventory is full) - Visual progress bars in action bar - Real-time percentage display ## ⌨️ Commands Base command: `/skiesfarming` (aliases: `/sf`, `/farming`). Requires the `skiesfarming.admin` permission. | Command | Description | |---------|-------------| | `/skiesfarming xp set <player> <amount>` | Set a player's farming XP to an exact amount | | `/skiesfarming xp add <player> <amount>` | Add XP to a player | | `/skiesfarming xp reset <player>` | Reset a player's farming XP to 0 | Targets can be online or offline players (matched by name). Changes are saved immediately. ## 🔑 Permissions | Permission | Default | Description | |------------|---------|-------------| | `skiesfarming.admin` | op | Access to the `/skiesfarming` admin commands | | `skiesfarming.crop.*` | false | Grants every crop permission (used when `unlock-mode: PERMISSION`) | | `skiesfarming.crop.<material>` | false | Allows planting a specific crop, e.g. `skiesfarming.crop.potatoes` | > Crop permissions are only enforced when `unlock-mode` is set to `PERMISSION`. In `LEVEL` mode they are ignored. ## 📋 Requirements - **Minecraft**: 1.15.1 or higher - **Server**: Spigot, Paper, or compatible forks - **Java**: Version 21 or higher - **Optional**: (https://www.spigotmc.org/resources/placeholderapi.6245/) for placeholder support ## 📥 Installation 1. Download the latest release from the (../../releases) page 2. Place `skiesfarming-1.0.jar` in your server's `plugins/` folder 3. Restart your server 4. Configure the plugin (optional - see (#-configuration)) 5. Enjoy! ## ⚙️ Configuration ### config.yml ```yaml # XP earned per mature crop harvested crop-xp: CARROTS: 4 POTATOES: 6 WHEAT: 8 BEETROOTS: 15 NETHER_WART: 24 # How crops are gated before planting: # LEVEL - require a farming level (uses unlock-levels below) # PERMISSION - require permission node skiesfarming.crop.<material> unlock-mode: LEVEL # Farming level required to plant each crop (used when unlock-mode: LEVEL) unlock-levels: CARROTS: 0 POTATOES: 10 WHEAT: 20 BEETROOTS: 50 NETHER_WART: 100 # Auto-refarm settings auto-refarm: enabled: true delay-ticks: 100 # 5 seconds (20 ticks = 1 second) only-when-not-using-hoe: true # Crop growth settings growth: mode: VANILLA # Options: VANILLA or FIXED fixed-grow-ticks: 1200 # 60 seconds (only applies when mode is FIXED) ``` ### levels.yml Choose your preferred progression system: #### LINEAR Growth Fixed XP increase per level: ```yaml growth-mode: LINEAR linear: base: 100 # XP for level 1 increment: