MidgardPlus

Admin guide

Admin guide

Running a world or a server with MidgardPlus.

Install, the F9 panel, the settings that matter, performance, commands and the fixes people need most. In the game it is F9, Guide, Admin.

Installing

  • Mod manager: install MidgardPlus by OdinTheRed with r2modman, Thunderstore Mod Manager or Gale. BepInEx and Jotunn come with it.
  • Launcher: midgardplus.odinthered.dev. It installs the mod, sets every setting with a proper control, and installs to a rented server over SFTP or FTP.
  • Server: the dedicated server needs BepInEx, Jotunn and MidgardPlus too. It writes BepInEx/config/midgardplus.cfg on first start, and that file counts for everyone who joins.
  • Versions: the first two numbers must match on the server and every player, like 1.52. The Megin add-on must be the same version on both sides.
  • Server pack: export one from the launcher and share the link. Friends get the same mods at the same versions in one paste.
  • Patch days are Wednesday and Sunday night.

The F9 panel and how settings sync

  • Who: single player, the host, or anyone on the server's adminlist.txt, written Steam_7656... Admin panel Steam IDs narrows it further.
  • Settings: every setting with its explanation, under Game settings. Filter by Server, Yours, Follows the server and Keys. A change applies while the game runs and reaches players in a second or two.
  • Decided by the server: server settings come from the server's file and replace each player's while they are connected. Players only see their own settings in the panel.
  • Personal: keys, Panel scale, Lighter graphics, My legendary effects, Skip intro and Detailed log are always each player's own.
  • Server controls player options: on by default. Players use the server's values for hints, timers, glow and their other own options. Off lets each player keep theirs.Setting: Server controls player options
  • Settings lock: keeps your values from one update to the next in midgardplus-locked.json.Setting: Lock settings between updates
  • New settings start off: an update never switches anything on in an existing cfg.Setting: Settings added by updates start off
  • Presets: Game settings, Presets. Everything off, Shipped defaults, Relaxed, Builder, Super easy, Gentle, The middle road, Unforgiving, Harder world, Two of you, Server host, Long days and the All the ... sets. The last change can be undone, and the launcher has the same ones under Quick setups.
  • Admin: Commands, Items, Spawner and Players, where you make admins, kick and ban. Every admin action goes to BepInEx/midgardplus-admin-changes.log.Setting: Admin devcommands, Admin change log

What to switch on, by area

Every feature below starts off unless a default is given.

  • Companions: Companions, Companions per player 1, Companions need a barracks, Companions per barracks 2, Companion levels, Companion jobs, Healer companion.
  • Building: World grid, Build camera, Builder plans, Excavation, Blueprints, Flowing water, Building painting.
  • Villages: Village (new land only), Village near the start on, Village growth, Village growth days 3, Village folk talk, Village walls, Village tiers.
  • Factions: NPC factions, Faction fame, Faction oaths, Settlement assaults, Village raids, Villages held by the Ashen Host 30 in 100, More factions, Factions raid each other, Wolf clans turn at night.
  • Bosses: Mosskin boss, Gravejarl boss, Vordr boss, Red One boss, Ulfarr boss, Bokr boss, Thogn boss, Extra bosses, Cinematic boss fights, Boss scaling, Upgraded sieges.
  • Loot: Loot rarity, Spell marks, Enchanting, Supporter legendaries in loot, Legendary rumours. Legendaries start dormant on, Legendary balance As made, Legendary finisher needs growth off.
  • Production: Stations fuel themselves, Station queues, Smelters fill nearby chests. Item magnet radius 0 is off.
  • Progress: Saga Book, Bounties, Upgrade tree, Per player boss progression, Seasons, Skill caps by bosses beaten.
  • Travel and sea: Tiered portals, Portal destination picker, Server map share Off, Ship anchors, First person on ships.

Performance

  • Legendary effects: Tame at first. Light for weak machines or crowded fights, Full for the big look. Most legendary effects allowed caps what players may pick, and My legendary effects is each player's own. Damage never changes.
  • Lighter graphics: Off, Balanced or Low end, for each player, never set by a server. Lighter graphics snow thins snowstorms.
  • Flowing water: Water cells in the world, 5000, caps all the water. Water worked out by Whoever placed it is the safe choice on a dedicated server.
  • Saves: Smooth world saves shortens the save hitch on big worlds. World save interval minutes is 30.
  • Network: Network queue size 0 is the game's own. A server on a good line can try 32 to 64.
  • Slow: lines in the log name the MidgardPlus work that took longest. Read them before turning things off.

Admin commands

