
pv-addon-groups
A server-side add-on for Plasmo Voice that allows creating group voice channels for communication between players regardless of distance.
Features
With this add-on, you can organize private voice chats for teams and friends. Groups are managed through chat commands, with a client-side add-on featuring a graphical interface planned for the future.
Groups can be password-protected or accessible only to players with specific permissions.
Installation
The add-on can be installed as a mod/plugin for Paper, Fabric, Forge OR as a plugin for Bungee, Velocity. When installed on Bungee or Velocity, groups will work for players across all servers in the network, allowing communication even when on different servers.
Basic Usage
Creating a Group and Inviting Players
- Open the Plasmo Voice menu (default key V), go to the "Activation" tab and configure the "Groups" activation
- Use the command
/groups create [...flags]
to create a group - Invite players to the group with the command
/groups invite <player>
- Use the activation to communicate in the group
Browsing Groups
You can browse public groups using commands: /groups
or /groups browse
Configuration Flags
When creating a group, you can use flags to modify settings. For example:
/groups create name: The Boys password: qwerty1245 persistent: true permissions: group.theboys
All flags are optional, order doesn't matter:
name:
andpassword:
- obvious parameterspersistent:
- makes the group permanent (not automatically deleted when empty or after server restart)permissions:
- allows only players with specific permissions to join (multiple can be specified comma-separated)
Flag Permissions
Flag | Permission | Default |
---|---|---|
name |
pv.addon.groups.flag.name |
True |
password |
pv.addon.groups.flag.password |
True |
persistent |
pv.addon.groups.flag.persistent |
OP |
permissions |
pv.addon.groups.flag.permissions |
OP |
Commands
/groups
or/groups browse [page]
- Browse groups/groups create [...flags]
- Create a group/groups invite <player>
- Invite a player to the group/groups join <group UUID> [password]
- Join the group (not recommended for manual use)/groups info
- Show info about current group/groups leave
- Leave current group/groups set <flag> <value>
- Set flag value for current group/groups unset <flag>
- Reset flag to default value/groups delete
- Delete current group/groups transfer <player>
- Transfer group ownership to another player/groups kick <player>
- Kick player from group/groups ban <player>
- Ban player from group/groups unban <player>
- Unban player from group
Permissions
Permission | Description | Default |
---|---|---|
pv.activation.groups |
Use groups activation | True |
pv.addon.groups.browse |
Use /groups browse |
True |
pv.addon.groups.browse.all |
Groups visible even without join permission | OP |
pv.addon.groups.create |
Use /groups create |
True |
pv.addon.groups.invite.member |
Use /groups invite as member |
True |
pv.addon.groups.invite.owner |
Use /groups invite as owner |
True |
pv.addon.groups.join |
Use /groups join |
True |
pv.addon.groups.join.all |
Use /groups join bypassing password and permission check |
OP |
pv.addon.groups.info.member |
Use /groups info as member |
True |
pv.addon.groups.info.owner |
Use /groups info as owner |
True |
pv.addon.groups.leave |
Use /groups leave |
True |
pv.addon.groups.set.owner |
Use /groups set as owner |
True |
pv.addon.groups.set.all |
Use /groups set in any group |
OP |
pv.addon.groups.unset.owner |
Use /groups unset as owner |
True |
pv.addon.groups.unset.all |
Use /groups unset in any group |
OP |
pv.addon.groups.delete.owner |
Use /groups delete as owner |
True |
pv.addon.groups.delete.all |
Use /groups delete in any group |
OP |
pv.addon.groups.transfer.owner |
Use /groups transfer as owner |
True |
pv.addon.groups.transfer.all |
Use /groups transfer in any group |
OP |
pv.addon.groups.kick.owner |
Use /groups kick as owner |
True |
pv.addon.groups.kick.all |
Use /groups kick in any group |
OP |
pv.addon.groups.ban.owner |
Use /groups ban/unban as owner |
True |
pv.addon.groups.ban.all |
Use /groups ban/unban in any group |
OP |