# SXD's Random Blocks 🎲

# SXD的随机方块 🎲

## 🌟 Introduction | 介绍

**English:**
Welcome to **SXD's Random Blocks**! This is a creative and fun mod for Minecraft 1.20.1 that adds five unique random blocks to the game. Each block, when broken, drops completely random items - the higher the block tier, the more items you'll get! Perfect for adding surprise elements to your world.

**中文:**
欢迎来到 **SXD的随机方块**！这是一个为 Minecraft 1.20.1 设计的创意趣味模组，添加了五种独特的随机方块到游戏中。每个方块被破坏时都会掉落完全随机的物品 - 方块等级越高，获得的物品越多！非常适合为你的世界增添惊喜元素。

---

## ✨ Key Features | 核心特性

### 🧱 Five Random Blocks | 五种随机方块

| Block | 方块 | Drops | 掉落物 |
|-------|------|-------|--------|
| **Low Random Block** | **低级随机方块** | 1 random item | 1个随机物品 |
| **Medium Random Block** | **中级随机方块** | Up to 10 random items (1-10 types) | 最多10个随机物品（1-10种类型） |
| **High Random Block** | **高级随机方块** | Up to 30 random items (1-30 types) | 最多30个随机物品（1-30种类型） |
| **Top Random Block** | **顶级随机方块** | Up to 64 random items (1-64 types) | 最多64个随机物品（1-64种类型） |
| **Ultimate Random Block** | **终极随机方块** | Up to 128 random items (1-128 types) | 最多128个随机物品（1-128种类型） |

### 🔥 Unique Properties | 独特属性

---

## 🧪 Crafting Recipes | 合成配方

Low Random Block | 低级随机方块

[ ][ ][ ]
[ ][Dirt][ ]
[ ][ ][ ]

### Medium Random Block | 中级随机方块

[Cobblestone][ ][ ]
[ ][Dirt][ ]
[ ][ ][ ]

### High Random Block | 高级随机方块

[Cobblestone][ ][Raw Iron]
[ ][Dirt][ ]
[ ][ ][ ]

### Top Random Block | 顶级随机方块

[Cobblestone][ ][Raw Iron]
[ ][Dirt][ ]
[Raw Gold][ ][ ]

### Ultimate Random Block | 终极随机方块

[Cobblestone][ ][Raw Iron]
[ ][Dirt][ ]
[Raw Gold][ ][Diamond]

---

## 🎲 Advanced Drop System | 高级掉落系统

**English:**
The random drop system is smart and optimized:
- Intelligent item filtering (excludes air, command blocks, barriers, etc.)
- Ensures variety of item types
- Weighted distribution for better randomness
- Stack optimization based on item max stack size

**中文:**
随机掉落系统智能且优化：
- 智能物品过滤（排除空气、命令方块、屏障等）
- 确保物品类型的多样性
- 加权分布以获得更好的随机性
- 基于物品最大堆叠数的堆叠优化

### 📊 Drop Ranges | 掉落范围

| Block Level | 方块等级 | Items | 物品数量 | Types | 类型数量 |
|------------|----------|-------|----------|-------|----------|
| Low | 低级 | 1 | 1 | 1 | 1 |
| Medium | 中级 | 7-10 | 7-10个 | 1-10 | 1-10种 |
| High | 高级 | 20-30 | 20-30个 | 1-30 | 1-30种 |
| Top | 顶级 | 30-64 | 30-64个 | 1-64 | 1-64种 |
| Ultimate | 终极 | 64-128 | 64-128个 | 1-128 | 1-128种 |

---

## 🛠️ Technical Details | 技术细节

### 🏗️ Block Properties | 方块属性

**English:**
- Hardness: 0.6 (same as grass block)
- Explosion Resistance: 3600000.0 (cannot be destroyed by explosions)
- Mining Speed: ~0.9s by hand, ~0.3s with shovel
- Sound: Grass block breaking sound
- Requires correct tool for drops: No (any tool works)

**中文:**
- 硬度：0.6（与草方块相同）
- 爆炸抗性：3600000.0（不会被爆炸破坏）
- 挖掘速度：空手约0.9秒，铲子约0.3秒
- 声音：草方块破坏声音
- 需要正确工具才能掉落：否（任何工具都有效）

