====== TulpenCraftNederweed ======

~~NOTOC~~

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

^ Eigenschap ^ Waarde ^
| **Plugin** | TulpenCraftNederweed |
| **Status** | 🟢 Actief |
| **Versie** | 1.0.0 |
| **Buildsysteem** | Maven |
| **Platform** | Paper |
| **Server(s)** | Survival |
| **Onderdeel van netwerk** | Ja |
| **Laatste controle** | {{DATUM}} |

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

----

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

TulpenCraftNederweed voegt een fictieve Nederweed-gameplayloop toe aan TulpenCraft:

<code>
zaad → planten → groeien → oogsten → verwerken → consumeren
     → stoned → munchies → 2× eetsnelheid
</code>

De plugin is volledig standalone en heeft geen runtime-afhankelijkheid van andere plugins.

----

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

**Jar-bestand:**

<code>
TulpenCraftNederweed-1.0.0.jar
</code>

**Locatie:**

<code>
/srv/minecraft/survival/plugins/TulpenCraftNederweed-1.0.0.jar
</code>

**Buildsysteem:**

<code>
Maven
</code>

**Buildcommando:**

<code bash>
mvn clean package
</code>

**Build-output:**

<code>
target/TulpenCraftNederweed-1.0.0.jar
</code>

----

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

**Configuratiebestand:**

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

==== Belangrijke instellingen ====

^ Instelling ^ Standaard ^ Betekenis ^
| `crop.growth-check-interval-ticks` | `40` | Interval tussen groeicontroles per plant |
| `crop.growth-chance-per-check` | `0.05` | Kans per controle om één groeistadium verder te gaan |
| `crop.min-light-level` | `9` | Minimale lichtsterkte voor groei |
| `crop.bonemeal-stages-per-use` | `1` | Aantal groeistadia dat bonemeal overslaat |
| `crop.harvest.min-nederweed` | `1` | Minimale opbrengst per volwassen plant |
| `crop.harvest.max-nederweed` | `3` | Maximale opbrengst per volwassen plant |
| `crop.harvest.seed-return-chance` | `0.6` | Kans op een teruggegeven zaadje |
| `consumption.joint.nutrition` | `2` | Voedingswaarde van de joint |
| `consumption.joint.saturation` | `1.0` | Saturatiewaarde van de joint |
| `consumption.joint.consume-seconds` | `2.0` | Consumptieduur van de joint |
| `stoned.duration-seconds` | `90` | Duur van het stoned-effect |
| `stoned.restack-mode` | `REFRESH` | Gedrag wanneer opnieuw wordt geconsumeerd |
| `stoned.clear-on-death` | `true` | Stoned-status verwijderen bij overlijden |
| `munchies.eat-speed-multiplier` | `2.0` | Eetsnelheidsvermenigvuldiger tijdens munchies |
| `secondhand.enabled` | `true` | Secondhand smoke inschakelen |
| `secondhand.radius` | `6.0` | Bereik van secondhand smoke |
| `secondhand.duration-seconds` | `20` | Duur van secondhand smoke |
| `secondhand.nausea-amplifier` | `0` | Nausea-versterker |
| `secondhand.slowness-amplifier` | `0` | Slowness-versterker |
| `debug.log-crop-growth` | `false` | Groei naar de serverlog schrijven |

==== Standaard-configuratie ====

<code yaml>
crop:
  growth-check-interval-ticks: 40
  growth-chance-per-check: 0.05
  min-light-level: 9
  bonemeal-stages-per-use: 1
  harvest:
    min-nederweed: 1
    max-nederweed: 3
    seed-return-chance: 0.6

consumption:
  joint:
    nutrition: 2
    saturation: 1.0
    consume-seconds: 2.0

stoned:
  duration-seconds: 90
  restack-mode: REFRESH
  effects:
    slowness-amplifier: 0
    nausea-pulse-amplifier: 0
    nausea-pulse-duration-seconds: 3
    nausea-pulse-interval-seconds: 18
  clear-on-death: true

munchies:
  eat-speed-multiplier: 2.0

secondhand:
  enabled: true
  radius: 6.0
  duration-seconds: 20
  nausea-amplifier: 0
  slowness-amplifier: 0

debug:
  log-crop-growth: false
</code>

----

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

^ Permission ^ Rank ^ Beschrijving ^
| `tulpencraftnederweed.use` | Speler | Nederweed planten, oogsten en consumeren |
| `tulpencraftnederweed.admin` | Admin | Admin- en testcommando's gebruiken |

==== Rankverdeling ====

De plugin declareert de gameplay-permission standaard als `true` en de admin-permission als `op`. De daadwerkelijke koppeling aan TulpenCraft-ranks wordt centraal beheerd.

