From 0c218ccf04f795173d39c758c310f3123343aae5 Mon Sep 17 00:00:00 2001
From: "Youenn \"SkytAsul\" Le Jeune" <skytasul@gmail.com>
Date: Tue, 12 May 2026 18:39:17 +0200
Subject: [PATCH] Add instructions to fix NMS-related error for
 paper-nms-maven-plugin users

---
 docs/en/user_guide/advanced/paperweight.md | 25 ++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/en/user_guide/advanced/paperweight.md b/docs/en/user_guide/advanced/paperweight.md
index 696192b..13c0641 100644
--- a/docs/en/user_guide/advanced/paperweight.md
+++ b/docs/en/user_guide/advanced/paperweight.md
@@ -35,6 +35,31 @@ paperweight {
 }
 ```
 
+If you are using the unofficial maven port of paperweight, [paper-nms-maven-plugin](https://github.com/Alvinn8/paper-nms-maven-plugin), you can fix the issue by excluding the `paper-nms` artifact at test time in your `pom.xml`:
+
+```xml
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>ca.bkaw</groupId>
+				<artifactId>paper-nms-maven-plugin</artifactId>
+				<version>1.4.11-SNAPSHOT</version>
+			</plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-surefire-plugin</artifactId>
+				<configuration>
+					<!-- This is the important part -->
+					<classpathDependencyExcludes>
+						<classpathDependencyExclude>ca.bkaw:paper-nms</classpathDependencyExclude>
+					</classpathDependencyExcludes>
+					<!-- Credits to https://stackoverflow.com/a/12068045 -->
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+```
+
 ::: warning
 With this, you can't use any NMS behavior during tests with MockBukkit
 :::