--- 📎 Attached 1 file(s):
File: pasted-code-1787203554802.txt
Skapa ett komplett Minecraft-plugin som heter Gröna Land Skripts.
Det ska vara ett eget, enkelt och kraftfullt skriptsystem, ungefär som Skript, men byggt specifikt för Arclight + NeoForge + Paper API 1.21.1.
TEKNIK
- Minecraft: 1.21.1
- Server: Arclight
- Modloader: NeoForge
- API: Paper API 1.21.1
- Java: 21
- Server-side
- Plugin-namn: Gröna Land Skripts
- Kortnamn: GLS
- Scriptformat: ".gls"
- Pluginfil: GrönaLandSkripts.jar
Pluginet ska vara ett riktigt fungerande plugin, inte en prototyp eller mockup.
---
1. EXTREMT ENKELT SKRIPTSPRÅK
Användaren ska kunna skapa scripts utan Java, Gradle eller kompilering.
Scripts ska vara vanliga textfiler med filändelsen:
.gls
Exempel:
welcome.gls
Användaren ska kunna öppna filen i Anteckningar och skriva:
on join:
message "&aVälkommen till servern, %player%!"
command /discord:
message "&bDiscord: https://discord.gg/example"
Sedan:
/gls reload
Klart.
Syntaxen ska vara enkel, tydlig och inspirerad av Skript.
Använd indentation med spaces.
---
2. AUTOMATISK MAPP
När pluginet startas första gången ska det automatiskt skapa:
/plugins/GrönaLandSkripts/
├── config.yml
├── INSTRUKTIONER.txt
├── scripts/
│ └── exempel.gls
└── logs/
Pluginet får aldrig skriva över användarens befintliga filer.
Om exempel.gls eller INSTRUKTIONER.txt redan finns ska de lämnas helt orörda.
---
3. INSTRUKTIONER.TXT
Skapa automatiskt en svensk:
INSTRUKTIONER.txt
Den ska förklara:
- hur man skapar ".gls"-scripts
- var scripts ska placeras
- hur "/gls reload" fungerar
- commands
- events
- conditions
- variables
- permissions
- effects
- moddade entities
- moddade fordon
- command suggestions
- exempel
Den ska vara lätt att förstå för någon som aldrig programmerat tidigare.
---
4. EXEMPEL.GLS
Skapa automatiskt ett fungerande exempel:
# ======================================
# Gröna Land Skripts - Exempel
# ======================================
on join:
message "&aVälkommen till servern, %player%!"
command /discord:
message "&bDiscord: &fhttps://discord.gg/example"
command /store:
message "&6Butik: &fhttps://example.com/store"
command /vote:
message "&aRösta: &fhttps://example.com/vote"
command /hej:
message "&eHej %player%!"
command /admin:
if player has permission "greensland.admin":
message "&aDu har admin-permission!"
else:
message "&cDu har inte permission!"
Alla exempel som genereras måste faktiskt fungera med parsern.
---
5. COMMAND SYSTEM
Scripts ska kunna skapa egna commands:
command /discord:
message "&bDiscord: https://discord.gg/example"
Stöd för:
- permissions
- aliases
- arguments
- optional arguments
- player-only commands
- console commands
- tab completion
- command suggestions
Exempel:
command /teleport <player>:
teleport player to <player>
---
6. COMMAND SUGGESTIONS / TAB COMPLETION
Detta är mycket viktigt.
När ett ".gls"-script skapar ett command ska det automatiskt registreras på servern och få Minecrafts vanliga command autocomplete.
Exempel:
Om scriptet innehåller:
command /discord:
message "&bDiscord"
ska:
/di<TAB>
föreslå:
/discord
Om användaren skriver:
/gls re
ska Minecraft visa exempelvis:
/gls reload
/gls scripts
/gls errors
/gls help
Det ska använda Minecrafts riktiga command suggestion-system.
---
7. ARGUMENT SUGGESTIONS
Stöd:
command /teleport <player>:
...
När användaren skriver:
/teleport <TAB>
ska online-spelare föreslås automatiskt.
Stöd även:
command /park <ride>:
suggest:
"balder"
"insane"
"jetpass"
Då ska:
/park <TAB>
visa:
balder
insane
jetpass
Stöd även dynamiska suggestions:
suggest online players
suggest worlds
suggest custom list
Command suggestions ska automatiskt uppdateras när scripts laddas om.
---
8. EVENTS
Implementera många användbara events:
on join:
on quit:
on chat:
on death:
on respawn:
on block break:
on block place:
on interact:
on damage:
on command:
Syntaxen ska vara enkel.
Exempel:
on join:
message "&aVälkommen %player%!"
---
9. CONDITIONS
Stöd exempelvis:
if player has permission "greensland.admin":
if player is sneaking:
if player is flying:
if player is online:
if player's health is less than 10:
if player's world is "world":
Exempel:
command /admin:
if player has permission "greensland.admin":
message "&aDu är admin!"
else:
message "&cDu har inte permission!"
---
10. VARIABLES
Använd enkel syntax:
set {coins.%player%} to 100
add 10 to {coins.%player%}
remove 5 from {coins.%player%}
delete {coins.%player%}
Variables ska sparas permanent och överleva serverrestart.
---
11. EFFECTS
Implementera enkla effects:
message "..."
broadcast "..."
send "..." to player
play sound ...
give item ...
teleport player ...
execute console command "..."
execute player command "..."
heal player
damage player
kick player
---
12. MODDADE ENTITIES
Detta är ett av de absolut viktigaste kraven.
Pluginet måste kunna hantera både:
- Bukkit/Paper entities
- Bukkit vehicles
- NeoForge entities
- NeoForge vehicles
- moddade entities
- moddade fordon
- passagerare
- Create-baserade fordon
- Create-baserade bergochdalbanor/coasters
Skapa ett eget:
Hybrid Entity API
som fungerar mellan Paper och NeoForge.
---
13. MODDADE FORDON
Skapa events:
on vehicle enter:
on vehicle exit:
on mod vehicle enter:
on mod vehicle exit:
on mod vehicle stopped:
Det måste vara möjligt att använda:
on mod vehicle exit:
cancel event
message "&cDu kan inte hoppa av under åkturen!"
Om NeoForge inte har ett vanligt cancellable event ska pluginet använda rätt kompatibilitetslösning för att faktiskt hindra spelaren från att lämna fordonet.
Detta ska fungera med moddade fordon, inte bara Bukkit Vehicles.
---
14. BERGOCHDALBANE-SYSTEM
Skapa automatiskt ett exempel:
rides.gls
Exempel:
on mod vehicle enter:
set {riding.%player%} to true
message "&aÅkturen börjar!"
on mod vehicle exit:
if {riding.%player%} is true:
cancel event
message "&cDu kan inte hoppa av under åkturen!"
on mod vehicle stopped:
if {riding.%player%} is true:
delete {riding.%player%}
message "&aÅkturen är slut!"
Det ska vara möjligt att använda detta för Gröna Lands moddade bergochdalbanor.
---
15. ARCLIGHT + NEOFORGE BRIDGE
Arkitekturen ska vara:
Gröna Land Skripts
|
Script Engine
|
Hybrid Event API
/ \
Paper API NeoForge API
\ /
Arclight
Använd Paper API när det fungerar.
När Paper API inte kan upptäcka eller hantera en moddad funktion ska NeoForge API användas.
Använd adapters/reflection där det behövs för kompatibilitet.
Pluginet får inte krascha om en specifik mod inte finns installerad.
---
16. PLUGIN COMMANDS
Implementera:
/gls help
/gls reload
/gls scripts
/gls errors
/gls version
Alias:
/greenslandskripts
/gls
Alla dessa ska ha command autocomplete.
---
17. RELOAD
När:
/gls reload
körs ska pluginet:
1. läsa alla ".gls"-filer
2. validera syntax
3. registrera commands
4. registrera events
5. uppdatera tab completion
6. aktivera fungerande scripts
7. rapportera fel
Servern ska inte behöva startas om.
---
18. FELHANTERING
Ett felaktigt script får aldrig krascha servern.
Exempel:
[Gröna Land Skripts] Fel i rides.gls
Rad: 12
Okänt event:
on coaster jump
Scriptet har stängts av.
Visa alltid:
- filnamn
- radnummer
- fel
- vad som förväntades om möjligt
Ett fel i ett script ska bara påverka det scriptet.
---
19. LOGGAR
Skapa:
/plugins/GrönaLandSkripts/logs/
och logga scriptfel där.
---
20. PRESTANDA
Pluginet ska:
- vara event-driven
- inte köra onödiga tasks varje tick
- inte blockera main thread
- inte skapa memory leaks
- rensa player-data när spelaren lämnar
- kunna hantera många scripts
- hantera reload korrekt
- inte krascha servern vid scriptfel
---
21. KOMPLETT PROJEKT
Skapa hela projektet:
GrönaLandSkripts/
├── build.gradle
├── settings.gradle
├── README.md
├── DOCUMENTATION.md
└── src/
└── main/
├── java/
└── resources/
└── plugin.yml
Det ska gå att bygga till:
GrönaLandSkripts.jar
och lägga direkt i:
/plugins/
---
22. VIKTIGASTE KRAVET
Gröna Land Skripts ska kännas som Skript, men vara enklare och speciellt anpassat för Arclight + NeoForge.
En användare ska kunna:
1. installera pluginet
2. starta servern
3. öppna "plugins/GrönaLandSkripts/scripts/"
4. skapa "mittscript.gls"
5. skriva några enkla rader
6. spara
7. köra "/gls reload"
8. direkt använda sitt nya command/event.
Dessutom ska commands automatiskt få Minecrafts vanliga Tab-completion och command suggestions.
Prioritera framför allt:
Enkel syntax + fungerande ".gls"-filer + automatisk command registration + Tab-completion + Arclight/NeoForge-kompatibilitet + moddade entities/fordon.
Bygg inte en demo. Skapa ett komplett, faktiskt fungerande plugin.
📄
pasted-code-1787203610311.txt
txt
539 lines
▶
Skapa ett komplett Minecraft-plugin som heter Gröna Land Skripts.
Det ska vara ett eget, enkelt och kraftfullt skriptsystem, ungefär som Skript, men byggt specifikt för Arclight + NeoForge + Paper API 1.21.1.
TEKNIK
- Minecraft: 1.21.1
- Server: Arclight
- Modloader: NeoForge
- API: Paper API 1.21.1
- Java: 21
- Server-side
- Plugin-namn: Gröna Land Skripts
- Kortnamn: GLS
- Scriptformat: ".gls"
- Pluginfil: GrönaLandSkripts.jar
Pluginet ska vara ett riktigt fungerande plugin, inte en prototyp eller mockup.
---
1. EXTREMT ENKELT SKRIPTSPRÅK
Användaren ska kunna skapa scripts utan Java, Gradle eller kompilering.
Scripts ska vara vanliga textfiler med filändelsen:
.gls
Exempel:
welcome.gls
Användaren ska kunna öppna filen i Anteckningar och skriva:
on join:
message "&aVälkommen till servern, %player%!"
command /discord:
message "&bDiscord: https://discord.gg/example"
Sedan:
/gls reload
Klart.
Syntaxen ska vara enkel, tydlig och inspirerad av Skript.
Använd indentation med spaces.
---
2. AUTOMATISK MAPP
När pluginet startas första gången ska det automatiskt skapa:
/plugins/GrönaLandSkripts/
├── config.yml
├── INSTRUKTIONER.txt
├── scripts/
│ └── exempel.gls
└── logs/
Pluginet får aldrig skriva över användarens befintliga filer.
Om exempel.gls eller INSTRUKTIONER.txt redan finns ska de lämnas helt orörda.
---
3. INSTRUKTIONER.TXT
Skapa automatiskt en svensk:
INSTRUKTIONER.txt
Den ska förklara:
- hur man skapar ".gls"-scripts
- var scripts ska placeras
- hur "/gls reload" fungerar
- commands
- events
- conditions
- variables
- permissions
- effects
- moddade entities
- moddade fordon
- command suggestions
- exempel
Den ska vara lätt att förstå för någon som aldrig programmerat tidigare.
---
4. EXEMPEL.GLS
Skapa automatiskt ett fungerande exempel:
# ======================================
# Gröna Land Skripts - Exempel
# ======================================
on join:
message "&aVälkommen till servern, %player%!"
command /discord:
message "&bDiscord: &fhttps://discord.gg/example"
command /store:
message "&6Butik: &fhttps://example.com/store"
command /vote:
message "&aRösta: &fhttps://example.com/vote"
command /hej:
message "&eHej %player%!"
command /admin:
if player has permission "greensland.admin":
message "&aDu har admin-permission!"
else:
message "&cDu har inte permission!"
Alla exempel som genereras måste faktiskt fungera med parsern.
---
5. COMMAND SYSTEM
Scripts ska kunna skapa egna commands:
command /discord:
message "&bDiscord: https://discord.gg/example"
Stöd för:
- permissions
- aliases
- arguments
- optional arguments
- player-only commands
- console commands
- tab completion
- command suggestions
Exempel:
command /teleport :
teleport player to
---
6. COMMAND SUGGESTIONS / TAB COMPLETION
Detta är mycket viktigt.
När ett ".gls"-script skapar ett command ska det automatiskt registreras på servern och få Minecrafts vanliga command autocomplete.
Exempel:
Om scriptet innehåller:
command /discord:
message "&bDiscord"
ska:
/di
föreslå:
/discord
Om användaren skriver:
/gls re
ska Minecraft visa exempelvis:
/gls reload
/gls scripts
/gls errors
/gls help
Det ska använda Minecrafts riktiga command suggestion-system.
---
7. ARGUMENT SUGGESTIONS
Stöd:
command /teleport :
...
När användaren skriver:
/teleport
ska online-spelare föreslås automatiskt.
Stöd även:
command /park :
suggest:
"balder"
"insane"
"jetpass"
Då ska:
/park
visa:
balder
insane
jetpass
Stöd även dynamiska suggestions:
suggest online players
suggest worlds
suggest custom list
Command suggestions ska automatiskt uppdateras när scripts laddas om.
---
8. EVENTS
Implementera många användbara events:
on join:
on quit:
on chat:
on death:
on respawn:
on block break:
on block place:
on interact:
on damage:
on command:
Syntaxen ska vara enkel.
Exempel:
on join:
message "&aVälkommen %player%!"
---
9. CONDITIONS
Stöd exempelvis:
if player has permission "greensland.admin":
if player is sneaking:
if player is flying:
if player is online:
if player's health is less than 10:
if player's world is "world":
Exempel:
command /admin:
if player has permission "greensland.admin":
message "&aDu är admin!"
else:
message "&cDu har inte permission!"
---
10. VARIABLES
Använd enkel syntax:
set {coins.%player%} to 100
add 10 to {coins.%player%}
remove 5 from {coins.%player%}
delete {coins.%player%}
Variables ska sparas permanent och överleva serverrestart.
---
11. EFFECTS
Implementera enkla effects:
message "..."
broadcast "..."
send "..." to player
play sound ...
give item ...
teleport player ...
execute console command "..."
execute player command "..."
heal player
damage player
kick player
---
12. MODDADE ENTITIES
Detta är ett av de absolut viktigaste kraven.
Pluginet måste kunna hantera både:
- Bukkit/Paper entities
- Bukkit vehicles
- NeoForge entities
- NeoForge vehicles
- moddade entities
- moddade fordon
- passagerare
- Create-baserade fordon
- Create-baserade bergochdalbanor/coasters
Skapa ett eget:
Hybrid Entity API
som fungerar mellan Paper och NeoForge.
---
13. MODDADE FORDON
Skapa events:
on vehicle enter:
on vehicle exit:
on mod vehicle enter:
on mod vehicle exit:
on mod vehicle stopped:
Det måste vara möjligt att använda:
on mod vehicle exit:
cancel event
message "&cDu kan inte hoppa av under åkturen!"
Om NeoForge inte har ett vanligt cancellable event ska pluginet använda rätt kompatibilitetslösning för att faktiskt hindra spelaren från att lämna fordonet.
Detta ska fungera med moddade fordon, inte bara Bukkit Vehicles.
---
14. BERGOCHDALBANE-SYSTEM
Skapa automatiskt ett exempel:
rides.gls
Exempel:
on mod vehicle enter:
set {riding.%player%} to true
message "&aÅkturen börjar!"
on mod vehicle exit:
if {riding.%player%} is true:
cancel event
message "&cDu kan inte hoppa av under åkturen!"
on mod vehicle stopped:
if {riding.%player%} is true:
delete {riding.%player%}
message "&aÅkturen är slut!"
Det ska vara möjligt att använda detta för Gröna Lands moddade bergochdalbanor.
---
15. ARCLIGHT + NEOFORGE BRIDGE
Arkitekturen ska vara:
Gröna Land Skripts
|
Script Engine
|
Hybrid Event API
/ \
Paper API NeoForge API
\ /
Arclight
Använd Paper API när det fungerar.
När Paper API inte kan upptäcka eller hantera en moddad funktion ska NeoForge API användas.
Använd adapters/reflection där det behövs för kompatibilitet.
Pluginet får inte krascha om en specifik mod inte finns installerad.
---
16. PLUGIN COMMANDS
Implementera:
/gls help
/gls reload
/gls scripts
/gls errors
/gls version
Alias:
/greenslandskripts
/gls
Alla dessa ska ha command autocomplete.
---
17. RELOAD
När:
/gls reload
körs ska pluginet:
1. läsa alla ".gls"-filer
2. validera syntax
3. registrera commands
4. registrera events
5. uppdatera tab completion
6. aktivera fungerande scripts
7. rapportera fel
Servern ska inte behöva startas om.
---
18. FELHANTERING
Ett felaktigt script får aldrig krascha servern.
Exempel:
[Gröna Land Skripts] Fel i rides.gls
Rad: 12
Okänt event:
on coaster jump
Scriptet har stängts av.
Visa alltid:
- filnamn
- radnummer
- fel
- vad som förväntades om möjligt
Ett fel i ett script ska bara påverka det scriptet.
---
19. LOGGAR
Skapa:
/plugins/GrönaLandSkripts/logs/
och logga scriptfel där.
---
20. PRESTANDA
Pluginet ska:
- vara event-driven
- inte köra onödiga tasks varje tick
- inte blockera main thread
- inte skapa memory leaks
- rensa player-data när spelaren lämnar
- kunna hantera många scripts
- hantera reload korrekt
- inte krascha servern vid scriptfel
---
21. KOMPLETT PROJEKT
Skapa hela projektet:
GrönaLandSkripts/
├── build.gradle
├── settings.gradle
├── README.md
├── DOCUMENTATION.md
└── src/
└── main/
├── java/
└── resources/
└── plugin.yml
Det ska gå att bygga till:
GrönaLandSkripts.jar
och lägga direkt i:
/plugins/
---
22. VIKTIGASTE KRAVET
Gröna Land Skripts ska kännas som Skript, men vara enklare och speciellt anpassat för Arclight + NeoForge.
En användare ska kunna:
1. installera pluginet
2. starta servern
3. öppna "plugins/GrönaLandSkripts/scripts/"
4. skapa "mittscript.gls"
5. skriva några enkla rader
6. spara
7. köra "/gls reload"
8. direkt använda sitt nya command/event.
Dessutom ska commands automatiskt få Minecrafts vanliga Tab-completion och command suggestions.
Prioritera framför allt:
Enkel syntax + fungerande ".gls"-filer + automatisk command registration + Tab-completion + Arclight/NeoForge-kompatibilitet + moddade entities/fordon.
Bygg inte en demo. Skapa ett komplett, faktiskt fungerande plugin.
Skapa Gradle-projektet och pluginmetadata.
Implementera parser, AST-körning, variabler, dynamiska commands och tab-completion.
Implementera eventlyssnare samt Paper/Arclight–NeoForge-reflektionsbrygga.
Lägga till svenska instruktioner och fungerande exempel-/ride-script.
Skapade Gröna Land Skripts som ett komplett Gradle-projekt med:
Java 21 + Paper API 1.21.1
.gls-parser med indentation och syntaxfel per fil/radDynamisk command registration via serverns CommandMap
Automatisk TAB-completion för commands, spelare och världar
/gls help,reload,scripts,errors,versionEvents för spelare, block, chat, damage och Bukkit-fordon
Villkor, variabler och effekter
Permanent
variables.ymlSvenska
INSTRUKTIONER.txtAutomatiska
exempel.glsochrides.glsLoggning till
logs/script-errors.logReflektionsbaserad Arclight/NeoForge-kompatibilitetsadapter
XSeries för material och ljud
README, teknisk dokumentation och
manifest.kod
Moddade fordon stöds när Arclight exponerar dem som Bukkit-entiteter. NeoForge-moddar som inte exponerar några Bukkit- eller gemensamma event kräver fortfarande en modspecifik brygga, eftersom ett fristående Bukkit-plugin inte kan registrera sig i okända NeoForge-eventtyper automatiskt.
package se.gronaland.skripts;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;
import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
public final class GreensLandSkripts extends JavaPlugin {
private VariableStore variableStore;
private ScriptEngine scriptEngine;
private HybridEntityApi hybridEntityApi;
@Override
public void onEnable() {
createDataFiles();
variableStore = new VariableStore(this);
variableStore.load();
hybridEntityApi = new HybridEntityApi(this);
scriptEngine = new ScriptEngine(this, variableStore, hybridEntityApi);
GLSCommand glsCommand = new GLSCommand(this, scriptEngine);
if (getCommand("gls") != null) {
getCommand("gls").setExecutor(glsCommand);
getCommand("gls").setTabCompleter(glsCommand);
}
Bukkit.getPluginManager().registerEvents(new ScriptListener(scriptEngine, hybridEntityApi), this);
scriptEngine.reload();
}
@Override
public void onDisable() {
if (scriptEngine != null) {
scriptEngine.shutdown();
}
if (variableStore != null) {
variableStore.save();
}
}
private void createDataFiles() {
File scripts = new File(getDataFolder(), "scripts");
File logs = new File(getDataFolder(), "logs");
if (!scripts.mkdirs() && !scripts.isDirectory()) {
getLogger().warning("Kunde inte skapa scripts-mappen.");
}
if (!logs.mkdirs() && !logs.isDirectory()) {
getLogger().warning("Kunde inte skapa logs-mappen.");
}
saveDefaultConfig();
saveResource("INSTRUKTIONER.txt", false);
saveResource("scripts/exempel.gls", false);
saveResource("scripts/rides.gls", false);
}
public File getScriptsFolder() {
return new File(getDataFolder(), "scripts");
}
public File getLogsFolder() {
return new File(getDataFolder(), "logs");
}
}