Better Sword

Project Summary

English: A Minecraft 1.20.1 mod that enhances sword gameplay with 10 unique enchantments (and enchanted books) + 4 commands. Currently Forge-only; Fabric support coming soon. Preserves vanilla mechanics.
中文: 适用于Minecraft 1.20.1的Mod，新增10种剑专属附魔（含附魔书）+4条指令强化剑玩法。目前仅支持Forge，Fabric支持即将推出，保留原版机制。

Project Description

1. Mod Functions

English: Solves "vanilla sword shallowness" with practical, balanced features (no overpowered effects) that work with vanilla enchantments/items. Suitable for survival and casual play. Key contents:
中文: 解决“原版剑玩法单一”问题，新增实用、平衡的功能（无过强效果），适配原版附魔/物品，适用于生存与休闲玩法。核心内容包括：

A. Enchantments

English: 5 levels per enchantment (linear effect scaling) + matching enchanted books. Obtain via:

• Enchanting Table (Level 10-30 XP)
• Dungeon Chests (5%-12% spawn rate)
• Librarian Villager Trades (5-15 Emeralds)

中文: 每种附魔5级满级（效果随等级线性提升），含对应附魔书。获取方式：

• 附魔台（10-30级经验）
• 地牢宝箱（生成概率5%-12%）
• 图书管理员村民交易（5-15颗绿宝石）

| Enchantment Name (English/中文) | Core Effect (Max Level 5) (满级核心效果) | Applicable Scenarios (适配场景) | Conflicts with Vanilla Enchantments (与原版附魔冲突) |
|--------------------------------|------------------------------------------|--------------------------------|----------------------------------------------------|
| Blade Armorbreak (裂甲锋刃) | English: 1. +6 extra damage to armored mobs; 2. Ignores 25% armor defense; 3. 15% chance to reduce armor durability.
中文: 1. 对带甲生物+6伤害；2. 忽略25%盔甲防御；3. 15%概率降低盔甲耐久 | English: Armored mobs (Ravagers) + bosses (Ender Dragon).
中文: 带甲生物（劫掠兽）+BOSS（末影龙） | English: None
中文: 无 |
| Soul Drain (灵魂汲取) | English: 1. Heals 1.5 HP per hit; 2. +2.5 HP on kill; 3. Excess healing → 1 Absorption HP.
中文: 1. 每击回血1.5；2. 击杀额外回血2.5；3. 多余回血转护盾 | English: Cave exploration, zombie swarms.
中文: 矿洞探索、僵尸潮 | English: None
中文: 无 |
| Wind Repel (风域斥退) | English: 1. Knockback → 3.5 (vanilla: 1.0); 2. Double knockback to flying mobs; 3. 10% chance for 1 wind damage.
中文: 1. 击退距离3.5（原版1.0）；2. 对飞行生物击退翻倍；3. 10%概率风系伤害 | English: Prevent melee mobs (Creepers) + high-altitude combat.
中文: 防近战生物（苦力怕）+高空战斗 | English: Vanilla "Knockback"
中文: 原版“击退” |
| Flame Shackle (焰缚囚笼) | English: 1. 10s burn (1 damage/s); 2. -50% movement speed when burning; 3. 2s mob aggro delay.
中文: 1. 10秒灼烧（每秒1伤）；2. 灼烧时移速-50%；3. 生物仇恨延迟2秒 | English: Fast mobs (Zombie Villagers) + dark areas.
中文: 高速生物（僵尸村民）+黑暗环境 | English: Vanilla "Fire Aspect"
中文: 原版“火焰附加” |
| Armor Decay (甲胄腐坏) | English: 1. "Decay Buff" (5s, max 3 stacks); 2. -45% defense at 3 stacks; 3. +10% damage taken.
中文: 1. “腐坏buff”（5秒，最多3层）；2. 3层时防御-45%；3. 受伤害+10% | English: Team boss fights, PvP.
中文: 组队打BOSS、PvP | English: None
中文: 无 |
| Crit Surge (暴击激增) | English: 1. 20% crit chance (vanilla: 5%); 2. 200% crit damage (vanilla: 150%); 3. 20% "Critical Strike" (+2 damage).
中文: 1. 暴击概率20%（原版5%）；2. 暴击伤害200%（原版150%）；3. 20%“会心”+2伤 | English: Burst damage + Strength Potions.
中文: 爆发伤害+力量药水 | English: None
中文: 无 |
| Durability Mend (耐久自补) | English: 1. Restores 5 durability/8s (idle); 2. Double speed if durability <20%; 3. No repair resources.
中文: 1. 闲置时每8秒回5耐久；2. 耐久<20%时修复翻倍；3. 无资源消耗 | English: Long explorations (End Cities) + less anvil use.
中文: 长期探索（末地城）+减少铁砧使用 | English: Vanilla "Unbreaking", "Mending"
中文: 原版“耐久”“经验修补” |
| Undead Erase (亡灵肃清) | English: 1. +12.5 damage to undead; 2. 100% double drops; 3. -30% undead aggro.
中文: 1. 对亡灵+12.5伤害；2. 100%双倍掉落；3. 亡灵仇恨-30% | English: Nether exploration + Wither preparation.
中文: 下界探索+凋灵备战 | English: Vanilla "Smite"
中文: 原版“亡灵克星” |
| Creeper Restrain (苦力怕禁锢) | English: 1. Stops Creeper detonation (15-block radius); 2. Creepers stay 3 blocks away; 3. +5s detonation timer on hit.
中文: 1. 15格内苦力怕停爆；2. 苦力怕保持3格距离；3. 攻击延长爆时5秒 | English: Base building + resource gathering.
中文: 基地建造+资源收集 | English: None
中文: 无 |
| Exp Harvest (经验收割) | English: 1. +75% XP on kills; 2. +150% XP for elite mobs; 3. 2-block larger XP range.
中文: 1. 击杀+75%经验；2. 精英生物+150%经验；3. 经验范围+2格 | English: Early Enchanting Table + late XP farming.
中文: 前期附魔台+后期刷经验 | English: None
中文: 无 |

