Описание
# Better Experience
[English](#english) | [中文](#chinese)
---
## English
### 🎮 Enhanced Minecraft Experience
**Better Experience** is a comprehensive Fabric mod designed for Minecraft 1.21.x that significantly enhance your gaming experience by improving the in-game display and mechanics
### ✨ Current Features
#### 🎨 3D Handheld Item Rendering
- **Universal Rendering**: Replace 2D textures of handheld items with their 3D models(You can even replace TNT with creepers!)
- **Flexible Customization**: Scale, rotate, translate, and customize item appearance
- **Multi-Perspective Support**: Independent configuration for first-person and third-person views
- **Entity & Block Rendering**: Choose between entity models or block states for rendering
#### 🛡️ Off-Hand Restriction System
- **Off-Hand Disable**: Disable off-hand item usage to prevent accidental activation
- **Whitelist**: Add items to whitelist to unlock off-hand restrictions
- **Smart Management**: Intuitive GUI for managing whitelisted items
#### Backpack Enhancement
- **R key organizes**: Use the R key to automatically organize containers where the mouse is located
- **Smart Transfer**: Use Shift R to deposit or remove items with one click based on transfer rules
#### 🎛️ Unified Configuration Interface
- **Quick Access**: Press key (configurable in key bindings) or use `/betterexperience config` command
- **Modular Design**: Independent configuration for each module
- **Import/Export**: Share configurations between different Minecraft instances
### 🚀 Future Plans
#### 🔧 Quality of Life Improvements
- **Convenience Box**: Shulker Boxes and Ender Boxes can be opened directly in the backpack
- **Map Teleportation**: Holding the map Shift right-click to teleport to the flag position bound to the map, supporting multi-flag teleportation
- **Auto-Replacement System**: Automatically replace broken tools and depleted blocks
- **Click Enhancement**: Advanced clicking and long-press functionality
- **Sittable Blocks**: Sit on certain blocks (like stairs, slabs) for immersive gameplay
### 🔄 Version Compatibility
- **Minecraft**: supports 1.21.x
- **Mod Loader**: Fabric
- **Java**: 17+
- **If you find a bug, please submit an issue on GitHub with the current version information**
---
## Chinese
### 🎮 增强的Minecraft体验
**Better Experience** 是一个专为Minecraft 1.21.x设计的Fabric模组，通过改善游戏内显示与机制来提升您的游戏体验。
### ✨ 当前功能
#### 3D手持物品渲染
- **通用渲染**: 支持将游戏中手持物品的2d贴图替换成其3D模型
- **灵活自定义**: 缩放、旋转、平移，自定义物品外观(你甚至可以将TNT替换成苦力怕！)
- **多视角支持**: 第一人称和第三人称独立配置
- **实体与方块渲染**: 可选择实体模型或方块状态进行渲染
#### 副手限制系统
- **副手禁用**: 禁用副手物品的使用，防止误触
- **白名单**: 将物品添加到白名单来解锁副手物品的锁定状态
- **智能管理**: 直观的GUI界面管理白名单物品
#### 背包增强
- **R键整理**: 使用R键自动整理鼠标所在位置的容器
- **智能转移**: 使用Shift+R可以根据转移规则将物品一键存入或取出
#### 统一配置界面
- **快速访问**: 通过按键 (可在按键绑定界面更改) 或使用 `/betterexperience config` 命令
- **模块化设计**: 各模块独立配置
- **导入导出**: 在不同Minecraft实例间共享配置
### 🚀 未来计划
#### 🔧 生活质量改进
- **便利盒子**:可以在背包中直接打开潜影盒与末影箱
- **地图传送**：手持地图Shift+右键可以传送到地图绑定的旗帜位置，支持多旗帜传送
- **自动替换系统**: 损坏工具/方块耗尽自动替换
- **连点/长按功能**: 高级点击和长按功能
- **可坐方块**: 坐在特定方块(如台阶，楼梯)上，增强沉浸感
### 🔄 版本兼容性
- **Minecraft**: 支持1.21.x
- **模组加载器**: Fabric
- **Java**: 17+
- **如果发现bug请在github上提交issue并附带当前版本信息**
---
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 👨💻 Author
**Aeolyn** - [GitHub](https://github.com/Tanfreefish)
## 🤝 Contributing
We welcome Issue submissions and Pull Requests!
## 📞 Contact
- GitHub: [@Aeolyn](https://github.com/Tanfreefish)
- Project Homepage: [Better Experience](https://github.com/Tanfreefish/better_experience)
---
## 📝 许可证
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
## 👨💻 作者
**Aeolyn** - [GitHub](https://github.com/Sin-Fish)
## 🤝 贡献
欢迎提交 Issue 和 Pull Request！
## 📞 联系方式
- GitHub: [@Aeolyn](https://github.com/Sin-Fish)
- 项目主页: [Better Experience](https://github.com/Sin-Fish/better_experience)