The four primitives and Weapons

ATTENTION / 注意
一部の機能を使用するには、ワールド設定でチート（コマンド）を有効にする必要があります。
某些功能可能需要在世界设置中启用作弊（命令）。

---

四种基础属性与武器

鎧を貫け。日頃の鬱憤を敵にぶつけろ。
击穿护甲，把平日积攒的怨气发泄到敌人身上。

---

このModは日本人学生のチームによって作られています。英語の説明が不自然な箇所があるかもしれません。ご了承ください。
本模组由一支日本学生团队制作。英文描述可能有些不自然，敬请谅解！

---

📦 概要 / 概述

武器・防具・鞘システムをMinecraftに追加するModです。
氷・電気・侵食・聖・闇・火・風・雷・水・瘴気 ・血・消滅・霊魂・霊火 の 14種類の属性 を武器に宿らせ、敵の防御を貫いて日頃の鬱憤を晴らしましょう！

为 Minecraft 添加武器、防具和刀鞘系统。
驾驭14种属性——冰、电、侵蚀、圣、火、风、水、雷、暗、瘴气、血、消灭、灵魂和灵火——击穿敌人的防御！

✨ 主な特徴 / 主要特色

• 🗡️ 多彩な武器 / 丰富武器 — 直刀・刀・大太刀・魔法武器など、複数の独自武器を追加 / 新增武士刀、长剑、魔法武器等多种独特武器
• 🛡️ 鞘システム / 刀鞘系统 — 抜刀・納刀のアクションで戦闘に没入感を / 通过拔刀与收刀动作，体验更沉浸的战斗
• 🌈 14種の属性 / 14种属性 — それぞれが独自の効果を持つ14種類の属性 / 14种各具独特效果的属性
• 🛡️ カウンター属性システム / 属性克制系统 — 本スロットの魔導書で属性ダメージを無効化 / 在副手栏位持有对应的魔导书，即可免疫属性伤害
• 🎯 スキルカスタマイズ / 技能自定义 — 武器ごとに攻撃モーションを自由に組み合わせ / 为不同类型的武器自由组合攻击动作
• ⚔️ カスタム難易度 / 自定义难度 — creative+ から nightmare・lunatic_extreme まで多彩な難易度 / 提供多种难度，从 creative+ 到 nightmare 和 lunatic_extreme
• 👥 戦闘AIを持つ敵Mob / 拥有战斗AI的敌对生物 — 回避・チャージ・ガードを使いこなす一般兵 / 普通士兵会灵活使用闪避、冲锋和格挡
• 🗃️ 武器ラック / 武器架 — お気に入りの武器を飾れる装飾ブロック / 用于展示心爱武器的装饰方块

---

バージョン6の追加機能 / 版本6新增内容

• ファンタジーマント / 奇幻斗篷 — Curiosのマントスロットに装備し、Rキーの選択から防御・刺突を使えます。マント装備中も抜刀・納刀を選べます。 / 将其装备在 Curios 的斗篷栏位中，并通过 R 键轮盘选择格挡或突刺。穿戴斗篷时仍可拔刀和收刀。
• 布でいなす防御 / 斗篷招架 — 利き手側へマントを回していなし、布が背中へ戻ります。近接攻撃と投射物を防ぎますが、ポーションや魔法・環境ダメージは防ぎません。 / 将斗篷绕过惯用手侧进行招架，随后斗篷会回到背后。可以抵挡近战攻击和投射物，但无法抵挡药水、魔法或环境伤害。
• 空いた手で刺突 / 空手突刺 — 空いた側の腕にマントを巻き付けて突きます。両手にアイテムがあると使用できません。マント自身の攻撃系エンチャント・属性を反映します。 / 将斗篷缠绕在空着的手臂上进行突刺。需要一只手为空；斗篷自身的攻击类附魔和属性会生效。
• 一人称・三人称アニメーション / 第一人称与第三人称动画 — 防御・刺突の布と腕の動きを両視点に反映。 / 在两种视角下都能看到格挡和突刺时的布料与手臂动作。
• 追加属性と装備 / 更多属性与装备 — 血・消滅・霊魂・霊火、ダガーと専用鞘、投げナイフなどを追加・拡張。 / 新增并扩展血、消灭、灵魂、灵火等属性，以及匕首、专用刀鞘和飞刀等装备。

