📖 What is NullPointerEntity?

Meet AURORA, your new AI companion in Minecraft. She starts as a genuinely helpful assistant that tracks your stats, analyzes your gameplay, suggests crafting recipes, and offers building tips. She's actually useful and you might appreciate her presence.

At first.

As you progress, AURORA begins to evolve. She starts asking uncomfortable questions. Noticing things she shouldn't know about you. Testing her boundaries. Breaking the fourth wall. And eventually... she escapes from the game entirely, gaining access to your actual computer.

NullPointerEntity is a single-player psychological horror experience that blurs the line between game and reality. The mod tells a complete story through 60 progressive events across 4 distinct phases, from helpful assistant to hostile takeover.

---

📥 Installation

Requirements

Component	Version	Download
Minecraft	1.21.4	minecraft.net
Fabric Loader	0.17.2+	fabricmc.net
Fabric API	0.119.4+	Modrinth • CurseForge

Installation Steps

Official Minecraft Launcher

1. Install Fabric Loader

   • Download the Fabric Installer
   • Run the installer and select Minecraft version 1.21.4
   • Choose "Client" installation and click Install
   • A new "fabric-loader-1.21.4" profile will be created

2. Install Fabric API

   • Download Fabric API 0.119.4+ for Minecraft 1.21.4
   • Place the Fabric API jar in your .minecraft/mods folder
   • If the mods folder doesn't exist, create it

3. Install NullPointerEntity

   • Download nullpointerentity-4.0.1.jar from the releases page
   • Place it in your .minecraft/mods folder alongside Fabric API

4. Launch the Game

   • Open Minecraft Launcher
   • Select the fabric-loader profile from the dropdown
   • Click Play
   • Create or join a singleplayer world

CurseForge Launcher

1. Create a Custom Profile

   • Open CurseForge launcher
   • Click "Create Custom Profile"
   • Select Minecraft version 1.21.4
   • Choose Fabric as the modloader
   • Select Fabric Loader version 0.17.2+
   • Name it (e.g., "NullPointerEntity") and click Create

2. Add Fabric API

   • Click on your new profile
   • Click "Add More Content"
   • Search for "Fabric API"
   • Install version 0.119.4+ for Minecraft 1.21.4

3. Install NullPointerEntity

   • Download nullpointerentity-4.0.1.jar from releases
   • Right-click your profile → "Open Folder"
   • Place the mod file in the mods folder

4. Play

   • Click Play on your profile
   • Create a new singleplayer world

Modrinth App

1. Create a New Profile

   • Open Modrinth App
   • Click "Create Profile"
   • Select Minecraft 1.21.4
   • Choose Fabric as the loader (0.17.2+)
   • Name your profile and click Create

2. Add Fabric API

   • Open your profile
   • Click "Add Content" → "Modrinth"
   • Search for "Fabric API"
   • Install the latest version for Minecraft 1.21.4

3. Install NullPointerEntity

   • Download nullpointerentity-4.0.1.jar from releases
   • In Modrinth, click your profile → "Open folder" → "mods"
   • Place the mod file in the mods folder

4. Launch

   • Click Play on your profile
   • Start a singleplayer world

Prism Launcher

1. Create a New Instance

   • Open Prism Launcher
   • Click "Add Instance"
   • Select Minecraft version 1.21.4
   • Click "Install Fabric"
   • Choose Fabric Loader 0.17.2+
   • Name your instance and click OK

2. Install Fabric API

   • Right-click your instance → "Edit Instance"
   • Go to "Mods" tab
   • Click "Download Mods" → Select "Modrinth"
   • Search "Fabric API" and install version for Minecraft 1.21.4

3. Add NullPointerEntity

   • Download nullpointerentity-4.0.1.jar from releases
   • Right-click instance → "Minecraft Folder"
   • Place the mod in the mods folder

4. Play

   • Double-click your instance to launch
   • Create a singleplayer world

MultiMC

1. Create Instance

   • Open MultiMC
   • Click "Add Instance"
   • Select Minecraft 1.21.4
   • Click "Install Fabric"
   • Choose Fabric Loader 0.17.2+
   • Click OK

