Spring til indhold
Platforme

Spigot- og Paper-plugins

Det bedste Bukkit-, Spigot- eller Paper-plugin fra Codexe i Java eller Kotlin: hvad du skriver i anmodningen, versioner, plugin.yml, afhængigheder, build og problemer.

Opdateret

På denne side
  1. Hvad du skriver i anmodningen
  2. Hvad Codexe genererer
  3. Versioner og Java
  4. Build og verificering
  5. Installation
  6. Almindelige problemer

Typerne Bukkit/Spigot/Paper laver et serverplugin, der kører på Paper, Spigot og deres forks. Vælg Java (Maven-projekt) eller Kotlin (Gradle-projekt med build.gradle.kts).

For at spille dit plugin i spillet kan du starte en privat testserver med Prøv det nu.

Når du sender anmodningen, spørger Codexe, hvilken Minecraft-version pluginet er til, fra 1.8.8 til 26.3. Koden skrives til den versions API og Java-niveau, og testserveren kører den version. Projekter, der er oprettet før 30. september 2026, beholder den version, der står i deres buildfiler.

#Hvad du skriver i anmodningen

  • Serversoftware og version: "Paper 1.21.4" eller "Spigot 1.20.1". Paper har et større API end Spigot. Kode skrevet til Spigot kører på Paper, men ikke omvendt, så bed om Spigot, hvis du har brug for begge.
  • Kommandoer med argumenter, hvem der må bruge dem, og tab completion.
  • Permissions med deres standardværdier (true, op, false).
  • De nøgler i config.yml, som skal kunne redigeres.
  • Lagring: YAML, SQLite, MySQL eller i hukommelsen.
  • Integrationer: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, nævnt udtrykkeligt, så de bliver tilføjet som afhængigheder.
Text
A Paper 1.21.4 plugin (Java) called Bounties.
- /bounty set <player> <amount>: takes money via Vault, adds it to the player's bounty.
- Killing a player with a bounty pays it to the killer.
- /bounty top shows the 10 highest bounties.
- Bounties stored in SQLite. Minimum bounty 100 (config.yml).
- Permission bounties.set (default true).
Text
A Paper 1.21.4 plugin in Kotlin called Bounties, same features as above.
Use Kotlin idioms (data classes, extension functions) but keep the Bukkit API usage standard.

#Hvad Codexe genererer

  • Et Maven-projekt (Java) eller Gradle-projekt (Kotlin) med den rigtige API-afhængighed.
  • Hovedklassen, der udvider JavaPlugin, plus klasser til kommandoer, listeners og lagring.
  • plugin.yml med hovedklassen, api-version, kommandoer og permissions, og config.yml, når der er indstillinger.
YAML
name: Bounties
version: 1.0.0
main: eu.codexe.bounties.Bounties
api-version: '1.21'
depend: [Vault]
commands:
  bounty:
    description: Manage bounties
permissions:
  bounties.set:
    default: true

#Versioner og Java

Codexe læser Minecraft-versionen fra buildfilen og bygger med Java 17 (før 1.20.5), Java 21 (1.20.5 og nyere) eller Java 25 (26.x). Hvis du ikke angiver en version, bruges Paper/Spigot-API'et 1.20.6.

#Build og verificering

Codexe kompilerer pluginet, før det kaldes Klar, og tjekker, at JAR-filen indeholder klasserne og en plugin.yml (eller paper-plugin.yml). Builds af plugins tager som regel et godt stykke under et minut. Se Kompilér.

#Installation

Download JAR-filen, læg den i plugins/, genstart serveren (brug ikke /reload), og tjek konsollen for fejl ved opstart.

#Almindelige problemer

SymptomSandsynlig årsag
Pluginet indlæses ikke, "main class not found"main: i plugin.yml passer ikke til klassen. Bed chatten om at rette det, eller tjek efter manuelle omdøbninger.
"Unsupported API version" på en ældre serverPluginet sigter mod et nyere API end din server. Angiv din præcise serverversion i anmodningen.
En kommando gør ingentingKommandoen mangler i plugin.yml, eller spilleren mangler permission.
NoClassDefFoundError for Vault eller lignendeDet plugin, der er afhængighed, er ikke installeret på serveren.
Kan bygges, men en funktion opfører sig forkertBeskriv den præcise adfærd i spillet i chatten. Verificeringen tjekker buildet, ikke gameplayet.
Spigot- og Paper-plugins | Codexe Docs