OraxenOreDrops
基于 Oraxen 的 Minecraft 服务器高级自定义矿石掉落插件。具备智能的精准/抢夺加成缩放功能,提供三种不同的掉落机制以确保游戏平衡。
✨ 特性
- ? 自定义方块掉落 - 配置任意方块掉落自定义 Oraxen 物品
- ? 智能精准加成缩放 - 三种不同的方法来平衡稀有掉落
- ? VeinMiner 支持 - 自动检测并在 VeinMiner 挖掘期间减少掉落
- ? AdvancedEnchantments 集成 - 支持自定义精准/抢夺附魔
- ? 丝触防掉落 - 使用丝之触碰时不产生自定义掉落
- ⚡ 性能优化 - 异步清理任务和高效缓存
- ? 调试模式 - 详细的日志记录用于测试掉落率
? 要求
- 服务器: Paper/Purpur/Pufferfish 1.21+
- 依赖项:
- Java: 21+
? 安装
- 从 Modrinth 下载最新版本
- 将 JAR 文件放入
plugins/ 文件夹
- 如果尚未安装 Oraxen,请安装它
- 重启服务器
- 在
plugins/OraxenOreDrops/config.yml 中配置掉落
⚙️ 配置
基本示例
debug-mode: false
drop-mechanics:
method: HYBRID # DIMINISHING, BONUS_ROLLS, 或 HYBRID
block-drops:
DIAMOND_ORE:
drop1:
oraxen-item: "diamond_shard"
chance: 25.0 # 25% 基础概率
min-amount: 1
max-amount: 3
drop2:
oraxen-item: "rare_gem"
chance: 0.5 # 0.5% 稀有掉落
min-amount: 1
max-amount: 1
掉落机制方法
HYBRID(推荐)
根据稀有度平衡几率增加和额外投掷:
- 常见掉落 (>50%): 主要是几率增加
- 稀有掉落 (<1%): 主要是额外投掷
- 混合掉落表的最佳整体平衡
DIMINISHING
对稀有物品使用对数缩放:
- Fortune I 在 0.1% 掉落上:~0.13% (+0.03%)
- Fortune III 在 0.1% 掉落上:~0.117% (+0.017%)
- 最适合应保持稀有的超稀有掉落
BONUS_ROLLS
额外的掉落尝试而不是增加几率:
- Fortune I 在 0.1% 掉落上:2 次投掷 = ~0.2%
- Fortune III 在 0.1% 掉落上:4 次投掷 = ~0.4%
- 最可预测且平衡
掉落几率指南
| 稀有度 |
几率范围 |
描述 |
精准加成 |
| 常见 |
50-100% |
频繁掉落 |
全额 (+每级 +1%) |
| uncommon |
10-50% |
常规掉落 |
减少 (+每级 +0.5%) |
| 稀有 |
1-10% |
偶尔掉落 |
对数 |
| 极稀有 |
0.1-1% |
罕见掉落 |
平方根 |
| 传说 |
<0.1% |
极其稀有 |
最小化 |
? 命令
| 命令 |
权限 |
描述 |
/oraxenoredrops reload |
oraxenoredrops.reload |
重新加载配置 |
/oraxenoredrops debug <on|off> |
oraxenoredrops.debug |
切换调试模式 |
/oraxenoredrops info |
oraxenoredrops.info |
显示插件信息 |
? 权限
| 权限 |
默认值 |
描述 |
oraxenoredrops.use |
op |
使用插件命令 |
oraxenoredrops.reload |
op |
重新加载配置 |
oraxenoredrops.debug |
op |
切换调试模式 |
oraxenoredrops.info |
true |
查看插件信息 |
? 详细特性
VeinMiner 检测
自动检测 VeinMiner 的使用并将精准等级降低 5 以防止过多掉落。仅在矿脉挖掘会话中处理每第 5 个方块。
AdvancedEnchantments 支持
无缝集成 AdvancedEnchantments 自定义附魔:
- 自定义精准/幸运附魔
- 自定义抢夺附魔
- 自定义丝之触碰附魔
智能精准缩放
掉落几率根据稀有度智能缩放:
- 常见物品获得全额精准加成
- 稀有物品获得减少的精准加成
- 即使拥有精准 X,超稀有物品仍保持稀有
计算示例
常见掉落 (50% 几率)
- 精准 0: 50%
- 精准 III: 53%
- 精准 X: 60%
稀有掉落 (1% 几率)
- 精准 0: 1%
- 精准 III: 1.12%
- 精准 X: 1.35%
超稀有掉落 (0.1% 几率)
- 精准 0: 0.1%
- 精准 III: 0.117%
- 精准 X: 0.133%
?️ 从源码构建
git clone https://github.com/yourusername/OraxenOreDrops.git
cd OraxenOreDrops
mvn clean package
编译后的 JAR 文件将在 target/OraxenOreDrops-1.0.jar
? 错误报告与功能请求
请使用 GitHub Issues 页面报告错误或请求功能。
? 许可证
本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
? 贡献
欢迎贡献!请随时提交 Pull Request。
- Fork 仓库
- 创建您的功能分支 (
git checkout -b feature/AmazingFeature)
- 提交您的更改 (
git commit -m 'Add some AmazingFeature')
- 推送到分支 (
git push origin feature/AmazingFeature)
- 打开 Pull Request
? 致谢
为 Minecraft 社区 ❤️ 制作
OraxenOreDrops
Advanced custom ore drops plugin for Minecraft servers using Oraxen. Features intelligent Fortune/Looting scaling with three different drop mechanics to ensure balanced gameplay.
✨ Features
- ? Custom Block Drops - Configure any block to drop custom Oraxen items
- ? Smart Fortune Scaling - Three different methods to balance rare drops
- ? VeinMiner Support - Automatic detection and reduced drops during VeinMiner usage
- ? AdvancedEnchantments Integration - Support for custom Fortune/Looting enchantments
- ? Silk Touch Prevention - No custom drops when using Silk Touch
- ⚡ Performance Optimized - Async cleanup tasks and efficient caching
- ? Debug Mode - Detailed logging for testing drop rates
? Requirements
- Server: Paper/Purpur/Pufferfish 1.21+
- Dependencies:
- Java: 21+
? Installation
- Download the latest release from Modrinth
- Place the JAR file in your
plugins/ folder
- Install Oraxen if not already installed
- Restart your server
- Configure drops in
plugins/OraxenOreDrops/config.yml
⚙️ Configuration
Basic Example
debug-mode: false
drop-mechanics:
method: HYBRID # DIMINISHING, BONUS_ROLLS, or HYBRID
block-drops:
DIAMOND_ORE:
drop1:
oraxen-item: "diamond_shard"
chance: 25.0 # 25% base chance
min-amount: 1
max-amount: 3
drop2:
oraxen-item: "rare_gem"
chance: 0.5 # 0.5% rare drop
min-amount: 1
max-amount: 1
Drop Mechanics Methods
HYBRID (Recommended)
Balances both chance increase and bonus rolls based on rarity:
- Common drops (>50%): Mainly chance increase
- Rare drops (<1%): Mainly bonus rolls
- Best overall balance for mixed drop tables
DIMINISHING
Uses logarithmic scaling for rare items:
- Fortune I on 0.1% drop: ~0.13% (+0.03%)
- Fortune III on 0.1% drop: ~0.117% (+0.017%)
- Best for ultra-rare drops that should stay rare
BONUS_ROLLS
Additional drop attempts instead of increasing chance:
- Fortune I on 0.1% drop: 2 rolls = ~0.2%
- Fortune III on 0.1% drop: 4 rolls = ~0.4%
- Most predictable and balanced
Drop Chance Guidelines
| Rarity |
Chance Range |
Description |
Fortune Bonus |
| Common |
50-100% |
Frequent drops |
Full (+1% per level) |
| Uncommon |
10-50% |
Regular drops |
Reduced (+0.5% per level) |
| Rare |
1-10% |
Occasional drops |
Logarithmic |
| Very Rare |
0.1-1% |
Seldom drops |
Square root |
| Legendary |
<0.1% |
Extremely rare |
Minimal |
? Commands
| Command |
Permission |
Description |
/oraxenoredrops reload |
oraxenoredrops.reload |
Reload configuration |
/oraxenoredrops debug <on|off> |
oraxenoredrops.debug |
Toggle debug mode |
/oraxenoredrops info |
oraxenoredrops.info |
Show plugin info |
? Permissions
| Permission |
Default |
Description |
oraxenoredrops.use |
op |
Use plugin commands |
oraxenoredrops.reload |
op |
Reload config |
oraxenoredrops.debug |
op |
Toggle debug mode |
oraxenoredrops.info |
true |
View plugin info |
? Features in Detail
VeinMiner Detection
Automatically detects VeinMiner usage and reduces Fortune level by 5 to prevent excessive drops. Only processes every 5th block in a vein mine session.
AdvancedEnchantments Support
Seamlessly integrates with AdvancedEnchantments custom enchantments:
- Custom Fortune/Luck enchantments
- Custom Looting enchantments
- Custom Silk Touch enchantments
Smart Fortune Scaling
Drop chances scale intelligently based on rarity:
- Common items get full Fortune bonus
- Rare items get reduced Fortune bonus
- Ultra-rare items stay rare even with Fortune X
Example Calculations
Common Drop (50% chance)
- Fortune 0: 50%
- Fortune III: 53%
- Fortune X: 60%
Rare Drop (1% chance)
- Fortune 0: 1%
- Fortune III: 1.12%
- Fortune X: 1.35%
Ultra-Rare Drop (0.1% chance)
- Fortune 0: 0.1%
- Fortune III: 0.117%
- Fortune X: 0.133%
?️ Building from Source
git clone https://github.com/yourusername/OraxenOreDrops.git
cd OraxenOreDrops
mvn clean package
The compiled JAR will be in target/OraxenOreDrops-1.0.jar
? Bug Reports & Feature Requests
Please use the GitHub Issues page to report bugs or request features.
? License
This project is licensed under the MIT License - see the LICENSE file for details.
? Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature)
- Commit your changes (
git commit -m 'Add some AmazingFeature')
- Push to the branch (
git push origin feature/AmazingFeature)
- Open a Pull Request
? Credits
Made with ❤️ for the Minecraft community
评论 0
登录后参与评分
还没有评论,来抢沙发吧