# Necrify<\/p>\n
Necrify is a punishment plugin designed for currently
\nVelocity (and
\nmaybe Paper\/BungeeCord in the future).<\/p>\n
## Table of contents<\/p>\n
1. [Plugin installation](#plugin-installation)
\n2. [Mutes (only affects Velocity)](#mutes)
\n3. [Duration](#duration)
\n4. [Commands](#commands)
\n5. [API](#punishment-api)
\n * [installation](#installation)
\n * [usage](#usage)<\/p>\n
## Plugin installation<\/p>\n
1. Download the latest version of the plugin or download dev
\n builds here (may be unstable or not working)
\n2. Put the downloaded file into the “`plugins“` folder of your server.
\n3. (Re-)Start the server.<\/p>\n
## Mutes<\/p>\n
With the 1.19.1, Minecraft’s chat system got
\nchanged (detailed explanation).
\nSince then, it is no longer possible to block chat messages in the ChatEvent of Velocity due to the signed chat
\nmessages.
\nThis is why the chat listener does not block any messages anymore which means mutes are effectively useless. A solution
\nto this problem is developing an extension plugin for the actual game servers where cancelling these messages is still
\npossible. Downloads for this paper plugin are found in
\nthe releases and also
\nas dev builds on Jenkins.
\nFor further information about 1.19.1, please refer to
\nthe official release notes<\/p>\n
## Commands
\nAll commands are registered with the prefix `\/necrify`. Moreover, it is possible to register top-level commands too by
\nsetting `allow-top-level-commands` to true (which is per default)
\nlegend:<\/b><\/p>\n
– ### Command overview<\/p>\n – **\/ban ### Duration<\/p>\n To be parsed by `PunishmentDuration#parse(String)`, a string must follow this scheme: ## Punishment API<\/p>\n ### Installation<\/p>\n Replace “`{version}“` with the current version, e.g. 1.2.3. The latest version can be found here. #### Gradle (kotlin)<\/p>\n “`kotlin depenencies { #### Gradle (groovy)<\/p>\n “`groovy dependencies { #### Maven<\/p>\n “`xml<\/p>\n You can also depend on the plugin modules or common module. In order to do so, replace the artifactId with the desired module name. ### Usage<\/p>\n #### Obtaining an instance of the api<\/p>\n If the [plugin](#plugin-installation) is used, you can obtain an instance of the api using the following snippet:<\/p>\n “`java #### Punishing a player<\/p>\n All punishments are issued via the target user. For example, banning a player could be done this way:<\/p>\n “`java Customizable plugin for velocity that allows the managment of various punishments<\/p>\n","protected":false},"featured_media":109296,"template":"","meta":{"_minecraft_slug":"necrify","_minecraft_project_id":"QVuZHDh5","_minecraft_author":"JvstvsHD","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":179,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"necrify.zip","_minecraft_size_bytes":46049017,"_minecraft_version_count":12,"_minecraft_updated_at":"2026-05-16T13:00:16.601565Z","_minecraft_date_created":"2025-06-17T22:06:07.511992Z","_minecraft_date_modified":"2025-12-06T11:54:54.657690Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/necrify","_minecraft_icon_attachment_id":109296,"_minecraft_imported_at":"2026-06-06T10:14:40+00:00","_minecraft_import_hash":"002079dccb989208d16d75e65a04ad5d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,985],"mod_loader":[132],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82,31,860,861,862,863,864],"class_list":["post-109295","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-velocity","mod_loader-paper","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n– [arg] means the argument is optional
\n– player as argument name means the a player name OR uuid is required
\n– reason means a reason that supports MiniMessage
\n– duration as argument name means a [duration](#duration)<\/p>\n
\n– **\/mute
\n– **\/tempban
\n– **\/tempmute
\n– **\/unban
\n– **\/unmute
\n– **\/necrify user
\n deletes this user including all punishments or inverts his whitelist status (from whitelisted to blacklisted or vice versa)
\n– **\/necrify punishment
\n given punishment(must be a uuid)<\/p>\n
\n[0-9][s, m, h, d]
\ns – second(s)
\nm – minute(s)
\nh – hour(s)
\nd – day(s)
\nThese value can be composed, all of them can be omitted.
\nExample: 1d12h15m30s<\/b> means a duration of 1 day, 12 hours, 15 minutes and 30 seconds.<\/p>\n
\nNote that you only want to use the string after necrify-{platform}- and without the version build number.<\/p>\n
\nrepositories {
\n mavenCentral()
\n}<\/p>\n
\n implementation(“de.jvstvshd.necrify:necrify-api:{version}”)
\n}
\n“`<\/p>\n
\nrepositories {
\n mavenCentral()
\n}<\/p>\n
\n implementation ‘de.jvstvshd.necrify:necrify-api:{version}’
\n}
\n“`<\/p>\n
\n
\n
\n
\n
\n <\/dependency>
\n<\/dependencies>
\n“`<\/p>\n
\nNote that code outside the API module is always subject to change and may not be stable. It is also not designed to allow
\naccess and modifications from outside the plugin itself and is often not documented.<\/p>\n
\n try {
\n Necrify api = (Necrify) server.getPluginManager().getPlugin(“necrify”).orElseThrow().getInstance().orElseThrow();
\n } catch(NoSuchElementException e) {
\n logger.error(“Punishment API is not available”);
\n }
\n“`<\/p>\n
\n \/\/Firstly, obtain the user instance
\n NecrifyUser user = api.getUserManager().getUser(uuid).orElseThrow(() -> new NoSuchElementException(“User not found”));
\n MiniMessage miniMessage = MiniMessage.miniMessage();
\n \/\/temporary ban:
\n Ban temporaryBan = user.ban(PunishmentDuration.parse(miniMessage.deserialize(“
\n \/\/permanent ban:
\n Ban permanentBan = user.banPermanent(miniMessage.deserialize(“
\n \/\/The ban instance you get via #join is the punishment that was issued. Note that using #join blocks the current
\n \/\/Thread and since database operations take some time to complete, it is recommended to use #whenComplete or other.
\n \/\/You can now use this instance to change or cancel the punishment:
\n temporaryBan.cancel().whenComplete((punishment, throwable) -> {
\n if(throwable != null) {
\n logger.error(“An error occurred while cancelling the punishment”, throwable);
\n return;
\n }
\n logger.info(“The punishment was successfully cancelled”);
\n });
\n \/\/#cancel should always return the same instance that you called the method on
\n \/\/Event tough a permanent ban was issued for an indefinite time, you can still change the duration and the reason:
\n permanentBan.change(PunishmentDuration.parse(“300d”), miniMessage.deseriaize(“
\n if(throwable != null) {
\n logger.error(“An error occurred while changing the punishment”, throwable);
\n return;
\n }
\n logger.info(“The punishment was successfully changed”);
\n });
\n“`
\nMuting a player is similar, just replace ‘ban’ with ‘mute’.
\nKicking a player can be done by calling `user.kick(Reason).join();` where it is safe to call #join since there is no
\ndatabase query done synchronously. This form of punishment cannot be changed nor cancelled as it only lasts a single moment.<\/p>\n","protected":false},"excerpt":{"rendered":"