B. 4ConvenientCommands

English: Requires cheat mode (survival: /gamemode creative; servers: admin permissions). Supports selectors (@p/@a/@r) or usernames.
中文: 需开启作弊（生存：/gamemode creative临时开启；服务器：管理员权限）。支持选择器（@p/@a/@r）或用户名。

| Command Function (指令功能) | Command Format (指令格式) | Example (示例) |
|-----------------------------|---------------------------|----------------|
| English: Add Enchantment
中文: 添加附魔 | /bettersword enchant <player> <enchantId> <level> | English: /bettersword enchant @p blade_armorbreak 5
中文: /bettersword enchant @p blade_armorbreak 5 |
| English: Get Custom Sword
中文: 获取专属剑 | /bettersword give <player> <material> | English: /bettersword give @a netherite
中文: /bettersword give @a netherite |
| English: Reset Enchantments
中文: 重置附魔 | /bettersword reset <player> | English: /bettersword reset @p
中文: /bettersword reset @p |
| English: Get Enchanted Book
中文: 获取附魔书 | /bettersword givebook <player> <enchantId> | English: /bettersword givebook Alex soul_drain
中文: /bettersword givebook Alex soul_drain |

2. Compatibility

Installation

A. Environment Metadata

| Item (项目) | Details (详情) |
|-------------|----------------|
| English: Minecraft Version
中文: 游戏版本 | 1.20.1 |
| English: Supported Loaders
中文: 支持加载器 | English: Currently Forge 47.1.0+; Fabric coming soon
中文: 当前Forge 47.1.0+，Fabric即将支持 |
| English: Required Dependencies
中文: 必装依赖 | English: Forge: None
中文: Forge端：无 |
| English: Supported Environments
中文: 支持环境 | English: Client (visuals/effects); Server (full support)
中文: 客户端（特效/界面）；服务端（完全支持） |

B. Installation Steps (安装步骤)

English:

1. Install Minecraft 1.20.1 + Forge 47.1.0+ (follow official guides).
2. Download the mod (.jar) from Modrinth.
3. Place the mod into the .minecraft/mods folder (create if missing).
4. Launch Minecraft with Forge profile; confirm load via "Mods" menu.

中文:

1. 安装Minecraft 1.20.1 + Forge 47.1.0+（参考官方教程）。
2. 从Modrinth下载Mod（.jar格式）。
3. 将Mod放入.minecraft/mods文件夹（不存在则新建）。
4. 用Forge配置文件启动游戏，通过“Mods”菜单确认加载。