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

1. Download the mod and place it in your server's mods folder
2. Install on server side only - no client installation required
3. Start/restart your server
4. 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

1. The mod monitors vault crystal usage and active vault instances
2. 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
3. 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

1. Resource Management: Prevent server overload from too many concurrent vaults
2. Coordinated Gameplay: Encourage players to coordinate vault runs
3. 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:

1. Check the known issues section below
2. Visit our GitHub repository (link)
3. 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