模组概述 📖

Simple Magic是一个为Minecraft 1.21.8设计的Fabric模组，版本0.0.6-alpha，为游戏添加了基础魔法系统
🔮。模组提供了多种魔法物品、自定义附魔和魔法生物，让玩家体验简单的魔法玩法 🎮。

主要功能 ⭐

1. 魔法物品系统 🪄

• 魔法之星 ⭐：基础魔法材料，通过击败魔法僵尸获得
• 漂浮魔法棒 🪄：右击生物施加悬浮效果
• 伤害魔法杖 ⚔️：可蓄力造成魔法伤害，支持附魔
• 水晶球 🔮：扫描周围生物，潜行右键可占卜
• 魔法卷轴 📜：右键创建魔法阵
• 魔法指南书 📚：提供模组使用指南

2. 自定义附魔系统 💫

• 蓄能附魔 ⚡：减少魔法杖蓄力时间（最高3级，每级减少20%）
• 伤能附魔 💥：增加魔法杖伤害输出（最高4级，每级+2点伤害）
• 两种附魔互斥，通过激活未激活的附魔书获得 📖
• 附魔书激活系统：未激活的附魔书带有特殊NBT标记，右键激活时播放华丽的粒子效果和音效 🎆

3. 魔法生物 🧟‍♂️

• 魔法僵尸 🧟‍♂️：25点生命值，4点攻击伤害，在光照等级<5的区域生成
• 生成机制：每5秒尝试一次，每个玩家有25%几率触发生成检查 ⏰
• 在玩家周围24-48格范围内定期生成，生成时有30%几率播放魔法粒子效果 ✨
• 特性：与普通僵尸一样会在阳光下燃烧 ☀️

4. 事件处理系统 🔄

• 玩家加入事件 👋：玩家加入服务器时的欢迎消息和模组介绍
• 实体移除事件 🗑️：处理实体被移除时的清理工作
• 物品投掷监听器 🎯：监听玩家投掷物品的事件
• 附魔书激活处理器 📖：处理未激活附魔书的右键激活逻辑

5. 技术特性 ⚙️

• 性能优化 🚀：法阵渲染在远距离时自动停止，粒子效果使用合理的生成频率
• 兼容性 🔗：适用于Minecraft 1.21.8，需要Fabric Loader 0.18.2+和Fabric API 0.136.1+，需要Java 21+
• 代码质量 ✅：使用现代Minecraft组件系统，正确的实体生成和属性设置，完善的错误处理

6. 视觉效果 🎨

• 所有魔法物品都有精心设计的粒子效果和音效 🎆
• 法阵渲染使用复杂的粒子系统，包括外圆、内圆、交杂线条和中心旋转光环 🔮
• 水晶球扫描到的生物会被持续标记显示5秒 👁️
• 魔法僵尸生成时有魔法粒子效果 ✨

游戏体验 🎮

优势 👍

1. 渐进式设计 📈：从简单的魔法星星开始，逐步解锁更复杂的魔法物品
2. 视觉吸引力 🌟：精心设计的粒子效果和音效增强游戏体验
3. 平衡性 ⚖️：合理的冷却时间和耐久度系统避免过度使用
4. 探索价值 🗺️：魔法僵尸的稀有掉落鼓励玩家探索和战斗

挑战 😤

1. 资源获取 💎：魔法星星的获取需要与魔法僵尸战斗
2. 制作成本 💰：高级魔法物品需要大量魔法星星
3. 战斗难度 ⚔️：魔法僵尸增加了游戏挑战性

为什么下载这个模组？🤔

1. 为原版Minecraft添加适度的魔法元素，不破坏游戏平衡 🎯
2. 提供视觉上吸引人的魔法效果和粒子系统 🌈
3. 增加游戏深度，提供新的战斗策略和探索目标 🎲
4. 适合喜欢魔法主题但又不想安装复杂系统的玩家 🧙‍♂️
5. Alpha版本意味着模组仍在开发中，未来可能会有更多功能 🚀

使用须知 ⚠️

1. 需要Fabric Loader 0.18.2+和Fabric API 📦
2. 模组处于Alpha阶段，可能存在未修复的问题 🐛
3. 魔法物品有耐久度限制，需要合理使用 ⏳
4. 魔法僵尸会在黑暗区域生成，建议保持照明 💡
5. 附魔系统需要通过激活未激活的附魔书来使用 📖

未来发展潜力 🔮

作为Alpha版本的模组，Simple Magic有潜力添加更多功能：

