# Antighost<\/p>\n
Lightweight Paper plugin that prevents death by consuming a Totem of Undying and applying safe effects.<\/p>\n
## Overview
\nThis repository contains a small Minecraft Paper plugin written in Java. The plugin listens for lethal damage and consumes a Totem of Undying (main\/off-hand) to keep the player alive while playing the totem effects. <\/p>\n
Key files:
\n– `src\/main\/java\/…\/Antighost.java` – plugin main class
\n– `src\/main\/java\/…\/listeners\/TotemListener.java` – main listener implementation
\n– `src\/main\/resources\/paper-plugin.yml` – Paper plugin descriptor (will be packaged into the JAR)
\n– `build.gradle` – Gradle build configuration<\/p>\n
## Requirements
\n– JDK 17+ (project is configured to target Java 21 in `build.gradle`; ensure your toolchain supports it)
\n– Gradle (the project includes the Gradle wrapper; you can run `.\/gradlew` on Unix or `.
\ngradlew.bat` on Windows)<\/p>\n
## Build
\nFrom the project root (Windows PowerShell):<\/p>\n
“`powershell
\n# Clean and build the plugin
\n.gradlew.bat –no-daemon clean build
\n“`<\/p>\n
After a successful build the plugin JAR will be in `build\/libs\/` (for example `build\/libs\/antighost-1.0-SNAPSHOT.jar`).<\/p>\n
## Verify the plugin descriptor is packaged (important for Modrinth)
\nModrinth (and Paper) requires a `plugin.yml` or `paper-plugin.yml` at the root of the plugin JAR. If Modrinth gives the error “No plugin.yml or paper-plugin.yml present for plugin file” the YAML is missing from the artifact.<\/p>\n
Use one of these commands in PowerShell to check the contents of the built JAR:<\/p>\n
“`powershell
\n# Find the latest built jar
\n$jar = Get-ChildItem .buildlibs*.jar | Select-Object -Last 1 -ExpandProperty FullName
\n# List entries and search for plugin descriptor names
\nAdd-Type -AssemblyName System.IO.Compression.FileSystem
\n[System.IO.Compression.ZipFile]::OpenRead($jar).Entries | Select-Object -ExpandProperty FullName | Where-Object { $_ -match ‘plugin.yml|paper-plugin.yml’ }
\n“`<\/p>\n
If the command prints `paper-plugin.yml` (or `plugin.yml`), it is present. It must appear at the root of the JAR (the entry name should be exactly `paper-plugin.yml` or `plugin.yml`).<\/p>\n
Alternative (using `jar` if available):<\/p>\n
“`powershell
\n& ‘C:Program FilesJavajdk-21binjar.exe’ tf buildlibsantighost-1.0-SNAPSHOT.jar | Select-String ‘paper-plugin.yml|plugin.yml’
\n“`<\/p>\n
## Common causes & fixes if the YAML is missing
\n– Resource file misplacement: ensure the descriptor is at `src\/main\/resources\/paper-plugin.yml` (or `plugin.yml`).
\n– `build.gradle` customizations: check for `sourceSets` overrides that exclude `src\/main\/resources` or `processResources` filters that unintentionally exclude `*.yml`.
\n– Using a shading plugin (Shadow): ensure you upload the shaded JAR (usually `shadowJar`) and that the shading configuration includes `sourceSets.main.output` so resources are bundled.
\n– If you use `processResources` to expand properties (this project uses it to expand `version` in `paper-plugin.yml`), make sure the `filesMatching(‘paper-plugin.yml’)` block is correct and not excluding the file.<\/p>\n
Example Gradle hints (Groovy DSL):
\n– Ensure resources are included (default behavior):<\/p>\n
“`groovy
\nsourceSets {
\n main {
\n resources.srcDirs = [‘src\/main\/resources’]
\n }
\n}<\/p>\n
jar {
\n from(sourceSets.main.output)
\n}
\n“`<\/p>\n
– If you use Shadow plugin, ensure you publish the shadow jar:<\/p>\n
“`groovy
\nshadowJar {
\n from(sourceSets.main.output)
\n}
\ntasks.build.dependsOn shadowJar
\n“`<\/p>\n
## Troubleshooting steps
\n1. Confirm the `paper-plugin.yml` exists at `src\/main\/resources`.
\n2. Run a clean build: `.
\ngradlew.bat –no-daemon clean build`.
\n3. Verify the JAR contents using the PowerShell snippet above.
\n4. If missing, inspect `build.gradle` for `processResources`, `sourceSets`, `jar`, or `shadowJar` blocks.
\n5. If you need help, open an issue or paste the output of `.
\ngradlew.bat –no-daemon clean build –info` and the JAR listing command output.<\/p>\n
## License
\nMIT<\/p>\n
—<\/p>\n
If you’d like, I can also add a small CI workflow that builds the jar and checks the JAR contains `paper-plugin.yml` automatically on push.<\/p>\n","protected":false},"excerpt":{"rendered":"
This plugin prevents client and server side totem ghosting. it will decrease the ghosting amount a lot.<\/p>\n","protected":false},"featured_media":16343,"template":"","meta":{"_minecraft_slug":"antitotemghost","_minecraft_project_id":"fdwyyeMx","_minecraft_author":"devBramCraft","_minecraft_license":"MIT","_minecraft_downloads":13,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"antitotemghost.zip","_minecraft_size_bytes":4123,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:56:31.399141Z","_minecraft_date_created":"2026-04-28T21:00:34.183468Z","_minecraft_date_modified":"2026-04-16T21:16:27.557184Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/antitotemghost","_minecraft_icon_attachment_id":16343,"_minecraft_imported_at":"2026-05-31T19:01:41+00:00","_minecraft_import_hash":"f0120528740f06e8ddf2cd278a12ea6d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,123],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-16342","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-technology","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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"],"yoast_head":"\n