SXD's Random Blocks

# 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 | 独特属性

- **Easy to Mine** | **易于挖掘** - Same hardness as grass blocks (0.6) | 硬度与草方块相同（0.6）
- **Blast Proof** | **防爆性能** - Extremely high explosion resistance (3600000.0) | 极高的爆炸抗性（3600000.0）
- **Any Tool Works** | **任何工具有效** - Can be broken with any tool (even bare hands) | 可以用任何工具破坏（甚至空手）
- **Unique Crafting** | **独特合成** - Each block has its own crafting recipe | 每个方块都有独特的合成配方

---

## 🧪 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 | 开发团队

- **Developer | 开发者:** SXD, ShanXidi（单熙迪）
- **Textures | 纹理:** SXD, ShanXidi（单熙迪）
- **Testers | 测试:** Community | 社区
- **Special Thanks | 特别感谢:** Minecraft & Forge teams | Minecraft和Forge团队

---

## 📜 License | 许可证

**MIT License**

**English:**  
Copyright (c) 2026 ShanXidi

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 许可证

版权所有 (c) 2026 单熙迪

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

上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中。

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

---

## 🔗 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! 🎮✨  
享受随机乐趣！🎮✨

✨ Mod Overview | 模组概述

A meticulously designed fun mod that adds five tiers of random blocks with varying rarity to your game. Breaking these blocks is like opening a treasure chest full of unknowns—you‘ll receive completely random item drops, from common resources to rare finds! 一个精心设计的趣味模组，为你的游戏添加了 五种具有不同稀有度的随机方块。破坏这些方块就像开启一个充满未知的宝藏——你会获得完全随机的物品掉落，从常见的资源到罕见的宝贝都有可能！

🧩 Core Features | 核心特性

🧱 Five Unique Random Blocks | 五种独特的随机方块

• Low Random Block | 低级随机方块: Drops 1 random item when broken. | 破坏时掉落 1个 随机物品。
• Medium Random Block | 中级随机方块: Drops up to 10 random items (1-10 types). | 破坏时掉落最多 10个 随机物品（1-10种类型）。
• High Random Block | 高级随机方块: Drops up to 30 random items (1-30 types). | 破坏时掉落最多 30个 随机物品（1-30种类型）。
• Top Random Block | 顶级随机方块: Drops up to 64 random items (1-64 types). | 破坏时掉落最多 64个 随机物品（1-64种类型）。
• Ultimate Random Block | 终极随机方块: Drops up to 128 random items (1-128 types). | 破坏时掉落最多 128个 随机物品（1-128种类型）。

⚙️ Smart Technical System | 智能技术系统

• Advanced Random Algorithm | 先进的随机算法: The drop pool includes a vast number of vanilla and modded items, ensuring every break is full of anticipation. | 掉落池包含大量原版及模组物品，确保每次破坏都充满期待。
• Intelligent Item Filtering | 智能物品过滤: Automatically excludes items that should not drop, such as command blocks and barriers. | 自动排除命令方块、屏障等不应掉落的物品。
• Performance Optimized | 性能优化: The drop logic is optimized to minimize game lag. | 掉落逻辑经过优化，尽量避免游戏卡顿。

🛡️ Practical Block Properties | 实用的方块属性

• Easy to Mine | 易于挖掘: Same hardness as grass blocks (0.6), can be mined by hand. | 硬度与草方块相同（0.6），空手即可挖掘。
• Extremely Blast-Resistant | 极致防爆: Has extremely high explosion resistance (3600000.0), cannot be destroyed by any explosion. | 拥有极高的爆炸抗性（3600000.0），任何爆炸都无法摧毁。
• Convenient Acquisition | 便捷获取: Any tool (including bare hands) will drop the block itself when breaking. | 任何工具（包括空手）破坏都会正常掉落方块本身。

🎨 Thoughtful In-Game Integration | 贴心的游戏内集成

• Dedicated Creative Tab | 独立的创造模式分类: All blocks are neatly organized in the "Random Blocks" creative tab. | 所有方块整齐收录在“随机方块”创造模式标签页下。
• Complete Crafting Support | 完整的合成支持: Features progressive crafting recipes, viewable in the recipe book. | 拥有从简到繁的合成配方，并能在合成书中查看。
• JEI/REI Compatible | 兼容JEI/REI: Easy to look up recipes and usages in-game. | 方便在游戏内查询合成与用法。

🧪 Crafting Recipes | 合成配方

All recipes are completed in the crafting table, reflecting a progression from basic to advanced: 所有配方均在工作台中完成，体现了从基础到顶级的进阶设计：

• Low | 低级: 1 Dirt in the center. | 中央放置1个泥土。
• Medium | 中级: Central Dirt + Cobblestone in the top-left. | 中央泥土 + 左上角圆石。
• High | 高级: Central Dirt + Cobblestone top-left + Raw Iron top-right. | 中央泥土 + 左上角圆石 + 右上角粗铁。
• Top | 顶级: Central Dirt + Cobblestone top-left + Raw Iron top-right + Raw Gold bottom-left. | 中央泥土 + 左上角圆石 + 右上角粗铁 + 左下角粗金。
• Ultimate | 终极: Central Dirt + Cobblestone top-left + Raw Iron top-right + Raw Gold bottom-left + Diamond bottom-right. | 中央泥土 + 左上角圆石 + 右上角粗铁 + 左下角粗金 + 右下角钻石。

📥 Installation & Compatibility | 安装与兼容

For detailed information on supported Minecraft versions, mod loaders (Forge, Fabric, etc.), and installation instructions, please see the version info section. 有关支持的Minecraft版本、模组加载器（Forge、Fabric等）及安装说明的详细信息，请查看 版本信息部分。

❓ FAQ | 常见问题

• Q: Will the drops break game balance? | 问：掉落物会破坏游戏平衡吗？ A: This is a mod focused on fun and surprise. We recommend server administrators use it with an understanding of its nature, or control accessibility by adjusting crafting recipes. | 答： 这是一个以趣味和惊喜为核心的模组。我们建议服务器管理员了解其特性后使用，或通过调整合成配方来控制获取难度。
• Q: Does it support items from other mods? | 问：支持其他模组的物品吗？ A: Yes! If other mods are installed, our random drop pool will automatically include their stackable items. | 答： 是的！如果安装了其他模组，本模组的随机掉落池会自动包含其中可堆叠的物品。
• Q: I can‘t find the blocks in Creative mode. | 问：创造模式怎么找不到方块？ A: Please check your creative inventory. We have set up a dedicated "Random Blocks" creative tab category for all our blocks. | 答： 请查看创造模式物品栏。我们为所有随机方块设置了独立的 “随机方块” 分类标签页。

🔗 Links & Support | 链接与支持

• GitHub Repository | 源代码仓库: https://github.com/SXD35/SXD-Random-Blocks
• Issue Tracker | 问题反馈: https://github.com/SXD35/SXD-Random-Blocks/issues
• Sponsored Link1 | 赞助链接1: https://afdian.com/a/SXD35
• License | 许可证: This mod is released under the MIT License. | 本模组采用 MIT 许可证 发布。

Ready to embrace the unexpected? Install the mod now and begin your random adventure! 准备好迎接未知的惊喜了吗？现在就安装模组，开始你的随机冒险吧！