[API]X39 Settings API

[X39]

HEYO
Mein nick ist X39 und ich hab was schönes für euch Modder da draußen

Meine Settings API

warum ich sie erstellt habe

Wisst ihr,
Ich fand es lässtig immer und immer wieder gigantische (und hässliche) dateien erstellen zu lassen nur damit user ein bisl was einstellen können ... ALSO hab ich mich an das problem gemacht und etwas erstellt was ihr hier jetzt sehen könnt!!!
Es lässt sich auf verschiedenste art und weise nutzen
einfaches beispiel gefälligst?
Nun
Nehmt die blockID
Ich muss z.b. nur noch abfragen ob sie vorhanden ist und FERTIG NIX mit 5 zeilen extra code erstellen
Mit anderen Worten
Diese API (naja oder eher diese klasse) macht es um LICHTJAHRE einfacher eine einfache Settings Datei für die benutzerfreundliche Bedienung eurer mods zu erstellen

Sie erstellt einfach nur Settings Dateien für eure Mods (wodurch ihr sie wesentlich benutzerfreundlicher gestallten könnt)

Beispiel:

IDs:
    Block:
        CopperOre = 244
        ExplosionResistBlock = 248
        FuelStation = 245
        HallelujaBlock = 251
        Radiation = 247
        Radiation2 = 246
        ReactorActive = 249
        ReactorIdle = 250
        SieveActive = 252
        SieveIdle = 253
        UraniumOre = 255
        UraniumOreGlowing = 254
    Item:
        CompressedObsidian = 504
        Halleluja = 503
        LinkedTargetingDevice = 509
        Plutanium = 502
        RocketEngine = 513
        RocketSpawner = 510
        RocketThruster = 514
        UraniumArrow = 511
        UraniumRaw = 500
        UraniumStick = 501
        WarHead = 512
        bootsRadiationProtection = 508
        helmetRadiationProtection = 505
        legsRadiationProtection = 507
        plateRadiationProtection = 506
Names:
    CompressedObsidian = Compressed Obsidian
    CopperOre = Copper Ore
    FuelStation = Fuel Station
    Halleluja = Halleluja
    LinkedTargetingDevice = LTD 2000
    Plutanium = Plutanium
    RadiationGrowing = Radiation >< Growing
    RadiationShrinking = Radiation >< Shrinking
    ReactorActive = Reactor >< ACTIVE
    ReactorIdle = Reactor
    RocketEngine = Tank
    RocketSpawner = Rocket Hull
    RocketThruster = Thruster
    SieveActive = Fluxinator >< ACTIVE
    UranSieveIdleiumOre = Fluxinator
    UraniumArrow = UraniumArrow
    UraniumOre = Uranium Ore >< Normal
    UraniumOreGlowing = Uranium Ore >< Glowing
    UraniumRaw = Uranis
    UraniumStick = Uranium
    WarHead = WarHead
    bootsRadiationProtection = bootsRadiationProtection
    helmetRadiationProtection = helmetRadiationProtection
    legsRadiationProtection = legsRadiationProtection
    plateRadiationProtection = plateRadiationProtection

Downloads:

• V3
• V2.2
• V2.0
  
• SOURCE CODE

​

HowToInstall- Benutzer

Wisst ihr wie ihr den ModLoader von rigusamie zu installieren habt?
Nun, macht es mit dieser API genau so und es wird funktionieren

Für ALLE die es nicht wissen - AUFPASSEN UND LESEN:

1. Ladet die aktuellste Version der API herunter
2. geht in euren Minecraft Ordner (bei Windows liegt er unter %appdata%/.minecraft/)
3. geht in den bin ordner
4. öffnet die minecraft.jar mit dem Datei Manager eurer Wahl (vermutlich wird es bei euch winrar sein)
5. nehmt die in Schritt 1 herunter geladene Datei und packt sie in die minecraft.jar
6. Löscht den META-INF Ordner
7. Freut euch das ihr es geschafft habt

HowToUse - Modder

Bevor ihr eure mod Dekompiliert habt (vermutlich mittels MCP) solltet ihr diese datei in die minecraft.jar werfen
Anschließend startet ihr den Dekompilierungs Prozess und wartet bis dieser beendet ist

