SanityMC

SanityMC

SanityMC is an innovative Minecraft plugin that introduces a dynamic sanity system to enhance gameplay. Players experience varying sanity levels based on environmental conditions, actions, and in-game events—ranging from subtle auditory cues to severe penalties like forced chat suppression and health loss. With extensive configuration options, gradual sanity adjustments, and integration with PlaceholderAPI, SanityMC offers immersive, customizable challenges.

Join the Discord to get updates earlier than others!

Features:

Sanity Tracking & Persistence

Current & Maximum Sanity:

Each player has a current sanity value and a maximum sanity. By default, both start at a value defined in the config (typically 100), but players can increase their maximum sanity by consuming special upgrade items. Persistence: Both current and maximum sanity values are saved to disk (in sanityData.yml and maxSanityData.yml), ensuring that a player’s sanity persists between sessions.

Gradual Sanity Adjustments

Gradual Changes:

All sanity changes (whether gaining or losing sanity) occur gradually. For example, if an event causes a loss of 3 sanity, the plugin subtracts 1 sanity point every 0.5 seconds until the total loss is applied.

Clamping:

A player’s current sanity is always clamped between 0 and their maximum sanity.

Environmental & Gameplay Conditions

Natural Drains & Gains:

Baseline Regeneration: Every 10 ticks (0.5 seconds), players gain +1 sanity. Hunger Penalty: If a player’s food level falls below 6, they lose 1 sanity every 10 ticks. Environmental Effects: Darkness, Rain, Caves, & Hostile Mobs: Conditions such as being in low light, during a storm, in a cave, or near hostile mobs trigger gradual sanity loss. Nether & Nether Portals: Spending time in the Nether or standing in a Nether portal causes additional sanity loss. Special Events: Damage: Every time a player takes damage, they lose 0.25 sanity gradually. Creeper Hiss: Occasionally, if a player’s sanity is 75 or below, a creeper hiss will play (only once every 45 seconds per player) and cause extra sanity loss. Advancements: Completing an advancement rewards the player with +20 sanity over time. Block Interactions: Breaking bells or monster spawners will drain sanity gradually, while certain actions like fishing grant sanity.

Threshold Effects

As a player’s sanity decreases, different effects become active:

Sanity ≤75: Constant gravel-step sounds play. Occasional cave sounds add to the eerie atmosphere. Sanity ≤49: Hallucination mobs (zombies with no AI) spawn briefly. Stone break sounds are played, and a custom command (e.g., a chat message) can be executed. Sanity ≤24: Jumpscare messages and random weapon swings occur. A custom command is executed and players may briefly experience blindness. Sanity <10: Players receive weakness and take random damage. Forced chat messages may appear, and they are prevented from chatting. Death at 0: When a player’s sanity reaches 0, the plugin sets their health to 0, causing them to die with a custom death message.

Worldguard Support:

Currently there are 4 flags in the worldguard, more coming in future versions, only 2 really matters, sanity-gain, and sanity-loss, which will allow sanity gain/loss in a region. The other two, sanity-death, and pet-death, if enabled, sanity-death will drop sanity if a nearby player dies, pet-death will drop sanity if a nearby pet dies.

The plugin is fully configurable via config.yml, where server admins can enable/disable individual conditions, set the intervals and amounts of sanity gain/loss, and customize threshold effect messages and commands. You can get real creative with the custom commands by creating custom commands using the Skript plugin.

PlaceholderAPI integration allows you to display the current sanity value (e.g., via %sanity_level% placeholders) in scoreboards or chat.