Ein ItemStack erstellen
Warnung
These docs were written for SpongeAPI 7 and are likely out of date. If you feel like you can help update them, please submit a PR!
Wenn du deine eigenen Gegenstände erstellen möchtest, musst du einige Schritte durchführen. Lass uns gemeinsam durch ein einfaches Beispiel gehen, um ein verzaubertes Diamant-Schwert zu erstellen.
Um einen ItemStack zu erstellen, müssen wir uns zuallererst einen Builder vom ItemStack
holen. Dies können wir mit Hilfe der ItemStack#builder() Methode. Im Builder können wir diverse Sachen angeben, wie zum Beispiel den ItemType oder die Anzahl des Gegenstände. In unserem Beispiel wäre dies ein einzelnes Diamant-Schwert, dass eine Verzauberung und einen speziellen Namen hat sowie unzerbrechlich ist. Wenn du ein einfaches Schwert ohne andere Daten haben willst, ist alles was du tun musst das Folgende:
import org.spongepowered.api.item.ItemTypes;
import org.spongepowered.api.item.inventory.ItemStack;
public ItemStack generateSword() {
ItemStack superMegaAwesomeSword = ItemStack.builder()
.itemType(ItemTypes.DIAMOND_SWORD).build();
return superMegaAwesomeSword;
}
Wir haben den grundlegenden Gegenstand erstellt. Nun, dass ist ein ganz gewöhnliches Diamant-Schwert, aber was ist, wenn wir etwas aufregenderes wollen? Wir wäre es zum Beispiel, wenn wir unser Schwert verzaubern und benennen möchten? Wir können EnchantmentData verwenden um unserem Schwert ein paar Verzauberungen hinzuzufügen. Das nachfolgende Beispiel wird unserem Schwert alle, im Spiel verfügbaren, Verzauberungen auf Stufe 1000 hinzufügen. Stelle sicher, dass du dies hinzufügst, bevor du return superMegaAwesomeSword;
aufrufst.
import java.util.List;
import java.util.stream.Collectors;
import org.spongepowered.api.Sponge;
import org.spongepowered.api.data.manipulator.mutable.item.EnchantmentData;
import org.spongepowered.api.data.meta.ItemEnchantment
import org.spongepowered.api.item.Enchantment;
EnchantmentData enchantmentData = superMegaAwesomeSword
.getOrCreate(EnchantmentData.class).get();
final List<EnchantmentType> enchantments = Sponge.getRegistry()
.getAllOf(EnchantmentType.class).stream().collect(Collectors.toList());
for (EnchantmentType enchantment : enchantments) {
enchantmentData.set(enchantmentData.enchantments()
.add(Enchantment.of(enchantment, 1000)));
}
superMegaAwesomeSword.offer(enchantmentData);
Nun, lass uns einmal annehmen, dass wir unserem übertriebenem Schwert einen coolen Namen geben wollen. In diesem Fall können wir den Wert für den ItemStack
direkt einen Key
setzen. Mit Hilfe des Key
s setzen können wir den Namen des ItemStack
s auf „SUPER MEGA AWESOME Diamond Sword“ ändern
import net.kyori.adventure.text.Component;
import net.kyori.adventure.text.TextComponent;
import net.kyori.adventure.text.format.NamedTextColor;
import org.spongepowered.api.data.key.Keys;
import org.spongepowered.api.item.ItemTypes;
superMegaAwesomeSword.offer(Keys.DISPLAY_NAME, TextComponent.ofChildren(
Component.text("SUPER ", NamedTextColor.BLUE),
Component.text("MEGA ", NamedTextColor.GOLD),
Component.text("AWESOME ", NamedTextColor.DARK_AQUA),
ItemTypes.DIAMOND_SWORD.asComponent().color(NamedTextColor.AQUA));
Und schließlich, um das Schwert unzerbrechlich zu machen, können wir wieder Key
s verwenden:
superMegaAwesomeSword.offer(Keys.UNBREAKABLE, true);
Das war alles. Nun hast du ein voll verzaubertes, unzerbrechliches und wunderschön benanntes Schwert, dass du deinen Spielern geben kannst.
Den Gegenstand spawnen
Sure, we can simply put the sword into a player’s inventory, but what if we wanted to throw it out into the open world
and spawn the item? This is where entity spawning comes into play. Since the in-game
graphical representation of an ItemStack
is Item, we can spawn it in similarly to a normal
Entity. The EntityType will simply be EntityTypes#ITEM and we will need to specify
that the Entity
will represent our ItemStack
. This can be done using the Keys#REPRESENTED_ITEM key.
An example is shown below:
import org.spongepowered.api.entity.Entity;
import org.spongepowered.api.entity.EntityTypes;
import org.spongepowered.api.event.CauseStackManager.StackFrame;
import org.spongepowered.api.world.Location;
import org.spongepowered.api.world.World;
import org.spongepowered.api.world.extent.Extent;
import java.util.Optional;
public void spawnItem(ItemStack superMegaAwesomeSword, Location<World> spawnLocation) {
Extent extent = spawnLocation.getExtent();
Entity item = extent.createEntity(EntityTypes.ITEM, spawnLocation.getPosition());
item.offer(Keys.REPRESENTED_ITEM, superMegaAwesomeSword.createSnapshot());
try (StackFrame frame = Sponge.getCauseStackManager().pushCauseFrame()) {
frame.addContext(EventContextKeys.SPAWN_TYPE, SpawnTypes.PLACEMENT);
extent.spawnEntity(item);
}
}
Einen Gegenstand anhand eines Blockes erstellen
Ein ItemStack
für einen Block kann durch die Methode ItemStack.Builder#itemType(ItemType) erstellt werden, ähnlich zu normalen Gegenständen. Aber was ist, wenn wir einen ItemStack
erstellen wollen, der dem aktuellen BlockState selbst entspricht? Um einen ItemStack
anhand eines BlockState
zu erstellen, musst du die Methode ItemStack.Builder#fromBlockState(BlockState) verwenden, die der ItemStack
-Builder bereitstellt. Ein Beispiel dafür wird hier drunter gezeigt:
import org.spongepowered.api.block.BlockState;
public ItemStack createStack(BlockState state) {
return ItemStack.builder().fromBlockState(state).build();
}