^ Rank ^ Rechten ^
| **Speler** | `tulpencraftnederweed.use` |
| **VIP** | `tulpencraftnederweed.use` |
| **VIP+** | `tulpencraftnederweed.use` |
| **Helper** | `tulpencraftnederweed.use` |
| **Bouwer** | `tulpencraftnederweed.use` |
| **Moderator** | `tulpencraftnederweed.use` + admin indien toegewezen |
| **Developer** | `tulpencraftnederweed.use` + admin indien toegewezen |
| **Admin** | `tulpencraftnederweed.use` + `tulpencraftnederweed.admin` |
| **Owner** | `tulpencraftnederweed.use` + `tulpencraftnederweed.admin` |

----

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

^ Commando ^ Permission ^ Beschrijving ^
| <code>/nederweed give &lt;seed\|raw\|joint&gt; [aantal] [speler]</code> | `tulpencraftnederweed.admin` | Geeft een custom Nederweed-item |
| <code>/nederweed stoned [speler]</code> | `tulpencraftnederweed.admin` | Geeft een speler het stoned-effect |
| <code>/nederweed clear [speler]</code> | `tulpencraftnederweed.admin` | Verwijdert het stoned-effect |
| <code>/nederweed reload</code> | `tulpencraftnederweed.admin` | Herlaadt de configuratie |

**Aliases:**

<code>
/nw
/weed
</code>

De normale gameplay — planten, groeien, oogsten, verwerken en consumeren — vereist geen commando.

----

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

==== Verplichte afhankelijkheden ====

  * Paper API `26.2.build.119-stable`
  * Java 25

==== Plugin-afhankelijkheden ====

Geen.

TulpenCraftNederweed vereist geen:

  * LuckPerms
  * Vault
  * PlaceholderAPI
  * WorldGuard
  * GriefPrevention
  * Citizens
  * QuestsCore
  * ProtocolLib
  * PacketEvents
  * andere TulpenCraft-plugins

==== Optionele integraties ====

Geen in de huidige standalone-versie.

Mogelijke toekomstige integraties zijn Citizens en QuestCore.

----

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

**Proxy-plugin:** Nee

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

TulpenCraftNederweed draait als backend-plugin op Survival en bevat geen Velocity-component.

----

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

Custom Nederweed-items worden voorzien van een eigen PersistentDataContainer-tag om ze betrouwbaar te kunnen identificeren.

Het joint-recept gebruikt naast het publieke recept ook een expliciete controle om te voorkomen dat willekeurig papier als ruwe Nederweed wordt behandeld.

De stoned-status wordt opgeslagen als een absolute eindtijd in de PersistentDataContainer van de speler. Hierdoor blijft de status correct bij disconnect, reconnect en serverrestart.

Bestaande sterkere effecten van andere bronnen worden niet zonder meer overschreven.

De plugin gebruikt geen externe database en heeft geen externe runtime-netwerkverbindingen nodig.

De crop gebruikt `ItemDisplay`- en `Interaction`-entities in plaats van een vanilla crop block. De plant is voorzien van een expliciete interactie-hitbox.

----

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

  * De plugin vereist Java 25.
  * De plugin is gericht op Paper 1.21.x.
  * De gebruikte Data Component API's zijn door Paper als `@Experimental` gemarkeerd.
  * Zonder resource pack worden de custom items als papier weergegeven.
  * Silk Touch en Fortune zijn niet van toepassing op de Nederweed-planten.
  * Oogsten gebeurt via interactie met de plant en niet via het breken van een blok.
  * De huidige versie heeft geen Citizens- of QuestCore-integratie.
  * Het resource pack is optioneel.
  * De plugin is standalone en heeft geen externe plugin-afhankelijkheden.

----

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

==== Plugin wordt niet geladen ====

Controleer:

<code bash>
java -version
</code>

De plugin vereist Java 25.

Controleer vervolgens:

<code>
/plugins
</code>

en de serverlog:

<code bash>
grep -i "TulpenCraftNederweed" logs/latest.log
</code>

==== Custom items zien eruit als papier ====

Dit is normaal wanneer het Nederweed-resource pack niet actief is.

Controleer of het resource pack correct aan de Minecraft-client wordt aangeboden.

==== Planten groeien niet ====

Controleer de configuratie:

<code yaml>
crop:
  growth-check-interval-ticks: 40
  growth-chance-per-check: 0.05
  min-light-level: 9
</code>

Controleer ook het lichtniveau boven de farmland.

Voor extra logging:

<code yaml>
debug:
  log-crop-growth: true
</code>

==== `/nederweed` werkt niet ====

Controleer de permission:

<code>
tulpencraftnederweed.admin
</code>

Deze permission is standaard alleen beschikbaar voor operators.

==== Een speler blijft stoned ====

Controleer de serverlog en de opgeslagen PersistentDataContainer-status. De plugin gebruikt een absolute eindtijd in plaats van een aftellende potionduur.

----

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

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

**Wijziging:** Documentatie opgesteld op basis van TulpenCraftNederweed 1.0.0 en de actuele broncode.

**Status:** 🟢 Actief

----

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

  * [[https://github.com/TulpenCraft/TulpenCraftNederweed|GitHub repository]]
  * [[https://tulpencraft.nl|TulpenCraft]]
  * [[https://wiki.tulpencraft.nl|TulpenCraft Wiki]]