Tolls | Turn every block into a business opportunity!

Three Intelligent Behavior Types
Not all blocks are created equal. Tolls understands this.

INVENTORY - Monetize Storage & Utilities
Turn every chest, furnace, and crafting table into a revenue stream. Players pay once, access the inventory. Simple economics, powerful results.

Perfect for:

• Public crafting stations that pay for themselves
• Premium storage facilities
• Enchanting table rentals
• Community furnaces and workbenches

SWITCH - Time-Based Access Control
Create doors and gates that open for exactly as long as you want. Set custom timers (1-30 seconds), watch them auto-close. VIP entrances have never been this elegant.

Perfect for:

• Temporary access to restricted areas
• Timed event gates
• Premium lever activations
• Auto-closing security systems

Bonus: Pressure plates activate for owners, open payment GUI for users. Arrows and mobs? Completely ignored.

⚡ COMMAND - Unlimited Possibilities
This is where it gets interesting. Any solid block can become a trigger for 25 different actions - from simple messages to complex sequences with fireworks, teleports, effects, and economy transactions.

25 Available Actions:

• Customizable fireworks (5 types, unlimited color combinations)
• Potion effects (speed, regen, absorption, you name it)
• Economy transactions (give, take, random rewards)
• Item management (give, take, drop, random drops)
• Player commands & console commands
• Teleportation with coordinates
• Titles, subtitles, action bars, chat messages
• Special effects (fire, sounds, particles)
• ⏱️ Precise timing with wait actions

Perfect for:

• Donation blocks with instant rewards
• Healing/buff stations with cooldowns
• Daily reward systems
• Quest completion triggers
• Teleport pads
• Mystery boxes with random prizes
• Literally anything you can imagine

Economy System That Just Works
Smart Money Management

• Vault integration - Works with any economy plugin
• Offline earnings - Players get paid even when offline
• Statistics tracking - Total earned, total payments, per-toll analytics
• Owner costs - Commands can cost the owner money per execution
• Creation costs - Optional fee to create tolls (prevents spam)
• Flexible pricing - Min/max limits, decimal support, per-toll customization

For Server Owners
Track everything. Server-owned vs player-owned tolls. Total transactions. Total revenue. All the data you need to balance your economy.

Visual System (DecentHolograms Optional!)
Three Ways to Show Toll Information
1. Holograms (requires DecentHolograms)

• Floating text above blocks
• 3D positioning (X/Y/Z offsets)
• Full MiniMessage support (gradients, rainbow, etc.)
• Auto-update on config reload

2. Ambient Particles (built-in)

• Continuous particle effects above toll blocks
• Client-side optimized - only visible to nearby players
• Configurable range and frequency
• 200x less network traffic than server-side

3. Action Bar on Look (built-in)

• Display info when players aim at toll blocks
• Updates every second
• Full formatting support
• Zero dependencies required

Mix and match or use just one. Your choice.

Comprehensive Audio Feedback
9 configurable sound effects for every action:

• Payment success & failure
• GUI open & close
• Toll creation & deletion
• ⚙️ Setting updates
• Command selection
• ❌ Errors

Every interaction feels responsive. Every action has feedback.

Powerful GUI System
Four Specialized GUIs
Each behavior type gets its own custom interface:

• gui_owner_inventory.yml - Manage inventory tolls
• gui_owner_switch.yml - Configure timers and switches
• gui_owner_command.yml - Select and manage commands
• gui_user.yml - Universal payment interface
• gui_commands_list.yml - Beautiful command selection menu

Fully Customizable

• Any slot layout (9-54 slots)
• Custom click types (SHIFT_CLICK, RIGHT_CLICK, etc.)
• Item materials, names, lore
• Full MiniMessage & color code support
• Placeholder support in all text

Command Selection Interface
No more manual command configuration. Owners browse a paginated GUI of pre-approved commands, click to assign. One command per toll. Visual glow shows what's active. It's point-and-click simple.

WorldGuard Integration
Control where tolls can exist with surgical precision:

WHITELIST Mode: "Only in these regions"
Perfect for marketplace zones and designated shop areas.

BLACKLIST Mode: "Anywhere except here"
Protect spawn, PvP arenas, and admin areas.

Region names auto-detected. Clear error messages. Startup logging shows integration status.

⚙️ Permission System
Dynamic Toll Limits
tolls.owned.15 → 15 tolls
tolls.owned.50 → 50 tolls
tolls.owned.* → Unlimited
Any number works. Highest permission wins. Perfect for donor tiers.

Simple Roles

• tolls.lock - Create tolls (default: everyone)
• tolls.admin - Full control + free toll access
• tolls.owned.* - Unlimited tolls

That's it. Clean, simple, powerful.

⏱️ Dual Cooldown System
Command Cooldowns
Prevent spam on specific commands. Set per-command in commands.yml. Tracks per-player.

Toll Usage Cooldowns
Rate-limit ANY toll regardless of type. Set per-toll via GUI. Prevents chest spam, door spam, everything spam.

Both systems:
✅ Show remaining time to players
✅ Thread-safe implementation
✅ Automatic cleanup
✅ Configurable min/max values

Command Cost System
Here's where it gets strategic:

Commands can cost the toll owner money per execution. Set cost: 5.0 in commands.yml, and every time someone uses that toll, the owner pays $5.

Why?

• Balances powerful commands (teleports, big buffs)
• Creates risk/reward for toll owners
• Prevents "set and forget" toll spam
• Owner must maintain balance or service stops

Example:
Toll price: $10 | Command cost: $3 | Owner profit: $7 per use