IF - Inventory Framework

To framework wymaga Javy 8 lub wyższej.

IF

IF - Inventory Framework to lekki, ale potężny framework GUI, mający na celu pomóc w tworzeniu, modyfikowaniu i łatwiejszym zarządzaniu GUI. Oto kilka powodów, dla których uważam, że IF wyróżnia się spośród innych podobnych frameworków:


Pane based: Oparte na panelach, które pozwalają podzielić GUI na mniejsze części, które można zmieniać indywidualnie, bez modyfikowania innych części GUI.

XML reading: IF potrafi czytać pliki XML i tworzyć całe GUI na ich podstawie. Koniec z długimi metodami tworzenia GUI, po prostu ładujemy je z pliku XML. (Nie martw się, XML jest całkowicie opcjonalny, po prostu zignoruj go, jeśli nie chcesz go używać.)

Extensible: Możesz tworzyć własne panele z ich własnymi funkcjami, które będą zachowywać się dokładnie tak, jak chcesz, bez konieczności od nowa projektowania nowego frameworka GUI.

No more event handlers: Nie musisz tworzyć nasłuchiwaczy, słuchać zdarzeń i używać tuzina instrukcji if, aby określić, który element został kliknięty. IF zajmie się tym za Ciebie, dzięki czemu możesz skupić się na tworzeniu swojego pluginu.

Rotations: Łatwo stosuj dwuwymiarowe obroty na swoich panelach, aby obracać je na różne sposoby.


IF ma obszerną wiki opisującą działanie frameworka i sposób jego użycia. Możesz znaleźć wiki tutaj.

Usage

IF działa samodzielnie. Musisz zintegrować go z Twoim pluginem, a nie dodawać go do serwera.

Jeśli nie używasz systemu budowy, możesz pobrać zasób z linku pobierania tutaj i dodać go jako zależność w IDE.

Jeśli używasz Maven, dodaj następujące jako zależność do pliku pom.xml:

<dependency>
  <groupId>com.github.stefvanschie.inventoryframework</groupId>
  <artifactId>IF</artifactId>
  <version>0.11.3</version>
</dependency>

IF znajduje się w Central Repository, więc nie musisz określać repozytorium.

Następnie dodaj to, aby wbudować IF w swój plugin:

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-shade-plugin</artifactId>
  <version>3.5.2</version>
  <configuration>
    <dependencyReducedPomLocation>${project.build.directory}/dependency-reduced-pom.xml</dependencyReducedPomLocation>
    <relocations>
      <relocation>
        <pattern>com.github.stefvanschie.inventoryframework</pattern>
        <shadedPattern>[YOUR PACKAGE].inventoryframework</shadedPattern>
      </relocation>
    </relocations>
  </configuration>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>shade</goal>
      </goals>
    </execution>
  </executions>
</plugin>

Zastąp [YOUR PACKAGE] swoim głównym pakietem.

Na wiki znajduje się obszerna dokumentacja i przykłady, które gorąco polecam, aby zobaczyć, jak to działa. Jeśli nie jesteś pewien, jak działa XML, istnieje również krótki tutorial na ten temat na wiki. 

Oto krótki fragment pokazujący, jak stworzyć podstawowe GUI z jednym elementem w nim.

//create a gui with 5 rows and the title My GUI
ChestGui gui = new ChestGui(5, "My GUI");
//create a new pane occupying the entire gui
OutlinePane pane = new OutlinePane(0, 0, 9, 5);
ItemStack item = new ItemStack(Material.ICE);
//create an item which will send a message when clicked
GuiItem guiItem = new GuiItem(item, event -> event.getWhoClicked().sendMessage("You clicked on ice!"));
 //add the item to the pane
pane.addItem(guiItem);
//add the pane to the item
gui.addPane(pane);

Sugestie i opinie są bardzo mile widziane!

Linki:

• Źródło
• Wiki
• Javadocs
• Lokalizacja Centralnego Repozytorium
• Zgłoszenia
• Discord