Forums.ATC.no
Ano-Tech Computers => Minecraft => Emne startet av: Cybersyn på 19. Mars 2015, 16:05 pm
-
Vi har nå satt opp en organisasjon på GitHub (https://github.com/Ano-Tech-Computers) som kan brukes til samarbeid om plugins. For å bli medlem av organisasjonen på GitHub må du legge inn GitHub-brukernavnet ditt i denne tråden.
Med mindre noe annet er spesifisert, følger repoene GitHub Flow (https://guides.github.com/introduction/flow/) og mer eller mindre stilen beskrevet i denne artikkelen (https://github.com/Ano-Tech-Computers/git-style-guide/blob/master/README.md).
Vi regner origin/master som hovedgrenen hvor kildekoden ved HEAD alltid reflekterer en produksjonsklar tilstand.
Vi regner origin/develop som hovedgrenen hvor kildekoden ved HEAD alltid reflekterer en tilstand med de ferskeste endringene under utvikling for neste produksjonsklare tilstand. Versjonsnummer fra denne grenen ender alltid med -SNAPSHOT, f. eks. 1.2-SNAPSHOT.
Når kildekoden i origin/develop når en produksjonsklar tilstand, opprettes det en pull request (PR) (https://help.github.com/articles/using-pull-requests/) fra den til origin/master. Før PRen godkjennes, må kildekoden gjøres helt klar. Dette innebærer blant annet å fjerne -SNAPSHOT fra versjonsnummeret. Etter PRen er godkjent, økes versjonsnummeret i origin/develop for å legge til rette for nye endringer.
Bob/develop O---O-----------O
/ \ \
origin/develop O-------O-------O---O--->
\ \ /
Alice/develop O---O---O---O
<------- tid ----------->
Bob/master O---O
/ \
origin/master O---O-------O-------O--->
/ \ /
origin/develop O-------O-------O---O--->
Du trenger
- Bruker på GitHub (https://github.com/join) som er medlem av organisasjonen (https://github.com/Ano-Tech-Computers)
- Eclipse IDE for Java Developers (http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/lunasr2) (mer spesifikt ide (http://www.eclipse.org/ide/)+jdt (https://eclipse.org/jdt/)+egit (https://eclipse.org/egit/)+m2e (https://eclipse.org/m2e/))
1. Fork prosjektet på GitHub (https://github.com/Ano-Tech-Computers)
(http://0o2471.net//62011.jpg) (http://0o2471.net/62011)
2. Importer prosjektet i Eclipse
File > Import...
Maven > Check out Maven Projects from SCM
(http://0o2471.net//62020.jpg) (http://0o2471.net/62020)
Høyreklikk prosjekt > Team > Switch To > Other...
(http://0o2471.net//62024.jpg) (http://0o2471.net/62024)
3. Gjør endringer
Husk å logge (commit) endringer så ofte det passer (https://github.com/Ano-Tech-Computers/git-style-guide/blob/master/README.md#commits).
Høyreklikk prosjekt > Team > Commit...
Gi en passende beskrivelse (commit message) (https://github.com/Ano-Tech-Computers/git-style-guide/blob/master/README.md#messages).
(http://0o2471.net//62021.jpg) (http://0o2471.net/62021)
4. Last opp (push) endringene til GitHub
Høyreklikk prosjekt > Team > Push to Upstream
5. Send en pull request til organisasjonen
(http://0o2471.net//62022.jpg) (http://0o2471.net/62022)
(http://0o2471.net//62023.jpg) (http://0o2471.net/62023)
Hvis det skal være en hotfix, bytter du ut develop med master i trinn 2 og 5.
Det opprinnelige forslaget:
Mange av feilene som oversvømmer Rapportering av feil-tråden er knyttet til ATCs hjemmelagde plugins, og jeg regner med at grunnen til at få av dem fikses er at Floyd ikke har like mye fritid som vi som bruker dem. Derfor hadde det vært supert om det hadde blitt lagt til rette for at fellesskapet kan bidra til å forbedre plugins direkte.
Mange av de hjemmelagde pluginsene har åpen kildekode, noe som er helt topp, men jeg ønsker at dette skal tas et skritt videre og legge til rette for at fellesskapet ikke bare kan lese kildekoden, men også endre den.
Som sagt ville det vært supert om dette kunne ordnes.
-
Jeg ser at PetitionPlugin allerede finnes på GitHub (https://github.com/FloydATC/Bukkit-PetitionPlugin), og jeg tenker GitHub er midt i blinken for dette.
-
Jeg kan ikke noe om plugins og koder osv.. Men jeg liker idèen
-
Om man ikke kan det, er jo følelsen av å bidra kanskje en god motivasjon til å lære?
-
Man kan laste dem ned fra http://minecraft.atc.no/bin/plugins/ (Tenkte jeg skulle skrive hvor man får pluginsene fra, i og med at du snakker om dem...)
Er det ikke mulig å endre på programmene etter man har lastet dem ned? (Åpne dem, kopiere/endre deler av koden og lagre).
I så fall kan man jo bare gjøre det å sende dem til floyd på den måten man syns er best.
Selvfølgelig blir ingen å få direkte tilgang til å endre kildekoden til plugins som kjøres på server-maskinen.
-
Jeg lærte det selv ved å plukke fra hverandre andres plugins.
- Alle plugins på serveren legges ut automatisk hver dag på http://minecraft.atc.no/bin/plugins/
- Alle JAR-filer er egentlig ZIP archives som kan åpnes med 7zip, WinZip, WinRAR eller lignende
- Alle mine hjemmelagde plugins inkluderer kildekode
Føl dere fri, plukk ting fra hverandre og lek med dem. Vedkommende som la PetitionPlugin på GitHub spurte om lov til å gjøre det men det var fordi han var redd for å tråkke noen på tærne. Ikke vær det. Kildekoden er inkludert nettopp fordi jeg ønsker å gi den bort. Det eneste jeg ber om er å bli kreditert for originalkoden.
Dersom noen modifiserer og forbedrer koden så send gjerne resultatet tilbake til meg, enten i form av en patch eller en ferdig kompilert plugin med oppdatert kildekode inni. Bare IKKE send meg en link til GitHub med beskjed om å laste ned og kompilere selv, for det kommer nok ikke til å skje... :-)
Trenger du et sted å starte? Hva med å fikse TipsPlugin? Egentlig en helt triviell plugin men samtidig den som irriterer meg mest. En ting er at æøå driver meg til vannvidd men den har også et problem med linjeskift. Den bryter sammen hver eneste gang jeg flytter til en annen Linux-maskin, trolig på grunn av et eller annet med locale-settings i Java og jeg ser ikke ut til noensinne å finne både tid og motivasjon til å fikse det selv.
-
Når vi først er i gang, her er en trinn-for-trinn fremgangsmåte som funker. Det er godt mulig det går an å gjøre det enklere med GitHub, i så fall må noen gjerne skrive om det.
0. Koden trenger JDK 1.7 for å fungere. Seriøst, jeg får det ikke til med 1.8. Vet du hvordan? Skriv i vei. Jeg må bruke 1.7.
1. Last ned og installer Eclipse fra http://eclipse.org
2. File -> New -> Java Project -> Gi den et navn (f.eks. "TipsPlugin")
3. Høyreklikk på prosjektet, Properties. Klikk på "Java Build Path", "Libraries". "Add External JARs...". For å lage en Bukkit/Spigot plugin må du henvise til bukkit-x.x.x-Rx.x.jar som du må laste ned fra nettet. Jo nyere versjon jo bedre. Dette er API'et til Bukkit/Spigot, dvs. den inneholder hver eneste metode du har tilgang til inne i Minecraft-serveren. Hvis dette ikke sier deg noe, slapp av, du vil se det etterhvert.
4. Høyreklikk på prosjektet, New -> File -> "plugin.yml". Bukkit/Spigot krever at alle plugins har denne filen. Kopier eksisterende eller Google for å se hva den må inneholde.
5. Høyreklikk på prosjektet, New -> Package -> f.eks. "no.atc.floyd.bukkit.tips". Dette navnet må være unikt fordi det danner ditt eget "namespace" i Java. Bruk gjerne "no.atc.DITTNAVN.blablabla", alle mine starter med "no.atc.floyd.blablabla".
6. For hver klasse (= java-fil), høyreklikk på "package" -> New -> Class -> Navn på klassen, f.eks. "TipsPlugin". Må matche navnet på java-filen, i dette tilfellet "TipsPlugin.java".
7. Alle java-klasser må ha en "constructor", denne må være "public", returnerer ingenting og inneholder alle attributter, metoder og funksjoner for klassen. En plugin til Bukkit/Spigot må dessuten ha en del andre egenskaper så her bør du ta utgangspunkt i eksisterende kode.
8. I prinsippet må en plugin ha følgende metoder:
- onEnable() som kalles opp når Bukkit/Spigot laster den inn
- onDisable() som kalles opp når Bukkit/Spigot avslutter
- @EventHandler metoder for å håndtere Events
9. Hvis du endrer "plugin.yml" må du trykke F5 for å refreshe prosjektet. Ikke spør meg hvorfor.
10. For å kompilere en JAR-fil, høyreklikk på prosjektet -> Export. Velg "JAR file", Next, angi filnavn.jar (NB! Pass på når du bytter mellom prosjekter!!!), kryss av for "Export generated class files" og "Export Java source files", Finish.
Alle event handlers merkes med @EventHandler, en makro definert i bukkit-*.jar som gjør den nødvendige magien for at pluginen skal fungere. Alle metoder med denne makroen må akseptere et objekt arvet fra klassen "org.bukkit.event.Event". Det er hundrevis av dem og du kan finne oversikter over dem på nettet. Ideen med event-klassen er at event-objektet inneholder alt du trenger å vite om eventen, f.eks. hvilken spiller eller blokk som er involvert. Dersom eventen kan kanselleres (f.eks. PlayerLoginEvent eller BlockPlaceEvent) så inneholder den også metoder for dette.
Resten dreier seg bare om å utforske API'et og skrive robust kode med skikkelig feilhåndtering. Ta høyde for at filer ikke finnes, navn er feil stavet, parametere mangler eller er av feil type osv.
Alle oppslag du gjør mot Bukkit/Spigot KAN returnere NULL, dvs. en ugyldig peker som vil få pluginen til å tryne hvis du forsøker å bruke den. Eksempel:
Player p = event.getPlayer();
Location loc = p.getLocation(); // <-- Hvis "event" ikke inneholder en gyldig spiller vil dette tryne
World w = loc.getWorld(); // <-- Hvis spilleren ikke er ferdig innlogget vil dette tryne
// gjør noe med w
Sammenlign med dette:
Player p = event.getPlayer();
if (p != null) {
Location loc = p.getLocation();
if (loc != null) {
World w = loc.getWorld();
// gjør noe med w
} else {
getLogger().info("Ugyldig lokasjon for spiller "+p.getName());
}
} else {
getLogger().info("Ugyldig spiller");
}
-
Vedkommende som la PetitionPlugin på GitHub
Er ikke dette (https://github.com/FloydATC) deg da?
-
Vedkommende som la PetitionPlugin på GitHub
Er ikke dette (https://github.com/FloydATC) deg da?
Hmm jo. Mulig det var noen som ba meg legge det ut så han kunne forke. Husker ikke... ???
Har aldri klart å venne meg til å bruke versjonsstyring, det er en av mine store svakheter.
-
Som en ekte kontrollfrik opprettet jeg en organisasjon på GitHub: https://github.com/Ano-Tech-Computers (https://github.com/Ano-Tech-Computers)
Det var helt nødvendig for å tilfredsstille hjernen min.
-
Som en ekte kontrollfrik opprettet jeg en organisasjon på GitHub: https://github.com/Ano-Tech-Computers (https://github.com/Ano-Tech-Computers)
Det var helt nødvendig for å tilfredsstille hjernen min.
Helt i orden, men siden den bruker "mitt" navn håper jeg du gir meg nødvendige rettigheter :-)
-
Helt i orden, men siden den bruker "mitt" navn håper jeg du gir meg nødvendige rettigheter :-)
Selvfølgelig, GitHub skal visstnok føre deg opp som eier automatisk når du takker ja til invitasjonen :)
Andre som ønsker å bidra kan poste en lenke til GitHub-profilen sin her.
Meg: https://github.com/osvein (https://github.com/osvein)
-
Det ser ut til at http://mc.atc.no/bin/plugins/PetitionPlugin.jar ikke inkluderer kildekode. Hvis https://github.com/FloydATC/Bukkit-PetitionPlugin er oppdatert vil du kanskje forke den i organisasjonen?
-
PetitionPlugin vedlikeholdes ikke lenger av meg og ble på et tidspunkt oppdatert fra bukkit.org
http://dev.bukkit.org/bukkit-plugins/petitionplugin/
Litt skuffende at kildekoden ikke lenger er inkludert, det var hele poenget :-(
-
Koden trenger JDK 1.7 for å fungere. Seriøst, jeg får det ikke til med 1.8. Vet du hvordan? Skriv i vei. Jeg må bruke 1.7.
Hos meg kompilerer det fint på JDK 8. Hva skjer når du prøver?
-
Description Resource Path Location Type
The project was not built since its build path is incomplete. Cannot find the class file for java.lang.CharSequence. Fix the build path then try building this project DocPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.lang.CharSequence. Fix the build path then try building this project Indispensable Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.lang.CharSequence. Fix the build path then try building this project MagicBlocks Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.lang.CharSequence. Fix the build path then try building this project SafetyPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.lang.CharSequence. Fix the build path then try building this project SeenPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.lang.CharSequence. Fix the build path then try building this project SlowEdit Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.lang.CharSequence. Fix the build path then try building this project TipsPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project AntiFarm Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project BanPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project CartPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project CompassPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project ContainerProtect Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project CreativeControl Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project GivePlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project KitPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project Multicast Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project Voter Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.Map$Entry. Fix the build path then try building this project WhoPlugin Unknown Java Problem
The project was not built since its build path is incomplete. Cannot find the class file for java.util.regex.Pattern. Fix the build path then try building this project TelePlugin Unknown Java Problem
The type java.lang.CharSequence cannot be resolved. It is indirectly referenced from required .class files DocPlugin.java /DocPlugin/src/com/floyd/bukkit/doc line 52 Java Problem
The type java.lang.CharSequence cannot be resolved. It is indirectly referenced from required .class files Indispensable.java /Indispensable/src/no/atc/floyd/bukkit/indispensable line 31 Java Problem
The type java.lang.CharSequence cannot be resolved. It is indirectly referenced from required .class files MagicBlocks.java /MagicBlocks/src/no/atc/floyd/bukkit/magicblocks line 43 Java Problem
The type java.lang.CharSequence cannot be resolved. It is indirectly referenced from required .class files SafetyPlugin.java /SafetyPlugin/src/no/atc/floyd/bukkit/safetyplugin line 29 Java Problem
The type java.lang.CharSequence cannot be resolved. It is indirectly referenced from required .class files SeenPlugin.java /SeenPlugin/src/no/atc/floyd/bukkit/seen line 46 Java Problem
The type java.lang.CharSequence cannot be resolved. It is indirectly referenced from required .class files SlowTask.java /SlowEdit/src/no/atc/floyd/bukkit/slow line 128 Java Problem
The type java.lang.CharSequence cannot be resolved. It is indirectly referenced from required .class files TipsPlugin.java /TipsPlugin/src/no/atc/floyd/bukkit/tips line 62 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files AntiFarm.java /AntiFarm/src/no/atc/floyd/bukkit/antifarm line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files BanPlugin.java /BanPlugin/src/no/atc/floyd/bukkit/ban line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files CartPlugin.java /CartPlugin/src/no/atc/floyd/bukkit/cart line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files CompassPlugin.java /CompassPlugin/src/no/atc/floyd/bukkit/compass line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files ContainerProtect.java /ContainerProtect/src/no/atc/floyd/bukkit/cp line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files CreativeControl.java /CreativeControl/src/no/atc/floyd/bukkit/cc line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files GivePlugin.java /GivePlugin/src/com/floyd/bukkit/give line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files KitPlugin.java /KitPlugin/src/no/atc/floyd/bukkit/kit line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files Multicast.java /Multicast/src/com/floyd/bukkit/multicast line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files Voter.java /Voter/src/no/atc/floyd/bukkit/voter line 1 Java Problem
The type java.util.Map$Entry cannot be resolved. It is indirectly referenced from required .class files WhoPlugin.java /WhoPlugin/src/no/atc/floyd/bukkit/who line 1 Java Problem
The type java.util.regex.Pattern cannot be resolved. It is indirectly referenced from required .class files Warp.java /TelePlugin/src/no/atc/floyd/bukkit/tele line 1 Java Problem
Tips mottas med takk...
NB! Jeg har ikke lastet ned TelePlugin 1.94 på denne maskinen, dette er 1.93
Oppdatering: Jeg har nå hatt tid til å sitte og plundre med dette i tre timer. Lastet ned og reinstallerte JDK8, det funker fortsatt ikke. Det samme gjelder JavaDoc/autocomplete. Etter oppgradering fra JDK7 til JDK8 er det helt håpløst å få noe som helst til å kompilere.
-
Har du oppdatert Eclipse? IIRC virker Java 8 bare med 4.4 "Luna" eller nyere.
-
Har du oppdatert Eclipse? IIRC virker Java 8 bare med 4.4 "Luna" eller nyere.
...og vips.
(http://i2.kym-cdn.com/entries/icons/original/000/000/554/facepalm.jpg)
-
OK, dette løste problemet med å få JDK8 til å fungere. Dessverre kjører mc.atc.no (i likhet med det fleste andre Linux-servere) JRE7 og Java-kode kompilert med JDK8 og JRE8 tryner under JRE7 hvis man bruker ConcurrentHashMap (og sikkert hundrevis av andre ting som pleide å fungere helt fint).
Etter mange uker med jakt på en løsning har jeg omsider knekt gåten:
http://forums.atc.no/index.php?topic=1868.0
Metoden gjør det mulig å bruke JDK8 til å kompilere jar-filer som fungerer under JRE7.
-
Hva med å fikse TipsPlugin? Egentlig en helt triviell plugin men samtidig den som irriterer meg mest. En ting er at æøå driver meg til vannvidd
Hvorfor bruker den Scanner? Jeg fikk ÆØÅ til å virke med FileReader. https://github.com/Ano-Tech-Computers/TipsPlugin/releases/tag/v2.0
-
Har nå brukt en times tid på å prøve å få ned en fungerende kopi av TipsPlugin v2 som kompilerer, men det nytter ikke.
1. Jeg får ikke importert Mavenprosjekter fra Git
2. Installasjon av m2e-egit funker ikke
Jeg får helt fnatt av Maven. Den er så helt utrolig overengineered og brukeruvennlig uten at det gir noen som helst synlig gevinst :-/
-
2. Installasjon av m2e-egit funker ikke
Det ser ut som den ikke finner JARen for m2e-egit på nettet. Det er litt rart, for webserveren (http://repo1.maven.org/maven2/.m2e/connectors/m2eclipse-egit/0.14.0/N/LATEST/plugins/) indekserer den, men den gir bare 404... Det er nok bare et midlertidig problem. Har det skjedd før?
Det ser ut som en eldre versjon er tilgjengelig, så hvis du får til å tvinge Eclipse til å bruke org.sonatype.m2e.egit_0.14.0.201504071521.jar (http://repo1.maven.org/maven2/.m2e/connectors/m2eclipse-egit/0.14.0/N/LATEST/plugins/org.sonatype.m2e.egit_0.14.0.201504071521.jar) og org.sonatype.m2e.egit.feature_0.14.0.201504071521.jar (http://repo1.maven.org/maven2/.m2e/connectors/m2eclipse-egit/0.14.0/N/LATEST/features/org.sonatype.m2e.egit.feature_0.14.0.201504071521.jar) i steden burde det virke, men jeg vet ikke hvordan.
Har nå brukt en times tid på å prøve å få ned en fungerende kopi av TipsPlugin v2 som kompilerer, men det nytter ikke.
Versjoner som er listet under Releases (https://github.com/Ano-Tech-Computers/TipsPlugin/releases) på GitHub kommer gjerne med en forhåndskompilert JAR (under Downloads).
Mange ligger også i varehuset (på grenen maven) (https://github.com/Ano-Tech-Computers/Warehouse14/tree/maven/no/atc/osvein/bukkit/tips/tipsplugin/2.2).