RandomEncounters

v0.8.6·Updated 2022-08-17

This server side mod spawns a random NPC near a random online player at random intervals, and the player wins a random item reward if the NPC is killed within the given time limit.

About this mod Author’s original text

Random Encounters mod for V Rising

See V Rising Database for detailed information about V Rising items, NPCs and more.

This server side mod spawns a random NPC near a random online player at random intervals, and the player wins a random item reward if the NPC is killed within the given time limit.

It can be configured using the configuration files which are created on first run.

Change Log

0.8.6

  • Excluded some NPCs which are summoned by other NPCs.

0.8.5

  • Removed the additional dependency to GT_VRising_GameData. It is now an embedded library.

0.8.4

  • NPCs should no longer spawn in object anymore (Well, much less frequently anyway).

0.8.3

  • Fixed an issue with InCombat detection.
  • Mod now depends on

0.8.2

  • Logging improvements.

0.8.1

  • Fixed an issue which was causing spawned NPC not being detected.

0.8.0

  • Fixed an issue which was causing the server crash.
  • You can now specify the quantities for each item in Items.cfg. Unobtainable items are disabled by default.
  • Increased performance for spawn detection.

0.7.1

  • Fixed an issue which was causing the same player being picked every time.

Source Code

Source code of this mod can be found at:

Installation

Random Encounters mod requires Wetstone plugin installed. The latest version of Wetstone can be downloaded from

Since version 0.7.0, the hot reloading feature of Wetstone does NOT work for RandomEncounters. Instead, please use the!re reload feature after you make an configuration change.

Chat Commands

All chat commands use the default prefix of!randomencounter or!re. They are only accessible by server admins.

Commands!re start or just!re: Starts an encounter for a random online user.!re me: Starts an encounter for the admin who sends the command.!re reload: Reloads the configuration without restarting the server.!re {playerName}: Starts an encounter for the given player, for example!re Adain.!re disable: Disables the random encounter timer.!re enabled: Enables the random encounter timer.

Configuration files and options:

Main.cfg

[Main]

Determines whether the random encounter timer is enabled or not.

Setting type: Boolean

Default value: true

Enabled = true

When enabled, players who are in a castle are excluded from encounters

Setting type: Boolean

Default value: true

SkipPlayersInCastle = true

When enabled, players who are in combat are excluded from the random encounters.

Setting type: Boolean

Default value: false

SkipPlayersInCombat = false

Minimum seconds before a new encounter is initiated. This value is divided by the online users count.

Setting type: Int32

Default value: 1200

EncounterTimerMin = 1200

Maximum seconds before a new encounter is initiated. This value is divided by the online users count.

Setting type: Int32

Default value: 2400

EncounterTimerMax = 2400

Maximum seconds until the player can kill the NPC for a reward.

Setting type: Int32

Default value: 120

EncounterLength = 120

The lower value for the NPC level - Player level difference. For example, if player level is 50, and this setting is 20, then the lowest level of the spawned NPC would be 30.

Setting type: Int32

Default value: 99

EncounterMinLevelDifference = 99

The upper value for the NPC level - Player level difference. For example, if player level is 50, and this setting is 20, then the highest level of the spawned NPC would be 70.

Setting type: Int32

Default value: 0

EncounterMaxLevelDifference = 0

System message template for the encounter.

Setting type: String

Default value: You have encountered a {0}. You have {1} seconds to kill it for a chance of a random reward.

EncounterMessageTemplate = You have encountered a {0}. You have {1} seconds to kill it for a chance of a random reward.

System message template for the reward.

Setting type: String

Default value: Congratulations. Your rew

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack_V_Risingmolenzwiebel-Wetstone

File & checksum

Filename
RandomEncounters-0.8.6.zip
File size
102.9 KiB
SHA-256
5923f1e6810507767e482f9a33e70e72fb15c1f89e132afbc635e3738b2df28f
Stored at
2026-10-06 19:15