Neuro Lurker

Neuro Lurker is a psychological‑horror presence powered by a local AI (Ollama). There is no fixed script — a language model decides what the creature does: it stalks, leaves anomalies, builds, makes sounds, reads your chat, hears your voice, and escalates over time. When it finally hunts, it chases you, smashes through glass and doors, screams, and one‑shots you. It is immortal — you can't kill it, only survive it. Everything runs on your own machine, offline and free. The AI runs only on the host; friends just need the mod.

Features

• 🧠 LLM‑driven, un‑scripted (Ollama/qwen): builds, digs, breaks/places blocks, plays sounds, spawns mobs, douses lights, leaves anomalies, summons doubles — its own choice every turn.
• ♾️ Thinks continuously at a tunable pace, not just on triggers.
• 🌑 Escalating Director: dormant → traces → night sightings → cave sounds → daytime watching → window peeking → villager loss → hunting. Taunting it (chat/voice) makes it angrier and escalates faster.
• 💬 Reads your chat & hears your voice (RU/EN) — but answers only ~1 in 4 times (silence is scarier).
• 🩸 Immortal hunter: can't be killed; breaks glass/doors/trapdoors/fences/leaves to reach you, screams loudly, and one‑shots on contact.
• 🪦 20+ anomalies: cairns, skull‑on‑post, mushroom rings, graves, soul fire, bone piles, hanging lanterns, dug pits, sculk, wither roses, iron cages, blood trails, glowing signs with your name, a hanged figure, and a copy of your base — with a copy of YOU inside that vanishes as you approach. qwen can also invent its own.
• 👥 Doubles: figures wearing a real player's skin appear and vanish as you get close.
• 🎞️ Custom animated model (GeckoLib, bundled): idle sway, a lurching run, glowing eyes in the dark.
• 🗣️ Whisper voice (optional) via Simple Voice Chat.
• 👨‍👩‍👧 Multiplayer aware: hears every player, personal memory per player.
• ⚙️ All in‑game, no command line: “👁 Lurker” button on title & pause screens — live status, event journal, model auto‑detect, and a one‑click Setup that downloads Ollama, the model and whisper for you.

Requirements

Minecraft 26.1.2 + Fabric Loader + Fabric API · Ollama (host) with qwen2.5:7b (or 14b), downloadable in‑game · GeckoLib bundled.

Installation

1. Install Fabric for MC 26.1.2 — https://fabricmc.net/use/installer/
2. Put lurker.jar + Fabric API (https://modrinth.com/mod/fabric-api) into mods (%appdata%\.minecraft\mods / ~/Library/Application Support/minecraft/mods).
3. Launch the fabric‑loader 26.1.2 profile.

Set up the AI (host) — no command line

Install & run Ollama (https://ollama.com/download) → in game “👁 Lurker” → ⚙ Setup → Download model → I am host = YES → Save.

Optional voice

Simple Voice Chat (all) lets it speak; whisper (host) lets it hear — ⚙ Setup → Install whisper downloads it for you (or point the “whisper folder” at whisper-server + ggml-small.bin).

Commands

/lurker spawn · hunt · doubles · anomaly · status · advance · day [n] · config (continuous on|off, interval <sec>, whisper <path>, host, model, url)

System requirements

👥 Guests (just the mod)

Same as normal modded Fabric 26.1.2:

• 4‑core CPU · 8 GB RAM · any GPU that runs Minecraft · ~2 GB free disk.
• They don't run the AI, so the mod adds almost no load.

🖥️ Host — Minimum (use qwen2.5:7b)

• CPU: modern 6‑core (Ryzen 5 / Core i5)
• RAM: 16 GB
• GPU: 6 GB VRAM (GTX 1660 / RTX 2060) — or Apple Silicon with 16 GB unified memory
• Disk: ~15 GB free (SSD)
• OS: Windows 10/11 64‑bit, or macOS (Apple Silicon)
• ⚠️ CPU‑only works, but the creature reacts slowly (responses take several seconds).

🚀 Host — Recommended (qwen2.5:14b, continuous mode, smooth)

• CPU: 8‑core+ (Ryzen 7 / Core i7)
• RAM: 32 GB
• GPU: 10–12 GB VRAM (RTX 3060 12 GB / 4060 Ti or better) — or Apple Silicon with 24 GB+ unified memory
• Disk: ~25 GB free SSD
• OS: Windows 11, or macOS (Apple Silicon)

Weak / no GPU?

• Use qwen2.5:7b instead of 14b.
• Turn off continuous mode (/lurker config continuous off) or raise /lurker config interval 60.
• Speech (whisper) is light: ~1 GB RAM and runs fine on CPU.