Plugins slaan hun instellingen meestal op in YAML-bestanden in de map plugins/<Plugin>/. YAML is een tekstformaat dat zijn structuur opbouwt met inspringing via spaties. Al één tab of een ontbrekend aanhalingsteken is genoeg om een plugin een bestand niet meer te laten lezen. Elke sectie hieronder behandelt één melding. Kom je via "Meer informatie" vanuit de Servergezondheid, dan ben je al op de juiste plek.

De volledige tekst vind je in de Console of onder Bestanden in logs/latest.log. Daarin staat bijna altijd het bestand, vaak ook de regel en kolom. Daaronder volgt vaak een stacktrace, een lijst met ingesprongen at-regels die laat zien waar in het programma de fout ontstond. Maak vóór elke wijziging aan configuratie- of wereldbestanden een back-up onder Back-ups. Bewerk bestanden het best terwijl de server is gestopt, want sommige plugins overschrijven hun configuratie bij het afsluiten.

YAML-syntaxfout in een pluginbestand

Zo ziet de melding eruit:

Cannot load plugins/<Plugin>/<File>.yml
Cannot load configuration from stream
org.bukkit.configuration.InvalidConfigurationException: while parsing a block mapping

Wat er achter zit: De plugin kan zijn YAML-configuratie niet lezen. YAML is een tekstformaat waarvan de structuur afhangt van de inspringing. while parsing a block mapping en expected <block end> wijzen op een foutieve structuur; sequence entries are not allowed here op een lijstitem op de verkeerde plek. Afhankelijk van de plugin ontbreken er afzonderlijke instellingen of de hele plugin.

