The four primitives and Weapons

ATTENTION / 注意 一部の機能を使用するには、ワールド設定でチート（コマンド）を有効にする必要があります。 Some features may require cheats (commands) to be enabled in your world settings.

The Four Primitives and Weapons

鎧を貫け。日頃の鬱憤を敵にぶつけろ。 Penetrate armor. Take out your daily grudges on your enemies.

このModは日本人学生のチームによって作られています。英語の説明が不自然な箇所があるかもしれません。ご了承ください。 This mod is made by a team of Japanese students. Apologies for any awkward English phrasing!

📦 概要 / Overview

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

Adds elemental weapons, armor, and a sheath system to Minecraft. Wield 14 elemental attributes — Ice, Electric, Corrosion, Holy, Fire, Wind, Water, Thunder, Dark, Miasma, Blood, Erasure, Soul, and Soul Fire — and pierce through your enemies' defenses!

✨ 主な特徴 / Key Features

• 🗡️ 多彩な武器 / Various Weapons — 直刀・刀・大太刀・魔法武器など、複数の独自武器を追加 / Adds katanas, longswords, magical weapons and more
• 🛡️ 鞘システム / Sheath System — 抜刀・納刀のアクションで戦闘に没入感を / Draw and sheathe your blade for immersive combat
• 🌈 14種の属性 / 14 Elements — それぞれが独自の効果を持つ14種類の属性 / 14 distinct elements, each with unique effects
• 🛡️ カウンター属性システム / Counter System — 本スロットの魔導書で属性ダメージを無効化 / Negate elemental damage with the right magic book
• 🎯 スキルカスタマイズ / Skill Customization — 武器ごとに攻撃モーションを自由に組み合わせ / Customize attack motions per weapon type
• ⚔️ カスタム難易度 / Custom Difficulty — creative+ から nightmare・lunatic_extreme まで多彩な難易度 / From creative+ to nightmare and lunatic_extreme
• 👥 戦闘AIを持つ敵Mob / Combat AI Mob — 回避・チャージ・ガードを使いこなす一般兵 / Common Soldier dodges, charges, and guards
• 🗃️ 武器ラック / Weapon Rack — お気に入りの武器を飾れる装飾ブロック / A decorative block to display your weapons

バージョン6の追加機能 / New in Version 6

• ファンタジーマント / Fantasy Mantle — Curiosのマントスロットに装備し、Rキーの選択から防御・刺突を使えます。マント装備中も抜刀・納刀を選べます。 / Equip it in the Curios mantle slot and select Guard or Thrust through the R-key wheel. Draw and Sheathe remain available while wearing it.
• 布でいなす防御 / Cloth Parry — 利き手側へマントを回していなし、布が背中へ戻ります。近接攻撃と投射物を防ぎますが、ポーションや魔法・環境ダメージは防ぎません。 / Sweep the cape around your dominant arm, then return it to your back. Blocks melee attacks and projectiles; potions, magic and environmental damage still pass through.
• 空いた手で刺突 / Empty-hand Thrust — 空いた側の腕にマントを巻き付けて突きます。両手にアイテムがあると使用できません。マント自身の攻撃系エンチャント・属性を反映します。 / Wrap the cape around your free arm and thrust. Requires an empty hand and uses the mantle's own attack enchantments and elemental attribute.
• 一人称・三人称アニメーション / First- and Third-person Animations — 防御・刺突の布と腕の動きを両視点に反映。 / Cloth and arm movements are visible in both camera views.
• 追加属性と装備 / More Elements and Equipment — 血・消滅・霊魂・霊火、ダガーと専用鞘、投げナイフなどを追加・拡張。 / Expanded elemental options, daggers and sheaths, and throwing knives.

初期設定のCT / Default cooldowns: マント防御3秒・刺突1秒 / Mantle Guard: 3 seconds; Thrust: 1 second.

TiCEX連携：刀身の鋳造 / TiCEX Integration: Cast Katana Blades

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

1. パーツビルダーで素材3個分から刀身を作る。
2. 鋳造台で刀身に溶融金90mBを流し、繰り返し使える金の鋳型を作る（元の刀身は消費）。
3. 鋳型に対応する溶融金属3素材分を流し、刀身を鋳造する。
4. 作業台で刀身と棒を組み合わせ、素材の攻撃力・耐久値を引き継いだ本MODの刀を作る。

四部品の刀 / Four-part Katana: 柄・鍔・頭・刀身を個別に作り、Tinkersの金床（上位ツールステーション）で組み立てられます。各部品の素材・特性を引き継ぎます。普通のツールステーションは3枠のため、この4部品構成には金床が必要です。

Build the blade, handle, guard and pommel separately, then assemble a four-part katana at a Tinkers' Anvil. The finished tool retains each part's material and traits. The ordinary Tinker Station has only three input slots.

With TiCEX and Tinkers’ Construct installed, make a blade in the Part Builder, pour 90 mB of gold over it for a reusable cast, then cast blades from three material units of molten metal. Craft a blade with a stick to make this mod's katana with the material's attack and durability stats. Assembly uses a crafting table, not the Tool Station.