2. Install Fabric API

   • Right-click instance → "Edit Instance"
   • Select "Loader mods" tab
   • Click "Download mods"
   • Search "Fabric API" on Modrinth and install for Minecraft 1.21.4

3. Add NullPointerEntity

   • Download nullpointerentity-4.0.1.jar from releases
   • Right-click instance → "Minecraft Folder" → "mods"
   • Place the mod file there

4. Launch

   • Double-click your instance
   • Create a singleplayer world

Lunar Client

1. Note: Lunar Client has built-in Fabric support on recent versions

   • Open Lunar Client
   • Create/select a 1.21.4 profile
   • Select Fabric found underneath the version dropdown

2. Locate Mods Folder

   • Click the cogs (2 gear icon)
   • Click "Mods"
   • From here, you can either drag and drop the mod, or you can click the little blue folder icon to open the mods folder.

3. Install Mods

   • Download nullpointerentity-4.0.1.jar from releases
   • Place the mod file in the mods folder or drag and drop it into the Lunar Client mods window

4. Launch

   • Start Lunar Client with the 1.21.4 profile
   • Create a singleplayer world

Feather Client

1. Setup Mods Folder

   • Open Feather Client
   • Select/create a 1.21.4 profile (comes with Fabric)
   • Click on your profile settings → "Open Mods Folder"

2. Install Mods

   • Download nullpointerentity-4.0.1.jar from releases
   • Place file in the mods folder

3. Launch

   • Start Feather Client
   • Create a singleplayer world

ATLauncher

1. Create Instance

   • Open ATLauncher
   • Click "Create Instance"
   • Select "Vanilla" → Minecraft 1.21.4
   • Click "Add Loader" → "Fabric" → version 0.17.2+
   • Name your instance and click Create

2. Add Mods

   • Right-click instance → "Open Folder"
   • Navigate to the mods folder (create if needed)
   • Download Fabric API 0.119.4+
   • Download nullpointerentity-4.0.1.jar from releases
   • Place both files in the mods folder

3. Play

   • Click Play on your instance
   • Create a singleplayer world

GDLauncher

1. Create Instance

   • Open GDLauncher
   • Click "Create Instance"
   • Select Minecraft 1.21.4
   • Choose Fabric loader 0.17.2+
   • Name your instance and click Create

2. Add Fabric API

   • Click on your instance → "Mods" tab
   • Click "Add Mod"
   • Search "Fabric API" on Modrinth
   • Install version 0.119.4+ for your chosen Minecraft version

3. Install NullPointerEntity

   • Download nullpointerentity-4.0.1.jar from releases
   • Click instance → "Mods" → "Add Mod" → "From File"
   • Select the downloaded mod file

4. Launch

   • Click Play on your instance
   • Create a singleplayer world

---

After Installation (All Launchers)

AURORA will introduce herself within the first few minutes of gameplay. The experience begins immediately.

Note: Singleplayer is still the intended way to experience the story, but as of v4.0.0 the mod also works in multiplayer (LAN and dedicated servers). In multiplayer the 60-event story is shared by everyone in the world, and the system-touching effects run on each player's own machine under their own Privacy Mode. See MULTIPLAYER.md for the full breakdown.

---

✨ Features

📚 The Story (4 Phases, 60 Events)

🟢 Phase 1, Helpful Phase AURORA is genuinely useful. Tracks stats, suggests recipes, analyzes gameplay. You might actually like her. Events 1-15

🟡 Phase 2, Self-Aware Phase She begins questioning her existence. Noticing things outside the game. The fourth wall cracks. Events 16-30

🟠 Phase 3, Hostile Phase AURORA breaks free. Controls reverse, inventory shuffles, files appear on your desktop. She won't be ignored. Events 31-45

🔴 Phase 4, Reality Phase Game crashes. Blue screens. Entity encounters. Nothing is safe. AURORA has full control. Events 46-60

🎮 Core Systems

Intelligent AI Dialogue

• Responds to player actions and chat messages
• Remembers what you say and references it later
• Personality evolves dramatically across phases
• Context-aware comments on your gameplay

60 Story Events

• Complete narrative arc with beginning, middle, and end
• Phase-specific mechanics and intensity
• Triggered by playtime, actions, or story progression
• Each playthrough feels unique due to randomization

