Minecraft-Debug-Stick-Crafting-in-Survival

Plugin allows to craft "Debug Stick" in survival mode

🎮 Features

• Custom crafting recipe
• Block restrictions with a configurable list
• Messages and feature toggles via config
• Hot reload with /debugstickreload

📋 Requirements

• Minecraft server: 26.1+ (Spigot or Paper)
• Java: JDK 25+

🔧 Installation

1. Download DebugStickCraftingInSurvival-{version_of_plugin}-{version_of_minecraft}.jar from Releases.
2. Place it in plugins/.
3. Restart the server or use /reload.
4. Edit plugins/DebugStickCraftingInSurvival/config.yml.
5. Run /debugstickreload to apply changes.

📖 Usage

Crafting recipe

Commands

Command	Description	Permission	Aliases
/debugstickreload	Reloads plugin configuration	debugstickcs.reload	/dsreload, /debugreload

Permissions

Permission	Description	Default
debugstickcs.reload	Allows reloading configuration	OP
minecraft.debugstick	Allows using Debug Stick	off
minecraft.debugstick.always	Allows using Debug Stick in Survival	off

⚙️ Configuration

File: plugins/DebugStickCraftingInSurvival/config.yml

# Feature toggles
features:
  enable_crafting: true
  enable_restrictions: true

# Messages shown to players
messages:
  restriction: "§cYou cannot use the Debug Stick on this type of block!"

# List of blocks where Debug Stick usage is restricted
excluded_blocks:
  - COMPOSTER
  - CHEST
  - CACTUS
  - ...

🔨 Build from source

Requirements:

• JDK 25+
• Maven 3.6+

Build:

mvn clean package

🚀 Release

Releases are built and published automatically by GitHub Actions. To publish a new version:

1. Update <version> in pom.xml.
2. Commit the version and changelog changes.
3. Push a tag with the exact Maven version prefixed by v:

git tag v2.1.4-26.x
git push origin v2.1.4-26.x

The workflow runs mvn clean verify, checks that the tag matches pom.xml, and attaches the resulting JAR to the GitHub Release. Pull requests and pushes to main run the build and verification steps without publishing a release.

🔌 Compatibility

Plugin Version	Minecraft	Java	API
2.1.4+	26.1+	25+	26.1
2.1.0+	1.21+	21+	1.21
1.x	1.19.x	8+	1.19

🗂️️ Project Structure

pl.nubet.debugstickinsurvival/
├── DebugStickCraftingInSurvival.java
├── command/
│   └── ReloadCommand.java
├── config/
│   └── ConfigurationManager.java
├── service/
│   └── BlockRestrictionService.java
├── listener/
│   └── DebugStickInteractionListener.java
└── recipe/
    └── DebugStickRecipeManager.java

📝 Changelog

See CHANGELOG.md for full history.

🔗 Links

• SpigotMC
• Modrinth

---

Made with ❤️ by Nubet ️