📖 遊び方 / How to Play

基本操作 / Basic Controls

🎯 スキルセレクション / Skill Selection

専用UIから 1st Hit / 2nd Hit / 3rd Hit / Charged / Dash / Right Click / Shift+Right Click の各アクションに割り当てるスキル（Thrust・Upper-Left Slash・Spin Slash・Slam Down・Dash Rush・Leap Slash・Shadow Step・Guard など）を自由に組み合わせられます。武器タイプ（Katana / Rapier / Straight Sword / Sword / Greatsword / Dagger / Shield / Bow / Crossbow / Throwing / Trident）ごとに別構成を保存可能です。

Open the Skill Selection screen to customize which moves trigger on each action slot (1st/2nd/3rd Hit, Charged, Dash, Right Click, Shift+Right Click). Each weapon category — Katana, Rapier, Straight Sword, Sword, Greatsword, Dagger, Shield, Bow, Crossbow, Throwing, Trident — keeps its own loadout.

✨ Special Technique

Storm Item などを 本スロット（magic book スロット） にセットした状態で、Magisches Feen Katana または Magical Katana でチャージ攻撃を行うと、Special Technique が発動します！

Set a Storm Item (or similar) in the book slot (magic book slot), then perform a Charged Attack with a Magisches Feen Katana or Magical Katana to trigger a powerful Special Technique!

🛡️ 鞘システム / Sheath System

各武器には専用の 鞘（Saya） が存在し、Curios の Belt / Back スロット に装備できます。鞘に武器を「納刀」しておくと、ツールチップで現在納刀中の武器が確認できます。

Each weapon has a dedicated Saya (sheath) that can be equipped in the Curios Belt / Back slot. When a weapon is sheathed, the tooltip shows which weapon is currently stored.

🌪️ 属性システム / Elemental System

このModには 14種類の属性 が存在します。それぞれ独自の効果を持ち、レベルに応じて強化されます。 This mod features 14 elemental attributes, each with unique effects that scale with level.

氷 / Ice

凍結中の敵に追加ダメージを与え、Slowness（鈍化）効果を付与します。 Deals bonus damage to frozen enemies and applies Slowness.

• 基礎倍率 / Base multiplier: 1.5×（+0.25× per level）
• Slowness 継続中は最大 +0.5× の追加ボーナス / Up to +0.5× bonus while Slowness is active

電気 / Electric

水中で範囲攻撃（AOE）が発生します。導体装備の敵ほど威力が上がります。 Triggers AOE damage in water. Bonus damage against enemies wearing conductive armor.

• 基礎倍率 / Base multiplier: 1.2×
• 水中 / In water: 1.5×
• 導体装備 1個ごとに / Per conductive item: +0.3×

侵食 / Corrosion

攻撃するたびに敵の防御力を削り取ります。高レベルでは Wither 効果も付与します。 Reduces enemy armor on every hit. Higher levels also apply Wither.

• 基礎倍率 / Base multiplier: 1.1×
• 防御力減少 / Armor reduction: −(2.0 + damage × 0.5)

聖 / Holy

アンデッドに強力な特攻ダメージを与えます。高レベルでは炎上効果も付与します。 Deals massive bonus damage to undead. Higher levels also set enemies on fire.

• 基礎倍率 / Base multiplier: 1.1×
• アンデッド特攻 / vs. Undead: 2.5×（+0.3× per level）

闇 / Dark

暗所（光レベル7以下）で大幅な威力ボーナス。Blindness を付与し、高レベルでは独自の持続ダメージ（DoT）も。 Massive damage bonus in dark areas (light level ≤7). Applies Blindness and, at higher levels, custom damage-over-time.

• DoT発動 / DoT activates at: Lv3+
• DoTダメージ / DoT damage: 0.5/tick + +0.5/Lv

火 / Fire

ヒット時に対象を炎上させます。レベルが上がるほど炎上時間が延長されます。 Sets the target on fire on hit. Higher levels extend the burn duration.

• 炎上時間 / Burn duration: 3秒 + 2秒/Lv

風 / Wind

攻撃時に 自分（攻撃者）に Strength バフ を付与します。連続戦闘で火力が伸びる属性。 Grants the attacker a Strength buff on hit. Damage scales the longer you fight.

• バフ持続 / Buff duration: 5秒 + 2秒/Lv
• 攻撃力ボーナス / Attack boost: +20% + +10%/Lv

雷 / Thunder

電気属性と同様に水中AOEを発生させます。導体装備にも追加ダメージ。 Like Electric, triggers AOE damage in water. Bonus against conductive armor.

水 / Water

敵に強力な Slowness II を付与し、機動力を奪います。 Applies a powerful Slowness II to enemies, crippling their mobility.

• Slowness 持続 / Slowness duration: 4秒 + 2秒/Lv

瘴気 / Miasma

