服务器库

服务器库

一个旨在简化服务端模组创建的库

基础库

ServerLibraries

Modrinth Shield Github Shield Wakatime

Banner Image

ServerLibraries 是一个用于 Minecraft 服务端 Fabric 模组开发的库,旨在简化开发体验,使其感觉像在制作基于 Bukkit 的插件。

功能特性

  • 简化的 事件处理,包含数百个已映射的事件。
  • 轻松实现同步/异步调度。

示例用法

以下是使用 ServerLibraries 处理事件的示例:

// 处理服务器事件的监听器类
public class ExampleListener implements Listener {

    @EventHandler
    public void onPlayerChatEvent(@NotNull PlayerChatEvent event) {
        event.setCancelled(true);
        ServerPlayerEntity player = event.getPlayer();
        String message = event.getMessage();
        // 格式化消息以显示玩家名称后跟消息
        String formattedMessage = player.getName().getString() + " > " + message;
        // 将格式化消息广播给所有玩家并在控制台记录
        msg.broadcast(formattedMessage);
        msg.log(formattedMessage);
    }

    @EventHandler
    public void onPlayerMoveEvent(@NotNull PlayerMoveEvent event) {
        // 获取玩家及其位置
        ServerPlayerEntity player = event.getPlayer();
        BlockPos pos = player.getBlockPos();
        // 格式化坐标并作为动作栏消息发送
        String message = "X: " + pos.getX() + " Y: " + pos.getY() + " Z: " + pos.getZ();
        msg.sendActionBar(player, message);
    }
}

// 主 Fabric 模组类
public class ExampleMod implements ModInitializer {
    @Override
    public void onInitialize() {
        EventsRegistry.registerListener(new ExampleListener());
    }
}

安装

要将 ServerLibraries 包含在你的项目中,请将以下内容添加到你的 build.gradle 文件。

Maven 仓库

repositories {
    exclusiveContent {
        forRepository {
            maven {
                name = "Modrinth"
                url = "https://api.modrinth.com/maven"
            }
        }
        filter {
            includeGroup "maven.modrinth"
        }
    }
}

依赖

添加以下依赖。将 <version> 替换为你想要使用的版本。你可以在 这里 找到可用版本,或使用下方版本以获取最新稳定版。

Stable Release Shield

dependencies {
    modImplementation "maven.modrinth:kjqxZ07F:<version>"
}

文档

文档和 Javadocs 可在 此处 找到。