? SkiesFarming
一款功能丰富的 Minecraft 服务器农业进度插件,将农业转变为一种具有回报性的技能驱动系统。玩家通过收获作物获得经验值,提升农业能力等级,并随着进度解锁新作物。
✨ 特性
? 进度系统
- 基于经验的升级 - 通过收获成熟作物获得经验值
- 可自定义的进度曲线 - 可选择线性(LINEAR)、指数(EXPONENTIAL)或自定义(CUSTOM)成长模式
- 持久化数据 - 玩家进度自动保存至磁盘
- 视觉反馈 - 动作栏显示进度条和升级通知
? 作物解锁
通过两种模式之一(在 config.yml 中配置 unlock-mode)限制玩家可以种植的作物:
LEVEL(默认)– 玩家必须达到特定的农业等级才能种植某种作物。
PERMISSION – 玩家必须拥有每种作物对应的权限节点(skiesfarming.crop.<material>)。否则将无法种植。非常适合与 LuckPerms 等权限插件配合,实现基于段位/捐赠者的进度系统。
| 作物 |
解锁等级 |
权限节点 |
每次收获经验值 |
| ? 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)
- 收获后自动重新种植作物
- 可配置的延迟时间(默认:5秒)
- 可选:仅在未使用锄头时激活
- 完美适用于挂机(AFK)农场设置
⏱️ 生长控制
- VANILLA 模式 - 标准 Minecraft 作物生长机制
- FIXED 模式 - 作物以恒定且可配置的速度生长
- 非常适合服务器经济平衡
?️ 作物保护
- 防止意外破坏未成熟的作物
- 需要手持锄头才能破坏未完全长大的作物
- 帮助玩家最大化其经验收益
? PlaceholderAPI 集成
兼容 PlaceholderAPI,可用于计分板、全息图等功能:
%skiesfarming_level% - 玩家当前的农业等级
%skiesfarming_top_1% 至 %skiesfarming_top_10% - 排行榜条目(格式:PlayerName:Level)
? 生活质量改进
- 自动拾取收获的作物
- 溢出保护(如果背包已满,物品会掉落)
- 动作栏中的可视化进度条
- 实时百分比显示
⌨️ 命令
基础命令:/skiesfarming(别名:/sf, /farming)。需要 skiesfarming.admin 权限。
| 命令 |
描述 |
/skiesfarming xp set <player> <amount> |
将玩家的农业经验值设置为指定数值 |
/skiesfarming xp add <player> <amount> |
向玩家添加经验值 |
/skiesfarming xp reset <player> |
重置玩家的农业经验值为 0 |
目标可以是在线或离线玩家(通过名称匹配)。更改会立即保存。
? 权限
| 权限 |
默认值 |
描述 |
skiesfarming.admin |
op |
访问 /skiesfarming 管理命令 |
skiesfarming.crop.* |
false |
授予所有作物的种植权限(当 unlock-mode: PERMISSION 时使用) |
skiesfarming.crop.<material> |
false |
允许种植特定作物,例如 skiesfarming.crop.potatoes |
仅当 unlock-mode 设置为 PERMISSION 时才会执行作物权限检查。在 LEVEL 模式下,这些权限将被忽略。
? 要求
- Minecraft: 1.15.1 或更高版本
- 服务端: Spigot, Paper 或兼容分支
- Java: 版本 21 或更高
- 可选: PlaceholderAPI 用于支持占位符
? 安装
- 从 Releases 页面下载最新版本
- 将
skiesfarming-1.0.jar 放入服务器的 plugins/ 文件夹
- 重启服务器
- 配置插件(可选 - 参见 Configuration)
- 享受游戏!
⚙️ 配置
config.yml
# 每收获一个成熟作物获得的经验值
crop-xp:
CARROTS: 4
POTATOES: 6
WHEAT: 8
BEETROOTS: 15
NETHER_WART: 24
# 种植前对作物的限制方式:
# LEVEL - 需要农业等级(使用下方的 unlock-levels)
# PERMISSION - 需要权限节点 skiesfarming.crop.<material>
unlock-mode: LEVEL
# 种植每种作物所需的农业等级(当 unlock-mode: LEVEL 时使用)
unlock-levels:
CARROTS: 0
POTATOES: 10
WHEAT: 20
BEETROOTS: 50
NETHER_WART: 100
# 自动补种设置
auto-refarm:
enabled: true
delay-ticks: 100 # 5秒 (20 ticks = 1秒)
only-when-not-using-hoe: true
# 作物生长设置
growth:
mode: VANILLA # 选项:VANILLA 或 FIXED
fixed-grow-ticks: 1200 # 60秒 (仅在 mode 为 FIXED 时生效)
levels.yml
选择你偏好的进度系统:
LINEAR 增长
每个等级固定的经验值增加:
growth-mode: LINEAR
linear:
base: 100 # 1级所需经验值
increment: 50 # 每级额外增加的经验值
round-to: 5 # 四舍五入到最接近的5的倍数
示例:1级 = 100 XP, 2级 = 150 XP, 3级 = 200 XP
EXPONENTIAL 增长
基于倍数的进度系统:
growth-mode: EXPONENTIAL
exponential:
base: 100 # 1级所需经验值
multiplier: 1.15 # 每级增加 15%
round-to: 5 # 四舍五入到最接近的5的倍数
示例:1级 = 100 XP, 2级 = 115 XP, 3级 = 132 XP
CUSTOM 等级
手动定义每个等级:
growth-mode: CUSTOM
levels:
1: 100
2: 150
3: 200
4: 300
5: 500
default-per-level: 300 # 未定义等级的后备值
? 用法
对于玩家
- 开始耕作:首先种植并收获胡萝卜(在 0 级即可获取)
- 获取经验值:破坏完全成熟的作物以赚取经验值
- 追踪进度:留意操作栏中的进度条
- 升级:达到新等级以解锁更有价值的作物
- 高级耕作:使用自动重新播种功能以提高耕作效率
提示:
- 只有成熟的作物才会提供经验值
- 如有需要,可使用锄头破坏未成熟的作物
- 高等级作物提供的经验值更多,但需要先提升等级
- 你的进度会自动保存
服务器管理员须知
管理玩家数据:
- 玩家数据存储在
plugins/skiesfarming/players.yml 中
- 格式:基于 UUID,包含经验值和最后已知名称
- 在玩家退出和服务器关闭时自动保存
平衡性建议:
- 调整经验值数值以控制进度速度
- 修改解锁等级以设置门槛
- 使用 FIXED 生长模式以实现可预测的耕作体验
- 调整自动重新播种延迟以优化服务器性能
性能考量:
- 插件资源占用极低
- 自动重新播种使用延迟任务,而非持续检查
- 玩家数据仅在玩家加入时加载
? PlaceholderAPI 示例
记分板
- "&7Farming Level: &a%skiesfarming_level%"
排行榜全息图
- "&6&l⭐ Top Farmers ⭐"
- "&e1. &f%skiesfarming_top_1%"
- "&e2. &f%skiesfarming_top_2%"
- "&e3. &f%skiesfarming_top_3%"
聊天格式
format: "&7[&aLv%skiesfarming_level%&7] &f{PLAYER}: {MESSAGE}"
?️ 路线图
我们正在考虑的未来功能:
- 更多作物类型(西瓜、南瓜、可可豆)
- 带有增益效果的自定义农具
- 团队/公会耕作进度
- 耕作任务与成就
- 供开发者使用的 API
- 支持 SQLite/MySQL 以适应大型服务器
有功能建议?请在 Discord 中提出!
? Bug 报告
发现 Bug?请在 Discord 中报告,并提供以下信息:
- Minecraft 版本
- 服务器软件及版本
- 插件版本
- 复现步骤
- 预期行为与实际行为的对比
- 控制台中的任何错误信息
? 许可证
保留所有权利。本插件按“原样”提供,仅供在 Minecraft 服务器上使用。未经许可,禁止重新分发或修改。
? 作者
- ItzAcat - 首席开发者
- SuperrSohrab - 联合开发者
? 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: PlaceholderAPI for placeholder support
? Installation
- Download the latest release from the Releases page
- Place
skiesfarming-1.0.jar in your server's plugins/ folder
- Restart your server
- Configure the plugin (optional - see Configuration)
- Enjoy!
⚙️ Configuration
config.yml
# 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:
growth-mode: LINEAR
linear:
base: 100 # XP for level 1
increment: 50 # Additional XP per level
round-to: 5 # Round to nearest 5
Example: Level 1 = 100 XP, Level 2 = 150 XP, Level 3 = 200 XP
EXPONENTIAL Growth
Multiplier-based progression:
growth-mode: EXPONENTIAL
exponential:
base: 100 # XP for level 1
multiplier: 1.15 # 15% increase per level
round-to: 5 # Round to nearest 5
Example: Level 1 = 100 XP, Level 2 = 115 XP, Level 3 = 132 XP
CUSTOM Levels
Define each level manually:
growth-mode: CUSTOM
levels:
1: 100
2: 150
3: 200
4: 300
5: 500
default-per-level: 300 # Fallback for undefined levels
? Usage
For Players
- Start Farming: Begin by planting and harvesting Carrots (available at level 0)
- Gain XP: Break fully grown crops to earn experience points
- Track Progress: Watch your progress bar in the action bar
- Level Up: Reach new levels to unlock more valuable crops
- Advanced Farming: Use the auto-refarm feature for efficient farming
Tips:
- Only mature crops give XP
- Use a hoe to break immature crops if needed
- Higher-level crops give more XP but require progression
- Your progress is automatically saved
For Server Administrators
Managing Player Data:
- Player data is stored in
plugins/skiesfarming/players.yml
- Format: UUID-based with XP and last known name
- Automatically saved on player quit and server shutdown
Balancing Tips:
- Adjust XP values to control progression speed
- Modify unlock levels to create gating
- Use FIXED growth mode for predictable farming
- Tune auto-refarm delay for server performance
Performance Considerations:
- Plugin uses minimal resources
- Auto-refarm uses delayed tasks, not continuous checking
- Player data is only loaded when players join
? PlaceholderAPI Examples
Scoreboard
- "&7Farming Level: &a%skiesfarming_level%"
Leaderboard Hologram
- "&6&l⭐ Top Farmers ⭐"
- "&e1. &f%skiesfarming_top_1%"
- "&e2. &f%skiesfarming_top_2%"
- "&e3. &f%skiesfarming_top_3%"
Chat Format
format: "&7[&aLv%skiesfarming_level%&7] &f{PLAYER}: {MESSAGE}"
?️ Roadmap
Future features we're considering:
- Additional crop types (melons, pumpkins, cocoa beans)
- Custom farming tools with bonuses
- Team/Guild farming progression
- Farming quests and achievements
- API for developers
- SQLite/MySQL support for larger servers
Have a feature request? Request it in the Discord!
? Bug Reports
Found a bug? Please report this in the Discord with:
- Minecraft version
- Server software and version
- Plugin version
- Steps to reproduce
- Expected vs actual behavior
- Any error messages from console
? License
All rights reserved. This plugin is provided as-is for use on Minecraft servers. Redistribution or modification without permission is prohibited.
? Authors
- ItzAcat - Lead Developer
- SuperrSohrab - Co-Developer
Made with ❤️ for the Minecraft community
评论 0
登录后参与评分
还没有评论,来抢沙发吧