Natural Disasters 🌪

A Fabric mod for Minecraft 26.2 that adds tornadoes, hurricanes, and earthquakes to your world. These devastating disasters wander (or shake) through your territory, fling entities into the air, and tear blocks apart—plus craftable Alerter blocks that warn you before each type of disaster strikes.

עברית • English

---

Features

Disasters

Disaster	Trigger	Radius	Duration
Tornado	Thunderstorm (15% chance)	8 blocks	30 sec
Hurricane	Thunderstorm (15% chance)	18 blocks	60 sec
Earthquake	Command only	40 blocks	20 sec

Tornadoes and Hurricanes:

• Wander across the world during thunderstorms
• Fling players, mobs, and items into the air
• Tear blocks into flying FallingBlockEntitys (hurricanes damage entities they hit)
• Emit cloud and smoke particles with a roaring thunder ambience

Earthquakes:

• Spawn at a fixed epicentre and shake the ground
• Bounce nearby entities into the air every half-second
• Crumble surface blocks, opening cracks and craters
• Triggered only via command (not from storms)

Alerter Blocks

Two craftable alerter blocks, each tuned to a different threat:

Block	Warns About	Recipe
Tornado & Hurricane Alerter	Tornadoes, Hurricanes	Useless Alerter + Wind Charge
Earthquake Alerter	Earthquakes	Useless Alerter + Dirt

Warning states (shared by both alerters):

• 🟢 Green (0): Safe — no danger
• 🟡 Yellow (1): Caution — disaster within 500 blocks
• 🔴 Red (2): Danger — disaster within 100 blocks

When at red alert, the alerter emits rapid beep sounds for players within 24 blocks.

Commands

• /naturaldisasters <tornado|hurricane|earthquake> [delaySeconds] — Manually trigger a disaster at your position (gamemaster only)

---

Installation

Requirements

• Minecraft 26.2
• Fabric Loader 0.19.3+
• Fabric API 0.152.2+26.2
• Java 25+

Steps

1. Download the latest JAR from releases
2. Place weather-mod-1.0.0.jar in your mods/ folder
3. Launch Minecraft with Fabric

---

Crafting Recipes

1. Useless Alerter

A plain alerter block (aesthetic only). Required to craft any working alerter.

[I] [G] [I]
[I] [R] [I]
[I] [I] [I]

• I: Iron Ingot
• R: Redstone Lamp
• G: Glass

2. Tornado & Hurricane Alerter

Warns about approaching tornadoes and hurricanes.

[U] [W]

• U: Useless Alerter
• W: Wind Charge

3. Earthquake Alerter

Warns about approaching earthquakes.

[U] [D]

• U: Useless Alerter
• D: Dirt

---

Usage

Surviving a Disaster

1. Craft an Alerter matching the threat you want to monitor
2. Place the block on a wall where you can see it
3. Watch for color changes:
   • Yellow means a disaster is approaching within 500 blocks
   • Red means imminent danger within 100 blocks—seek shelter!
4. Take cover indoors or underground when the warning turns red

Manual Triggers

Use the command to spawn a disaster for testing or fun:

/naturaldisasters tornado
/naturaldisasters hurricane 60
/naturaldisasters earthquake 30

With a delay, alerters will warn before the disaster strikes.

---

Configuration

No in-game config file. To adjust disaster behavior, edit the source:

• DisasterManager.java — Spawn chance, delay timing, and alert scan radius
• DisasterType.java — Per-disaster radius, speed, damage, and duration values

---

Development

Building from Source

./gradlew build

Output: build/libs/weather-mod-1.0.0.jar

Project Structure

• src/main/java/com/weather/ — Main mod code
  • disaster/ — Disaster logic and scheduling
  • block/ — Alerter block implementations
  • command/ — Command handling
  • registry/ — Item and block registration
  • mixin/ — Mixin configuration for integration
• src/main/resources/ — Assets, recipes, lang files

Language Support

The mod includes translations for:

• English (en_us.json)
• Hebrew (he_il.json)

To add more languages, create a new lang file in assets/weather-mod/lang/ and update fabric.mod.json.

Minecraft 26.2 Notes

This project uses Minecraft 26.2 with Mojang mappings. Some API calls differ from standard versions (see CLAUDE.md for details). Always verify with:

javap -classpath "$USERPROFILE/.gradle/caches/fabric-loom/26.2/minecraft-common.jar" <ClassName>

---

Technical Details

How It Works

