Pixel Dream StudiosWiki

VeroxLib

An Architectury library providing a fully extensible Sanity System for Minecraft mods.

Minecraft Loader Architectury License API

VeroxLib is a Architectury-based library for Minecraft mods that introduces a fully extensible Sanity System.

It provides developers with an easy-to-use API for managing player mental states, triggering madness effects, and integrating sanity-related gameplay mechanics across Fabric and NeoForge.

Overview

VeroxLib allows mods to simulate psychological mechanics such as fear, corruption, hallucinations, or insanity without reinventing infrastructure.

Features

Global Sanity System

  • Every player has a sanity value from 0.0 to 100.0
  • Sanity Loss in specific biome with the tag: is_horror_biome

Modular Madness Effects

  • Register effects triggered by sanity thresholds
  • Client or server execution support

Custom Attributes

VeroxLib automatically registers:

  • veroxlib:corruption
  • veroxlib:sanity_resistance
  • veroxlib:sanity_regen

Cross-Platform Support

Works on:

  • Fabric
  • NeoForge

via Architectury.

Cultist System

Built-in support for Cultist players:

  • Immune to sanity effects
  • Ideal for factions, classes, or lore systems

Attributes

AttributeDescription
veroxlib:corruptionIncreases sanity loss speed
veroxlib:sanity_resistanceControlls sanity loss (1.0 = 100% resistance)
veroxlib:sanity_regenControll sanity regen (1.0 = 100% regeneration)

Example Use Cases

  • Horror mods
  • Psychological survival gameplay
  • Lovecraftian mechanics
  • Magic corruption systems
  • RPG classes & factions
  • Hallucination systems

Compatibility

LoaderSupported
FabricYes
NeoForgeYes
Forgenot planned
QuiltUntested

Version Matrix

MinecraftVeroxLib
1.21.1Supported
1.21+Planned

Where to go next

Contributing

Contributions are welcome.

Recommended workflow:

  1. Fork repository
  2. Create feature branch
  3. Implement changes
  4. Submit Pull Request

Please keep API stability in mind.

License

Licensed under the MIT License.

You may freely:

  • Use in mods
  • Include in modpacks

Attribution appreciated but not required.

Support

If you encounter issues:

  • Open a GitHub Issue
  • Provide logs
  • Include loader + Minecraft version

On this page