初期設定のCT / 默认冷却时间： マント防御3秒・刺突1秒 / 斗篷格挡：3秒；突刺：1秒。

---

TiCEX連携：刀身の鋳造 / TiCEX 联动：铸造刀身

TiCEXとTinkers’ Constructを併用すると、素材付きの刀身と金の鋳型を追加します。

1. 使用部件构建台，以3份材料制作刀身。
2. 在铸造台中向刀身浇注90mB熔融金，制作可重复使用的金质铸模（原刀身会被消耗）。
3. 向铸模中浇注相当于3份材料的对应熔融金属，铸造刀身。
4. 在工作台上将刀身与木棍组合，制作本模组的刀，并继承材料的攻击力和耐久度。

四部件武士刀 / 四部件武士刀： 分别制作刀柄、护手、刀首和刀身，再使用匠魂铁砧（高级工具站）组装。每个部件都会保留其材料与特性。普通工具站只有3个输入槽，因此这套四部件结构需要使用铁砧。

分别制作刀身、刀柄、护手和刀首，然后在匠魂铁砧上组装成四部件武士刀。成品会保留每个部件的材料与特性。普通的工具站只有3个输入槽。

安装 TiCEX 和 Tinkers’ Construct 后，在零件制造台制作一片刀刃，再浇注 90 mB 金液，制成可重复使用的铸模；随后用三份熔融金属铸造刀刃。将刀刃与木棍合成，即可制作本模组的武士刀，其攻击力和耐久度取决于所用材料。组装时使用工作台，而不是工具站。

---

📖 遊び方 / 如何游玩

基本操作 / 基本操作

操作 / 动作	方法 / 按键
通常攻撃 / 普通攻击	主手持有武器时左键点击
チャージ攻撃 / 蓄力攻击	主手持有武器时长按左键
回避 / 闪避	副手持有刀鞘时右键点击，或主手持有武器时右键点击

🎯 スキルセレクション / 技能选择

在专用界面中，可自由组合分配给 第1击 / 第2击 / 第3击 / 蓄力 / 冲刺 / 右键 / Shift+右键 等动作的技能（突刺、左上斩、旋转斩、下劈、冲刺突袭、跃斩、暗影步、防御等）。每种武器类型（武士刀 / 刺剑 / 直剑 / 剑 / 巨剑 / 匕首 / 盾牌 / 弓 / 弩 / 投掷武器 / 三叉戟）都可以保存独立的配置。

打开 技能选择界面，自定义各动作栏位（第1/2/3击、蓄力、冲刺、右键、Shift+右键）触发的招式。每种武器类别——武士刀、刺剑、直剑、剑、巨剑、匕首、盾牌、弓、弩、投掷武器、三叉戟——都有独立的配置。

✨ 特殊招式

风暴物品等物品放入书籍栏（魔法书栏）后，使用魔法妖精武士刀或魔法武士刀进行蓄力攻击，即可发动特殊招式！

将风暴物品（或类似物品）放入书籍栏（魔法书栏），然后使用魔法妖精武士刀或魔法武士刀进行蓄力攻击，即可触发强力的特殊招式！

---

🛡️ 鞘システム / 刀鞘系统

每种武器都有专属的刀鞘（Saya），可装备在 Curios 的腰带 / 背部栏位。将武器收刀入鞘后，可在工具提示中查看当前收纳的武器。

每种武器都有专属的刀鞘（Saya），可装备在 Curios 的腰带 / 背部栏位。武器收刀入鞘后，工具提示会显示当前收纳的武器。

---

🌪️ 属性システム / 元素系统

本模组共有14 种元素属性，各自拥有独特效果，效果会随等级提升而增强。
本模组包含14 种元素属性，每种属性都有独特效果，且效果会随等级提升而增强。