1. When a thunderstorm begins, the mod has a 15% chance to schedule a tornado or hurricane 2 minutes in the future
2. When the timer expires, an ActiveDisaster spawns and begins wandering
3. Tornadoes/hurricanes scan for entities and blocks in their path, flinging and destroying them
4. Earthquakes stay at their epicentre, bouncing nearby entities and crumbling surface blocks every few ticks
5. DisasterManager continuously scans for Alerter blocks around online players and updates their warning state based on disaster proximity—each alerter type only reacts to the disaster type it warns about
6. Players see the block color change and hear rapid beeps when danger is near

Server-Side Only

All disaster logic runs server-side. Clients receive:

• Entity motion packets (for flinging and bouncing)
• Block state updates (for alerter color changes)
• Particle effects and sound

---

---

עברית

Natural Disasters 🌪

מוד Fabric לדיוק Minecraft 26.2 שמוסיף טורנדו, הוריקנים ורעידות אדמה לעולם שלך. אסונות טבעיים אלו משוטטים בשטח (או מרעידים אותו), זורקים ישויות לאוויר ותורעים בלוקים — בתוספת בלוקי מתריע שניתן לייצור ומזהירים אתכם לפני כל סוג אסון.

תכונות

אסונות:

אסון	טריגר	רדיוס	משך
טורנדו	סערת רעם (סיכוי 15%)	8 בלוקים	30 שניות
הוריקן	סערת רעם (סיכוי 15%)	18 בלוקים	60 שניות
רעידת אדמה	פקודה בלבד	40 בלוקים	20 שניות

טורנדו והוריקנים:

• משוטטים בעולם במהלך סערות רעם
• זורקים שחקנים, יצורים וחפצים לאוויר
• תורעים בלוקים ל-FallingBlockEntity
• פולטים חלקיקים וקולות רעם

רעידות אדמה:

• נוצרות בנקודה קבועה ומרעידות את הקרקע
• מקפיצות ישויות קרובות לאוויר כל חצי שנייה
• מפוררות בלוקי פני קרקע ופותחות סדקים ומכתשים
• מופעלות רק דרך פקודה (לא מסערות)

בלוקי מתריע:

בלוק	מזהיר על	מתכון
מתריע טורנדו והוריקן	טורנדו, הוריקנים	מתריע חסר תועלת + Wind Charge
מתריע רעידות אדמה	רעידות אדמה	מתריע חסר תועלת + עפר

מצבי אזהרה (משותף לשני המתריעים):

• 🟢 ירוק (0): בטוח — אין סכנה
• 🟡 צהוב (1): זהירות — אסון בתוך 500 בלוקים
• 🔴 אדום (2): סכנה — אסון בתוך 100 בלוקים

בהתראה אדומה, המתריע מוציא ביפים מהירים לשחקנים בטווח של 24 בלוקים.

פקודות

• /naturaldisasters <tornado|hurricane|earthquake> [delaySeconds] — הפעל אסון באופן ידני (רק gamemaster)

התקנה

דרישות:

• Minecraft 26.2
• Fabric Loader 0.19.3+
• Fabric API 0.152.2+26.2
• Java 25+

צעדים:

1. הורד את ה-JAR האחרון מ-releases
2. הנח את weather-mod-1.0.0.jar בתיקיית mods/
3. הפעל את Minecraft עם Fabric

מתכני ייצור

1. מתריע חסר תועלת

[I] [G] [I]
[I] [R] [I]
[I] [I] [I]

• I = ברזל | R = מנורת אבן האדמה | G = זכוכית

2. מתריע טורנדו והוריקן

[U] [W]

• U = מתריע חסר תועלת | W = Wind Charge

3. מתריע רעידות אדמה

[U] [D]

• U = מתריע חסר תועלת | D = עפר

שימוש

1. יצור מתריע המתאים לסוג האיום שאתה רוצה לנטר
2. הנח את הבלוק על קיר שתוכל לראות
3. צפה לשינויי צבע:
   • צהוב = אסון מתקרב בתוך 500 בלוקים
   • אדום = סכנה מיידית בתוך 100 בלוקים — חפש מקלט!
4. חזור לבטחון בבנייה או תחת האדמה כשהאזהרה הופכת לאדומה

---

עזרה ובעיות

אם אתה נתקל בבעיות:

1. ודא שיש לך את הגרסה הנכונה של Minecraft, Fabric ו-Fabric API
2. בדוק שה-JAR נמצא בתיקיית mods/
3. פתח את ה-logs של Minecraft לפרטים נוספים

---

Made with ❤️ for Fabric Modding