====== TulpenCraftSuperPickAxe ======

~~NOTOC~~

===== 📌 Status =====

^ Eigenschap ^ Waarde ^
| **Plugin** | TulpenCraftSuperPickAxe |
| **Status** | 🟢 Actief |
| **Versie** | 1.0.4 |
| **Platform** | Paper API 26.2 |
| **Server(s)** | Survival |
| **Onderdeel van netwerk** | Ja |
| **Laatste controle** | {{DATUM}} |

^ Server ^ Actief ^
| **Velocity** | ❌ |
| **Lobby** | ❌ |
| **Survival** | ✅ |
| **Events** | ❌ |

----

===== 🎯 Doel =====

TulpenCraftSuperPickAxe is een Paper-plugin waarmee spelers **instant mining** kunnen inschakelen voor hun pickaxe.

Met `/spa` kan een speler instant mining zelf aan- of uitzetten.

De functie past uitsluitend de breeksnelheid van geschikte blokken aan. Het normale `BlockBreakEvent` blijft intact, waardoor bestaande beveiligingsplugins zoals [[plugins:worldguard|WorldGuard]] en [[plugins:griefprevention|GriefPrevention]] het breken van blokken nog steeds kunnen toestaan of blokkeren.

De status van instant mining wordt per speler opgeslagen en blijft behouden na een serverherstart.

----

===== 📦 Installatie =====

**Jar-bestand:**

<code>
TulpenCraft-SuperPickAxe-1.0.4.jar
</code>

**Locatie:**

<code>
/srv/minecraft/survival/plugins/TulpenCraft-SuperPickAxe-1.0.4.jar
</code>

----

===== ⚙️ Configuratie =====

**Configuratiebestand:**

<code>
/srv/minecraft/survival/plugins/TulpenCraftSuperPickAxe/config.yml
</code>

==== Belangrijke instellingen ====

^ Instelling ^ Waarde ^ Betekenis ^
| `instant-mining-spelers` | `[]` | Lijst met UUID's van spelers waarvoor instant mining actief is |

==== TulpenCraft-configuratie ====

<code yaml>
instant-mining-spelers: []
</code>

De lijst wordt automatisch door de plugin beheerd. Handmatig aanpassen is normaal gesproken niet nodig.

----

===== 🔐 Rechten =====

^ Permission ^ Rank ^ Beschrijving ^
| `spa.use` | vip en hoger | `/spa` gebruiken en instant mining uitvoeren |

==== Rankverdeling ====

^ Rank ^ Rechten ^
| **Speler** | Geen toegang |
| **VIP** | `spa.use` |
| **VIP+** | `spa.use` |
| **Helper** | `spa.use` |
| **Bouwer** | `spa.use` |
| **Moderator** | `spa.use` |
| **Developer** | `spa.use` |
| **Admin** | `spa.use` |
| **Owner** | `spa.use` |

----

===== 💬 Commando's =====

^ Commando ^ Permission ^ Beschrijving ^
| <code>/spa</code> | `spa.use` | Instant mining aan- of uitzetten |

----

===== ⛏️ Ondersteunde pickaxes =====

Instant mining werkt met:

  * Houten pickaxe
  * Stenen pickaxe
  * IJzeren pickaxe
  * Gouden pickaxe
  * Diamanten pickaxe
  * Netherite pickaxe

----

===== 🚫 Uitgesloten blokken =====

De volgende blokken worden nooit instant gebroken:

  * Bedrock
  * Barrier
  * End Portal
  * End Portal Frame
  * Command Block
  * Structure Block
  * Structure Void
  * Jigsaw Block
  * Light

Deze uitzonderingen blijven altijd van kracht, ook wanneer instant mining voor de speler is ingeschakeld.

----

===== 🔗 Afhankelijkheden =====

  * **Paper API 26.2**
  * **Java 25**

Optioneel:

  * [[plugins:worldguard|WorldGuard]]
  * [[plugins:griefprevention|GriefPrevention]]

WorldGuard en GriefPrevention zijn geen verplichte dependencies. De plugin kan zonder deze plugins functioneren.

----

===== 🌐 Netwerk / Proxy =====

**Proxy-plugin:** Nee

^ Onderdeel ^ Waarde ^
| Proxy | Velocity |
| Backend | Survival |

TulpenCraftSuperPickAxe draait als backend-plugin op de Survival-server en heeft geen eigen Velocity-component.

----

===== 🛡️ Beveiliging =====

TulpenCraftSuperPickAxe verandert uitsluitend de breeksnelheid van ondersteunde blokken.

Het normale `BlockBreakEvent` blijft intact. Hierdoor kunnen protection-plugins zoals WorldGuard en GriefPrevention het breken van een blok nog steeds annuleren.

Beschermde gebieden blijven daarmee beschermd zolang de betreffende protection-plugin het `BlockBreakEvent` correct afhandelt.

Bedrock, barriers, portals, command blocks en andere systeemblokken worden door de plugin expliciet uitgesloten van instant mining.

Wanneer een speler de permissie `spa.use` verliest terwijl instant mining actief is, wordt instant mining voor die speler automatisch uitgeschakeld.

----

===== ⚠️ Aandachtspunten =====

  * Instant mining moet door de speler met `/spa` worden ingeschakeld.
  * De actieve status wordt per speler opgeslagen als UUID.
  * De status blijft behouden na een serverherstart.
  * Alleen ondersteunde pickaxes kunnen instant mining gebruiken.
  * Beschermde blokken kunnen nog steeds door WorldGuard of GriefPrevention worden geblokkeerd.
  * Systeemblokken zoals Bedrock en Command Blocks worden nooit instant gebroken.
  * De configuratielijst wordt automatisch beheerd; handmatig aanpassen is normaal gesproken niet nodig.
  * Bij het verliezen van `spa.use` wordt instant mining automatisch uitgeschakeld.

----

===== 🧪 Troubleshooting =====

==== `/spa` werkt niet ====

Controleer of de speler de juiste permissie heeft:

<code bash>
/lp user <speler> permission check spa.use
</code>

==== Instant mining werkt niet ====

Controleer of instant mining voor de speler is ingeschakeld met:

<code bash>
/spa
</code>

Controleer daarnaast of de speler een ondersteunde pickaxe gebruikt.

==== Een blok wordt niet instant gebroken ====

Controleer of het blok voorkomt in de lijst met uitgesloten blokken.

Daarnaast kan een protection-plugin het `BlockBreakEvent` annuleren.

Controleer bijvoorbeeld de WorldGuard-regio:

<code bash>
/rg info <region>
</code>

==== Instant mining wordt na verlies van rechten uitgeschakeld ====

Dit is het verwachte gedrag. Wanneer `spa.use` wordt ingetrokken terwijl instant mining actief is, schakelt de plugin de functie automatisch uit.

----

===== 📝 Onderhoud =====

**Laatste wijziging:** {{DATUM}}

**Wijziging:** Documentatie aangemaakt voor TulpenCraftSuperPickAxe 1.0.4.

**Status:** ✅ Actief

----

===== 🔗 Externe links =====

  * [[https://github.com/TulpenCraft/TulpenCraftSuperPickaxe|GitHub repository]]
  * [[https://github.com/TulpenCraft/TulpenCraftSuperPickaxe#tulpencraft-superpickaxe|README / officiële documentatie]]