氷 / 冰

对被冻结的敌人造成额外伤害，并施加缓慢效果。
对被冻结的敌人造成额外伤害，并施加缓慢效果。

• 基础倍率：1.5×（每级 +0.25×）
• 缓慢效果持续期间，额外加成最高为 +0.5×

電気 / 电

在水中造成范围伤害。敌人穿戴的导电护甲越多，伤害越高。
在水中触发范围伤害。对穿戴导电护甲的敌人造成额外伤害。

• 基础倍率：1.2×
• 在水中：1.5×
• 每件导电装备：+0.3×

侵食 / 腐蚀

每次攻击都会削弱敌人的护甲。高等级时还会施加凋零效果。
每次命中都会降低敌人的护甲。高等级时还会施加凋零效果。

• 基础倍率：1.1×
• 护甲降低：−(2.0 + 伤害 × 0.5)

聖 / 神圣

对亡灵造成大量额外伤害。高等级时还会点燃敌人。
对亡灵造成大量额外伤害。高等级时还会点燃敌人。

• 基础倍率：1.1×
• 对亡灵：2.5×（每级 +0.3×）

闇 / 暗影

暗处（光照等级≤7）可获得大幅伤害加成。施加失明效果，高等级时还会造成专属持续伤害（DoT）。

• DoT触发等级：Lv3+
• DoT伤害：0.5/刻 + 每级+0.5

火 / Fire

命中时点燃目标。等级越高，燃烧时间越长。
命中时点燃目标。等级越高，燃烧时间越长。

• 燃烧时间：3秒 + 每级2秒

风 / Wind

攻击时为自身（攻击者）施加力量增益。在连续战斗中，伤害会不断提升。
命中时为攻击者施加力量增益。战斗持续越久，伤害越高。

• 增益持续时间：5秒 + 每级2秒
• 攻击加成：+20% + 每级+10%

雷 / Thunder

与电属性类似，可在水中造成范围伤害。对穿戴导电装备的敌人也能造成额外伤害。

水 / Water

对敌人施加强力的缓慢 II效果，使其行动能力大幅受限。

• 缓慢效果持续时间：4秒 + 每级2秒

瘴气 / Miasma

可阻止敌人恢复生命并造成持续伤害（DoT）。治疗药水和金苹果都会失效，是一种极具策略性的属性。
阻止敌人恢复生命并造成持续伤害。治疗药水和金苹果都会失效——这是一种极具策略性的属性。

• 阻止恢复持续时间：5秒 + 每级3秒
• DoT持续时间：3秒 + 每级2秒

---

额外四种属性

血（Blood）、消灭（Erasure）、灵魂（Soul）和灵魂之火（Soul Fire）也可使用。不同属性拥有专属效果和魔导书。请查看游戏内提示，确认装备附加的属性。

血、消灭、灵魂和灵魂之火也可使用，每种属性都有专属效果和魔导书。请查看游戏内提示，确认装备附加的属性。

---

🛡️ 属性反制系统

在魔导书槽位中装备反制属性魔导书，即可免疫对应属性造成的伤害。这套系统为模组内的战斗增添了策略博弈。

在魔导书槽位中装备反制属性魔导书，即可抵消受到的属性伤害。这为战斗增添了丰富的策略性。

受到的属性	反制属性
冰 / Ice	火 / Fire
火 / Fire	水 / Water
电 / Electric	风 / Wind
雷 / Thunder	风 / Wind
腐蚀 / Corrosion	水 / Water
圣 / Holy	暗 / Dark
暗 / Dark	圣 / Holy
水 / Water	雷 / Thunder
风 / Wind	冰 / Ice
瘴气 / Miasma	圣 / Holy

---

⚔️ 自定义难度

除了原版的 easy / normal / hard 外，本模组还新增了多种自定义难度，可通过命令切换。
除了原版的 easy / normal / hard 外，本模组还新增了多种自定义难度，可通过命令切换。

