Zipir Havaci

🛡️ ZİPİRHAVACI MOD

**Mechanic Guide | Key Bindings | Scroll Locations | Enchantment Protections** ---

⚡ WHAT IS ZİPİRHAVACI MOD?

ZipirHavaci is an experimental project born out of personal curiosity to make Minecraft's static combat system a bit more dynamic and physics-responsive. The mod features several prototypes, including a kinetic gauntlet, shield-based tethering mechanics, and movement restrictions based on real-time weight calculations. My priority while developing this project was to ensure that every action has a physical consequence and a cost, rather than relying on "magic" buttons. The project has currently reached its intended core features and has been left in an open-ended dormant state. While it remains uncertain whether new updates will arrive in the future, ZipirHavaci stands as a hobby project focused entirely on performance and original mechanics. *Just a mod I created. Anyone who wants can access the source code and build upon it.*

🛠️ Dependencies

To ensure Zipir Havaci runs smoothly and all animations render correctly, the following dependencies are required: * **GeckoLib** This mod utilizes GeckoLib for its advanced animation engine. To avoid visual glitches or crashes, please ensure you are using the specified version or higher. * **Required Version:** 4.4.9 or newer * **Platform:** Forge ---

🎮 KEY BINDINGS & CONTROLS

* **[ Right Click ]** → Fire Gauntlet * **[ R ]** → Change Mode (PULL or PUSH mode) * **[ Shift + Left Click ]** → Begin Reload (hold crouch for 3.5 seconds — releasing cancels it!) * **[ Bind: Super Skill ]** → Trigger leveled Super Skill blast * **[ V ]** → Activate Soul Bond (tether pull toward your stuck shield) * **[ Bind: Aura Skill ]** → Activate / release Aura field *(Bind the custom skills in Controls → ZipirHavaci)* ---

🪖 WEIGHT SYSTEM — How It Works

Every time you fire the Gauntlet, your armor weight directly affects performance. **Formula:** `Total Weight = Armor Value + Armor Toughness` *(capped at 60)* | Weight (0–60) | Launch Multiplier | Damage Multiplier | | :--- | :--- | :--- | | **0 (Unarmored)** | ×1.00 | ×1.00 | | **30 (Mid Armor)** | ×0.90 | ×1.025 | | **60 (Full Armor)** | ×0.80 | ×1.05 | * **Heavier armor** = slower self-launch, but more knockback on enemies. * **Lighter build** = faster flight, but weaker push force. * **Empty off-hand** = +15% power bonus! **OVERHEAT (Heavy Armor Failure):** In PUSH mode, if you are already falling fast (Y velocity < -1.9) AND your total weight exceeds 46, the Gauntlet overheats. This occurs because the character is too heavy for the gauntlet's push power, rather than being a standard firing failure. A misfire happens: smoke appears but no launch occurs. ---

💠 GAUNTLET — SUPER SKILL LEVELS

Super Skill accepts levels 1–5. Higher levels consume more ammo and produce a larger effect radius. | Level | Ammo Cost | Base Power | Range | | :---: | :---: | :---: | :---: | | **1** | 2 ammo | 4.5 | 6.1 blocks | | **2** | 3 ammo | 6.0 | 7.7 blocks | | **3** | 4 ammo | 7.5 | 9.3 blocks | | **4** | 5 ammo | 9.0 | 10.9 blocks | | **5** | 6 ammo | 16.0 | 12.5 blocks | **PULL Level 5:** * Vacuum cone pulls enemies in front, pushes those behind. * 80–110° conical area depending on level. * Blocks show crack animation for 10 seconds (visual only, nothing breaks). * Cyan funnel particle effect. **PUSH Level 5:** * 3-wave shockwave, each ring 100 ms apart. * Orange circles + white border + rotating halo. * If aiming downward AND level ≥ 3 → **GROUND BLAST** (omnidirectional explosion, wood doors shatter, iron doors shake). ---

🔋 GAUNTLET AMMO & RELOAD

The Gauntlet has 6 ammo slots (internally Uses: 0–6). * **Normal Shot:** 1 ammo consumed, 20-tick cooldown. * **Super Skill:** (Level + 1) ammo consumed. **SYSTEM EXHAUSTION (at 5 ammo used):** A delayed cooldown triggers 500 ms after the shot: * 6-second (120-tick) cooldown starts. * Cooldown animation and sound play. **RELOAD:** Once the cooldown expires: 1. The exhaustion flag clears. 2. Hold **Shift + Left Click**. 3. Crouch continuously for 70 ticks (~3.5 seconds). *(Releasing crouch cancels reload!)* 4. On success → Adds **3 rounds** to your current count (up to a max of 6). *Progress bar appears on the action bar as a 15-block display.* **FUEL:** Each shot consumes **1 Gunpowder** from your inventory. Without it, firing is blocked and a warning message appears. ---

🔗 SOUL BOND SKILL