Zo los je het op:

  1. Open onder Bestanden het genoemde bestand. Zoek bij Cannot load configuration from stream in de omliggende logregels naar de plugin en de bijbehorende configuratie, in plaats van een bestandsnaam aan te nemen.
  2. Controleer de gemelde regel en de items ervoor. line en column geven de regel en kolom aan; de oorzaak kan hoger in het bestand liggen.
  3. Vervang tabs in de inspringing door spaties. Items van gelijke rang moeten even ver zijn ingesprongen. Bij een lijst onder een sleutel staat elk item dat met - begint op een eigen regel.
  4. Zet tekstwaarden met speciale tekens aan het begin, zoals &, { of een backtick, tussen aanhalingstekens en sluit alle aanhalingstekens correct af. Verwijder meegekopieerde Markdown-omlijstingen van drie backticks.
  5. Controleer het opgeschoonde bestand met een YAML-validator en start opnieuw op. Verwijder geheime waarden voordat je het bestand aan een online validator geeft.

Opgeslagen item of opgeslagen locatie in een pluginbestand niet leesbaar

Zo ziet de melding eruit:

[org.bukkit.configuration.serialization.ConfigurationSerialization] Could not call method 'public static org.bukkit.Location org.bukkit.Location.deserialize(java.util.Map)' of class org.bukkit.Location for deserialization
java.lang.IllegalArgumentException: unknown world

Wat er achter zit: Plugins slaan voorwerpen (kits, shopwaren, menu-items) en locaties (homes, warps, spawnpunten) op als gegevensblokken in hun YAML-bestanden. Een item dat onder een oudere Minecraft-versie is opgeslagen, kan door het huidige itemformaat soms niet meer worden ingelezen ("Could not deserialize found primitive"). Staat onder de melding Location en unknown world, dan wijst een opgeslagen locatie naar een wereld die niet meer bestaat of die bij het lezen nog niet geladen was. De server blijft draaien, alleen deze items ontbreken.

Zo los je het op:

  1. Zoek de betreffende plugin. De regels direct voor en na de melding noemen meestal de plugin of het bestand ervan.
  2. Maak een back-up, open het bestand onder Bestanden en verwijder of vernieuw de betreffende item-items.
  3. Maak de items daarna opnieuw aan in het spel, bijvoorbeeld de kit of de shopwaar.
  4. Bij unknown world: verwijder de locatie of stel die opnieuw in met de commando's van de plugin. Bestaat de wereld nog, zorg er dan voor dat die geladen is.
  5. Herstart de server en controleer de Console.

Goed om te weten: Heb je een wereld verwijderd of hernoemd, dan wijzen oude homes en warps naar het niets. De melding verdwijnt pas als deze items weg zijn.

DeluxeMenus: twee menu's gebruiken hetzelfde commando

Zo ziet de melding eruit:

[DeluxeMenus] open_command specified for menu: <Menu> already exists for another menu!
Skipping menu: <Menu>

Wat er achter zit: In DeluxeMenus kan elk menu een eigen commando hebben waarmee spelers het openen. Dat staat in het menubestand onder open_command. Hebben twee menubestanden hetzelfde commando, dan slaat DeluxeMenus het tweede menu over en is het in het spel niet bereikbaar. De regel "Skipping menu" noemt het overgeslagen menu. Alle andere menu's en de server draaien normaal door. Meest voorkomende oorzaak: een menubestand is als sjabloon gekopieerd en het commando is niet aangepast.

Zo los je het op:

  1. Open onder Bestanden de map plugins/DeluxeMenus/gui_menus.
  2. Zoek het bestand van het overgeslagen menu en het bestand dat hetzelfde open_command gebruikt.
  3. Geef het overgeslagen menu een eigen, nog vrij commando.
  4. Sla op en laad DeluxeMenus opnieuw met /dm reload, in het spel met schuine streep, in de Console zonder.
  5. Open het menu ter test met het nieuwe commando.

Goed om te weten: Wordt een menu alleen vanuit een ander menu geopend, dan heeft het meestal geen eigen commando nodig. Dan kun je het open_command daar ook weglaten.

„Failed to autoload world …“: Multiverse laadt een wereld niet

Zo ziet de melding eruit:

[Multiverse-Core] Failed to autoload world '<Wereld>': Failure{reason=WORLD_FOLDER_INVALID}
[Multiverse-Core] Failed to import world <Wereld>: Failure{reason=WORLD_FOLDER_INVALID}
[Multiverse-Core] Failed to autoload world '<Wereld>': Failure{reason=BUKKIT_NAMESPACED_KEY_MISMATCH}: Namespace mismatch detected! …

Wat er achter zit: Multiverse-Core beheert werelden in plugins/Multiverse-Core/worlds.yml; ontbreekt er een geldige wereldmap, dan kan het de wereld niet laden. Bij BUKKIT_NAMESPACED_KEY_MISMATCH is de wereld al geladen, maar onder een andere interne identificatie dan Multiverse verwacht. Ook dubbel ingevoerde Nether-/Endwerelden of geïmporteerde, niet-geladen werelden (WORLD_EXIST_UNLOADED) veroorzaken laadproblemen; de server en andere werelden blijven gewoon draaien.

Zo los je het op:

  1. Controleer bij WORLD_FOLDER_INVALID onder Bestanden of de wereldmap compleet is en past bij de mapstructuur van je serversoftware. Zet ontbrekende gegevens terug vanuit een back-up.
  2. Bestaat de wereld niet meer, verwijder dan de verouderde vermelding met /mv remove <Wereld>.
  3. Is de wereld wel aanwezig maar niet geladen, gebruik dan /mv load <Wereld>.
  4. Vergelijk bij BUKKIT_NAMESPACED_KEY_MISMATCH de twee identificaties in de melding. Stem de Multiverse-koppeling af volgens de handleiding voor jouw serverversie.
  5. Voer Nether en End niet extra in als de server ze via server.properties of bukkit.yml laadt.
  6. Start de server opnieuw op en controleer de Console.

Goed om te weten: Oude tips over Chunkster vervang je door een herstel vanuit back-ups; zie Wereldgegevens beschadigd, verouderd of niet op te slaan.

DeluxeMenus: menubestand is ongeldig

Zo ziet de melding eruit:

[DeluxeMenus] Detected invalid configuration in file: <Menu>.yml
org.bukkit.configuration.InvalidConfigurationException: while scanning a simple key
 in 'reader', line <Line>, column <Column>:

Wat er achter zit: DeluxeMenus kan het genoemde menubestand niet verwerken en laadt dit menu niet. Spelers zien bij het bijbehorende commando geen interface, alle andere menu's werken gewoon door. De precieze reden staat in de regels direct onder de melding, meestal een YAML-fout met regel en kolom. Typisch is een ontbrekende spatie na de dubbele punt, dus hide_attributes:true in plaats van hide_attributes: true.

Zo los je het op:

  1. Lees de regels onder de melding en noteer regel en kolom.
  2. Open het menubestand onder Bestanden, meestal in de map plugins/DeluxeMenus/gui_menus.
  3. Corrigeer de plek: een spatie na elke dubbele punt, alleen spaties om in te springen, teksten met & of # tussen aanhalingstekens.
  4. Volgt er geen YAML-fout, controleer dan de opties aan de hand van de handleiding van DeluxeMenus, bijvoorbeeld materiaalnamen of de schrijfwijze van voorwaarden.
  5. Laad opnieuw met /dm reload en open het menu om te testen.

Goed om te weten: Een # na een spatie leidt in YAML een opmerking in. Zonder aanhalingstekens ontbreekt dan de rest van de regel, bijvoorbeeld bij hex-kleuren.

„FileNotFoundException“: pluginbestand ontbreekt of kan niet worden aangemaakt

Zo ziet de melding eruit:

java.io.FileNotFoundException: plugins/DigitalClockRemastered/terrainbackups/<Bestand> (No such file or directory)
java.io.FileNotFoundException: plugins/AuctionHouse/auctions.dat (No such file or directory)
java.io.FileNotFoundException: plugins/MagicSpells/spellbooks/<Bestand> (No such file or directory)

Wat erachter zit: Een plugin kan een benodigd bestand onder plugins/ niet lezen of aanmaken. Een verwijderd bestand of een ontbrekende dan wel hernoemde submap kan de oorzaak zijn; bij de eerste start ontbreken sommige gegevensbestanden nog. FileOutputStream of FileWriter in de aanroepstack onder de fout wijzen op een schrijfpoging, die ook mislukt als de bovenliggende map ontbreekt. Afhankelijk van de plugin wordt het bestand later aangemaakt, valt een deelfunctie uit of schakelt de plugin zichzelf uit.

Zo los je het op:

  1. Start de server één keer opnieuw op en controleer of de melding terugkomt.
  2. Controleer onder Bestanden het volledige pad, inclusief submappen. De namen moeten, inclusief hoofdletters en kleine letters, overeenkomen met de melding.
  3. Ontbreken er nog steeds gegevensmappen of bestanden, stop dan de server en herstel ze onder Back-ups vanuit een back-up.
  4. Helpt dat niet, maak dan een back-up van de pluginmap en installeer de plugin opnieuw volgens de handleiding ervan.

Goed om te weten: Een nieuw aangemaakt bestand begint met lege gegevens of standaardwaarden. Verloren spelersgegevens krijg je terug uit een passende back-up.

Ingestelde wereldgenerator is niet geïnstalleerd

Zo ziet de melding eruit:

Could not set generator for default world '<Wereld>': Plugin '<Plugin>' does not exist

Wat erachter zit: Een wereldgenerator is het programma dat nieuw landschap aanmaakt. In bukkit.yml of in de wereldconfiguratie staat voor de wereld een generator uit een plugin ingesteld, maar die plugin is niet geïnstalleerd of is niet geladen. De server maakt nieuwe gebieden dan aan met de standaardgenerator. Gebieden die al verkend zijn, blijven zoals ze zijn, maar aan de randen kan het landschap onlogisch doorlopen.

Zo los je het op:

  1. Open onder Bestanden het bestand bukkit.yml en zoek het gedeelte worlds:. Onder de wereldnaam staat daar generator: <Plugin>.
  2. Wil je de generator houden, installeer dan de genoemde plugin onder Plugins in een passende versie.
  3. Heb je hem niet meer nodig, verwijder dan de generator-regel.
  4. Start de server opnieuw op en controleer in de Console of de melding verdwenen is.

Goed om te weten: De naam achter generator: moet precies overeenkomen met de naam van de plugin. Een typefout leidt tot dezelfde melding, ook al is de plugin geïnstalleerd.

Configuratie is nieuwer dan plugin of serversoftware

Zo ziet de melding eruit:

Warning: This command deletes or removes game content. Create a backup first and check the command’s target.

[Configurations] Loading a newer configuration than is supported (<File version> > <supported version>)! You may have to backup & delete your global config file to start the server.

Wat erachter zit: De configuratie is geschreven door een nieuwere versie dan die nu draait. Typisch is een downgrade, dus het overstappen naar een oudere plugin- of Minecraft-versie. Het eerste getal tussen haakjes is de versie van het bestand, het tweede de hoogste versie die het geïnstalleerde programma kent. Nieuwere instellingen worden genegeerd. Als de melding het over het "global config file" heeft, komt ze van Paper zelf en gaat het meestal om config/paper-global.yml.

Zo los je het op:

  1. Controleer of je onlangs een plugin of bij Versie de serverversie hebt verlaagd.
  2. Ofwel: Update weer naar de versie wabij die de configuratie past.
  3. Of: Herstel de configuratie bij Back-ups vanuit een back-up van de stand van de oude versie.
  4. Is er geen passende back-up, download het bestand dan bij Bestanden, verwijder het en start opnieuw op. Er wordt een nieuw bestand aangemaakt, waarna je je aanpassingen met de hand overzet.

Goed om te weten: Hoe je veilig van versie wisselt, lees je in Minecraft-versie en modloader veilig wijzigen.

MinecraftWarriors3 vindt de map van de kaart niet

Zo ziet de melding eruit:

[MinecraftWarriors3] [Offizielle Map] Quell-Ordner der Map nicht gefunden: ./plugins/MinecraftWarriors3/maps/<Kaartmap>

Wat erachter zit: MinecraftWarriors3 haalt de officiële kaart uit een bronmap die in de configuratie is ingesteld. Deze map ontbreekt. De kaart kan daardoor niet worden gekopieerd of gestart, alles wat erop draait valt uit. De server zelf blijft draaien.

Zo los je het op:

  1. Open onder Bestanden het pad uit de melding. De punt aan het begin (./) staat voor de hoofdmap van de server.
  2. Ontbreekt de map, upload de kaart dan daarheen. De wereldbestanden moeten direct in de map staan, niet in een extra submap, zoals vaak ontstaat bij het uitpakken van een archief.
  3. Staat de kaart ergens anders of heeft de map een andere naam, corrigeer dan het pad in de configuratie onder plugins/MinecraftWarriors3/. Hoofdletters en kleine letters maken verschil.
  4. Start de server opnieuw op en controleer de Console.

Goed om te weten: Hoe je een wereld volledig uploadt, lees je in Minecraft-wereld uploaden en veilig wisselen.

Plugin kan een menu, hologram of tekstbestand niet laden

Zo ziet de melding eruit:

Failed to load hologram from file '<Bestand>'
[YamlStorage] Failed to load npc file: <Bestand>
Could not load messages.yml!

Wat erachter zit: Een plugin kon een van zijn bestanden niet lezen, bijvoorbeeld een menu, een taalbestand, een hologram of een NPC (een figuur die door de server wordt aangestuurd). Meestal zit er een opmaakfout in het bestand, een dubbele naam of een voorwaarde met een verkeerde schrijfwijze achter. Bij menuplugins zijn voorwaarden vaak kleine JavaScript-expressies, dan luidt de melding "Error in requirement javascript syntax". Het betreffende onderdeel ontbreekt in het spel, de rest blijft werken.

Zo los je het op:

  1. Lees de regels onder de melding. Daarin staan vaak de regel en de reden.
  2. Open het bestand onder Bestanden en vergelijk het met het voorbeeld uit de handleiding van de plugin.
  3. Kun je de fout niet vinden, hernoem het bestand dan in plaats van het te verwijderen, bijvoorbeeld naar messages.yml.alt. Bij configuratie- en taalbestanden maakt de plugin bij het herstarten een nieuw bestand aan.
  4. Neem je teksten en instellingen stap voor stap over uit het oude bestand en start opnieuw op.

Goed om te weten: Bij bestanden met hologrammen, NPC's of menu's gaan met een nieuw bestand de vermeldingen verloren. Haal ze in dat geval liever terug uit Back-ups.

Inspringing of dubbele punt fout: pluginbestand niet leesbaar

Zo ziet de melding eruit:

org.bukkit.configuration.InvalidConfigurationException: mapping values are not allowed here
Caused by: while parsing a block mapping
The file plugins/<Plugin>/<File>.yml is broken, it has been renamed …

Wat erachter zit: YAML bouwt zijn structuur op met inspringing en dubbele punten. "mapping values are not allowed here" betekent meestal dat er in een waarde een dubbele punt met een spatie erachter staat zonder dat de waarde tussen aanhalingstekens staat, of dat een regel verkeerd is ingesprongen. "while parsing a block mapping" wijst op een regel die verder of minder ver is ingesprongen dan de buren. De plugin gebruikt het bestand dan niet en valt terug op standaardwaarden of start helemaal niet. EssentialsX hernoemt een kapot bestand en maakt een nieuw aan.

Zo los je het op:

  1. Open het genoemde bestand bij Bestanden en ga naar de regel uit de melding. Bekijk ook de regel erboven.
  2. Spring alleen in met spaties, sleutels van gelijke rang precies even ver.
  3. Zet teksten met een dubbele punt tussen aanhalingstekens, bijvoorbeeld message: "Achtung: Neustart".
  4. Een YAML-validator in de browser toont je de foutplek. Start daarna de server opnieuw op.

Goed om te weten: Heeft EssentialsX het bestand hernoemd, dan staat je oude versie ernaast. Zet je wijzigingen over naar het nieuwe bestand in plaats van het kapotte terug te kopiëren.

Ongeldige rekenformule in een pluginconfiguratie

Zo ziet de melding eruit:

net.objecthunter.exp4j.tokenizer.UnknownFunctionOrVariableException: Unknown function or variable '<Expressie>' …

Wat erachter zit: Sommige plugins berekenen waarden uit formules in hun configuratie, zoals prijzen, beloningen of cooldowns. De rekenbibliotheek exp4j die hiervoor wordt gebruikt, kent alleen getallen, rekentekens, ingebouwde functies en de variabelen die de plugin beschikbaar stelt. Staat er iets anders in de formule, bijvoorbeeld "100t" in plaats van "100", dan breekt de berekening af. De bijbehorende functie van de plugin werkt dan niet zoals bedoeld. De server blijft draaien.

Zo los je het op:

  1. Noteer de expressie tussen enkele aanhalingstekens uit de melding.
  2. Vind de plugin via de stacktrace, de ingesprongen at-regels eronder. Daar staat meestal de bestandsnaam van de plugin, bijvoorbeeld <Plugin>.jar//.
  3. Zoek de expressie in de configuratiebestanden van deze plugin. Bij veel bestanden helpt het om de map via SFTP te downloaden en op je eigen computer te doorzoeken.
  4. Vervang hem door een getal of een geldige formule. Welke variabelen zijn toegestaan, staat in de handleiding van de plugin.
  5. Laad de plugin opnieuw of start de server opnieuw op.

Goed om te weten: Zo stel je de SFTP-toegang in: Serverbestanden in het paneel bewerken en via SFTP verbinden.

FancyNpcs: NPC-actie met lege willekeurige reeks

Zo ziet de melding eruit:

Exception in thread "FancyNpcs-ActionExecutor" java.lang.IllegalArgumentException: bound must be positive

Wat erachter zit: Een actie van een NPC uit FancyNpcs moet willekeurig iets kiezen, bijvoorbeeld een van meerdere vervolgacties. Is de selectie leeg of het getallenbereik negatief, dan kan er geen willekeurig getal worden gemaakt en wordt de actie afgebroken. Spelers merken dit doordat er bij het klikken op de NPC niets of maar een deel gebeurt. De server en de andere NPC's blijven gewoon draaien.

Zo los je het op:

  1. Werk FancyNpcs bij naar de actuele versie voor jouw serverversie.
  2. Controleer de acties van de betreffende NPC. Elke willekeurige selectie heeft minstens één item nodig, getalsgrenzen moeten positief zijn.
  3. De gegevens van de NPC's staan onder Bestanden in de map plugins/FancyNpcs. Maak vóór een wijziging een back-up en bewerk de bestanden alleen als de server is gestopt.
  4. Start de server en klik ter controle op de NPC.

Goed om te weten: De melding noemt de NPC niet. Heb je meerdere NPC's met willekeurige acties, test ze dan na elkaar en houd daarbij de Console in de gaten.

Tekst met oude kleurcodes in een MiniMessage-veld

Zo ziet de melding eruit:

Legacy formatting codes have been detected in a MiniMessage string …

Wat erachter zit: MiniMessage is een schrijfwijze voor tekstopmaak met tags tussen punthaken, zoals <red> of <bold>. Veel actuele plugins gebruiken het voor chat, titels en menu's. Oude kleurcodes met & of § begrijpt MiniMessage niet. Staat zo'n code in een tekst, dan verschijnt die verkeerd opgemaakt of helemaal niet. De server blijft draaien.

Zo los je het op:

  1. Zoek de plugin. De regel vóór de melding of de stacktrace eronder noemt die meestal.
  2. Open onder Bestanden het configuratie- of taalbestand van de plugin en vervang de oude codes door tags:
    • &c wordt <red>, &a wordt <green>, &e wordt <yellow>
    • &l wordt <bold>, &o wordt <italic>, &r wordt <reset>
    • &#37FF00 of §x§3§7… wordt <#37FF00>
  3. Biedt de plugin in zijn instellingen een legacy-modus voor oude codes, dan kun je in plaats daarvan die inschakelen.
  4. Laad de plugin opnieuw of start de server opnieuw en controleer de tekst in het spel.

Goed om te weten: Meng in één tekst nooit beide schrijfwijzen. Eén enkele overgebleven & is genoeg voor de melding.

Paxel: waarde voor een gereedschapsniveau ontbreekt

Zo ziet de melding eruit:

[Paxel] Setting "<Instelling>" for tier "<Niveau>" is not defined in the config!

Wat erachter zit: Een Paxel is een gereedschap dat houweel, bijl en schep combineert. De plugin Paxel biedt het in meerdere niveaus aan, en elk niveau heeft in de configuratie bepaalde verplichte waarden nodig. Voor het genoemde niveau ontbreekt er een. Deze Paxel kan dan niet worden gemaakt of uitgegeven. Vaak gebeurt dit na een update, wanneer de nieuwe versie een instelling verwacht die in het oude bestand nog ontbreekt.

Zo los je het op:

  1. Open onder Bestanden de configuratie in de map plugins/Paxel.
  2. Zoek het niveau uit de melding en vul de genoemde instelling aan. Een compleet niveau in hetzelfde bestand dient je als voorbeeld.
  3. Je kunt ook het bestand hernoemen en opnieuw starten. De plugin schrijft dan de standaardconfiguratie van de huidige versie en jij neemt je aanpassingen over.
  4. Start de server opnieuw en controleer de Console.

Goed om te weten: Let bij het aanvullen op dezelfde inspringing als bij de overige waarden van het niveau, anders volgt er een YAML-fout.

Ongeldige permissie in de plugin.yml van een plugin

Zo ziet de melding eruit:

Permission node '<Plugin>.<Permission>' in plugin description file for <Plugin> v<Versie> is invalid

Wat erachter zit: Elke plugin beschrijft in zijn plugin.yml, een bestand binnenin de plugin-JAR, de permissies die hij meebrengt. Een van die beschrijvingen kon niet worden geladen. De genoemde naam kan daarbij helemaal correct zijn. Vaak ontbreekt een eigenschap van de beschrijving of is die verkeerd opgemaakt. Meestal start de plugin toch, maar deze permissie wordt niet met de standaardwaarden aangemaakt.

Zo los je het op:

  1. Lees in de melding welke plugin het betreft.
  2. Werk hem bij naar een build die bij jouw serverversie past. Vervang daarvoor de JAR terwijl de server is gestopt.
  3. Is het een eigen plugin, controleer dan het volledige permissions-blok van de plugin.yml aan de hand van het Bukkit-formaat, niet alleen de naam. Elk item is een sectie met eigenschappen zoals description, default (true, false, op of not op) en children.
  4. Start de server opnieuw.

Goed om te weten: Geef je rechten sowieso zelf uit met een permissieplugin zoals LuckPerms, dan heeft de melding meestal weinig effect op je spelers.

SuntexSocial: SOCKS5-proxy zonder adres

Zo ziet de melding eruit:

[SuntexSocial] … SOCKS5 proxy is enabled, but telegram.proxy.host is empty

Wat erachter zit: SuntexSocial verbindt je server met een Telegram-bot. In de configuratie is ingesteld dat de bot via een SOCKS5-proxy het internet op gaat. Een proxy is een tussenserver waarlangs de verbinding loopt. Het adres van deze proxy (telegram.proxy.host) is echter leeg. De Telegram-bot start daarom niet, de Minecraft-server blijft normaal draaien.

Zo los je het op:

  1. Open onder Bestanden de configuratie in de map plugins/SuntexSocial.
  2. Heb je de proxy nodig, vul dan onder telegram en proxy bij host de hostnaam in, samen met de bijbehorende poort. Beide krijg je van de aanbieder van de proxy.
  3. Heb je geen proxy nodig, schakel de SOCKS5-proxy dan uit in dezelfde configuratie.
  4. Start de server opnieuw en controleer of de bot reageert.

Goed om te weten: Een proxy is alleen nodig als Telegram vanuit het netwerk van de server niet direct bereikbaar is. Is daar geen reden voor, laat hem dan uitgeschakeld.

Wereldgenerator-plugin start te laat

Zo ziet de melding eruit:

Could not set generator for default world '<Wereld>': Plugin '<Plugin>' is not enabled yet

Wat erachter zit: Voor de hoofdwereld is een generator uit een plugin ingesteld, maar de plugin start pas nadat de server de werelden heeft geladen. De wereld gebruikt dan de normale generator, nieuwe gebieden zien er dus anders uit dan gepland. Voor al gegenereerde gebieden verandert er niets. De server draait normaal.

Zo los je het op:

  1. Lees in de handleiding van de generatorplugin na hoe die voor de hoofdwereld wordt ingesteld.
  2. Meestal hoort de generator in bukkit.yml onder worlds: bij de naam van de hoofdwereld.
  3. De plugin moet bij het opstarten van de server laden, dus vóór de werelden. Dat bepaalt de ontwikkelaar in de plugin.yml met load: STARTUP. Komt de melding toch, controleer dan of de geïnstalleerde versie bij jouw serverversie past.
  4. Start de server opnieuw en controleer de Console.

Goed om te weten: Gebieden die al met de normale generator zijn ontstaan, blijven zoals ze zijn. Wil je dat de hele wereld met de nieuwe generator ontstaat, dan heb je een nieuwe wereld nodig. Maak daarvoor eerst een back-up van de oude onder Back-ups.

LuckPerms kan het importbestand niet lezen

Zo ziet de melding eruit:

[LuckPerms] Error whilst reading from the import file

Wat er achter zit: Met de import neemt LuckPerms groepen, rechten en spelergegevens over uit een bestand dat eerder met de export is aangemaakt, bijvoorbeeld bij een verhuizing vanaf een andere server. LuckPerms kon het gekozen bestand niet lezen of het formaat niet verwerken. De import wordt afgebroken. De server blijft gewoon draaien.

Zo los je het op:

  1. Controleer bij Bestanden of het bestand in de map plugins/LuckPerms staat en of de naam precies overeenkomt met die in het commando.
  2. Upload het bestand ongewijzigd, zoals de export het heeft aangemaakt, dus niet uitgepakt, hernoemd of bewerkt.
  3. Lees de foutmelding direct onder deze regel. Daar staat de exacte plek waar het lezen mislukte.
  4. Start daarna de import opnieuw met /lp import <Bestand>.

Goed om te weten: Hoe je groepen en rechten in LuckPerms opzet en controleert, lees je in LuckPerms instellen: rechten en groepen.

Paper-instelling bevat een onbekende waarde

Zo ziet de melding eruit:

Encountered an unexpected exception
org.spongepowered.configurate.serialize.SerializationException: [<Setting path>] <unknown value> …

Wat er achter zit: Paper leest zijn instellingen uit config/paper-global.yml, config/paper-world-defaults.yml en per wereld uit de paper-world.yml in de wereldmap. In een van deze bestanden staat een waarde die jouw serverversie niet kent, bijvoorbeeld een voorwerp of een gegevensonderdeel dat pas in een nieuwere versie bestaat of dat is hernoemd. De instelling wordt niet overgenomen. Dit komt vaak voor na een overstap naar een oudere versie of als bestanden van een andere server zijn gekopieerd.

Zo los je het op:

  1. Lees de melding: tussen de rechte haken staat het pad van de instelling, dus de sleutels van buiten naar binnen, daarna volgt de onbekende waarde.
  2. Open het bijbehorende bestand bij Bestanden in de map config of in de wereldmap en volg het pad.
  3. Corrigeer de waarde naar een naam die jouw versie kent, of verwijder hem.
  4. Start de server opnieuw op.

Goed om te weten: Verwijder je een hele instelling, dan zet Paper bij de volgende start de standaardwaarde weer terug.

BMenu: menu-ID is al in gebruik („key already exists“)

Zo ziet de melding eruit:

[BMenu] key already exists <Namespace>:<Menu>

Wat hier achter zit: BMenu beheert menu's via unieke ID's. Wordt een al bezette ID opnieuw geregistreerd, dan negeert de plugin de nieuwe invoer en houdt hij de bestaande. Hierdoor kunnen wijzigingen in de tweede menudefinitie ontbreken of kan er een ander menu verschijnen dan verwacht. De server blijft gewoon draaien.

Zo los je het op:

  1. Maak onder Back-ups een back-up van je instellingen voordat je menubestanden bewerkt.
  2. Lees de volledige ID in de Console. Vergelijk onder Bestanden de ID's van de BMenu-menudefinities en controleer ook geïmporteerde menu's op dubbele definities.
  3. Verwijder een overbodige kopie of geef het tweede menu een unieke ID. Pas verwijzingen naar een gewijzigde ID ook aan.
  4. Start de server volledig opnieuw op en test de betreffende menu's. Blijft de melding bestaan ondanks unieke definities, meld het probleem dan met het volledige startlog aan de BMenu-auteur.

Goed om te weten: De volgorde van registratie bepaalt welke invoer behouden blijft. Verlaat je er dus niet op dat bestanden in een bepaalde volgorde worden geladen.

SCore: Kopf-ID wordt geweigerd door de kopdatabase

Zo ziet de melding eruit:

[SCore] Error when creating the Head: <Kopwaarde> invalid head database id ! (<Kopwaarde>)

Wat erachter zit: SCore moet een aangepaste kop maken, maar kan de ingestelde waarde niet via de kopdatabase omzetten. Een database-ID verwijst naar een daar opgeslagen kop; een texturewaarde beschrijft daarentegen het uiterlijk ervan. De betreffende kop ontbreekt, terwijl de server gewoon blijft draaien.

Zo los je het op:

  1. Controleer in de Console welke SCore-plugin de kop op dit moment laadt. Open de bijbehorende kopdefinitie onder Bestanden.
  2. Vergelijk het ingestelde formaat met de handleiding van deze plugin. Gebruik een geldige kop-ID; een texturewaarde vul je alleen in het daarvoor gedocumenteerde veld in.
  3. Als er een kopdatabase is gekoppeld, controleer dan de opstartmeldingen ervan en wacht tot deze volledig is geladen. Test de kop daarna opnieuw.
  4. Herstart de server na de aanpassing en controleer het betreffende scherm of voorwerp.

Multiverse: naam van de standaardwereld botst met een andere wereld

Zo ziet de melding eruit:

[Multiverse-Core] Unable to migrate default world's name caused by level-name change.
[Multiverse-Core] We have detected a clash between the default name '<Wereld>' and an existing non-default world in your worlds.yml file.
[Multiverse-Core] Please change the level-name in server.properties to something else and restart the server.

Wat erachter zit: Multiverse moet na een wijziging van level-name de naam van de standaardwereld overnemen. De nieuwe naam is in de wereldconfiguratie al aan een andere wereld toegewezen. Daarom wordt de overname afgebroken en moet de koppeling van de standaardwereld worden gecorrigeerd.

Zo los je het op:

  1. Maak onder Back-ups een back-up en stop de server voordat je wijzigingen doorvoert.
  2. Vergelijk onder Bestanden de regel level-name in server.properties met het Multiverse-bestand worlds.yml. Controleer welke bestaande wereld daadwerkelijk de standaardwereld moet zijn.
  3. Was de wijziging onbedoeld, herstel dan de vorige naam van deze standaardwereld. Voor een geplande hernoeming los je eerst het conflict op volgens de Multiverse-handleiding.
  4. Start de server en controleer in de Console of de koppeling lukt. Controleer daarna of je in de bedoelde wereld terechtkomt.

UltimateDonutSmp: beloningscommando van een kist mislukt

Zo ziet de melding eruit:

[UltimateDonutSmp] Failed to grant crate reward <Beloning> from crate <Kist> to <Speler>
org.bukkit.command.CommandException: Unhandled exception executing <Commando>

Wat erachter zit: UltimateDonutSmp voert voor een kistbeloning een commando uit. Dit commando eindigt met een fout, waardoor de betreffende beloningsactie mislukt. De server blijft draaien; de kistconfiguratie en het volledige foutenspoor laten zien welk commando het betreft.

Zo los je het op:

  1. Open de volledige melding in de Console of onder Bestanden in logs/latest.log. Lees ook de daaropvolgende regels met de oorzaak.
  2. Controleer onder Bestanden het beloningscommando van de betreffende kist. Vergelijk de schrijfwijze en de spelerplaatshouders met de handleiding van jouw UltimateDonutSmp-versie.
  3. Werk de plugin onder Plugins bij naar een passende versie en herstart de server na de aanpassing.
  4. Test de beloning gecontroleerd. Controleer vóór een nieuwe uitgifte of onderdelen al zijn uitbetaald of uitgegeven, zodat er niets dubbel wordt uitgedeeld.

NovaSync-dashboard veilig instellen en standaardinloggegevens vervangen

Zo ziet de melding eruit:

[NovaSyncPlugin] [CRITICAL] dashboard.creds: no OWNER account configured AND defaults still in vault

Wat erachter zit: In het NovaSync-dashboard ontbreekt een eigenaarsaccount, oftewel het account voor het beheer van het dashboard. Tegelijkertijd staan er in de inloggegevensopslag van de plugin nog standaardinloggegevens. De veilige eerste installatie is dus niet compleet en moet worden afgerond. De gameserver blijft gewoon draaien; de waarschuwing heeft betrekking op de toegang tot het dashboard van de plugin.

Zo los je het op:

  1. Lees de volledige melding in de Console of onder Bestanden in logs/latest.log.
  2. Open in je NovaSync-dashboard het genoemde pad /dashboard en doorloop de installatiewizard volledig. Stel daarbij je eigenaarsaccount in.
  3. Vervang de standaardinloggegevens door eigen inloggegevens met een sterk wachtwoord dat je nergens anders gebruikt. Controleer daarna of NovaSync de waarschuwing opnieuw weergeeft.

Goed om te weten: Inloggegevens horen niet in een ticket of in een openbaar gedeeld logfragment. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.

DonutShop: aankoopcommando mislukt, shards worden terugbetaald

Zo ziet de melding eruit:

[DonutShop] Shard shop command failed for <Speler> ("<Commando>"); refunding <Bedrag> Shard.

Wat erachter zit: DonutShop probeert de gekochte beloning toe te kennen via een opgeslagen commando. Dit commando mislukt en de plugin meldt de terugbetaling van de shards. De server blijft draaien; alleen deze aankoop is getroffen.

Zo los je het op:

  1. Lees in de Console de meldingen direct vóór het aankoopcommando. Daarin kan een onbekend commando of een ongeldige parameter staan.
  2. Open het betreffende shopitem onder Bestanden. Vergelijk de commandonaam, argumenten en spelerplaatshouders met de documentatie van de verantwoordelijke plugin.
  3. Controleer of de uitvoerende plugin onder Plugins is geïnstalleerd en volgens de Console succesvol is geladen.
  4. Voer de correctie door volgens de handleiding van DonutShop. Test daarna één enkele aankoop en controleer de beloning en het shardtegoed.

ExecutableItems: true of false ontbreekt in het speciale commando

Zo ziet de melding eruit:

[ExecutableItems] INVALID COMMAND A SCommand contains an invalid boolean: <Waarde> for command: <Commando>

Wat erachter zit: ExecutableItems controleert de argumenten van een speciaal commando. Een booleaanse waarde is een ja-nee-aanduiding met de schrijfwijzen true of false. Op de daarvoor bedoelde plek staat een andere waarde. De betreffende item-actie is daardoor ongeldig; de server blijft draaien.

Zo los je het op:

  1. Open de melding in de Console en zoek het genoemde commando op in de betreffende itemconfiguratie onder Bestanden.
  2. Maak een back-up van het bestand voordat je het bewerkt. Vergelijk de volledige argumentenreeks met de documentatie van je geïnstalleerde ExecutableItems-versie.
  3. Vul true of false in op de daarvoor bedoelde plek. Controleer ook de positie van de volgende commando's als argumenten zijn verschoven.
  4. Start de server na het opslaan opnieuw op en test precies deze item-actie.

ExecutableItems: wereld in disableItemsPerWorld is ongeldig

Zo ziet de melding eruit:

[ExecutableItems] Invalid world: <Wereld> in the option disableItemsPerWorld

Wat erachter zit: ExecutableItems moet bepaalde items per wereld blokkeren. Een daarvoor ingevoerde wereld wordt door de plugin niet herkend als een geldige geladen wereld. De blokkaderegel van dit item kan daardoor niet goed worden toegewezen. De server blijft draaien.

Zo los je het op:

  1. Controleer in de Console of de gewenste wereld succesvol is geladen. Los eerst een daar gemelde laadfout op.
  2. Maak onder Bestanden een back-up van de ExecutableItems-configuratie en zoek de optie disableItemsPerWorld.
  3. Vergelijk het item met de daadwerkelijke naam van de geladen wereld. Corrigeer de schrijfwijze en verwijder items voor werelden die definitief zijn verwijderd.
  4. Start de server volledig opnieuw op. Controleer de Console en test of de bedoelde items in de betreffende wereld geblokkeerd zijn.

Staat jouw melding er niet bij?

Lees de hele melding in de Console of in logs/latest.log, ook de regels er direct voor. Vaak staat daar welke plugin op dat moment zijn bestanden laadt. In de stacktrace eronder herken je de plugin aan de bestandsnaam van de JAR of aan de map plugins/<Plugin>/ in het pad. Noemt de melding een bestand met regel en kolom, dan is het bijna altijd een vormfout zoals in de secties hierboven. Maak vóór elke wijziging een back-up. Kom je er niet uit, open dan een ticket en geef het tijdstip van de melding door.