• 更多类型的魔法杖和魔法物品 🪄
• 更复杂的魔法系统和法术 📜
• 更多魔法生物和Boss 🐉

---

English Translation 🌍

Simple Magic Mod Description ✨

Mod Overview 📖

Simple Magic is a Fabric mod for Minecraft 1.21.8 (version 0.0.6-alpha) that adds a basic magic system to the game
🔮. The mod provides various magic items, custom enchantments, and magical creatures, allowing players to experience
simple magic gameplay 🎮.

Main Features ⭐

1. Magic Item System 🪄

• Magic Star ⭐: Basic magic material, obtained by defeating Magic Zombies
• Magic Wand - Levitation 🪄: Right-click creatures to apply levitation effect
• Damage Magic Wand ⚔️: Chargeable magic damage, enchantable
• Crystal Ball 🔮: Scans nearby creatures, sneak-right-click for divination
• Magic Circle Scroll 📜: Right-click to create magic circle
• Magic Guide Book 📚: Provides mod usage guide

2. Custom Enchantment System 💫

• Charge Power ⚡: Reduces wand charge time (max level 3, 20% reduction per level)
• Damage Power 💥: Increases wand damage output (max level 4, +2 damage per level)
• Enchantments are mutually exclusive, obtained by activating unactivated enchantment books 📖
• Book activation system: Unactivated books have special NBT markers, right-click activation plays gorgeous
  particle effects and sounds 🎆

3. Magical Creature System 🧟‍♂️

• Magic Zombie 🧟‍♂️: 25 health points, 4 attack damage, spawns in areas with light level < 5
• Spawn mechanism: Attempts every 5 seconds, each player has 25% chance to trigger spawn check ⏰
• Periodically spawns 24-48 blocks around players with 30% chance of magic particle effects ✨
• Features: Burns in sunlight like regular zombies ☀️

4. Event Handling System 🔄

• Player Join Event 👋: Welcome message and mod introduction when players join the server
• Entity Removal Event 🗑️: Handles cleanup when entities are removed
• Item Throw Listener 🎯: Monitors player item throwing events
• Enchantment Book Activation Handler 📖: Handles right-click activation logic for unactivated enchantment books

5. Technical Features ⚙️

• Performance Optimization 🚀: Magic circle rendering auto-stops at long distances, reasonable particle generation
  frequency
• Compatibility 🔗: Compatible with Minecraft 1.21.8, requires Fabric Loader 0.18.2+ and Fabric API 0.136.1+,
  requires Java 21+
• Code Quality ✅: Uses modern Minecraft component system, proper entity spawning and attribute setting,
  comprehensive error handling

6. Visual Effects 🎨

• All magic items have精心 designed particle effects and sounds 🎆
• Magic circle rendering uses complex particle system including outer circle, inner circles, intersecting lines,
  and central rotating halo 🔮
• Creatures detected by Crystal Ball are continuously marked for 5 seconds 👁️
• Magic Zombies have magic particle effects when spawning ✨

Gameplay Experience 🎮

Advantages 👍

1. Progressive Design 📈: Starts with simple Magic Stars, gradually unlocking more complex magic items
2. Visual Appeal 🌟: Carefully designed particle effects and sounds enhance gaming experience
3. Balance ⚖️: Reasonable cooldown times and durability system prevent overuse
4. Exploration Value 🗺️: Rare drops from Magic Zombies encourage exploration and combat

Challenges 😤

1. Resource Acquisition 💎: Magic Stars require battling Magic Zombies
2. Crafting Cost 💰: Advanced magic items require many Magic Stars
3. Combat Difficulty ⚔️: Magic Zombies increase game challenge

Why Download This Mod? 🤔

1. Adds moderate magic elements to vanilla Minecraft without breaking game balance 🎯
2. Provides visually appealing magic effects and particle systems 🌈
3. Increases game depth with new combat strategies and exploration goals 🎲
4. Suitable for players who like magic themes but don't want complex systems 🧙‍♂️
5. Alpha version means the mod is still in development with potential for more features 🚀

Usage Notes ⚠️

1. Requires Fabric Loader 0.18.2+ and Fabric API 📦
2. Mod is in Alpha stage, may have unresolved issues 🐛
3. Magic items have durability limits requiring reasonable use ⏳
4. Magic Zombies spawn in dark areas,建议保持照明 💡
5. Enchantment system requires activating unactivated enchantment books 📖

#✦ Future Development Potential 🔮
As an Alpha version mod, Simple Magic has potential to add more features:

• More types of magic wands and magic items 🪄
• More complex magic systems and spells 📜
• More magical creatures and bosses 🐉