Throw your shield into a wall. Activate Soul Bond — you will be pulled toward the shield like a grappling hook. **STEP BY STEP:** 1. Do NOT hold a shield in either hand. 2. Press the **[ V ]** bind. 3. Shield must be ≤ 25 blocks away. 4. You need at least 1 Soul Sand in your inventory (consumed). 5. The pull begins — you fly toward the shield in SPECTATOR mode. 6. Stops automatically when you are 2 blocks from the shield. 7. Previous game mode is restored. **SPIRITUAL COST (every use):** * 0.5 HP (magic damage) * 3-second Wither effect * 1 Soul Sand consumed *Note: You must learn Soul Bond first — reading the Soul Bond Scroll is required before the skill works. Cooldown is 8 seconds.* ---

⚡ AURA SKILL

Gain Aura levels by being struck by lightning (Lightning Calibration). Your Aura Level starts at 0 and rises with each strike. **WHILE AURA IS ACTIVE:** * A dynamic kinetic field surrounds you (scanned every 2 ticks). * Enemies without Aura receive area knockback and damage. * Colliding with another Aura player triggers a balanced smart collision (equal force exchanged). **DEACTIVATION:** Pressing Aura again releases a shockwave, launching nearby enemies. ---

☄️ METEOR IMPACT SKILL

Equip a shield. Fall or fly at high speed while blocking. As your charge builds, a visual aura intensifies around you. **IMPACT TRIGGERS WHEN:** * Charge ≥ 35 (Max 50) * A solid surface is detected ahead * Shield is in use **IMPACT EFFECTS:** * Your shield takes 10% of its max durability as damage. * 3-wave smoke and flame ring expands. * Display block entities show displaced surface fragments (visual only, 20s duration). * Doors within 3 blocks shatter; within 15 blocks shake. **SELF-DAMAGE ON IMPACT:** Raw damage = (impact speed × 4.5) × 0.90. Maximum self-damage hard cap is 16 HP (further reduced by enchantments). *Note: You must read the Meteor Impact Scroll before this skill activates.* ---

📜 SCROLLS — WHERE TO FIND THEM

| Scroll | Location | Chance | | :--- | :--- | :--- | | **Soul Bond Scroll** | Nether Fortress chest loot | 9% | | **Meteor Impact Scroll** | Ancient City chest loot | 15% | *⚠ Once a scroll is read, it is permanently consumed.* ---

🛡️ ENCHANTMENT PROTECTIONS

Enchantments on armor affect how much damage you take from a Meteor Impact. **SELF-DAMAGE REDUCTION (When YOU perform the impact):** | Enchantment | Damage Reduction | | :--- | :--- | | Feather Falling (max IV) | Up to 30% total | | Blast Protection (max IV) | Up to 44% total | | Protection (max IV) | Up to 18% total | | Fire Protection (max IV) | Up to 30% total | *(Reductions stack but are capped at 85% total).* **HELMET SPECIALS (Worn by target):** * **Wither Skeleton Skull:** +15% damage reduction (Triggers Resistance I & Regen II). * **Turtle Shell:** +18% damage reduction (Caps damage at 7 hearts, triggers Resistance VIII & Dolphin's Grace II). ---

⚙️ CORE ROD

Core Rod is a multi-functional redstone component that combines six different logic modes in a single block. **MODES (Cycle with Shift + Right Click):** 1. **REPEATER:** Classic 1–6 tick delay gate. 2. **PULSE:** Oscillator (blinking output). 3. **INVERTER:** NOT gate. 4. **LATCH:** Toggle memory (Persists through chunk reloads via NBT). 5. **COUNTER:** Outputs once every N rising edges (1 to 6). 6. **AND:** Outputs only when two separate faces receive a signal simultaneously. ---

⚙️ COMPATIBILITY NOTES

* **Minecraft:** 1.20.x (Forge) * **Mod-added doors:** Treated as iron-like (only shake, never shatter) * **Multiplayer:** All calculations run server-side — client receives packets. ---

❓ FAQ

**Q: I found a Soul Bond Scroll but the skill doesn't work.** A: Make sure you are not holding a shield. The skill requires your hands to be free and Soul Sand in your inventory. **Q: The Gauntlet won't fire.** A: First, ensure you have Gunpowder in your inventory as fuel. If you see an "Overheat" message, it means you tried to use PUSH mode while falling with heavy armor. The device overheats because it cannot counter that much kinetic force, causing a misfire. **Q: How does the Reload work?** A: Manual Reload takes 3.5 seconds and adds 3 rounds to your current count (up to a max of 6). Use it strategically! **Q: Does the Meteor Impact skill destroy blocks?** A: No. The cracks and displaced block fragments are purely visual display entities. All blocks remain intact. **Q: Why doesn't the Energy Carrier receive power from redstone dust?** A: Energy Carrier does not accept power from redstone dust by design for stable signal propagation. However, redstone dust CAN receive power from the Energy Carrier. ---

🔍 DISCOVERY: RECIPE NOTES

Progressing requires knowledge. There is an **8% chance** to find "Recipe Notes" inside village chests and other loot locations. Right-click with a Recipe Note in your hand to permanently unlock that specific crafting recipe. --- **Created by Just Somebody**