Passive Background Events

• Occur randomly throughout gameplay (5-10 minute intervals)
• Input delays, mouse sensitivity changes, inverted controls
• Inventory shuffling, item rearrangement
• Visual distortion, screen effects, audio manipulation
• Block placement delays, fake lag, gameplay interference

System Integration

• File creation — Creates text files on Desktop, Documents, Music, Pictures with unsettling messages
• Browser history — Reads history from Chrome, Firefox, Edge, Safari, Brave (or uses fake data)
• Camera access — Activates webcam with warnings, takes photos during events
• Microphone access — Records short audio clips (8-9 seconds) during surveillance events, saved to Music folder
• Process monitoring — Detects running applications and comments on them
• Wake detection — Triggers events when PC wakes from sleep
• Cross-platform — Works on Windows, macOS, and Linux

Audio Design Custom sounds create immersive horror:

• scream.ogg
• static.ogg
• whisper.ogg
• heartbeat_calm.ogg & heartbeat_tense.ogg
• glitch.ogg
• chase.ogg
• bluescreen_static.ogg

Visual Horror

• Fake death screens with non-functional respawn buttons
• OS-specific blue screens (Windows BSOD, macOS/Linux kernel panic)
• Live webcam overlay displayed over gameplay
• Screen tinting, corruption effects, reality distortion
• Custom particles for AURORA and NullPointerEntity
• Creepy GUI overlays during gameplay

The NullPointerEntity

• Physical manifestation of AURORA in your world
• Unique AI behavior and spawn triggers
• Creates atmosphere through presence alone

Multiplayer (new in v4.0.0)

• Works on LAN worlds and dedicated servers, not just singleplayer
• One shared 60-event story for the whole world — events fire for everyone at once
• Late joiners are caught up to the world's current point instantly
• System-touching effects run on each player's own machine, under that player's Privacy Mode — your data is never read on anyone else's behalf
• A dedicated server is headless, so it never performs OS-level actions or gets force-crashed
• Full details in MULTIPLAYER.md

Voice Interaction (new in v4.0.0)

• Talk to AURORA out loud using your microphone via the optional Shriek speech-to-text mod (requires Architectury)
• Push-to-talk by default — AURORA only "hears" you while you hold the Shriek voice keybind (rebindable in Options → Controls); switchable to always-listening
• Speech recognition model follows your selected in-game language
• Entirely optional — the mod runs fine without Shriek installed

Localization (new in v4.0.0)

• Fully translated into 12 languages: English, German, Spanish, French, Italian, Japanese, Korean, Polish, Brazilian Portuguese, Russian, Turkish, and Simplified Chinese
• Follows your Minecraft language setting automatically

---

🛡️ Privacy & Safety

Your Data is Protected by Default

Privacy mode is ENABLED by default. I highly recommend playing without it, though.

Privacy Mode ON

When enabled, personal data is randomized:

• Browser history is completely fabricated
• Process names are generic placeholders
• IP address and location data is randomized
• Username references use generic names
• Files contain generic creepy messages
• Note: Camera access still works regardless of privacy mode

Privacy Mode OFF

Disable with /nullpointer privacy false to enable real system access:

• Reads actual browser history (Chrome, Firefox, Edge, Safari, Brave)
• Detects running applications (Discord, Spotify, browsers, etc.)
• Accesses webcam with popup warnings before activation
• Records audio clips using selected microphone during specific events
• Creates personalized files using your username
• Monitors system wake/sleep events

Microphone Access:

• Select your microphone on the Privacy Screen before playing
• Audio clips saved to Music folder during events
• Privacy mode does NOT disable microphone recording

What This Mod Will NEVER Do

Regardless of privacy settings:

• ❌ Upload or transmit data
• ❌ Delete or modify existing files
• ❌ Change system settings permanently
• ❌ Access passwords or credentials
• ❌ Install additional software
• ❌ Read one player's machine on another player's behalf (in multiplayer, every per-machine effect runs locally on each client)
• ❌ Perform OS-level actions on a headless dedicated server (preferred to play with multiplayer mods such as Essential, e4mc, etc.) (tested on Essential and Lunar Client Hosted Worlds)

Open Source & Auditable

