Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/henkelmax/enhanced-groups

Various improvements to voice chat groups.
https://github.com/henkelmax/enhanced-groups

fabricmc-mod minecraft-mod simple-voice-chat

Last synced: 5 days ago
JSON representation

Various improvements to voice chat groups.

Awesome Lists containing this project

README 

        
# Simple Voice Chat Enhanced Groups



A server side Fabric mod providing useful features to Simple Voice Chat groups.



## Features



### Instant Groups



The command `/instantgroup`  automatically adds every player nearby to a group,

if they are not already in a group.

The default range of this is 128 blocks.

Alternatively you can provide the range as the first argument of the command: `/instantgroup 256`.



![](https://media0.giphy.com/media/dDEqQ6hIwd9NvWscGF/giphy.gif)



### Group Summary



Players that join the server will get a quick summary of all active voice chat groups.



### Persistent Groups



The command `/persistentgroup` creates a group that will not be deleted when all players leave it or the server

restarts.



**Usage**:



`/persistentgroup list` - Lists all persistent groups



`/persistentgroup remove ` - Deletes the group with the given name



`/persistentgroup remove ` - Deletes the group with the given ID (For internal use only)



`/persistentgroup add  [] [] []` - Creates a persistent group



### Auto Joining Groups



Players can be automatically added to a group when they join the server.



**Note**: This feature is only available for persistent groups.



**Usage**:



`/autojoingroup set  [password]` - Sets your auto join group



`/autojoingroup set  [password]` - Sets your auto join group (For internal use only)



`/autojoingroup remove` - Removes your auto join group



### Force Joining Groups



Players can be forced to join a group.



**Usage**:



`/forcejoingroup ` - Forces the player to join your group



### Forced Group Types



If `force_group_type` is enabled in the config, players won't be able to create groups with a different type.

All created groups will be of the type specified in the config.

This will be useful for servers that used the global `open_groups` config option in older versions of Simple Voice Chat.



**Note**: Forced group types will only be applied to groups that are created with the GUI in Simple Voice Chat.

It does not apply to any of the commands provided by this mod.

If you don't want regular players to be able to use these commands,

you can set the permission levels in the config to a higher value.



Possible config values are `OFF`, `NORMAL`, `OPEN` and `ISOLATED`.



## Config Options



The config file is located at `config/enhancedgroups/enhancedgroups.properties`.



| Name                                       | Default Value   | Description                                                               |

|--------------------------------------------|-----------------|---------------------------------------------------------------------------|

| `default_instant_group_range`              | `128`           | The default range for the instant group command if no range was provided  |

| `instant_group_name`                       | `Instant Group` | The name of the instant group                                             |

| `instant_group_command_permission_type`    | `EVERYONE`      | The default permission type of the `instantgroup` command                 |

| `persistent_group_command_permission_type` | `OPS`           | The default permission type of the `persistentgroup` command              |

| `auto_join_group_command_permission_type`  | `EVERYONE`      | The default permission type of the `autojoingroup` command                |

| `force_join_group_command_permission_type` | `OPS`           | The default permission type of the `forcejoingroup` command               |

| `group_summary`                            | `true`          | If a summary of all groups should be shown when a player joins the server |

| `force_group_type`                         | `OFF`           | If the group type should be forced to a specific type                     |



## Permissions



This mod supports the [fabric-permissions-api](https://github.com/lucko/fabric-permissions-api).



The default permission type of each node is defined in the [config](#config-options).



| Permission Node                  | Description                                                               |

|----------------------------------|---------------------------------------------------------------------------|

| `enhancedgroups.instantgroup`    | The permission node to be able to execute the `/instantgroup` commands    |

| `enhancedgroups.persistentgroup` | The permission node to be able to execute the `/persistentgroup` commands |

| `enhancedgroups.autojoingroup`   | The permission node to be able to execute the `/autojoingroup` commands   |

| `enhancedgroups.forcejoingroup`  | The permission node to be able to execute the `/forcejoingroup` commands  |