Locking Mechanism

Locking Mechanism

Overview

The locking mechanism prevents concurrent account access conflicts across single-server and multi-server deployments.

How It Works

Bank uses lock records during account load/save cycles:

• Standard lock mode uses boolean lock state.
• Time lock mode uses timestamp-based unlock logic.

When a player switches servers quickly, lock checks reduce duplicate load/write risk and preserve account integrity.

Configuration

Relevant keys:

• Bank.Save.Lock.Time
• Bank.Save.Load.Delay

Commands

Admin lock operations:

• /bank admin lock <player> <true/false>

Permissions

• bank.admin.lock

Data and Storage

Lock state is persisted in storage lock tables/collections:

• standard lock records
• time-lock records

Examples

• Multi-server network with rapid server switching benefits from lock enforcement to avoid data races.

Troubleshooting

• Player appears stuck locked: inspect lock state and use admin lock command.
• Frequent lock warnings: review server switching flow and save latency.

Related Pages

• Storage and Persistence
• Admin Operations and Troubleshooting