MoonforgedEventManager

Moonforged Event Manager

Bring races and community competitions to your Valheim server with Viking-style gates, banners, horns, runes and live scoreboards. Keep past results on the event board, and remember your fallen Vikings on a carved Death Note stone.

Use Event Manager, Death Note, or both. Each can be enabled separately in the configuration.

Video Tutorial

Watch the showcase and tutorial to see race setup, event controls, scoreboards and Death Note in action.

Watch the Moonforged Event Manager tutorial on YouTube

Event Grounds

• Start and finish gates with lanterns that light up at night.
• Direction, danger, safe-haven and welcome banners.
• Personalized banners for your server name.
• Registration and finish runes.
• An event horn with separate start and finish sound choices.
• A wooden event scoreboard with Current Race, Race Deaths and Event History columns.
• A stone winner's stand for your event grounds.

Pieces appear in the Moonforged Event Manager Hammer category. Change General → CustomHammerTab to use another category name.

Start and Finish Gates

Mark your course entrance and finish line.

Direction Banners

Guide racers around the course with directional markers.

Danger and Safe-Haven Banners

Mark hazards and safe areas along the route.

Personalized Banners

Welcome players with your server name, set through the banner configuration.

Winner's Podium

Give your first-, second- and third-place racers a place to celebrate.

How to Run a Race

1. Build a course with a Start Rune, Finish Rune, Event Horn and Event Scoreboard.
2. Add the organizers' in-game character names to AdminPlayerNames in the configuration. Separate multiple names with commas.
3. Players use the Start Rune to register.
4. A configured race admin uses the horn to start the event. The horn finishes playing before the countdown begins. Wait for GO! before racing.
5. Each racer uses the Finish Rune to record their finish time.
6. When the last registered racer finishes, the event ends automatically. Everyone receives EVENT FINISHED, and the selected finish horn plays regardless of distance. Rankings stay on the board.
7. A configured race admin uses the Start Rune to reset and reopen registration for the next race.

Example race-admin setting:

AdminPlayerNames = Caenos,AnotherCharacter

Race organizers do not need Valheim server-admin status to run races when their character names are configured. Changing protected server settings and using the data-clearing buttons requires server-admin access.

Cancel an Interrupted Race

A configured race admin can Shift + Use the Start Rune twice within five seconds to cancel and reset the current event. This stops the horn/countdown and reopens registration. Saved event history and world death totals are preserved.

Browse Event History

Completed events are saved per world. The history column shows the number of saved events and a selectable event list.

• Previous / Next: move the selection.
• Show Event: display the selected event's results.
• Either arrow while viewing results: return to event selection.

Only configured race admins can change the selection. The displayed selection and results are shared with players on the server.

Death Note — Deaths of the Realm

A carved memorial stone displays player names and world death counts in three columns, with up to 30 players per page. Longer names shrink to fit their space, while death counts have their own reserved area. Additional pages rotate automatically.

• A player's name is added on their first recorded death.
• World totals persist between sessions and are sent to joining players.
• Deaths can show a top-screen announcement with the player name, cause and total. Creature names are included when the attacker can be identified.
• On the first recorded death, the stone plays an Obliterator-style visual lightning effect without damage. The player's name glows blue before returning to the carved appearance.
• Registered racers can also have their deaths counted for the current race.

Counting begins when the feature is enabled; the mod does not reconstruct earlier deaths. Disabling Death Note preserves its saved totals. Race-only death counts remain part of Event Manager.

Configuration

Launch the mod once to create:

BepInEx/config/Caenos.MoonforgedEventManager.cfg

Use an in-game Configuration Manager or edit the file while the game/server is stopped.

General

• EventManagerEnabled: enable events and their Hammer pieces. Switching it off cancels the current race and preserves saved history.
• DeathNoteEnabled: enable world death tracking, its board, announcements and sound.
• CustomHammerTab: choose the Hammer category name.