📖 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 40 progressive events across 4 distinct phases, from helpful assistant to hostile takeover.

---

📥 Installation

Requirements

Component	Version	Download
Minecraft	1.21.4 - 1.21.8	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 (or any version from 1.21.4 to 1.21.8)
   • Choose "Client" installation and click Install
   • A new "fabric-loader-1.21.x" profile will be created

2. Install Fabric API

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

3. Install NullPointerEntity

   • Download nullpointerentity-1.0.0.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 (or any version from 1.21.4 to 1.21.8)
   • 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 your chosen Minecraft version

3. Install NullPointerEntity

   • Download nullpointerentity-1.0.0.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 (or any version from 1.21.4 to 1.21.8)
   • 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 your chosen Minecraft version

3. Install NullPointerEntity

   • Download nullpointerentity-1.0.0.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 (or any version from 1.21.4 to 1.21.8)
   • 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 your chosen Minecraft version

3. Add NullPointerEntity

   • Download nullpointerentity-1.0.0.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 (or any version from 1.21.4 to 1.21.8)
   • 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

3. Add NullPointerEntity

   • Download nullpointerentity-1.0.0.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 - 1.21.8 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-1.0.0.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 - 1.21.8 profile (comes with Fabric)
   • Click on your profile settings → "Open Mods Folder"

2. Install Mods

   • Download nullpointerentity-1.0.0.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 (or any version from 1.21.4 to 1.21.8)
   • 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-1.0.0.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 (or any version from 1.21.4 to 1.21.8)
   • 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-1.0.0.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.

Important: This mod is designed for singleplayer only. All features automatically disable on multiplayer servers.

---

✨ Features

📚 The Story (4 Phases, 40 Events)

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

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

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

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

🎮 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

40 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
• 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

---

🛡️ 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
• Creates personalized files using your username
• Monitors system wake/sleep events

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
• ❌ Function in multiplayer (auto-disables)

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-40)
/nullpointer progress                           Show your current event progress
/nullpointer progress reset                     Reset all progression
/nullpointer list                               Show all 40 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

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?

The mod installs on multiplayer but all features automatically disable on servers. It's designed as a singleplayer experience.

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-1.0.0.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 1.5-3 hours of gameplay to experience all 40 events, depending on your playstyle and event timing.

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?

Yes! MIT license allows use in public modpacks, modification, and redistribution. Just provide credit and link back to this repository.

---

🔧 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 open source under the MIT License. Contributions welcome!

Development Setup

git clone https://github.com/CqllMetoxic/NullPointerEntity.git
cd NullPointerEntity-1.21.4
./gradlew genSources
./gradlew runClient

How to Contribute

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes and test thoroughly
4. Commit (git commit -m "Add amazing feature")
5. Push (git push origin feature/amazing-feature)
6. Open a Pull Request

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

---

👤 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
• [❌] 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
• [❌] Port to newer Minecraft versions (1.21.9+)
• [❌] Add Multiplayer mode
• [❌] Add multiple language support
• [❌] Integration with popular voice mod systems using Shriek
• [❌] Add functionality for the custom items

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

---

🔗 Links

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

---

YouTube videos on the mod:

@willseff: