Doorbell

Doorbell
A modern, feature-rich plugin that adds real, interactive doorbells to your Minecraft server.

---

Features

• Custom doorbells: Bind bells, buttons, pressure plates, or levers as named doorbells.
• Rich notifications: Players receive chat, sound, title, and particle effects when a doorbell is rung.
• Offline support: Missed rings are delivered through EssentialsX Mail when available, or through the built-in mailbox system.
• Configurable effects: Sounds, particles, and titles can all be customized.
• GUI management: Manage your doorbells through a clean GUI with pagination support.
• Teleport support: Teleport to your doorbells from the GUI with the proper permission.
• Public and private modes: Let everyone ring, or restrict access to the owner and members only.
• Access control: Private doorbells cannot be rung or triggered by non-members. Unauthorized redstone activation is blocked.
• Member system: Add friends or housemates so they receive notifications too.
• Cooldown and history: Prevent spam and track recent visitors.
• Mailbox: View missed notifications at any time with /doorbell mail.
• Tab completion: Commands and options include smart tab completion.
• Multiworld support: Works across all worlds and dimensions.
• Live reload: Reload config and messages with /doorbell reload.

---

Installation

1. Download the Doorbell plugin JAR.
2. Place it in your plugins/ folder.
3. Start or restart your server.
4. (Optional) Edit config.yml, messages.yml, or effects.yml to customize behavior and visuals.

---

Commands

/doorbell bind <name>                  - Bind the next clicked supported block as a doorbell
/doorbell delete <name>                - Delete one of your doorbells
/doorbell list [page]                  - View your doorbells in a paginated list
/doorbell gui                          - Open the GUI to manage your doorbells
/doorbell mode <name> <public|private> - Change a doorbell's access mode
/doorbell addmember <name> <player>    - Add a member to a doorbell
/doorbell removemember <name> <player> - Remove a member from a doorbell
/doorbell history <name>               - View recent ring history
/doorbell mail                         - Read missed notifications
/doorbell reload                       - Reload config and message files

---

Permissions

doorbell.use       - Use Doorbell commands [default: true]
doorbell.teleport  - Teleport to your doorbells through the GUI [default: op]
doorbell.reload    - Reload Doorbell configuration [default: op]
doorbell.admin     - Reserved for future admin features [default: op]

---

How It Works

1. Run /doorbell bind <name>.
2. Right-click a supported block such as a bell, button, lever, or pressure plate.
3. That block is now linked as your doorbell.
4. Use /doorbell mode to set it to public or private.
5. Use /doorbell addmember to share access with friends.
6. Manage, teleport to, or remove doorbells with /doorbell gui.

---

Advanced Features

• Redstone protection: Private doorbells are protected from unauthorized redstone activation.
• Recent history: Check who rang a doorbell and when.
• Custom effects: Fine-tune sounds, titles, and particles to match your server.
• EssentialsX integration: Uses EssentialsX Mail when present, with a built-in fallback mailbox.
• Configurable supported blocks: Adjust which blocks can be used as doorbells in config.yml.
• Live reloading: Reload settings without replacing the plugin file.

---

Links

• Website
• Support Discord
• Source Code (GitLab)