VeroxLib
An Architectury library providing a fully extensible Sanity System for Minecraft mods.
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.0to100.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:corruptionveroxlib:sanity_resistanceveroxlib: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
| Attribute | Description |
|---|---|
veroxlib:corruption | Increases sanity loss speed |
veroxlib:sanity_resistance | Controlls sanity loss (1.0 = 100% resistance) |
veroxlib:sanity_regen | Controll 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
| Loader | Supported |
|---|---|
| Fabric | Yes |
| NeoForge | Yes |
| Forge | not planned |
| Quilt | Untested |
Version Matrix
| Minecraft | VeroxLib |
|---|---|
| 1.21.1 | Supported |
| 1.21+ | Planned |
Where to go next
Contributing
Contributions are welcome.
Recommended workflow:
- Fork repository
- Create feature branch
- Implement changes
- 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
