UniversalSurvivorUnlocks

Universal Survivor Unlocks

Universal Survivor Unlocks (USU) is a configurable progression framework for modded survivors in Risk of Rain 2.

USU automatically detects compatible modded survivors, normally respects characters that already provide their own unlock requirement, and can give progression challenges to survivors that would otherwise be available immediately. Curated compatibility cases can also expose a separate USU-owned alternative without modifying the creator's Original system.

Current release: 0.3.0

· GitHub / Source Code · Support development / Donate · Discord: @shleiderick

Support / Apoyo

Donations help me keep the project updated and continue developing new presets, compatibility fixes, multiplayer improvements, and the universal mission system.

Los donativos ayudan a mantener el proyecto actualizado y a continuar desarrollando nuevos presets, correcciones de compatibilidad, mejoras multijugador y el sistema universal de misiones.

Questions, bug reports, survivor requests, preset ideas, balance feedback, and suggestions are welcome on Discord.

Preguntas, reportes de errores, solicitudes de personajes, ideas de presets, comentarios de balance y sugerencias son bienvenidas en Discord.

AI Usage Notice

Universal Survivor Unlocks has been developed with assistance from artificial intelligence tools during parts of the programming, design, writing, debugging, documentation, and visual-resource workflow.

This notice is included for transparency so players who prefer to avoid AI-assisted content can make an informed decision before installing the mod.

Aviso sobre uso de IA: Universal Survivor Unlocks ha sido desarrollado con asistencia de herramientas de inteligencia artificial durante parte del proceso de programación, diseño, redacción, depuración, documentación y recursos visuales.

Este aviso se incluye por transparencia para que quienes prefieran evitar contenido desarrollado con estas herramientas puedan decidir antes de instalar el mod.

What does USU do?

USU adds progression to compatible modded survivors without replacing the systems created by other survivor authors.

Main goals:

• Automatically detect installed modded survivors.
• Respect survivors that already have their own native unlock requirements.
• Lock compatible survivors when USU assigns them a challenge.
• Unlock survivors through gameplay instead of making every compatible character immediately available.
• Provide built-in creator-made challenge presets.
• Store survivor and challenge information in Survivors.json.
• Preserve survivor configuration when character mods are temporarily disabled or uninstalled.
• Support host-authoritative multiplayer.
• Support both shared-progress and per-player challenge designs.
• Keep vanilla and official DLC progression untouched.
• Use a reusable Mission System v2 instead of requiring a unique hardcoded tracker for every future challenge.
• Localize the official challenge names/descriptions according to the game's active language.
• Reward official USU challenges with configurable Lunar Coin rewards.

0.3.0 release focus

Version 0.3.0 adds the first public adaptive Generated mission pipeline on top of the Mission Authority & Persistence foundation introduced in 0.2.2.

Highlights:

• Compatible modded survivors with no applicable creator Original, Official USU, or player CUSTOM mission can receive a temporary Generated mission at runtime.
• Generated missions are built from the currently installed survivor/profile context and may differ between players with different local mod rosters. That is intentional: they are temporary fallbacks, not permanent authored presets.
• Generated content is not persisted as CUSTOM. If USU later gains an Official preset for that survivor, or the mod author adds an Original unlock, the authored content takes priority according to the normal provider/authority rules.
• The current generated runtime supports Execution, HealingSupport, ResourceMastery, Melee