GaS QuestSpawner
Shared party hunting zones for GearAndStorage quests. Red map circles, four difficulty settings, elite enemies and minibosses. The quest owner activates a zone; party kills count too.GaS-QuestSpawner
Personal hunting zones connected to GearAndStorage quests. Accept a kill quest, find its red circle on the map and enter it to begin the hunt.
Language / Jazyk / Sprache
English: The mod follows Valheim's language: English, Czech or German. Other languages use English for mod-owned text. Configuration Manager labels and descriptions are translated; prefab names and configuration keys remain stable. Custom quest text belongs to its author and is not automatically translated. See LOCALIZATION.md in the package.
Česky: Mod používá jazyk Valheimu: angličtinu, češtinu nebo němčinu. Ostatní jazyky použijí pro texty modu angličtinu. Názvy a popisy v Configuration Manageru jsou přeložené; názvy prefabů a klíče konfigurace se nemění. Vlastní texty questů jsou obsahem autora a automaticky se nepřekládají. Podrobnosti jsou v LOCALIZATION.md v balíčku.
Deutsch: Die Mod folgt der Valheim-Sprache: Englisch, Tschechisch oder Deutsch. Andere Sprachen verwenden Englisch für mod-eigene Texte. Namen und Beschreibungen im Configuration Manager sind übersetzt; Prefab-Namen und Konfigurationsschlüssel bleiben gleich. Eigene Questtexte stammen vom jeweiligen Autor und werden nicht automatisch übersetzt. Einzelheiten stehen in LOCALIZATION.md im Paket.
Requirements
- BepInExPack Valheim 5.4.2350.
- GearAndStorage 0.5.13 or newer with its quest integration API.
- Install the same spawner and GearAndStorage versions on the server and all clients. This is not a server-only mod.
The mod manager installs the dependencies. This package contains only the spawner DLL; it does not bundle another GearAndStorage copy. Epic Loot is not required.
Hunting zones
- Each unfinished kill objective gets its own personal map circle, when suitable terrain can be found 500–1000 metres from where the quest becomes active.
- The search uses the target creature's natural biome and terrain rules. It visits nearer samples first, with 25-metre radial steps. It does not load distant terrain just to spawn enemies.
- Spawns begin only while the owner of the active quest is inside the circle, after a short streaming delay. Other players may join and fight after activation, but do not activate an inactive zone.
- Leaving pauses new spawns. Completing the kill objective, abandoning or completing the quest removes the circle and stops its spawns.
- Every spawner-created creature killed by any player inside its circle counts as one kill for that circle's objective, including stronger relatives and minibosses. Both the killer and victim must be inside. Ordinary world creatures keep GearAndStorage's normal prefab-based credit rules.
- Creatures are part of the shared world and visible to other players. A party member can kill a creature spawned for the quest owner; the kill advances the owner's quest once.
- Leftover creatures despawn after about 60 seconds without their active owner, or after wandering over 25 metres beyond the circle. Cleanup gives no kill credit or drops. Unloaded creatures are cleaned up when streamed back in.
- Live population is capped. After remote death or cleanup the conservative population record may delay replacements by up to 90 seconds.
- Zones persist with the character for the current world and quest attempt. A reaccepted quest gets a fresh attempt; old enemies do not advance it.
Difficulty in mod configuration
Edit BepInEx/config/mkova.GaSQuestSpawner.cfg, or use Configuration Manager. There is no separate difficulty menu in the game world. The server controls settings in multiplayer without overwriting the client's local file. Restart after editing configuration files.
- Easy: more basic target creatures, no elites. Up to 12 alive; batches of 3 every 12 seconds.
- Normal: mostly basic creatures with some stronger relatives, such as shamans in greyling hunts. Up to 14 alive; batches of 3 every 11 seconds.
- Hard: basic creatures, stronger relatives, larger enemies and elites. Up to 16 alive; batches of 4 every 10 seconds.
- VeryHard: mostly elite target creatures, plus one named miniboss per zone. Up to 18 alive; batches of 5 every 9 seconds.
Elites use level 3; minibosses use level 4 of an ordinary creature. They do not introduce new models or special abilities and are not imported Epic Loot bounty bosses. A miniboss is created once per zone, including if it later despawns.
Quest rewards never change. The quest JSON controls item and skill rewards. Creatures retain ordinary game/mod drop behaviour.
ZoneRadius defaults to 70 metres and supports 40–100 metres for new zones. FamiliesJson maps target prefabs to Strong, Large and Boss ordinary creature variants. Defaults cover greyling/greydwarf, skeleton, draugr, fuling, wolf and seeker families. Other targets fall back to stronger versions of themselves.
Bosses and supported creatures
Any quest containing a real boss prefab is excluded from hunting zones entirely. Boss summoning and altars remain unchanged. Putting a real boss into a family mapping does not allow it to spawn.
Land creatures with loaded natural SpawnSystem definitions are supported, including modded creatures with suitable rules. Water-only and dungeon-only targets are not supported. If no suitable point exists in the distance band, the mod reports it and retries after a minute; the quest remains completable normally.
Loaded base protection is checked before spawning. An unloaded base may not be detectable at initial map placement, so a marked area can still have blocked spawn locations when visited. Quest waves do not require the natural spawn time of day or progression key, but geographic checks remain in effect.
Quest creation
Use GearAndStorage's existing KillReqs with exact prefab names. No spawner-specific JSON fields are necessary. Place quest*.json directly in BepInEx/config/GearAndStorage/Quests/ on the server (or locally in single-player).
The package includes a Czech quest authoring cheatsheet in docs/CHEATSHEET_QUESTY_CS.md and opt-in JSON examples in docs/examples/. Examples are not automatically activated.
Validation
The original gameplay was tested by the author, including successful quest completion and cleanup. Version 1.0.2 adds shared party kill credit; live two-client verification is still recommended. Automated tests cover difficulty, distance sampling, zone boundaries, party credit, quest-attempt isolation and the real GearAndStorage kill-credit relay. Builds use the author's installed Valheim assemblies.
