๐ Mod Overview & Core Features
๐น Stalking Entities
- Goat Stalker โ Carries an unsettling portrait, materializes, pauses/slides/fades then chases. Peers through windows.
- Something โ Haunts dark enclosed spaces. Vanishes if looked at, pursues if ignored. Summons minions.
- Something Minion โ Breaks soft blocks to reach you (when mob griefing is on). Lasts 90 seconds.
- Tears Before Bedtime โ Independent hostile entity. Immediate chase, 64 HP, hits hard.
- Bed Peeker โ Appears at foot of bed while sleeping. Stands motionless, vanishes when spotted.
๐ Night Horror Events
- Door Peeker โ Opens nearby doors and peeks inside during night sequences.
- Window Head & Hand โ Head appears above window, slides down breaking glass. Hand reaches in.
- Torch-lined Tunnel โ Rare event with mineshaft-style tunnel appearing nearby.
- Rising Audio Cues โ Creepy bass countdown music before each event.
- Per-player Cooldowns โ Same scare type cannot repeat immediately.
๐ RUN Dimension
- Access Method โ Hold a book with "square root of 3" near a Nether portal.
- Baldi-style Schoolhouse โ Collect 7 notebooks while being hunted.
- SQuArE rOOt Of 3 โ Hulking pursuer spawnable via spawn egg.
- Large RUN Overlay โ Appears on screen while inside the dimension.
- High Risk โ Bring no essential items; focus on notebooks.
๐ฅค Bsoda System
- Empty Bsoda Can โ Dropped by every mob on death.
- Filled Bsoda โ Right-click water source to fill.
- Knockback Spray โ 10-second directional knockback beam from your eye.
- Infinite Use โ Filled can never depletes.
- Creative Variant โ Infinite Bsoda available in creative mode.
๐ ๏ธ Technical Summary
๐งฌ Entity AI Systems
- Goat Stalker AI โ Stalk โ Pause โ Slide โ Fade โ Chase state machine.
- Something AI โ Dark space detection, line-of-sight based vanish/pursue logic.
- Minion Spawning โ Up to 3 minions summoned during chase, break soft blocks.
- Window Peek System โ Scripted sequences with glass breaking mechanics.
- Bed Peeker Trigger โ Activates while player is sleeping in bed.
๐ฆ Dimension & Events
- RUN Dimension โ Custom dimension with Baldi-style schoolhouse generation.
- Night Event Timer โ Every 3 minutes at night, triggers horror events.
- Audio System โ Rising bass countdown cues before each event.
- Event Cooldowns โ Per-player cooldowns prevent repetition.
- Portal Detection โ Nether portal + book detection for RUN entry.
โ๏ธ Death & Respawn Mechanics
- Custom Respawn โ Mineshaft-style tunnel near death site.
- Blindness Effect โ 5 minutes of Blindness on respawn.
- Creative Bypass โ Creative players are NOT immune to stalker kills.
- Spectator Ignore โ Spectator players are ignored by all stalker logic.
- Death Message โ "[Player] was dragged away by the creatures."
๐ฎ Commands & Items
- /stalkermod โ Force-trigger horror music and events.
- /stalkemod โ Typo-compatible alias.
- Empty Bsoda Can โ Dropped by all mobs on death.
- Filled Bsoda โ Right-click water to fill, sprays knockback.
- Spawn Eggs โ SQuArE rOOt Of 3, Yelling Creature, Tears Before Bedtime.
โข Goat Stalker: Materialization โ Pause โ Slide โ Fade โ Chase state machine.
โข Something: Light level 7 or below detection, line-of-sight AI.
โข Minions: Break soft blocks, 90-second lifespan, up to 3 at a time.
โข RUN Dimension: Custom generator with notebook collection system.
โข Bsoda: Infinite use after filling, 10-second knockback beam, 1.75s cooldown.
๐พ Entity & Event Guide
Entities
| Entity | Behavior | Special Abilities | HP |
|---|---|---|---|
| Goat Stalker | Stalks, peeks through windows, materializes then chases | Pause โ Slide โ Fade โ Chase; Right-look apparition | 30 |
| Something | Haunts dark spaces, vanishes when looked at | Summons minions, cave climber variant, breaks blocks | 40 |
| Something Minion | Summoned during chase, pursues player | Breaks soft blocks, 90-second lifespan | 15 |
| Bed Peeker | Appears at foot of bed while sleeping | Motionless stare, vanishes when spotted | N/A |
| Tears Before Bedtime | Immediate chase, plays theme music | 64 HP, 10 damage, TBB Deluxe Icon billboard | 64 |
| SQuArE rOOt Of 3 | Always in chase mode, RUN dimension pursuer | Fast, hard-hitting, spawn egg available | 50 |
| Yelling Creature | Transforms into CRT TV, smashes out and chases | Full transformation animation | 35 |
Night Horror Events
Door Peeker
- Opens nearby door during night sequence
- Peeks inside for short scan period
- Slides further in if not spotted
- Message: "something opened your door and peeked inside"
- Closes door when event ends
Window Head & Hand
- Head appears above window, stares down
- Slides downward breaking glass panes/blocks
- Hand reaches in and withdraws
- Breaks up to 4 glass panes
- Message: "the head slides down your window and four panes break"
Bed Peeker
- Spawns at foot of bed while sleeping
- Stands completely still facing you
- Disappears when you wake up
- Cannot attack
- Triggers during sleep sequence
Torch-lined Tunnel
- Rare event
- Mineshaft-style tunnel appears nearby
- Requires time since last tunnel event
- Per-player cooldown applies
๐ฅค Bsoda System & RUN Dimension Guide
๐ฅค Bsoda System
1. Kill any mob โ receive Empty Bsoda Can.
2. Hold can and right-click on water source โ Filled Bsoda.
3. Right-click with Filled Bsoda โ spray knockback beam from eye.
4. Beam pushes mobs continuously for 10 seconds.
5. Cooldown: 1.75 seconds between uses.
6. Filled can never depletes โ infinite use!
โข Empty Bsoda: dropped by every mob on death
โข Filled Bsoda: right-click water source to fill
โข Spray: 10-second directional knockback beam
โข Cooldown: ~1.75 seconds
โข Creative: Infinite Bsoda variant available
๐ RUN Dimension
1. Open Book and Quill.
2. Write "square root of 3" anywhere in text.
3. Close book (signing optional).
4. Hold book in either hand.
5. Stand near a lit Nether portal.
6. Dimension transition triggers automatically.
7. Collect 7 notebooks while being hunted.
8. Large RUN overlay appears on screen.
โข Baldi-style schoolhouse environment
โข SQuArE rOOt Of 3 hunts you throughout
โข Collect 7 notebooks to escape
โข Bring no essential items โ focus on survival
๐ Death Consequences & Respawn
โ ๏ธ When Killed by a Stalker
- Killed by: Goat Stalker, Something, or Something Minion
- Respawn Location: Newly generated mineshaft-style tunnel near death site
- Blindness: 5 minutes of Blindness upon respawn
- Creative Immunity: Creative players are NOT immune to stalker kills
- Spectator: Spectator players are ignored by all stalker logic
- Death Message: "[Player] was dragged away by the creatures."
๐ก๏ธ Survival Tips
- Sleep safely: Enclosed rooms with no glass = no Window Head event.
- Secure doors: Use trapdoors or keep doors on interior to limit Door Peeker.
- Craft Bsodas early: Every mob kill yields a can โ prepare before night.
- Look at Something: Dismiss it immediately before it spawns minions.
- Don't look at Goat Stalker: Looking at its apparition dismisses it harmlessly.
- RUN prep: Bring no essential items โ focus on collecting notebooks.
๐ฅ Installation Guide
๐งต Fabric Installation
RECOMMENDED Best performance & stability
1. Install Fabric Loader for your MCPE version.
2. Download Fabric API from Modrinth or CurseForge.
3. Download StalkerMod-Fabric-[version].jar.
4. Place both JARs in .minecraft/mods/ folder.
5. Launch using Fabric profile.
โโโ mods/
โโโ fabric-api-0.92.0+1.20.1.jar
โโโ StalkerMod-Fabric-1.0.0.jar
โ Note: Fabric API is mandatory.
โ๏ธ NeoForge Installation
ALTERNATIVE For Forge ecosystem
1. Install NeoForge for your MCPE version.
2. Download Kotlin for Forge (KFF) โ required.
3. Download StalkerMod-NeoForge-[version].jar.
4. Place both JARs in mods/ folder.
5. Launch NeoForge profile.
โโโ mods/
โโโ Kotlin-For-Forge-4.11.0-all.jar
โโโ StalkerMod-NeoForge-1.0.0.jar
โ ๏ธ Important: Without Kotlin for Forge, the mod crashes on launch.
๐ Quickstart & Recommendations
- Quickstart: Play at night in any Overworld biome โ horror events trigger automatically every 3 minutes.
- Bsoda: Kill any mob โ Empty Bsoda Can โ right-click water โ Filled Bsoda.
- RUN Entry: Write "square root of 3" in a book, hold it, stand near Nether portal.
- Command: Use
/stalkermodor/stalkemodto force-trigger horror events. - Performance: Fabric version is lighter and recommended for best FPS.
- Mod Compatibility: Works with most performance mods and world gen mods.
1. Download Fabric/NeoForge server launcher.
2. Add Stalker Mod + required API/Kotlin mods to "mods" folder.
3. Start server (agree to EULA).
4. Configure event rates in /config/stalkermod/.
โจ๏ธ Commands
โข /stalkermod โ triggers horror event sequence with audio cues
โข /stalkemod โ works exactly the same (for those who typo)