# \ud83d\udea8 MCAlerts \u2014 Real-Time Israeli Red Alert Notifications for Minecraft<\/p>\n
> **Never miss a siren again.** MCAlerts brings live Home Front Command (pikud ha’oref) rocket and missile alerts directly into your Minecraft server \u2014 color-coded, city-targeted, and persistent across restarts.<\/p>\n
Built for Israeli players and server owners who don’t want to alt-tab during an alert. Fully Hebrew & English bilingual. Zero gameplay interference.<\/p>\n
—<\/p>\n
## \ud83c\udf1f Features at a Glance<\/p>\n
| Feature | Details |
\n|—|—|
\n| \ud83d\udd34 Rocket\/Siren Alerts | Full-screen title + red chat \u2014 city-targeted only |
\n| \ud83d\udfe1 Pre-Warnings | Yellow chat (everyone) + actionbar (your city) |
\n| \ud83d\udfe2 Incident Ended | Green chat broadcast to all players |
\n| \ud83c\udfd9\ufe0f City Selection GUI | Browse & search all Israeli cities |
\n| \ud83c\udf10 Bilingual | Hebrew & English per-player toggle |
\n| \ud83d\udcbe Persistent History | Alerts survive server restarts (up to 200 stored) |
\n| \ud83d\udcfa Holograms | In-world TextDisplay boards with recent alert history |
\n| \ud83d\udce3 Social Safety System | Clickable “I’m safe” broadcast after sirens |
\n| \ud83d\udd0c PlaceholderAPI | Expose alert data to scoreboards, tab lists, etc. |<\/p>\n
—<\/p>\n
## \ud83d\udd34 Alert System \u2014 How It Works<\/p>\n
MCAlerts polls the official pikud ha’oref API every second and classifies every alert into one of three categories:<\/p>\n
### \ud83d\ude80 SIREN Alerts \u2014 *Red*
\n**Rocket fire, hostile aircraft, terrorist infiltration, earthquake, Red Alert**<\/p>\n
– \ud83d\udcfa **Full-screen title** blasted in the middle of the screen with `\u26a0 RUN TO SHELTER`
\n– \ud83d\udcac **Red chat message** `[MCAlerts] Rocket Fire: Tel Aviv`
\n– \ud83d\udd0a **Urgent sound** plays
\n– \ud83c\udfaf **City-targeted only** \u2014 players who haven’t set their city to an affected area won’t be disturbed
\n– \u2764\ufe0f **Safety check-in** appears 10 minutes later (Social System, optional)<\/p>\n
### \u26a1 PREWARN Alerts \u2014 *Yellow*
\n**Early warning \u2013 launch detected, life-saving instructions, minutes to shelter**<\/p>\n
– \ud83d\udcac **Yellow chat** \u2192 sent to **ALL players** on the server (everyone should know)
\n– \ud83d\udfe1 **ActionBar** notification \u2192 only if your city is in the affected zone
\n– \ud83d\udd14 Softer chime sound for city-matched players<\/p>\n
### \u2705 ENDED Alerts \u2014 *Green*
\n**Incident ended (\u05e1\u05d9\u05d5\u05dd \u05d4\u05d0\u05d9\u05e8\u05d5\u05e2)**<\/p>\n
– \ud83d\udcac **Green chat** \u2192 sent to **ALL players**, no city targeting needed
\n– No sound, no title \u2014 just a calm confirmation<\/p>\n
—<\/p>\n
## \ud83c\udfd9\ufe0f City Selection GUI<\/p>\n
Run `\/mcalerts` to open the city picker.<\/p>\n
– Browse all ~1,200+ Israeli cities loaded live from the government’s official city registry
\n– **Search** by typing a city name in Hebrew or English
\n– **Global mode** \u2014 receive alerts for every city in the country (BEACON icon)
\n– **Clear** your selection at any time (BARRIER icon)
\n– Settings and city are saved per-player across sessions<\/p>\n
—<\/p>\n
## \ud83c\udf10 Bilingual Support<\/p>\n
Each player can independently toggle between **Hebrew** and **English** via the Language button (BOOK icon) in the city GUI.<\/p>\n
| Hebrew | English Translation |
\n|—|—|
\n| \u05d9\u05e8\u05d9 \u05e8\u05e7\u05d8\u05d5\u05ea \u05d5\u05d8\u05d9\u05dc\u05d9\u05dd | Rocket Fire |
\n| \u05d7\u05d3\u05d9\u05e8\u05ea \u05db\u05dc\u05d9 \u05d8\u05d9\u05e1 \u05e2\u05d5\u05d9\u05df | Hostile Aircraft Infiltration |
\n| \u05d7\u05d3\u05d9\u05e8\u05ea \u05de\u05d7\u05d1\u05dc\u05d9\u05dd | Terrorist Infiltration |
\n| \u05e1\u05d9\u05d5\u05dd \u05d4\u05d0\u05d9\u05e8\u05d5\u05e2 | Incident Ended |
\n| \u05d4\u05ea\u05e8\u05e2\u05d4 \u05de\u05d5\u05e7\u05d3\u05de\u05ea – \u05d6\u05d9\u05d4\u05d5\u05d9 \u05e9\u05d9\u05d2\u05d5\u05e8 | Early Warning \u2013 Launch Detected |
\n| \u05d4\u05e0\u05d7\u05d9\u05d5\u05ea \u05de\u05e6\u05d9\u05dc\u05d5\u05ea \u05d7\u05d9\u05d9\u05dd | Life-Saving Instructions |<\/p>\n
—<\/p>\n
## \u2764\ufe0f Social Safety System<\/p>\n
When a siren alert fires for a player’s city, a **clickable safety check-in** appears in chat 10 minutes later:<\/p>\n
“`
\n[MCAlerts] Are you safe? [YES, I’M SAFE]
\n“`<\/p>\n
Clicking it broadcasts a server-wide message so everyone knows you’re okay. Players can disable this feature per-account via the Sunflower icon in the GUI.<\/p>\n
—<\/p>\n
## \ud83d\udcfa In-World Holograms<\/p>\n
Place a live alert board anywhere in your world using TextDisplay entities. Boards auto-update whenever a new alert arrives and color-code each entry by type.<\/p>\n
“` Holograms display the last 10 alerts with timestamps, color-coded \ud83d\udd34\ud83d\udfe1\ud83d\udfe2 and formatted for readability. They persist across server restarts.<\/p>\n —<\/p>\n ## \ud83d\udcbe Persistent Alert History<\/p>\n Every alert is saved to `plugins\/MCAlerts\/alerts-history.json` immediately when received. On server restart, the full history is restored \u2014 so `\/mcalerts testapi` will correctly show last-hour alert counts even after a reboot.<\/p>\n Up to **200 alerts** are retained on disk.<\/p>\n View recent history in chat:<\/p>\n “` —<\/p>\n ## \ud83d\udd0c PlaceholderAPI Support<\/p>\n MCAlerts registers a PAPI expansion with the identifier `%mcalerts_*%`.<\/p>\n | Placeholder | Returns | Use these in scoreboards, tab lists, action bar plugins, or any PAPI-compatible plugin.<\/p>\n —<\/p>\n ## \u2699\ufe0f Commands<\/p>\n | Command | Permission | Description | ### \ud83e\uddea Test Alert Types<\/p>\n “` All test alerts require `\/mcalerts confirm` within 30 seconds as a safety gate.<\/p>\n —<\/p>\n ## \ud83d\udee0\ufe0f Configuration<\/p>\n “`yaml # Override the alert endpoint \u2014 useful if your server IP is outside Israel # Player data (auto-managed, do not edit manually) # Hologram locations (auto-managed) ### \ud83c\udf0d Geo-Block Fix<\/p>\n oref.org.il blocks non-Israeli IP addresses. If your server is hosted outside Israel, you’ll see HTTP 403 errors. Set `alert-url` to a reverse proxy or a self-hosted relay that forwards requests from an Israeli IP.<\/p>\n “` Use this command to diagnose connectivity. It will tell you exactly whether your server is blocked, reachable, or if there’s an active alert right now.<\/p>\n —<\/p>\n ## \ud83d\udccb Requirements<\/p>\n – **Paper \/ Purpur** (1.21.X+ recommended, requires TextDisplay API) > \u26a0\ufe0f **Spigot** works but hologram features require Paper’s Display Entity API. Core alert functionality is fully compatible.<\/p>\n —<\/p>\n ## \ud83e\uddd1\u200d\ud83d\udcbb Credits<\/p>\n **frqme** \u2014 Lead developer, everything you see here<\/p>\n **pikud ha’oref (Home Front Command)** \u2014 The public API this plugin queries. Stay safe \ud83c\uddee\ud83c\uddf1<\/p>\n —<\/p>\n ## \ud83d\udcdc License<\/p>\n Released under the **MIT License**. Use it, fork it, self-host it, do whatever you want \u2014 just don’t sell it as your own.<\/p>\n —<\/p>\n *\ud83d\udea8 MCAlerts is a community safety tool. It relies on the official Israeli Home Front Command API and is not affiliated with or endorsed by the Israeli government.*<\/p>\n","protected":false},"excerpt":{"rendered":" This plugin shows pikud haoref alerts in Israel inside minecraft with city selection and more<\/p>\n","protected":false},"featured_media":99276,"template":"","meta":{"_minecraft_slug":"mcalerts","_minecraft_project_id":"jvTMRAgx","_minecraft_author":"frqmelikescheese","_minecraft_license":"LicenseRef-MCAlerts-License","_minecraft_downloads":8,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mcalerts.zip","_minecraft_size_bytes":29118,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:17:53.585534Z","_minecraft_date_created":"2026-04-15T01:58:47.105393Z","_minecraft_date_modified":"2026-04-01T20:39:11.532215Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mcalerts","_minecraft_icon_attachment_id":99276,"_minecraft_imported_at":"2026-06-05T16:53:10+00:00","_minecraft_import_hash":"6aba668efff2820c76d10076a9e1e7c4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-99275","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/mcalerts hologram create
\n\/mcalerts hologram delete
\n\/mcalerts hologram list \u2014 list all boards
\n“`<\/p>\n
\n\/mcalerts history
\n“`<\/p>\n
\n|—|—|
\n| `%mcalerts_last_title%` | Title of the most recent alert |
\n| `%mcalerts_last_areas%` | Affected areas of the most recent alert |
\n| `%mcalerts_last_time%` | Timestamp of the most recent alert |
\n| `%mcalerts_history_1%` | Full formatted string for alert #1 (newest) |
\n| `%mcalerts_history_N%` | Full formatted string for alert #N |<\/p>\n
\n|—|—|—|
\n| `\/mcalerts` | \u2014 | Open city selection GUI |
\n| `\/mcalerts history` | \u2014 | View last 20 alerts in chat |
\n| `\/mcalerts testapi` | \u2014 | Test endpoint connectivity & last-hour summary |
\n| `\/mcalerts test
\n| `\/mcalerts confirm` | `mcalerts.confirm` | Confirm a pending test broadcast |
\n| `\/mcalerts clearhistory` | `mcalerts.clear` | Wipe all stored alert history |
\n| `\/mcalerts hologram
\n| `\/mcalerts safe` | \u2014 | Broadcast your safety status (clickable button) |<\/p>\n
\n\/mcalerts test rocket \u2014 Rocket fire (SIREN, red)
\n\/mcalerts test aircraft \u2014 Hostile aircraft (SIREN, red)
\n\/mcalerts test prewarn \u2014 Early warning (PREWARN, yellow)
\n\/mcalerts test warning \u2014 Life-saving instructions (PREWARN, yellow)
\n\/mcalerts test end \u2014 Incident ended (ENDED, green)
\n“`<\/p>\n
\n# config.yml<\/p>\n
\n# and gets geo-blocked by oref.org.il (HTTP 403)
\nalert-url: “https:\/\/www.oref.org.il\/WarningMessages\/alert\/alerts.json”<\/p>\n
\nplayers:
\n
\n city: “\u05ea\u05dc \u05d0\u05d1\u05d9\u05d1 – \u05d9\u05e4\u05d5”
\n english: false
\n social: true<\/p>\n
\nholograms:
\n main:
\n world: world
\n x: 0.0
\n y: 64.0
\n z: 0.0
\n“`<\/p>\n
\n\/mcalerts testapi
\n“`<\/p>\n
\n– **Java 21+**
\n– **PlaceholderAPI** *(optional \u2014 enables `%mcalerts_*%` placeholders)*
\n– Network access to `oref.org.il` or a proxy relay<\/p>\n