Wenn das alles geschafft ist, geht es RICHTIG einfach weiter
Ich erstelle hier mal ein paar beispiele:

new X39SettingsProvider(false, "Steve", "StevesMod", "settings.txt");
new X39SettingsProvider(true, "Peter", "Zwegart", "Glass", "Extend", "settings.txt");
new X39SettingsProvider(false, "settings.txt")

wie ihr seht
kann man so viele Kommata setzen wie man will (sie ersetzen hier quasi das '/' bzw. '\' Zeichen)
Der Boolesche wert ganz am Anfang steht lediglich für die erweiterte Ausgabe (hauptsächlich für mich interessant)
Die Referenz zu den Funktionen (JavaDoc) ist HIER zu entnehmen

Zuzüglich wäre noch zu erwähnen
der in der Referenz mehrfach erwähnte key setzt sich wie folgt zusammen:

"MAINKEY.SUBKEY1.SUBKEY2.SUBKEYn"

Wie ihr seht, ist das aktuelle Trennzeichen also der Punkt ('.')
In der Datei wird es anschließend (nach der Alphabetischen Sortierung) in der obig angezeigten Hierarchie ausgegeben

SPECIAL HINT FOR MODLOADER MODDERS

ihr könnt euch über die funktion

ModLoader.getMinecraftInstance().getMinecraftDir().toString()

den gesammten pfad zur minecraft dir ausgeben lassen wodurch es z.b. bei mac usern zu weniger problemen bezüglich den pfad gibt

CODE BEISPIELE

• Anwendungs Beispiel -|- MultipleLanguages - ModLoader

CHANGELOG

• V3
  • [ADD]Es ist nun möglich kommentare an den anfang zu setzen
  • [ADD]Es ist nun möglich kommentare an optionen zu hängen
• V2.2
  • [CHANGE]Bindestrich trennung wurde zu Punkt trennung geändert
  • [FIX]Die trennung von mehreren unter bereichen (angenommen bla1.bla2.bla3.bla4 folgt direkt bla1.bla5 in der datei) wurde gefixt sodass diese nun korrekt geladen werden
  • [ADD]"isOptionExisting(Object)" wurde eingeführt (wahlweise auch mit default parameter sodass die option sofort angelegt wird insofern sie nicht existiert)

Geplant für die zukunft:
Aktuell leider nixe ... Bin aber für ALLE Vorschläge offen

LIZENZ

Dieses Projekt steht unter der GPL (General Public License)

[McAwesome]

Das ist wirklich was Schönes

[X39]

hab mal die mini API upgedated

[MCenderdragon]

nent mich alle doof aber ich habe immer noch nicht verstanden was das kann

[X39]

nent mich alle doof aber ich habe immer noch nicht verstanden was das kann

fragen kostet ja nichts
im endeffekt erstellt man mit dieser lustigen klasse
SETTINGS dateien
wodurch der user z.b. die ItemIDs selbst festlegen kann

[MCenderdragon]

ahhhhhhhhhhh
das ist ne echt gute sache :daumenhoch:

[Universum]

DAS IST VOLL COOL!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! kriegst den dia.

[omega]

Ich finds genial, proktisch und einfach, was will man mehr, von mir bekomst ein

[Nyah]

Warum schreib ich den Mist eigentlich selber, wenn ich doch nur beim alten Killer vorbei schauen müsste... Wenn ich das nächste Mal was decompile ist das mit drinnen.
Es wäre übrigens ganz toll, wenn du den Quellcode irgendwo online stellen könntest, dann müsste man es nicht erst decompilen.

MfG
Nyah

[X39]

Warum schreib ich den Mist eigentlich selber, wenn ich doch nur beim alten Killer vorbei schauen müsste... Wenn ich das nächste Mal was decompile ist das mit drinnen.
Es wäre übrigens ganz toll, wenn du den Quellcode irgendwo online stellen könntest, dann müsste man es nicht erst decompilen.

MfG
Nyah

mach ich gerne
kommt übrigens bald auch wieder ein kleines update womit ein paar viele funktionen umbenannt werden (dieses nerfige ...OptionAs... wird damit entfernt (nerft beim lesen XD))
wünsche werden also gern angenommen