Singularity

Ringing ears sound loop

- Fixes click in ear ringing sound loop

- Fixed custom ammo sounds feature breaking silencers

Fixes regression (1.0.1.2): custom ammo sounds always applied, even with normal ammo.
Performance improvements.

- Adds five new entity-AI-related features that give entities more advanced decision-making (see blocks.xml for more info). For reference: New entity class types, EntityGregariousness, SetAsTargetIfHurt_BypassSameTypeCheck, RunawayFromEntity_NoImplicitPlayer, SetNearestCorpseAsTarget_Filters.

- Made NetPackageItemActionSound.GetLength() dynamic to prevent disconnections in multiplayer and for optimization
- ItemActionRanged_Patches.UpdateSounds sends NetPackages only when needed
- Fixed errors when dedicated servers load

- Added a ServerPolicies section in blocks.xml and implemented the first (and likely only one ever), which allows servers to dictate the Brightness (OptionsGfxBrightness) of clients when they join.
- Reworked gregariousness. Gregarious entities now travel from further away to join other gregarious entities of their type.
- Fixed inline documentation in blocks.xml regarding cannibalism.
- Officially dropped backward compatibility (got enough on my plate, sorry).
- Other minor improvements and optimizations.
- Tidied things up in the source enough to be worth a mention, but unless you are a GitHub rat you won't care about this one.

- Groups of gregarious entities can now be capped in size using a Singularity_GroupSize property (read blocks.xml for details).
- Updated documentation about Singularity_Gregariousness.

- Gregariousness: Fixed group counter-attacking behavior not triggering when playing offline.
- Improved examples in blocks.xml
- Very minor refactoring

- Added NoRespawnNearBackpack server policy

- Hotfix: Set AllowSpawnNearBackpack to default before closing to avoid issues

- Renamed folder to avoid locale issues with applications like Wabbajack

- Switched to SemVer
- Added an AdvancedSkyManager section. Read blocks.xml for details.

1.6.0
- New feature: some math functions in XML. See blocks.xml for details, and remember: with great power comes great responsibility.
- 2.6 stable compatibility.
- Fixed mismatching end of blood moons when using the Advanced Sky Manager.

Advanced Sky Manager changes:
- New feature: The visual start and end times of Blood Moons are now configurable (see blocks.xml).
- Improved: Reworked trader opening/closing times. They can now be configured using a digital clock format like in vanilla, and they are auto-adjusted as needed when Realistic Noons is enabled (see blocks.xml). They are also more robust and fail gracefully if badly configured.
- Improved: Fixed typo in blocks.xml and reworded a little bit.
- Fixed: NullReferenceException when joining dedicated servers.
- Fixed: Time of trader close warning not updated correctly.

SINGULARITY REFACTOR RELEASE NOTES
OVERVIEW
This refactor represents a complete architectural overhaul of the Singularity framework. The primary focus is the introduction of the SGAI system, which replaces the previous ad-hoc group assist, target selection, and flee patches with a unified, role-based AI architecture. New systems for material overrides and entity scaling are also added. The new design prioritizes performance, consistency, and modder configurability while adding emergent behaviors such as group coordination, hunger-driven feeding, startle responses, and rage mechanics.
All previously existing features (ShaderlessFX, entity stun, non-lethal explosives, ammo sounds, screen effect overrides, server policies, advanced sky manager, and XML patch operations) remain functional with only naming convention changes. This document focuses exclusively on new or significantly reworked systems.
AI SYSTEM OVERHAUL (SGAI)
Core Data Model
The SGAI system introduces a persistent per-entity data container EData, stored in a ConditionalWeakTable keyed by EntityAlive. EData tracks the entity's group role (Solitary, Alpha, Follower), emotional state (Startled, Enraged), hunger level, digestion status, confidence scale, self-preservation flag, and references to its group and alpha.
Group Roles and Formation
Group roles are assigned through the new EAIGroupUpSG task. This task reads two parameters from its XML data: chance (0.0 to 1.0, probability of being social) and groupSize (maximum members, -1 for unlimited). On execution, the task either initializes the entity as solitary, attempts to join an existing alpha with available slots, or starts a new group as alpha. Group formation occurs once per entity and is not re-evaluated on every tick. The group size property determines how many slots the alpha has available; slots are consumed when followers join and are not freed on follower death, intentionally leading to multiple smaller groups rather than one large group.
GroupD…

- Hotfix for XML encoding

- Material overrides now respect an optional variantName attribute. Omitting it keeps all overrides combined into one fixed look (same visual result as before). Using distinct names creates separate variants, with deterministic pseudo-random selection per entity. Existing mods retain the same visual outcome; this just makes variant creation more intentional. See blocks.xml for details (it is much clearer there than a short changelog entry will ever be). Technically, this is a breaking change, but I released 4.0.0 so recently, that I'm treating it as an improvement when it comes to versioning. Variants in the original implementation were as good as broken in terms of usefulness anyway.

Added guard to prevent NRE related to Twitch Integration

- Fixed omitted confidence check that was causing predators to run away too easily.

- Improved hysteresis in EAIFollowAlphaSG
- Removed unwanted home-return from EAIApproachAndAttackTargetSG while keeping chase timeout.
- Fixed erratic behavior caused by EAIRunawayWhenHurtSG
- Ensured retreat can interrupt eating (priority-driven)
- Fixed edge-case NRE during entity initialisation.