====== TulpenCraftInfinityChest ======

~~NOTOC~~

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

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

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

----

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

TulpenCraftInfinityChest maakt het mogelijk om geselecteerde kisten te gebruiken als **oneindige itembron voor hoppertransport**.

Een geregistreerde kist levert één specifiek item. De plugin houdt automatisch een reserve van dit item beschikbaar, zodat hoppers het item kunnen transporteren naar bijvoorbeeld furnaces, blast furnaces, smokers en andere inventories.

De plugin is bedoeld voor automatische transportsystemen en heeft geen afhankelijkheid van andere plugins.

----

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

**Jar-bestand:**

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

**Locatie:**

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

**Buildsysteem:**

Gradle

**Buildcommando:**

<code bash>
./gradlew clean build
</code>

**Build-output:**

<code>
build/libs/TulpenCraftInfinityChest-1.0.0.jar
</code>

----

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

**Configuratiebestand:**

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

==== Belangrijke instellingen ====

^ Instelling ^ Waarde ^ Betekenis ^
| `settings.allow-player-open` | `false` | Bepaalt of spelers een geregistreerde bronkist handmatig mogen openen |
| `sources` | Automatisch | Bevat de geregistreerde Infinite Supply Chests |
| `messages.*` | Configureerbaar | Berichten van de plugin |

==== TulpenCraft-configuratie ====

```yaml
settings:
  allow-player-open: false

sources: {}

messages:
  usage: "§eGebruik: /infsource create <item>, remove, info of reload"
  player-only: "§cDit commando kan alleen door een speler met een aangekeken kist worden gebruikt."
  not-chest: "§cKijk naar een kist."
  invalid-item: "§cOngeldig item."
  created: "§aDeze kist is ingesteld als oneindige bron van §f%item%§a."
  removed: "§aInfinite Supply Chest verwijderd."
  not-source: "§cDeze kist is geen Infinite Supply Chest."
  info: "§aDeze kist levert oneindig §f%item%§a."
  reloaded: "§aInfinite Chest-config is opnieuw geladen."
  no-permission: "§cGeen toestemming."
  open-denied: "§cDeze kist is alleen bedoeld als automatische itembron."
  break-denied: "§cVerwijder deze Infinite Supply Chest eerst met §f/infsource remove§c."
```

----

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

^ Permission ^ Rank ^ Beschrijving ^
| `tulpencraft.infsource.create` | Operator | Infinite Supply Chest aanmaken |
| `tulpencraft.infsource.remove` | Operator | Infinite Supply Chest verwijderen |
| `tulpencraft.infsource.info` | Operator | Informatie over een Infinite Supply Chest bekijken |
| `tulpencraft.infsource.reload` | Operator | Pluginconfiguratie opnieuw laden |

==== Rankverdeling ====

De plugin declareert de permissions standaard als `op`. De daadwerkelijke koppeling aan TulpenCraft-ranks wordt beheerd buiten de plugin, bijvoorbeeld via de centrale permissionstructuur.

^ Rank ^ Rechten ^
| **Speler** | Geen standaardrechten |
| **VIP** | Geen standaardrechten |
| **VIP+** | Geen standaardrechten |
| **Helper** | Indien toegewezen via permissionbeheer |
| **Bouwer** | Indien toegewezen via permissionbeheer |
| **Moderator** | Indien toegewezen via permissionbeheer |
| **Developer** | Indien toegewezen via permissionbeheer |
| **Admin** | Indien toegewezen via permissionbeheer |
| **Owner** | Indien toegewezen via permissionbeheer |

----

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

^ Commando ^ Permission ^ Beschrijving ^
| <code>/infsource create &lt;item&gt;</code> | `tulpencraft.infsource.create` | Registreert de aangekeken kist als oneindige bron van het opgegeven item |
| <code>/infsource remove</code> | `tulpencraft.infsource.remove` | Verwijdert de registratie van de aangekeken bronkist |
| <code>/infsource info</code> | `tulpencraft.infsource.info` | Toont welk item de aangekeken bron levert |
| <code>/infsource reload</code> | `tulpencraft.infsource.reload` | Herlaadt de pluginconfiguratie |

