LabAide

Dependancy information

Maven

     <repository>
         <id>arcadelabs-mvn-releases</id>
         <name>ArcadeLabs Repository</name>
         <url>https://repo.zorino.in/releases</url>
     </repository>

<dependency>
    <groupId>in.arcadelabs.labaide</groupId>
    <artifactId>LabAide</artifactId>
    <version>[VERSION]</version>
</dependency>

Gradle

 maven {
 url "https://repo.zorino.in/releases"
 }

 implementation "in.arcadelabs.labaide:LabAide:[VERSION]"

Utilities

.
└── in.arcadelabs.labaide
    ├── cooldown
    │   └── CooldownManager
    │       └── Cooldown management utility.
    ├── experience
    │   └── ExperienceManager
    │       └── Player experience management utility.
    ├── item
    │   ├── HeadBuilder
    │   │   └── Playuer skull bulider utility.
    │   └── ItemBuilder
    │       └── Item builder utility.
    ├── logger
    │   └── Logger
    │       └── Java logging utiliy supporting Adventure's components.
    ├── metrics
    │   └── Bstats
    │       └── Bstats metrics tracker.
    ├── namespacedkey
    │   └── NamespacedKeyBuilder
    │       └── NamespacedKey builder utility.
    └── randomizer
        └── ProbabilityCollection
            └── Weighted randomized collection utility.

Examples

Cooldown.java

int cooldown = 10; //Add cooldown peeriod in seconds
  CooldownManager cooldownManager = new CooldownManager(cooldown);
  MiniMessage miniMessage = MiniMessage.builder().build();
  
  public void onCraftEvent(final CraftItemEvent event) {
    if (!(Objects.equals(event.getRecipe().getResult(), new ItemStack(Material.NETHER_STAR)))) return;
    Player player = (Player) event.getWhoClicked();
    if (!this.cooldownManager.isOnCooldown(player.getUniqueId())) {
      event.getInventory().setResult(new ItemStack(Material.BEACON));
      if (this.cooldown >= 0) // int value -1 will disable this
        this.cooldownManager.setCooldown(player.getUniqueId());
    } else {
      player.sendMessage(this.miniMessage.deserialize("<red>You can't craft beacon for another <seconds> seconds.</red>",
              Placeholder.component("seconds", Component.text(this.cooldownManager.getRemainingTime(player.getUniqueId())))));
      event.setCancelled(true);
    }
  }

ExperienceManager.java

  public void saveXP(final Player player) {
    player.getPersistentDataContainer().set(this.lifeSteal.getNamespacedKeyBuilder().getNewKey("player_xp"),
            PersistentDataType.INTEGER,
            ExperienceManager.getExp(player)); //Get precise amount of player XP 
    player.setExp(0);
    player.setLevel(0);
  }

  public void restoreXP(final Player player) {
    if (!(player.getPersistentDataContainer().has(this.lifeSteal.getNamespacedKeyBuilder().getNewKey("player_xp")))) return;
    ExperienceManager.changeExp(player,
            player.getPersistentDataContainer().get(this.lifeSteal.getNamespacedKeyBuilder().getNewKey("player_xp"),
                    PersistentDataType.INTEGER));
  }

HeadBuilder.java & ItemBulder.java

  Logger logger = new Logger("LifeSteal", null, null, null);
  HeadBuilder headBuilder = new HeadBuilder(this.logger, Logger.Level.ERROR);
  //https://minecraft-heads.com/custom-heads/search?searchword=heart
  //Go down and check for 'value' fiels and copy paste that down below.
  String skullTexture = "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNmQzNmMzMjkxZmUwMmQxNDJjNGFmMjhkZjJmNTViYjAzOTdlMTk4NTU0ZTgzNDU5OTBkYmJjZDRjMTQwMzE2YiJ9fX0=";
  ItemBuilder itemBuilder = new ItemBuilder(Material.PLAYER_HEAD, lifeSteal.getHeadBuilder().createSkullMap(skullTexture))
          .setName(Component.text("Heart <3"))
          .setLore((List<Component>) Component.empty())
          .setModelData(389645)
          .setPDCObject(this.lifeSteal.getNamespacedKeyBuilder().getNewKey("heart_item"), PersistentDataType.STRING, "No heart spoofing, dum dum.")
          .setPDCObject(this.lifeSteal.getNamespacedKeyBuilder().getNewKey("heart_itemtype"), PersistentDataType.STRING, "Cursed")
          .setPDCObject(this.lifeSteal.getNamespacedKeyBuilder().getNewKey("heart_itemindex"), PersistentDataType.STRING, "1")
          .setPDCObject(this.lifeSteal.getNamespacedKeyBuilder().getNewKey("heart_healthpoints"), PersistentDataType.DOUBLE, "4")
          .build();
  ItemStack heart = itemBuilder.getBuiltItem();

Logger.java

  Logger logger = new Logger("LifeSteal", null, null, null);
  try {
    somethingStupid();
  } catch (StupidException e) {
    logger.log(Logger.Level.ERROR, Component.text(e.getMessage(), NamedTextColor.DARK_PURPLE), e.fillInStackTrace());
  }

Logger.java

  BStats metrics = new BStats(this.instance, resourceID);

NamespacedKeyBuilder.java

  NamespacedKeyBuilder namespacedKeyBuilder = new NamespacedKeyBuilder("lifesteal", this.instance);
  NamespacedKey namespacedKey = namespacedKeyBuilder.getNewKey("heart_healthpoints");

ProbabilityCollection.java

    ProbabilityCollection<Character> randomChar = new ProbabilityCollection<>();
    randomChar.add('A', 10);
    randomChar.add('B', 10);
    randomChar.add('C', 10);
    randomChar.add('D', 10);
    
    char letter = randomChar.get();