Vault Limiter

A server-side utility mod for Vault Hunters that allows server administrators to limit the number of concurrent vault instances. This helps manage server resources and encourages coordinated vault running among players.

Usage Rights

✅ You may:

Include this mod in any modpack
Use it on public or private servers

No permission needed - just go ahead and use it! All I ask is that you don't claim it as your own work.

Overview

Limit the number of concurrent vault instances
Configure maximum vault duration for notification purposes
Customizable world folder name support
Excludes The Other Side and Arena dimensions from limits
Easy-to-use admin commands
Shows remaining time until a vault slot becomes available

Installation

Download the mod and place it in your server's mods folder
Install on server side only - no client installation required
Start/restart your server
Configure settings using in-game commands or the config file

Configuration

In-Game Commands

All commands require operator permissions (level 2):

/vaultlimit <number> - Set maximum concurrent vaults (1-100)
/vaultlimit status - Show current settings and active vault count
/vaultlimit timeout <minutes> - Set maximum vault duration for notification purposes (1-120)
/vaultlimit worldfolder <name> - Set world folder name (default: "world")
/vaultlimit help - Show all available commands

Config File

Located at: world/serverconfig/vaultlimiter-server.toml

[Vault_Limiter_Configuration]
    # Maximum number of concurrent vaults allowed
    maxConcurrentVaults = 3

    # Maximum vault duration in minutes
    vaultTimeoutMinutes = 30

    # Name of the world folder (usually 'world' unless customized)
    worldFolderName = "world"

How It Works

The mod monitors vault crystal usage and active vault instances
When a player attempts to create a new vault:
- Checks the current number of active vaults
- Compares against the configured limit
- If at limit, prevents portal creation and shows time until next available slot
Vault counting method:
- Counts unique vault dimensions that players are currently in
- Excludes The Other Side and Arena dimensions
- Automatically handles vault cleanup

Example Messages

When at vault limit:

Cannot create vault portal: Maximum concurrent vaults (3) already reached.
Maximum vault duration remaining: 15m

Status command:

Current settings:
- Vault limit: 3
- Maximum duration: 30 minutes
- World folder: world
- Active vaults: 2

Common Use Cases

Resource Management: Prevent server overload from too many concurrent vaults
Coordinated Gameplay: Encourage players to coordinate vault runs
Custom Setups: Support for modded server configurations with custom world folder names

Compatibility

Required: Minecraft 1.18.2
Required: Forge 40.1.0+
Required: Vault Hunters (tested with version 3.16.0.1)
Server-side only

Support

If you encounter any issues or have suggestions:

Check the known issues section below
Visit our GitHub repository (link)
Join our Discord server (link)

Known Issues

None currently reported

Future Plans

Additional configuration options
Integration with more vault crystal types
Performance optimizations
Statistics tracking