https://github.com/paring-chan/customclientblocker

A simple plugin that kicks player using specific client brand
https://github.com/paring-chan/customclientblocker

Last synced: 2 months ago
JSON representation

A simple plugin that kicks player using specific client brand

• Host: GitHub
• URL: https://github.com/paring-chan/customclientblocker
• Owner: paring-chan
• License: gpl-3.0
• Created: 2023-09-27T13:45:37.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2025-04-10T08:13:39.000Z (3 months ago)
• Last Synced: 2025-04-22T18:07:59.913Z (2 months ago)
• Language: Kotlin
• Homepage:
• Size: 185 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CustomClientBlocker

A simple plugin that kicks player using specific client brand

![Modrinth](https://img.shields.io/modrinth/dt/xsOXeDko?logo=modrinth&label=Modrinth)

## Installation

Download plugin at [Modrinth(Under review)](https://modrinth.com/plugin/custom-client-blocker) or [Releases](https://github.com/pikokr/CustomClientBlocker/releases) 

or, you can also download [snapshot builds](https://jenkins.paring.moe/job/Paper/job/CustomClientBlocker/)

## Usage

### Configuration

You can configure this plugin by editing `plugins/CustomClientBlocker/config.yml`

```yaml

# The list of clients to block

blacklist:

  - forge

# Kick message

kickMessage: Using %client% is not allowed!

```

### Commands

The base command is `/clientblocker` or `/ccb`

And base permission is `customclientblocker.command`

| Command | Description                                      | Permission                                                                     |

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

| players | Lists players, but the connected client is shown | `customclientblocker.command.players`                                          |

| list    | Lists which clients are blocked                  | `customclientblocker.command.list`                                             |

| block   | Adds an entry to client blacklist                | `customclientblocker.command.block` or `customclientblocker.command.modify`    |

| unblock | Removes an entry to client blacklist             | `customclientblocker.command.unblock`  or `customclientblocker.command.modify` |

| reload  | Reloads the setting from config file             | `customclientblocker.command.reload`                                           |

### Bypassing specific players

You can add an except by adding permission `customclientblocker.bypass` to a player