### 🔌 Compatibility | 兼容性

**English:**
✅ Compatible with most mods
✅ Includes items from other mods in drops
✅ Doesn't modify vanilla game mechanics
✅ Works in singleplayer and multiplayer

**中文:**
✅ 与大多数模组兼容
✅ 掉落物中包含其他模组的物品
✅ 不修改原版游戏机制
✅ 在单人和多人游戏中均可工作

---

## 🎯 Use Cases | 使用场景

### 🏰 Adventure Maps | 冒险地图
- Random reward systems | 随机奖励系统
- Surprise chests | 惊喜宝箱
- Mystery gifts | 神秘礼物

### 🎮 Survival Servers | 生存服务器
- Economy systems | 经济系统
- Random events | 随机事件
- Fun mechanics | 趣味机制

### 🧪 Creative Builds | 创意建筑
- Decorative elements | 装饰元素
- Interactive builds | 互动建筑
- Game mechanics | 游戏机制

---

## 🔄 Future Plans | 更新计划

### Short-term | 近期计划
- [ ] Config file for drop rates | 掉落率配置文件
- [ ] More block tiers | 更多方块等级
- [ ] Particle effects | 粒子效果

### Long-term | 长期计划
- [ ] JEI/REI integration | JEI/REI集成
- [ ] Random block generator | 随机方块生成器
- [ ] Achievements system | 成就系统

---

## ❓ FAQ | 常见问题

### Q1: Client or server installation? | 客户端还是服务器安装？
**A1:** **Both!** Client for rendering, server for drop logic.
**A1:** **都需要！** 客户端用于渲染，服务器用于掉落逻辑。

### Q2: Explosion proof? | 防爆吗？
**A2:** **Yes!** 3600000.0 explosion resistance.
**A2:** **是的！** 3600000.0爆炸抗性。

### Q3: What tools work? | 什么工具有效？
**A3:** **Any tool** including bare hands. Shovel is fastest.
**A3:** **任何工具**包括空手。铲子最快。

### Q4: Includes modded items? | 包括模组物品吗？
**A4:** **Yes,** if other mods are installed.
**A4:** **是的，** 如果安装了其他模组。

### Q5: Game balance? | 游戏平衡性？
**A5:** This is a **fun/entertainment** mod. Use accordingly.
**A5:** 这是一个**娱乐趣味**模组。请相应使用。

---

## 📊 Statistics | 统计数据

| Item | 项目 | Count | 数量 |
|------|------|-------|------|
| Blocks | 方块 | 5 | 5个 |
| Recipes | 配方 | 5 | 5个 |
| Textures | 纹理 | 5 | 5个 |
| Item Pool | 物品池 | 1000+ | 1000+个 |
| Code Files | 代码文件 | 4 main | 4个主要 |

---

## 👥 Credits | 开发团队

---

## 📜 License | 许可证

**MIT License**

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

**中文:**
MIT 许可证

特此免费授予任何获得本软件及相关文档文件（以下简称"软件"）副本的人不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售本软件的副本，并允许获得本软件的人享有上述权利，但须遵守以下条件：

本软件按"原样"提供，不附带任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因本软件或使用本软件而引起的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权诉讼还是其他诉讼。

---

## 🔗 Links | 相关链接

- [GitHub Forge](https://github.com/SXD35/SXD-Random-Blocks) | GitHub Forge
- [Sponsored Link1](https://afdian.com/a/SXD35) | 赞助链接1

---

## 💖 Support | 支持我们

**English:**
If you enjoy this mod, please:
⭐ Rate on CurseForge
🔗 Share with friends
🐛 Report bugs
💡 Suggest ideas
☕ Sponsor Me

**中文:**
如果您喜欢这个模组，请：
⭐ 在CurseForge评分
🔗 分享给朋友
🐛 报告错误
💡 提出建议
☕ 赞助我

---

**Version | 版本:** 1.1.1
**Last Updated | 最后更新:** 2026年1月
**For | 适用于:** Minecraft 1.20.1 Forge 47.4.10+

Enjoy the randomness! 🎮✨
享受随机乐趣！🎮✨