Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
Roguenarok Foundation
Foundation for Roguenarok: synchronized raid timer, administrator controls, participant tracking and persistent server checkpoints. Required on server and clients.
By Hesher
| Last updated | 11 hours ago |
| Total downloads | 4 |
| Total rating | 0 |
| Categories | Modpacks |
| Dependency string | Hesher-Roguenarok_Foundation-0.2.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2README
Roguenarok Foundation
The networking foundation for Roguenarok, a Valheim extraction mode in development.
Install the same version on the server and every client. This release provides the raid controller and test interface; islands, travel, combat runes and extraction rewards are not implemented yet.
Features
- Shared raid state and countdown synchronized by the server.
- Waiting, preparation, raid, evacuation and finished phases.
- Raid participants retained across reconnects; players joining after raid start are spectators.
- Server-checked administrator commands.
- Persistent checkpoints scoped to the world, with atomic replacement and a backup.
- Downtime counts against the raid timer. Expired raids finish when the server starts.
- Exact mod version checking through Jotunn.
Installation
Install through r2modman or Thunderstore Mod Manager. BepInExPack Valheim and Jotunn are declared dependencies.
For a manual install, merge the BepInEx folder from the ZIP into your game or mod-manager profile folder. On a dedicated server, use the server installation folder. Restart the game or server after updates. Keep only one copy of Roguenarok.Foundation.dll.
Controls
Press F6 in a world to open the test panel. F6 or Escape closes it.
Administrators listed in the server's adminlist.txt can use:
| Command | Action |
|---|---|
| rogue status | Refresh raid status; available to any connected player |
| rogue start 300 | Start a five-minute raid after five seconds of preparation |
| rogue extract | Start test evacuation, up to two minutes and no longer than the remaining raid time |
| rogue finish | Finish the current raid or evacuation |
| rogue reset | Return to waiting |
Enter commands in the F6 panel, or in the game console if enabled. Start duration is 10–2700 seconds. The test raid supports 1–4 connected participants.
The participant counter shows connected raid members / total raid members, not total server population. Before starting a group test, have all players join the world, then reset and start the raid.
Checkpoints
Server files: BepInEx/Roguenarok/state/<world UID>/raid-state.xml and .bak.
Configure the storage directory through Server / StateDirectory in BepInEx/config/local.roguenarok.foundation.cfg. This setting is used on the server only. Interface / ShowHUD controls the local HUD.
If the main file is damaged, the backup is loaded and the damaged file is retained. If no valid checkpoint exists, or a checkpoint cannot be written, raid commands are blocked and an error is logged. New state is not acknowledged until saved. Keep the server clock correct.
Current scope and testing
This is an early prototype. Test commands do not change player inventory, grant rewards, teleport players or delete structures.
49 automated state, permission, timer, snapshot-order and persistence checks passed. Shared timer operation was tested with two players in 0.1.0. Checkpoint creation and restoration were verified on a Linux dedicated server in 0.2.0. Active-raid downtime and damaged-file recovery are covered by automated tests; repeat the multiplayer gameplay test after installing this release.
This mod was developed with AI assistance.