Type these in the F5 console as an admin. Many are buttons in F9, Admin, Commands too.

  • midgardplus report: saves one file with your version, mods and changed settings, ready for a bug report.
  • midgardplus legend: lists the legendaries. Add a name for one, all for every one, fill to fill the bar of the one in your hand.
  • midgardplus legend test NAME, or test all: maxed test copies, awake and whole. They cannot be sold, earn no deeds or leaderboard kills, and fade if dropped or when you die.
  • midgardplus legend awaken: wakes the one in your hand. midgardplus legend grow 50, or grow max: sets its growth.
  • midgardplus mosskin, vordr, gravejarl, ulfarr, bokr, thogn: calls that boss. Add clear after any but gravejarl to remove it.
  • villages list, grow, shrink, flip, raid, rest, war, capitals or tiers: living villages. factions start or clear. sieges, sieges start NAME, sieges stop, sieges reload.
  • midgardplus map kind villages: shows places on your map, also bosses, traders, dungeons, midgardplus and rumours. midgardplus map all on or off.
  • midgardplus altars, midgardplus recovery list, midgardplus water: replay boss altars, world recovery and flowing water.
  • midgardplus places status, catchup, or here TYPE: what New places in old worlds has set down, a new search now, or one place near you.
  • genloc: the game's own command, with devcommands on. Places missing locations in land nobody has explored.
  • Megin: mpl_lodge where and mpl_arena where tell where Ýdalir and Himinbjörg stand. mpl_lodge raise and mpl_arena raise put one where you stand if the world has none.

Old worlds

  • A world decides where its places go when it is made. That is why new places used to need a new world.
  • Bring new places to an old world: turn it on once after an update and load the world. New MidgardPlus places go into land nobody has walked.Setting: Bring new places to an old world
  • New places in old worlds: also uses explored land, only on flat dry ground away from builds, wards and tames, 45 seconds after the world loads. Back up the world first.Setting: New places in old worlds
  • genloc does the same for the game's own locations and the replay altars.
  • Villages only appear in land nobody has generated yet, so switch Village on before players explore.
  • No Ýdalir or Himinbjörg: stand on a flat spot and run mpl_lodge raise or mpl_arena raise.

The dev channel

  • Dev builds come out between patch days. In the launcher: Help and tools, Update channel, Dev, then paste the key pinned in #dev-builds on Discord.
  • A dev build that adds new network parts cannot join stable servers until patch day. The launcher says which kind it is.
  • Servers stay on stable unless you choose otherwise. Back to Stable is one click.

Logs and bug reports

  • The log: Valheim/BepInEx/LogOutput.log, on the server and on each player.
  • Send it as a file, not a paste. The launcher's Send my log takes names, Steam IDs and IPs out first.
  • Detailed log: writes every line, not only the first of each kind. Turn it on before you reproduce a bug.Setting: Detailed log
  • Server logs to keep: keeps each run's log in BepInEx/logs, so a crash is still there to read.Setting: Server logs to keep
  • Slow: lines name what took too long. Send them with any lag report.
  • Where: #help-and-bugs on Discord, with what you did, the log file, hosting or joining, and your version.

Megin server settings

  • Everything starts off. Turn on The Lodge in F9, group Megin, or in BepInEx/config/midgardplus.lodge.cfg.
  • Lodge record: Character, the default, keeps rank and powers with the character and the server checks them. Server makes the server's record win, and strangers start as guests.
  • Trials: Saga Book, Simple or None. Power slots 4. Rare affinity chance 5.
  • Megin paths: off. Path change coin 300, Path change wait days 3, Path change points lost 3.
  • Lodge quests: off. Staged trials, Máldagi, callings, elders' tales and daily work. Contract refresh minutes 60.
  • Himinbjorg: off. Himinbjorg entry fee 25, Himinbjorg wait minutes 10, Himinbjorg reward strength 1.
  • Hamskipti: off. Megin powers hit players: off, with its own PvP limits.

Common problems

  • Keys stop working: a MidgardPlus window or another mod's window is still open and holds the game's keys. Close it. If an overlay or another program owns the key, change it under Keys.
  • A player's setting does not apply: Server controls player options is on, so the server's value wins while they are connected. The log lists every setting the server sets differently.
  • A feature seems ignored: another mod may do the same job. Step aside for other mods lets that mod have it and says so in the log.Setting: Step aside for other mods
  • Extra bag rows with another inventory mod: MidgardPlus leaves a bag alone while another mod owns it. Keep rows in one mod. Empty rows past 9 before removing MidgardPlus.Setting: Extra inventory rows, Bag rows past 9
  • Version mismatch: the join error names the side that is out of date. Update both to the same 1.52.
  • Nothing new after an update: new settings start off. Switch on what you want.

New in 1.52