Documentation
Supported Blocks
- Buttons (any)
- Pressure plates (any)
- Bells
- Levers
- (Can be changed in config!)
How to Add a Doorbell

1. Use /doorbell bind <name>
2. Right-click a supported block (button, plate, bell, lever)
3. The block is now a doorbell with your chosen name!

Doorbell Access
- Public: Anyone can ring.
- Private: Only the owner and added members/housemates can ring or activate the bell (redstone is blocked for outsiders).
Adding & Removing Members

• Add with /doorbell addmember <name> <player>
• Remove with /doorbell removemember <name> <player>
• Members get notifications just like the owner!

Changing Mode
- Use /doorbell mode <name> public to let everyone ring
- Use /doorbell mode <name> private for only members
GUI
- Use /doorbell gui to open a menu for all your bells
- Left-click: Teleport (if you have doorbell.teleport permission)
- Right-click: Delete
Notifications
- Owner/Members Online: Instantly notified by chat, sound, titles, and particles (all effects are configurable)
- Owner Offline: Gets an EssentialsX mail (if present) or mailbox message (shown with /doorbell mail or on join)
- Ringer: Always gets animated effects and confirmation
History
- See who rang your doorbell and when with /doorbell history <name>
- Up to 25 most recent rings per bell
Cooldown
- Customizable cooldown per bell (see config)
- Prevents spam ringing
Mailbox
- Missed notifications are stored and shown with /doorbell mail
- Supports both EssentialsX and internal mailbox
Config Reload
- Use /doorbell reload (needs permission) to reload all config and effects live
Permissions
- doorbell.use — Use main commands (default: true)
- doorbell.teleport — Teleport via GUI (default: OP)
- doorbell.reload — Reload config (default: OP)
- doorbell.admin — Admin (future, full control) (default: OP)
Multiworld and Advanced Support
- Doorbells work in any world or dimension
- You can bind as many bells as you want, anywhere
Configuration
- All effects (particles, sounds, titles) can be customized in effects.yml
- Allowed blocks can be changed in config.yml
- Cooldowns, GUI options, and more are easily configurable