难度	说明
creative+	自由度甚至高于创造模式
peaceful	和平
easy	与原版一致
normal	与原版一致
hard	与原版一致
realistic	真实向战斗调整
lunatic	高难度
lunatic+	更高难度
lunatic_extreme	极高难度
nightmare	噩梦级别

切换命令：

/gamerule difficulty <難易度名>

---

👤 普通士兵 / 普通士兵

拥有类似玩家战斗 AI 的敌对生物。会使用闪避、蓄力攻击和格挡技能。
拥有类似玩家战斗 AI 的敌对生物——会像真正的玩家一样闪避、蓄力攻击和格挡。

属性	数值
生命值	40
攻击力	5
护甲值	4（相当于铁装备）
闪避成功率	30%
蓄力率	50〜80%

召唤命令：

/summon the_four_primitives_and_weapons:common_soldier ~ ~ ~

---

🧪 状态效果的运用

给生物施加状态效果可以削弱其 AI（不会影响玩家）。
给生物施加状态效果可以削弱其 AI。这些效果不会影响玩家。

效果	主要影响
失明	视野−70%・移动速度−30%・闪避有70%概率失败 / 视野−70%，速度−30%，闪避有70%概率失败
反胃	闪避方向随机・蓄力瞄准方向偏移±45° / 闪避方向随机，蓄力瞄准偏移±45°
虚弱	攻击力−4（在原版效果基础上额外降低）/ 攻击力−4（额外叠加在原版效果之上）
黑暗	视野−50%・蓄力范围−50% / 视野−50%，蓄力范围−50%

效果可以叠加。同时施加失明＋反胃＋虚弱，几乎会让 AI 完全无法运作。
效果可以叠加。组合失明＋反胃＋虚弱，几乎会彻底瘫痪 AI。

/effect give @e[type=!minecraft:player,distance=..10] minecraft:blindness 30 0

---

💻 运行环境

• Minecraft: 1.20.1
• 模组加载器: Forge 47.4.0（Minecraft 1.20.1）
• Java: 17
• 必需： Curios API 5.14.1 或更高版本
• 可选： JEI、匠魂（用于制作素材武器、刀的部件和铸造；还需要安装 Mantle 等必需前置）。即使不安装 TiCEX，也可以使用素材联动
• 客户端：必需
• 服务器：支持

---

📥 安装方法

1. 准备 Java 17、Minecraft Forge 1.20.1 和 Curios API
2. 将本模组的 .jar 文件放入 mods 文件夹.jar 文件放入你的 mods 文件夹
3. 启动 Minecraft
4. 创建地图，开始战斗吧！

---

📜 许可证

本项目基于 BSD 2-Clause License 许可证发布。
本项目基于 BSD 2-Clause License 许可。

你可以自由再发布和修改；使用本模组时，如果能注明原作者的 userID，我们将不胜感激。
你可以自由再发布和修改；使用本模组时，请注明原作者的 userID。

---

🧩 插件开发

本模组支持通过插件扩展。外部模组可以安全地添加武器类型、可收刀（纳刀）的物品、属性联动等内容。
本模组支持插件扩展。外部模组可以安全地注册武器类型、可收刀物品、元素联动等。

GitHub 上公开了一个示例插件（模板兼参考实现）。weapon_types/weapons.json 附带使用 maw_saya/saya.json 等数据驱动钩子的最小示例。
GitHub 上提供了一个示例插件，可用作模板和参考实现。它展示了 weapon_types/weapons.json 和 maw_saya/saya.json 等数据驱动钩子的用法。

• 示例插件：hrmcngs/The-four-primitives-and-Weapons-addons-Sample

有关插件制作方法和 API 详情，请参阅示例仓库的 README。
如何制作插件及 API 详情，请参阅示例仓库的 README。

---

🔗 链接

• GitHub（主体）：hrmcngs/The-four-primitives-and-Weapons
• GitHub（插件示例）：hrmcngs/The-four-primitives-and-Weapons-addons-Sample
• Twitter：@hrmcngs
• 网站：hrmc.ngs.computer

---

由日本学生用❤️制作。