Eclipse is a plugin, that provides the essential features for server admins, theres more add-ons, which is... not published yet. but it will be, in the feature.
# basic build
./gradlew build
# build with shadow
./gradlew shadowJar
# build with..... cats, meow meow
./gradlew catAdd to settings.gradle.kts:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
mavenCentral()
maven { url = uri("https://jitpack.io") }
}
}Add to dependencies:
dependencies {
implementation("com.github.CatsT0day:EclipseAPI:Tag")
}Add to settings.gradle:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
}Add to dependencies:
dependencies {
implementation 'com.github.CatsT0day:EclipseAPI:Tag'
}Add to pom.xml:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.CatsT0day</groupId>
<artifactId>EclipseAPI</artifactId>
<version>Tag</version>
</dependency>
</dependencies>Replace Tag with the actual version (e.g., 1.0.0.8).
import me.catst0day.Eclipse.Entity.Player.EclipsePlr;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.command.CommandSender;
import java.util.UUID;
public class Example {
public void runExample(CommandSender sender) {
UUID playerUUID = UUID.fromString("123e4567-e89b-12d3-a456-426614174000");
EclipsePlr player = Eclipse.getI().getPlayer(playerUUID);
if (player != null) {
sender.sendMessage("Found player: " + player.getName());
} else {
sender.sendMessage("Player not found");
}
}
}import me.catst0day.Eclipse.Entity.Player.EclipsePlr;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.Location;
import org.bukkit.entity.Player;
public class Example {
public boolean setPlayerHome(Player player, String homeName) {
EclipsePlr plr = Eclipse.getI().getPlayer(player);
Location playerLocation = player.getLocation();
boolean success = plr.setHome(homeName, playerLocation);
if (success) {
player.sendMessage("Home '" + homeName + "' set!");
return true;
} else {
player.sendMessage("Failed to set home");
return false;
}
}
}import me.catst0day.Eclipse.Entity.Player.Gui;
import me.catst0day.Eclipse.Entity.Player.GuiButton;
import org.bukkit.Material;
import org.bukkit.entity.Player;
import org.bukkit.Location;
public class Example {
private void showHomesGui(Player player) {
Gui gui = new Gui(player, "§7Homes", 6);
int slot = 10;
for (String home : getHomes(player)) {
GuiButton homeButton = new GuiButton(Material.PLAYER_HEAD)
.setName("§a" + home)
.onLeftClick(p -> {
Location homeLocation = Eclipse.getI().getHomeManager()
.getHome(p.getUniqueId(), home);
if (homeLocation != null) {
p.teleport(homeLocation);
p.closeInventory();
}
});
gui.addButton(slot, homeButton);
slot++;
if (slot % 9 == 8) slot += 2;
}
gui.open();
}
private List<String> getHomes(Player player) {
// Get homes from your data source
return List.of("home1", "home2");
}
}import me.catst0day.Eclipse.Holograms.EclipseHologram;
import me.catst0day.Eclipse.Holograms.EclipseHologramManager;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.Location;
import org.bukkit.entity.Player;
import java.util.List;
public class Example {
public void createHologram(Player player, Location location) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
List<String> lines = List.of(
"&6&lWelcome to the Server!",
"&fEnjoy your stay",
"&eOnline players: %online%"
);
boolean success = manager.createHologram("welcome", location, lines);
if (success) {
player.sendMessage("HOooooooooooooooooooooloooooo!");
} else {
player.sendMessage("Bro, we cant create holos with the same name");
}
}
}import me.catst0day.Eclipse.Holograms.EclipseHologram;
import me.catst0day.Eclipse.Holograms.EclipseHologramManager;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.entity.Player;
public class Example {
public void modifyHologram(Player player) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
EclipseHologram hologram = manager.getHologram("welcome");
if (hologram != null) {
// Add a new line
hologram.addLine("&aNew line added!");
// Set view distance
hologram.setViewDistance(64);
// Make it clickable
hologram.setClickable(true);
hologram.setClickCommand("warp spawn");
// Set permission requirement
hologram.setPermission("eclipse.hologram.see");
// Update the hologram for all players
manager.updateHologram(hologram);
player.sendMessage("Hologram modified!");
} else {
player.sendMessage("Hologram not found!");
}
}
}import me.catst0day.Eclipse.Holograms.EclipseHologramManager;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.entity.Player;
public class Example {
public void deleteHologram(Player player, String name) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
boolean success = manager.deleteHologram(name);
if (success) {
player.sendMessage("Hologram '" + name + "' deleted!");
} else {
player.sendMessage("Hologram not found!");
}
}
}import me.catst0day.Eclipse.Holograms.EclipseHologram;
import me.catst0day.Eclipse.Holograms.EclipseHologramManager;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.entity.Player;
public class Example {
public void listHolograms(Player player) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
player.sendMessage("=== mabye, i should put something there ===");
for (EclipseHologram hologram : manager.getAllHolograms()) {
player.sendMessage("- " + hologram.getName() +
" at " + hologram.getLocation().getWorld().getName() +
" (" + hologram.getLocation().getBlockX() + ", " +
hologram.getLocation().getBlockY() + ", " +
hologram.getLocation().getBlockZ() + ")");
}
}
}import me.catst0day.Eclipse.Holograms.EclipseHologram;
import me.catst0day.Eclipse.Holograms.EclipseHologramManager;
import me.catst0day.Eclipse.Holograms.EclipseHologram.FollowType;
import me.catst0day.Eclipse.Holograms.EclipseHologram.TextAlignment;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.Location;
import org.bukkit.entity.Player;
import org.bukkit.Material;
import java.util.List;
public class Example {
public void createAdvancedHologram(Player player, Location location) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
List<String> lines = List.of(
"&6&lHOLO",
"&fWith custom settings",
"!nextpage!",
"&ePage 2 content"
);
boolean success = manager.createHologram("advanced", location, lines);
if (success) {
EclipseHologram hologram = manager.getHologram("advanced");
// Text settings
hologram.setTextAlignment(TextAlignment.CENTER);
hologram.setTextShadow(true);
hologram.setTextAlpha(255);
hologram.setBackgroundColor("#FF0000");
hologram.setBackgroundAlpha(128);
// Animation settings
hologram.setFadeInTicks(20);
hologram.setFadeOutTicks(20);
// Display settings
hologram.setScale(1.5);
hologram.setFollowType(FollowType.CENTER);
hologram.setYawOffset(0);
hologram.setPitchOffset(0);
// Board settings (background board)
hologram.setBoardEnabled(true);
hologram.setBoardMaterial(Material.OAK_PLANKS);
hologram.setBoardScale(1.0);
hologram.setBoardThickness(0.1);
// Icon settings
hologram.setIconScale(1.0);
hologram.setIconYawOffset(0);
hologram.setIconPitchOffset(0);
// Update interval
hologram.setUpdateInterval(10);
// Line of sight check
hologram.setLineOfSight(true);
// Light level
hologram.setLightLevel(15);
manager.updateHologram(hologram);
player.sendMessage("idk what to put here");
}
}
}import me.catst0day.Eclipse.Holograms.EclipseHologram;
import me.catst0day.Eclipse.Holograms.EclipseHologramManager;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.entity.Player;
public class Example {
public void handlePagination(Player player) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
EclipseHologram hologram = manager.getHologram("advanced");
if (hologram != null) {
// Get current page for player
int currentPage = hologram.getPlayerPage(player);
// Go to next page
hologram.nextPage(player);
// Go to previous page
hologram.prevPage(player);
// Set specific page
hologram.setPlayerPage(player, 2);
// Get total page count
int totalPages = hologram.getPageCount();
// Get lines for specific page
List<String> pageLines = hologram.getLinesForPage(0);
player.sendMessage("Current page: " + currentPage + "/" + totalPages);
}
}
}import me.catst0day.Eclipse.Holograms.EclipseHologramManager;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.entity.Player;
public class Example {
public void showAllHolograms(Player player) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
manager.showAllHologramsToPlayer(player);
player.sendMessage("All holograms shown!");
}
public void hideAllHolograms(Player player) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
manager.hideAllHologramsFromPlayer(player);
player.sendMessage("All holograms hidden!");
}
}import me.catst0day.Eclipse.Holograms.EclipseHologram;
import me.catst0day.Eclipse.Holograms.EclipseHologramManager;
import me.catst0day.Eclipse.Eclipse;
import org.bukkit.entity.Player;
public class Example {
public void checkVisibility(Player player) {
EclipseHologramManager manager = Eclipse.getI().getHologramManager();
EclipseHologram hologram = manager.getHologram("welcome");
if (hologram != null) {
boolean isVisible = hologram.isVisibleTo(player);
boolean shouldUpdate = hologram.shouldUpdateFor(player);
player.sendMessage("Visible: " + isVisible);
player.sendMessage("Should update: " + shouldUpdate);
player.sendMessage("View distance: " + hologram.getViewDistance());
player.sendMessage("Always visible: " + hologram.isAlwaysVisible());
}
}
}---See LICENSE and CONTRIBUTING.md for more info.