Better sword(更好的剑-更多附魔)

Better Sword

Project Summary

中文: 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

中文: 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 (裂甲锋刃) | 中文: 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%概率降低盔甲耐久 | 中文: Armored mobs (Ravagers) + bosses (Ender Dragon).
中文: 带甲生物（劫掠兽）+BOSS（末影龙） | 中文: None
中文: 无 | | Soul Drain (灵魂汲取) | 中文: 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. 多余回血转护盾 | 中文: Cave exploration, zombie swarms.
中文: 矿洞探索、僵尸潮 | 中文: None
中文: 无 | | Wind Repel (风域斥退) | 中文: 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%概率风系伤害 | 中文: Prevent melee mobs (Creepers) + high-altitude combat.
中文: 防近战生物（苦力怕）+高空战斗 | 中文: Vanilla "Knockback"
中文: 原版“击退” | | Flame Shackle (焰缚囚笼) | 中文: 1. 10s burn (1 damage/s); 2. -50% movement speed when burning; 3. 2s mob aggro delay.
中文: 1. 10秒灼烧（每秒1伤）；2. 灼烧时移速-50%；3. 生物仇恨延迟2秒 | 中文: Fast mobs (Zombie Villagers) + dark areas.
中文: 高速生物（僵尸村民）+黑暗环境 | 中文: Vanilla "Fire Aspect"
中文: 原版“火焰附加” | | Armor Decay (甲胄腐坏) | 中文: 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% | 中文: Team boss fights, PvP.
中文: 组队打BOSS、PvP | 中文: None
中文: 无 | | Crit Surge (暴击激增) | 中文: 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伤 | 中文: Burst damage + Strength Potions.
中文: 爆发伤害+力量药水 | 中文: None
中文: 无 | | Durability Mend (耐久自补) | 中文: 1. Restores 5 durability/8s (idle); 2. Double speed if durability <20%; 3. No repair resources.
中文: 1. 闲置时每8秒回5耐久；2. 耐久<20%时修复翻倍；3. 无资源消耗 | 中文: Long explorations (End Cities) + less anvil use.
中文: 长期探索（末地城）+减少铁砧使用 | 中文: Vanilla "Unbreaking", "Mending"
中文: 原版“耐久”“经验修补” | | Undead Erase (亡灵肃清) | 中文: 1. +12.5 damage to undead; 2. 100% double drops; 3. -30% undead aggro.
中文: 1. 对亡灵+12.5伤害；2. 100%双倍掉落；3. 亡灵仇恨-30% | 中文: Nether exploration + Wither preparation.
中文: 下界探索+凋灵备战 | 中文: Vanilla "Smite"
中文: 原版“亡灵克星” | | Creeper Restrain (苦力怕禁锢) | 中文: 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秒 | 中文: Base building + resource gathering.
中文: 基地建造+资源收集 | 中文: None
中文: 无 | | Exp Harvest (经验收割) | 中文: 1. +75% XP on kills; 2. +150% XP for elite mobs; 3. 2-block larger XP range.
中文: 1. 击杀+75%经验；2. 精英生物+150%经验；3. 经验范围+2格 | 中文: Early Enchanting Table + late XP farming.
中文: 前期附魔台+后期刷经验 | 中文: None
中文: 无 |

B. 4ConvenientCommands

中文: 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 (示例) | |-----------------------------|---------------------------|----------------| | 中文: Add Enchantment
中文: 添加附魔 | `/bettersword enchant <player> <enchantId> <level>` | 中文: `/bettersword enchant @p blade_armorbreak 5`
中文: `/bettersword enchant @p blade_armorbreak 5` | | 中文: Get Custom Sword
中文: 获取专属剑 | `/bettersword give <player> <material>` | 中文: `/bettersword give @a netherite`
中文: `/bettersword give @a netherite` | | 中文: Reset Enchantments
中文: 重置附魔 | `/bettersword reset <player>` | 中文: `/bettersword reset @p`
中文: `/bettersword reset @p` | | 中文: Get Enchanted Book
中文: 获取附魔书 | `/bettersword givebook <player> <enchantId>` | 中文: `/bettersword givebook Alex soul_drain`
中文: `/bettersword givebook Alex soul_drain` |

2. Compatibility

Installation

A. Environment Metadata

| Item (项目) | Details (详情) | |-------------|----------------| | 中文: Minecraft Version
中文: 游戏版本 | 1.20.1 | | 中文: Supported Loaders
中文: 支持加载器 | 中文: Currently 中文; Fabric coming soon
中文: 当前中文，Fabric即将支持 | | 中文: Required Dependencies
中文: 必装依赖 | 中文: Forge: None
中文: Forge端：无 | | 中文: Supported Environments
中文: 支持环境 | 中文: 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”菜单确认加载。