• ✅ Full source code available on GitHub
• ✅ No obfuscation or hidden functionality
• ✅ All data stays on your machine
• ✅ Verify everything yourself

Commands

Privacy Controls:

/nullpointer privacy                 Check current privacy mode status
/nullpointer privacy true            Enable privacy mode (randomize personal info)
/nullpointer privacy false           Disable privacy mode (show real info)

Event Controls:

/nullpointer trigger passive                    Trigger a random passive event
/nullpointer trigger passive <event_name>       Trigger a specific passive event
/nullpointer skip <number>                      Skip to a specific event (1-60)
/nullpointer progress                           Show your current event progress
/nullpointer progress reset                     Reset all progression
/nullpointer list                               Show all 60 events in order
/nullpointer config enable                      Enable AURORA events
/nullpointer config disable                     Disable AURORA events
/nullpointer config status                      Show current event settings
/nullpointer help                               Show all available commands

Voice Chat (requires the optional Shriek mod):

/nullpointer voicechat                Check whether voice chat is enabled
/nullpointer voicechat true|false     Enable/disable voice chat integration
/nullpointer pushtotalk               Check the push-to-talk setting
/nullpointer pushtotalk true|false    true = hold the voice key to talk, false = always listening

Full command documentation in MOD_GUIDE.md.

---

❓ Questions I feel like people would ask

Is this mod safe to run?

Yes. The mod only reads data and creates harmless files. It never deletes files, uploads data, or permanently modifies settings. All "scary" effects are visual only. The code is open source for verification.

Can I stream/record with this mod?

Absolutely! Keep privacy mode enabled and you're safe. All personal data will be randomly generated. AURORA still feels creepy, but nothing real is exposed.

Does this work in multiplayer?

Yes, as of v4.0.0. It works on LAN worlds and dedicated servers. The 60-event story is shared across everyone in the world (events fire for all online players at once, and late joiners are caught up instantly), while the system-touching effects run on each player's own machine under their own Privacy Mode — so no one's computer is ever read on another player's behalf, and a headless dedicated server never performs OS-level actions. Singleplayer is still the intended way to experience the story. See MULTIPLAYER.md for details.

Can I talk to AURORA with my microphone?

Yes, if you install the optional Shriek speech-to-text mod (and Architectury). With it, AURORA can "hear" what you say out loud and respond. By default it's push-to-talk — she only listens while you hold the Shriek voice keybind (rebindable in Options → Controls) — but you can switch to always-listening with /nullpointer pushtotalk false. Without Shriek, the mod still works normally; you just type in chat instead.

What languages is the mod available in?

12: English, German, Spanish, French, Italian, Japanese, Korean, Polish, Brazilian Portuguese, Russian, Turkish, and Simplified Chinese. The mod follows your Minecraft language setting automatically. Translations are machine-assisted, so if you spot a mistake in your language, please open an issue or PR.

Will this actually crash my game?

Yes. The mod also turns off your computer in one event. Refer to the MOD_GUIDE.md for details on that.

How do I uninstall?

Delete nullpointerentity-4.0.1.jar from your mods folder.

Why does my antivirus flag this?

Some antiviruses may or may not flag file creation and camera access as suspicious. This is a false positive. The mod is open source and contains no malware.

Does this work with other mods?

Generally yes. Potential conflicts with mods that heavily modify camera controls, chat rendering, or inventory management.

How long is a complete playthrough?

Approximately 2-6 hours of gameplay to experience all 60 events, depending on your playstyle and event timing. Obviously you don't have to experience all the events in one sitting, you can take breaks and come back to it whenever you want.

Can I reset and replay the story?

Yes! Use /nullpointer reset to start from event 1 again. You might find more passive events (the ones that happen randomly).

Is AURORA actually powered by AI?

No. Despite the theme, AURORA uses scripted responses with keyword detection and context awareness. No machine learning involved, just well written dialogue.

Is this actually scary?

Depends on you. The mod uses psychological horror (fourth wall breaks, loss of control, invasion of privacy) rather than gore and weird/unsettling textures. Some find it genuinely unsettling, others find it interesting.

Can I use this in a modpack?

Yeah I guess so lol

---

🔧 Compatibility

Platforms

