pv-addon-reminder

pv-addon-reminder

A lightweight Plasmo Voice add-on that reminds players to install the mod when they join your server — no Plasmo Voice API required. Works before or after AuthMe login, or even without AuthMe entirely.

✨ Features

• Flexible timing – Run the reminder:
  • On join (before-auth mode)
  • After AuthMe login (after-auth mode)
  • Automatically choose based on whether AuthMe is installed (auto mode)
• AuthMe optional – Will run without AuthMe installed.
• No PV API – Detects Plasmo Voice clients via plugin channel packets.
• Once-per-session option – Avoids spamming players.
• Customizable message – Fully configurable text with color codes and {player} placeholder.
• Lightweight – Minimal performance impact.

📥 Installation

1. Download the latest jar from the Versions tab.
2. Place it in your server's /plugins folder.
3. Start your server to generate the config.
4. Edit config.yml to suit your needs.

⚙️ Configuration

mode: auto          # auto | after-auth | before-auth
message: "&7Hey {player}! This server uses &aPlasmo Voice &7for proximity chat. Install it: &bmodrinth.com/plugin/plasmo-voice"

auth-delay-ticks: 20   # Delay when using after-auth (or auto + AuthMe present)
join-delay-ticks: 40   # Delay when using before-auth (or auto + AuthMe missing)

once-per-session: true # Send reminder only once per session

plasmovoice-channel-prefix: "plasmovoice:"
channels:
  - "plasmovoice:voice"
  - "plasmovoice:main"

🛠️ Commands & Permissions

No commands or permissions - install and configure.

🔌 Compatibility

• Minecraft: 1.21.8+ (may work on older versions but not guaranteed)
• Servers: Paper, Spigot, Purpur, and forks
• Optional: AuthMe Reloaded

📜 License

This project is licensed under the MIT License.