Merge pull request #41 from oskar3123/39-clean-the-readme-a-bit

Clean the README a bit
This commit is contained in:
2025-02-10 00:46:33 +01:00
committed by GitHub
+53 -24
View File
@@ -12,19 +12,25 @@
# [StaffChat](https://oskar3123.github.io/StaffChat) # [StaffChat](https://oskar3123.github.io/StaffChat)
Simple and highly configurable staffchat Simple and highly configurable staff chat.
## Download ## Download
You can download the plugin from the [Spigot resource page](https://www.spigotmc.org/resources/37804/) or via the [GitHub releases](https://github.com/oskar3123/StaffChat/releases) You can download the plugin from
the [Spigot resource page](https://www.spigotmc.org/resources/37804/) or via
the [GitHub releases](https://github.com/oskar3123/StaffChat/releases).
## License ## License
This plugin is licensed with the MIT License, for more information see the [LICENSE file](https://github.com/oskar3123/StaffChat/blob/master/LICENSE) This plugin is licensed with the MIT License, for more information see
the [LICENSE file](https://github.com/oskar3123/StaffChat/blob/master/LICENSE).
## Building ## Building
To build this yourself just clone the repository and run the `shadowJar` task with the Gradle Wrapper To build this yourself just clone the repository and run the `shadowJar` task with the Gradle
Wrapper.
The plugin jar-file can be found inside the `build/libs` folder after building.
### Windows ### Windows
@@ -46,53 +52,74 @@ cd StaffChat
### Bukkit/Spigot ### Bukkit/Spigot
Because the event API in 1.14+ is now strict between sync and async events you should check whether this was called synchronously or asynchronously by using `event.isAsynchronous()` Because the event API in 1.14+ is now strict between sync and async events you should check whether
this was called synchronously or asynchronously by using `event.isAsynchronous()`.
```java ```java
public class StaffChatListener implements Listener public class StaffChatListener implements Listener {
{
@EventHandler @EventHandler
public void onStaffChat(StaffChatEvent event) public void onStaffChat(StaffChatEvent event) {
{
// String format = event.getFormat();
// event.setFormat("&b{NAME} >> {MESSAGE}");
// String message = event.getMessage();
// Player player = event.getPlayer(); // Player player = event.getPlayer();
// String format = event.getFormat();
// String message = event.getMessage();
// event.setFormat("&b{NAME} >> {MESSAGE}");
// event.setMessage(filterMessage(message));
// event.setCancelled(true); // event.setCancelled(true);
} }
private static String filterMessage(String message) {
// ...
return message;
}
} }
``` ```
Register the listener with
Register the listener in the `onEnable` method of your plugin.
```java ```java
public class YourPlugin extends JavaPlugin {
@Override
public void onEnable() {
getServer().getPluginManager().registerEvents(new StaffChatListener(), this); getServer().getPluginManager().registerEvents(new StaffChatListener(), this);
}
}
``` ```
in your plugin onEnable.
### BungeeCord ### BungeeCord
```java ```java
public class StaffChatListener implements Listener public class StaffChatListener implements Listener {
{
@EventHandler @EventHandler
public void onStaffChat(BungeeStaffChatEvent event) public void onStaffChat(BungeeStaffChatEvent event) {
{ // ProxiedPlayer player = event.getPlayer();
// String format = event.getFormat(); // String format = event.getFormat();
// event.setFormat("&b{NAME} >> {MESSAGE}");
// String message = event.getMessage(); // String message = event.getMessage();
// Player player = event.getPlayer(); // event.setFormat("&b{NAME} >> {MESSAGE}");
// event.setMessage(filterMessage(message));
// event.setCancelled(true); // event.setCancelled(true);
} }
private static String filterMessage(String message) {
// ...
return message;
}
} }
``` ```
Register the listener with
Register the listener in the `onEnable` method of your plugin.
```java ```java
public class YourPlugin extends Plugin {
@Override
public void onEnable() {
getProxy().getPluginManager().registerListener(this, new StaffChatListener()); getProxy().getPluginManager().registerListener(this, new StaffChatListener());
}
}
``` ```
in your plugin onEnable.
### Velocity ### Velocity
@@ -117,15 +144,17 @@ public class StaffChatListener {
} }
} }
``` ```
Register the listener on the `ProxyInitializeEvent` in your plugin. Register the listener on the `ProxyInitializeEvent` in your plugin.
```java ```java
@Plugin @Plugin
public class Plugin { public class YourPlugin {
private final ProxyServer server; private final ProxyServer server;
@Inject @Inject
public Plugin(ProxyServer server) { public YourPlugin(ProxyServer server) {
this.server = server; this.server = server;
} }