敵の 回復を阻害 し、持続ダメージ（DoT）を与えます。回復薬や金リンゴが効かなくなる、戦略性の高い属性。 Blocks enemy healing and deals damage-over-time. Healing potions and golden apples become ineffective — a highly strategic element.

• 回復阻害持続 / Healing block duration: 5秒 + 3秒/Lv
• DoT持続 / DoT duration: 3秒 + 2秒/Lv

追加の4属性 / Four Additional Elements

血（Blood）・消滅（Erasure）・霊魂（Soul）・霊火（Soul Fire）も利用できます。属性によって専用効果や魔導書が異なります。付与状態はゲーム内ツールチップで確認してください。

Blood, Erasure, Soul and Soul Fire are also available, with element-specific effects and magic books. Check in-game tooltips for the element attached to your equipment.

🛡️ カウンター属性システム / Counter Element System

本スロット（magic book スロット） に カウンター属性の魔導書 を装備しておくと、対応する属性ダメージを無効化できます。Mod内戦闘に駆け引きが生まれる、戦略性のシステムです。

Equip a counter-element magic book in the book slot to negate incoming elemental damage. This adds a deep layer of strategy to combat.

⚔️ カスタム難易度 / Custom Difficulty

バニラの easy / normal / hard に加え、独自難易度を多数追加。コマンドで切り替え可能です。 In addition to vanilla easy / normal / hard, this mod adds custom difficulties switchable via command.

切り替えコマンド / Switch with:

/gamerule difficulty <難易度名>

👤 一般兵 / Common Soldier

プレイヤーのような戦闘AIを持つ敵Mobです。回避・チャージ攻撃・ガードスキルを使います。 A hostile mob with player-like combat AI — it dodges, charges, and guards just like a real player.

召喚コマンド / Summon command:

/summon the_four_primitives_and_weapons:common_soldier ~ ~ ~

🧪 ステータス効果の活用 / Using Status Effects

Mobにステータス効果を付与することでAIを弱体化できます（プレイヤーには影響しません）。 Applying status effects to mobs weakens their AI. These effects do not affect players.

複数効果の重複が可能です。盲目＋混乱＋弱体化を同時付与するとAIがほぼ機能しなくなります。 Effects stack. Combining Blindness + Nausea + Weakness nearly disables the AI entirely.

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

💻 動作環境 / Requirements

• Minecraft: 1.20.1
• Mod Loader: Forge 47.4.0（Minecraft 1.20.1）
• Java: 17
• 必須 / Required: Curios API 5.14.1以上 / 5.14.1 or later
• 任意 / Optional: JEI、Tinkers’ Construct（素材武器・刀の部品製作・鋳造用。Mantleなど必須依存も必要）。TiCEXなしでも素材連携を利用可能 / JEI, Tinkers’ Construct with its required dependencies (including Mantle) for material weapons and katana parts/casting; TiCEX is optional. TiCEXを併用する場合はTiCEX側の必須依存も別途導入 / JEI. If using TiCEX, install its required dependencies separately.
• クライアント / Client: 必須 / Required
• サーバー / Server: 対応 / Supported

📥 導入方法 / Installation

1. Java 17・Minecraft Forge 1.20.1・Curios APIを用意 / Install Java 17, Minecraft Forge 1.20.1 and Curios API
2. このModの .jar ファイルを mods フォルダに配置 / Place the mod .jar file into your mods folder
3. Minecraftを起動 / Launch Minecraft
4. ワールドを作成し、戦いを始めよう！ / Create a world and start your adventure!

📜 ライセンス / License

このプロジェクトは BSD 2-Clause License の下で公開されています。 This project is licensed under the BSD 2-Clause License.

再配布・改変は自由ですが、使用される際はuserIDを記載していただけると嬉しいです。 You are free to redistribute and modify, but please credit the original userID when using this mod.

🧩 アドオン開発 / Addon Development

本Modはアドオンによる拡張に対応しています。外部Modから武器タイプ・鞘(納刀)対象アイテム・属性連携などを安全に追加できます。 This mod supports addon extensions. External mods can safely register weapon types, sheathable items, elemental hooks, and more.

サンプルアドオン（テンプレート兼参考実装）を GitHub で公開しています。weapon_types/weapons.json や maw_saya/saya.json といったデータ駆動のフックを使った最小構成のサンプル付きです。 A sample addon — usable as both a template and reference implementation — is available on GitHub. It demonstrates data-driven hooks such as weapon_types/weapons.json and maw_saya/saya.json.

• Sample Addon: hrmcngs/The-four-primitives-and-Weapons-addons-Sample

アドオンの作り方とAPIの詳細はサンプルリポジトリの README を参照してください。 See the sample repository's README for how-to guides and API details.

🔗 リンク / Links

• GitHub (本体 / Main): hrmcngs/The-four-primitives-and-Weapons
• GitHub (アドオンサンプル / Addon Sample): hrmcngs/The-four-primitives-and-Weapons-addons-Sample
• Twitter: @hrmcngs
• Website: hrmc.ngs.computer

Made with ❤️ by Japanese students.