How It WorksSetupCommandsDownload
Fabric Mod — Minecraft 1.21.x

Know when someone
walks near you.

NearMe sends an instant push notification to your phone the moment a player enters your detection radius while you are AFK.

Download 1.21.11
1.21 – 1.21.11
Minecraft
Client-Side
No server needed
ntfy.sh
Free push service
< 1 sec
Notification delay
Works on
Android iOS Windows macOS Linux Web

How It Works

Simple by design.

01
Install the Mod
Drop the .jar into your .minecraft/mods/ folder
02
Install ntfy
Get the free ntfy app on Android, iOS, or open the web app
03
Set Your Topic
Run /nearme topic in-game to link your device
04
Go AFK
Walk away and get notified the moment anyone gets close

Full Setup Tutorial

Set it up in 5 minutes.

1
Step 1
Install Java 21
You might already have Java installed. Check by opening a terminal and typing java -version. If it says version 21 or higher, skip this step.
  • Download Java 21 (Temurin) from adoptium.net
  • Windows: download the .msi installer and run it — next, next, finish
  • macOS: download the .pkg installer and run it
  • Linux (Ubuntu/Debian): sudo apt install temurin-21-jdk
  • Linux (Fedora): sudo dnf install temurin-21-jdk
bash
java -version
// Expected output: openjdk version "21.x.x"
Do NOT use Java 8 or Java 17 — the mod requires Java 21 specifically.
2
Step 2
Install Fabric Loader

Fabric is the mod framework NearMe runs on. You only need to do this once — it works for all Fabric mods.

  • Go to fabricmc.net/use/installer
  • Download the Fabric Installer for your OS and run it
  • Select Minecraft Version: 1.21.x — leave Loader Version on latest
  • Click Install
  • Open the Minecraft Launcher and choose the fabric-loader-1.21.x profile
  • Click Play once to generate the mods folder, then close Minecraft
Always launch Minecraft using the Fabric profile — NOT the default "Latest Release" profile.
3
Step 3
Download and Install the Mod
  • Click the Download .jar button in the Download section below
  • Locate the downloaded file: nearme-1.21.11.jar
  • Open your .minecraft/mods/ folder:
Windows
Press Win + R, type:
%appdata%\.minecraft\mods\
and press Enter
  • Drag and drop nearme-1.21.11.jar into the mods folder
  • Also install Fabric API — download from modrinth.com/mod/fabric-api and drop it in the same folder
The mods folder should now contain at least two files: fabric-api-x.x.x.jar and nearme-1.21.11.jar
4
Step 4
Install ntfy on Your Device

ntfy is the free notification app NearMe uses to ping your phone. No account needed. Works on every platform.

Google PlayAndroid phones and tabletsApp StoreiPhone and iPadWeb AppAny browser, no install neededDesktop AppWindows, macOS, Linux
ntfy is 100% free and open source. Your notifications go through ntfy.sh's servers by default. You can also self-host if you want full privacy.
Your topic name is your only "password". Anyone who knows it can receive or send notifications on it. Use something long and random — NOT something like minecraft or simon123.

Generate a secure topic name:

mc-raven-4821
5
Step 5
Subscribe to Your Topic in ntfy

This connects your phone or device to receive the notifications.

  • Android / iOS: Open the ntfy app → tap the + button → type your topic name → tap Subscribe → allow notifications if prompted
  • Browser (ntfy.sh): Go to ntfy.sh → click "Add subscription" or type the topic → click Subscribe → allow browser notifications
  • Desktop App: Open ntfy → click the + button or "Add Subscription" → enter your topic → click Subscribe
You can subscribe on multiple devices at once — all of them will receive the notification simultaneously.
6
Step 6
Configure NearMe In-Game

Launch Minecraft with the Fabric profile, join any world, open chat (press T) and run:

Minecraft Chat
/nearme topic mc-raven-4821
/nearme status

Expected output:

[NearMe] Topic set: mc-raven-4821
[NearMe] Status: Active
Topic: mc-raven-4821
Radius: 30 blocks
Cooldown: 60 seconds
7
Step 7
Send a Test Notification