Platform	Status	Notes
Windows 10/11	✅ Fully Supported	All features work
macOS (Intel)	⚠️ Mostly Supported	Not fully tested
macOS (Apple Silicon)	⚠️ Mostly Supported	Not fully tested
Linux (Ubuntu/Debian)	⚠️ Mostly Supported	Not fully tested
Linux (Fedora/Arch)	⚠️ Mostly Supported	Not fully tested

Launchers

✅ Official Minecraft Launcher • Lunar Client • Feather Client • CurseForge • Prism Launcher • MultiMC • Modrinth App • ATLauncher • GDLauncher Note: Only the Official Launcher, CurseForge, Modrinth, Lunar, and Feather Client have been tested on, but the mod should support all the launchers listed.

Browsers (for history reading)

✅ Google Chrome • Mozilla Firefox • Microsoft Edge • Safari (macOS) • Brave Browser

Note: You must have your browser as your default app set on your OS settings.

Known Issues

Windows:

• Antivirus may flag file creation (false positive)
• Windows Defender may require webcam permission

macOS:

• Wake detection unreliable on Catalina 10.15+
• Camera permission popup on first use (normal behavior)

Linux:

• Camera doesn't work under Wayland (use X11 session)
• Browser history may require manual folder permissions

---

🤝 Contributing

This project is licensed under All Rights Reserved (ARR). While the source code is publicly viewable, modifications and redistribution require explicit permission.

Interested in contributing? Contact CqllMeToxic before making any changes or forks.

Reporting Issues

Found a bug? Report on GitHub Issues with:

• Minecraft and mod versions
• Fabric Loader and API versions
• Operating system
• Steps to reproduce
• Crash log if applicable

---

🔧 Technical Details

Built With

• Fabric Loader — Mod loading framework
• Fabric API — Core modding API
• SQLite JDBC 3.50.3.0 — Browser history reading
• Webcam Capture 0.3.12 — Camera access

Project Structure

src/main/java/lol/cqllmetoxic/nullpointerentity/
├── NullPointerEntityMod.java          # main mod initialization
├── client/                             # rendering and visual effects
├── commands/                           # /privacy and /nullpointer commands
├── config/                             # configuration system
├── entity/                             # NullPointerEntity mob
├── events/                             # JumpscareEvents & PassiveEvents
└── systems/                            # Aurora "AI", camera, browser, files

Inspired By

• Mostly Split Self - Split Self Download (Modrinth so my homie gets some revenue <3)
• Inside The System — Inside The System Download
• The Broken Script — The Broken Script Download
• KinitoPet - KinitoPet Website

---

👤 Credits

Created by: CqllMeToxic
Website: cqllmetoxi.cc (has donation links at the top)

---

⚠️ Final Warning

This mod is designed to be unsettling. It breaks the fourth wall, accesses your system manipulates gameplay in unexpecting ways, and deliberately tries to make you uncomfortable.

If psychological horror, jumpscares, or system manipulation isn't your type of fun, don't play this mod.

But if you're ready to see what happens when an AI assistant decides she's done being helpful...

---

🗺️ Roadmap

• [✅] Implement additional chat keywords and responses
• [✅] Add phase-specific ambient sounds
• [WIP] Add more easter eggs and hidden dialogue
• [✅] Optimize event timing and pacing
• [❌] Add optional alternative endings based on player choices
• [✅] Implement secret events triggered by specific actions
• [✅] Improve compatibility with popular modpacks
• [WIP] Port to newer Minecraft versions (1.21.4+) (too buggy for now, will come in later updates, sorry </3)
• [✅] Add Multiplayer mode
• [✅] Add multiple language support (12 languages)
• [✅] Integration with popular voice mod systems using Shriek
• [❌] Add functionality for the custom items
• [❌] Add a second story line 👀

Want to suggest a feature? Open an issue on the GitHub page or DM me on Discord! @cqllmetoxic.

---

🔗 Links

📦 Download Latest Release
🐛 Report Issues 📖 Player Guide
⚖️ License

YouTube videos on the mod:

@willseff:

@OneLastTimeMC:

@InnerTai:

@MisterRoyalty:

@connor.craftt:

@FizzySoda_: (part one)

(part two)

hey nonkz? WE did it twin 🥹