NullPointerEntity (Optimized)

# NullPointerEntity This modpack will be updated with the next upate of the NullPointerEntity mod. **I HIGHLY recommend playing this on the Vanilla launcher, Feather, or Lunar Client. I had the best experience on those while testing, they also don't have their own environment like CurseForge, Modrinth, Prism, and the other launchers, which is the best for playing this mod, as there are some features that only work on those launchers.** Drop a **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](https://github.com/CqllMeToxic/NullPointerEntity/blob/master/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](MULTIPLAYER.md) **Voice Interaction (new in v4.0.0)** - Talk to AURORA out loud using your microphone via the optional [Shriek](https://modrinth.com/mod/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. | Feature | Privacy Mode ON | Privacy Mode OFF | |---------|------------------------------|---------------------------| | **Browser History** | ❌ Random fake data | ✅ Reads actual history | | **Process Monitoring** | ❌ Generic fake names | ✅ Real running apps | | **Location/IP Data** | ❌ Randomized fake data | ✅ Real IP and location | | **Username** | ❌ Generic reference | ✅ Your Windows username | | **Camera Access** | ✅ Still accesses webcam | ✅ Accesses webcam | | **Microphone Access** | ✅ Records audio clips | ✅ Records audio clips | | **File Creation** | ✅ Generic messages | ✅ Context-aware content | | **Safe for Streaming?** | ⚠️ Camera and mic still work | ❌ No | ### 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 Trigger a specific passive event /nullpointer skip 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](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](MULTIPLAYER.md) for details. Can I talk to AURORA with my microphone? Yes, if you install the optional [Shriek](https://modrinth.com/mod/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](https://github.com/CqllMetoxic/NullPointerEntity/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](https://fabricmc.net/)** — Mod loading framework - **[Fabric API](https://github.com/FabricMC/fabric)** — Core modding API - **[SQLite JDBC](https://github.com/xerial/sqlite-jdbc) 3.50.3.0** — Browser history reading - **[Webcam Capture](https://github.com/sarxos/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