Iron's Point Blank

## Used AI to create this mod

##If you don't understand this language, feel free to use a translator. There are no images; all content is text-based and can be translated.

MagicGuns is a combat expansion mod designed to integrate Point Blank firearms with the magic system of Iron's Spells 'n Spellbooks. It transforms traditional modern firearms into powerful magical catalysts, allowing you to trigger potent spell effects automatically while pulling the trigger.

​🛠️ Core Features

​Integrated Gun-Magic Combat: When you hold any Point Blank weapon in your main hand, hitting an entity will automatically trigger the spell contained in the scroll held in your off-hand.

​Precise NBT Parsing:

​Automatically identifies and reads the data list under the irons_spellbooks:spell_container tag.

​Accurately retrieves the Spell ID (e.g., shadow_slash) and its corresponding Spell Level.

​Intelligent Cooldown System:

​Automatically activates a 3-second (60 ticks) cooldown after casting to prevent spell spamming.

​The cooldown progress is displayed directly on the off-hand item icon using the Vanilla Cooldown Tracker.

​Silent Operation Mode: All debug text prompts have been removed to provide a fully immersive experience, making spellcasting feel like a native game mechanic.

​🎮 How to Use

​Arm Yourself: Equip any Point Blank firearm (IDs starting with pointblank:) in your main hand, and hold an Iron's Spells spell scroll in your off-hand.

​Combat: Hit a mob or entity using your firearm.

​Trigger: The mod automatically locates the target's position and executes the /cast command to unleash the corresponding spell from your off-hand.

📖 模組簡介

MagicGuns 是一款功能性的戰鬥擴展模組，旨在為 Point Blank 槍械模組注入強大的魔法力量。透過此模組，玩家不再只是發射普通的子彈，而是能將副手中的「法術卷軸」轉化為槍械的次要攻擊手段。當你手持特定的槍械擊中目標時，會自動觸發並施放對應的魔法。

🛠️ 核心功能

• 自動化施法系統：當主手持有任何來自 Point Blank 模組的武器時，攻擊敵對生物會自動觸發副手卷軸中的法術。

• 精準 NBT 數據提取：模組會自動解析 Iron's Spells 卷軸中複雜的 spell_container 數據結構，獲取法術 ID 與等級並精確執行。

• 智慧型冷卻管理：

  • 內建冷卻邏輯（預設 3 秒），防止連續觸發導致的不平衡。

  • 與 vanilla 冷卻系統同步，卷軸圖標會顯示動畫進度。

• 跨 Mod 兼容性：

  • 支援所有 ID 以 pointblank: 開頭的武器。

  • 支援 Iron's Spells 的 NBT 卷軸系統（ID 為 scroll 但包含 data 標籤的物品）。

🎮 使用方法

1. 裝備：主手拿著任何 Point Blank 的槍械，副手拿著 Iron's Spells 的法術卷軸。

2. 開火：直接攻擊（擊中）生物。

3. 施法：模組會根據卷軸內的法術（如：Shadow Slash）自動在目標位置執行施法指令。