Alle create/remove/info-commando's werken op de kist waar de speler naar kijkt. De maximale kijkafstand is 6 blokken.

==== Voorbeeld ====

Een kist instellen als oneindige kolenbron:

<code>
/infsource create COAL
</code>

Een bron verwijderen:

<code>
/infsource remove
</code>

Informatie bekijken:

<code>
/infsource info
</code>

Configuratie herladen:

<code>
/infsource reload
</code>

----

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

==== Verplichte afhankelijkheden ====

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

==== Plugin-afhankelijkheden ====

Geen.

TulpenCraftInfinityChest vereist geen:

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

----

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

**Proxy-plugin:** Nee

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

TulpenCraftInfinityChest is een backend-plugin en bevat geen Velocity-component.

----

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

Infinite Supply Chests worden beschermd tegen ongewenste wijzigingen.

Standaard kunnen spelers een geregistreerde bronkist niet openen. Een geregistreerde bronkist kan ook niet normaal worden afgebroken. De registratie moet eerst met `/infsource remove` worden verwijderd.

Daarnaast worden inventory-transacties waarbij een andere inventory items naar een geregistreerde bron probeert te verplaatsen geblokkeerd.

De plugin gebruikt geen externe database en heeft geen externe netwerkafhankelijkheden.

De bronregistraties worden opgeslagen in `config.yml` op basis van wereld-UUID en blokcoördinaten.

----

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

  * De plugin vereist Java 25.
  * De plugin gebruikt de Paper API `26.2.build.116-stable`.
  * Een bron wordt aangemaakt door naar een kist te kijken.
  * De maximale kijkafstand voor `/infsource` is 6 blokken.
  * Een bron levert één specifiek materiaal.
  * Bij het aanmaken wordt de inventory van de kist leeggemaakt.
  * Spelers kunnen bronkisten standaard niet openen.
  * Bronkisten kunnen niet worden afgebroken zolang ze geregistreerd zijn.
  * Gebruik `/infsource remove` voordat een bronkist wordt verwijderd.
  * De configuratie bevat de locaties en materialen van alle geregistreerde bronnen.
  * De voorraadcontrole draait iedere 2 ticks.

----

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

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

Controleer of de plugin actief is:

<code>
/plugins
</code>

Controleer de serverlog:

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

Controleer daarnaast de Java-versie:

<code bash>
java -version
</code>

De plugin vereist Java 25.

==== `/infsource` geeft geen toestemming ====

Controleer de betreffende permission:

<code>
tulpencraft.infsource.create
tulpencraft.infsource.remove
tulpencraft.infsource.info
tulpencraft.infsource.reload
</code>

De permissions zijn standaard beschikbaar voor operators.

==== "Kijk naar een kist" ====

Zorg dat je binnen maximaal 6 blokken recht naar een kist kijkt.

==== De bronkist kan niet worden afgebroken ====

Dit is normaal.

Verwijder eerst de bronregistratie:

<code>
/infsource remove
</code>

Daarna kan de kist normaal worden afgebroken.

==== De bronkist kan niet worden geopend ====

Dit is standaardgedrag wanneer:

<code yaml>
settings:
  allow-player-open: false
</code>

Indien handmatig openen gewenst is, kan dit worden ingesteld op `true`.

==== De bron levert geen items ====

Controleer:

  * of de kist nog bestaat;
  * of de kist nog op de geregistreerde locatie staat;
  * welk materiaal geregistreerd is met `/infsource info`;
  * of de bronregistratie nog in `config.yml` staat;
  * of de plugin correct geladen is.

----

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

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

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

**Status:** 🟢 Actief

----

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

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