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”菜单确认加载。