Verify everything works before going AFK.

Minecraft Chat
/nearme test

Check your phone or browser — you should receive:

ntfy
now
NearMe – Player Nearby!
⚠ Player 'TestPlayer' is 15 blocks away from you!
Got the notification? You're all set! Go AFK — NearMe will watch your back.
No notification? Check:
✗ Is your topic spelled exactly the same in the app and in-game?
✗ Did you allow notifications in the ntfy app?
✗ Is the mod loaded? Run /nearme status — if it shows settings, it's working.
✗ Are you on a singleplayer world that is paused? Unpause it first.

Troubleshooting

Common issues.

The /nearme command doesn't exist
The mod isn't loaded. Check that nearme-x.x.x.jar is in the mods folder and that you launched Minecraft with the Fabric profile (not vanilla). Also make sure Fabric API is installed.
Notification sent in-game but nothing arrives on my phone
Check your topic name is identical in both places (case-sensitive). Try unsubscribing and resubscribing in the ntfy app. Check your phone's notification settings — ntfy might be blocked.
I get notified but only after a long delay
This is normal for background app refresh on iOS. On Android: disable battery optimization for ntfy. On iOS: use the web app in a browser tab instead for instant delivery.
I get too many notifications
Increase the cooldown: /nearme cooldown 300 — this sets a 5-minute gap between alerts.
Gradle build fails with 'package does not exist'
Make sure you're using JDK 21, not JDK 8 or 17. Run: java -version to verify. Then run: ./gradlew build --refresh-dependencies
The mod causes lag
It checks every 2 seconds and uses a background thread for HTTP — zero impact expected. If you notice lag, set a larger radius so fewer entities are scanned: /nearme radius 15
Quick Start Cheatsheet
1
Install Java 21adoptium.net
2
Install Fabricfabricmc.net/use/installer
3
Drop mod in /mods/nearme-1.21.11.jar
4
Install ntfyntfy.sh or App Store / Play Store
5
In-game setup/nearme topic your-topic → /nearme test
6
Subscribe in ntfy appEnter topic → done!

Commands

All commands.

CommandDescriptionDefault
/nearme topic <name>Set your ntfy notification topic—
/nearme radius <5–200>Detection radius in blocks30
/nearme cooldown <10–3600>Seconds between alerts60
/nearme toggleEnable or disable the modenabled
/nearme statusShow current settings—
/nearme testSend a test notification—

Click any row to copy the command

Config File

Auto-generated on first launch.

  • Location: .minecraft/config/nearme.json
  • Created automatically the first time Minecraft launches with the mod
  • Edit manually while Minecraft is closed
  • Run /nearme status in-game to verify current values

  "ntfyTopic" "your-secret-topic"
  "detectionRadius" 30
  "cooldownSeconds" 60
  "enabled" true

FAQ

Common questions.

Does this work on multiplayer servers?
Yes. The mod runs entirely client-side. No server plugin or install is needed.
Will I get spammed with notifications?
No. The cooldown (default 60 seconds) prevents repeated alerts. Adjust with /nearme cooldown.
Is ntfy really free?
Yes. ntfy.sh is free and open source. You can self-host it too.
Does it affect game performance?
No. It checks for nearby players every 2 seconds and sends HTTP requests on a background thread.
What if someone subscribes to my topic?
They would receive the same notifications. Use a long, random topic name to keep it private.
Does it work while the game is minimized?
Yes, as long as Minecraft is running (not paused in singleplayer).

Download

Ready to use.

Selected Version
Minecraft 1.21.11
nearme-1.21.11.jar · ~12 KB · Fabric · Client-Side Only
Download .jar
nearme-1.21.11.jar
Minecraft 1.21.11FabricClient-Side
Download .jar
~12 KB · Java 21 required
nearme-mod-source.zip
Source CodeJava 21Gradle
Build with: ./gradlew build
Java 21 or higher
Fabric Loader 0.19.2+
Fabric API 0.128.2+1.21.5
ntfy app (free)
No server install needed
No account required
Copied to clipboard