Back to mods

Vintage Story Mod DB · Vintage Story mod

BetterQueue

I saw a lot of frustration with the launch of a new popular server where people waited hours for the queue and then crashed at the end or had to redownload 1 mod and move to the back of the queue again. I felt this is an oversight so I changed it. Server side

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which BetterQueue release should I use?

Updated today
Latest stable file 1.1.0
Game version 1.22.0, 1.22.1, 1.22.2
Loader Built-in Vintage Story mod system

BetterQueue 1.1.0 targets 1.22.0, 1.22.1, 1.22.2. Do not install it on the client. It must be installed on the dedicated server. No extra mods listed for this file.

Where it goes

Is BetterQueue required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported
Dedicated server Required
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This Vintage Story file is marked server-only.

What else does BetterQueue 1.1.0 need?

1.1.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add BetterQueue without breaking your instance.

Built for BetterQueue 1.1.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.1.0. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.1.0. It opens that exact file at the source.

About this project

What does BetterQueue add?

I saw a lot of frustration with the launch of a new popular server where people waited hours for the queue and then crashed at the end or had to redownload 1 mod and move to the back of the queue again. I felt this is an oversight so I changed it. 

 

Server side only, players don't need to install anything.


What it does:

- When someone joins the queue, the server sends them its mod list right away (configurable). If they're missing mods, they get the download prompt immediately instead of after waiting through the whole queue.

- If someone disconnects from the queue (to download mods, crash, whatever) and comes back within 10 minutes (configurable), they get put back where they would have been instead of the back of the line. The line keeps moving while they're gone so they don't lose any progress.

- If someone crashes while loading in, or crashes/leaves in their first 5 minutes after getting in (no audio, menus broken, etc), they go back to the front of the line when they rejoin instead of the back. Their in-game slot isn't held open while they're gone, the next person in line gets it, they just get priority in the queue.

To keep this from being abused, kicks and bans never count, and each player can only use it 3 times an hour (configurable). All of it can be changed or turned off below.


Your server needs the queue turned on for this to do anything (MaxClientsInQueue above 0 in serverconfig.json).

You can find the config under: VintagestoryData\ModConfig\BetterQueue.json on the server

checkModsWhenQueued: true/false, sends the mod list when someone joins the queue. Default is true

keepSpotMinutes: how many minutes someone keeps their spot after disconnecting. Also how long someone who crashed after getting in has to rejoin. 0 turns it off, max is 1440 (a day). Default is 10

keepSpotAfterJoining: true/false, gives people their spot back if they crash while loading in or right after getting in. Default is true

afterJoiningMinutes: how many minutes after getting into the world still counts. The timer starts once they're actually in the world, so crashing on the loading screen always counts no matter how long loading takes. Default is 5

countLeaving: true/false, counts leaving the game too, not just crashing (for people restarting to fix something). Default is true

maxRejoinsPerHour: how many times one player can get their spot back after getting in, per hour. 0 is no limit. Default is 3

If you're updating from 1.0.0 the new settings get added to your existing config on startup.


Settings can also be changed live with commands (needs controlserver):

/betterqueue - shows current settings

/betterqueue keepminutes 10 - keepSpotMinutes

/betterqueue modcheck on - checkModsWhenQueue

/betterqueue afterjoin on - keepSpotAfterJoining

/betterqueue afterjoinminutes 5 - afterJoiningMinutes

/betterqueue countleaving on - countLeaving 

/betterqueue maxperhour 3 - maxRejoinsPerHour

/betterqueue move <PlayerName> <QueuePosition> - moves someone in the queue to that spot (1 is the front, a big number puts them at the back). They keep the new spot if they disconnect and come back. Use /list clients to see who's where

/betterqueue reload - reloads the config if you edited the file by hand


Saved spots are only kept in memory, so they reset if the server restarts.

Made for 1.22.7. It patches some of the server's queue code, so if a game update changes that the mod turns itself off and puts an error in the server log instead of breaking anything.

If you have any issues with this mod, please comment and I will look into it.

 

if you think this mod needs art and would like to make some, let me know and i'll upload it with credit. 

Project description from Vintage Story Mod DB.

Pick your setup

BetterQueue releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

8 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

BetterQueue versions and loaders

2 of 2 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.