服务器API

服务器API

Fabric 的服务器端模组 API

基础库

Fabric Server API

一个为 Fabric 打造的服务器 API,旨在显著简化服务器端模组。 其宏大目标是让服务器端 Fabric 变得更加稳定且令人愉快。

快捷键菜单

  • 当前绑定为 Shift+F
  • 默认禁用
    • 通过 ServerAPI 的配置文件启用

快捷键菜单目前仅允许用户传送到出生点。未来它将允许更多功能,包括其他服务器端模组的配置界面、替代类型的 TPA、交易、决斗以及许多其他功能。

要使用当前的“传送到出生点”功能,管理员必须先通过菜单右上角的“ADMIN”按钮在菜单中设置出生点。这需要玩家是 OP,或者拥有 serverapi.admin 权限。

快捷键菜单系统在未来几个月(希望如此)会有更多功能。

事件

  • PlayerEvents.JUMP
    • 针对所有 ServerPlayerEntity 的可取消跳跃事件
  • PlayerEvents.SNEAK
    • 针对所有 ServerPlayerEntity 的可取消潜行事件
  • PlayerEvents.BLOCK_BREAK
    • 当玩家破坏方块时的可取消事件

ServerUtils

一个实用工具类,提供一系列静态方法供你使用!

  • Block getBlockByTag(Identifier);
  • ItemStack getHeadFromRaw(String rawId);
  • void setStackModelData(ItemStack, int); // 用于资源包
  • void setStackLore(ItemStack, List<MutableText>);
  • MutableText getText(String, Formatting...);

ServerAPI

用于访问……的“主”API,至少这是未来的目标。目前用途有限!

  • ServerPlayerEntity getPlayerByUUID(UUID, MinecraftServer);
  • ServerAPI.Logger
    • 提供一个注入了颜色属性的字符串,供你向控制台记录带颜色的文本。可能被滥用,因此未来版本可能通过配置选项默认禁用?
    • String Success(String); // 绿色
    • String Warning(String); // 黄色
    • String Error(String); // 红色
    • String Debug (String); // 青色

未来目标 - 更长远

  • 一个“ServerPlayer”类,将抽象掉许多与直接与 Player 类交互的服务器端 Fabric 模组相关的更“复杂”的事项。
  • 更多事件。
  • 为你的服务器端模组提供更简单的配置文件管理!
  • 轻松读写离线玩家数据。
  • 为你的服务器端模组提供 GUI 配置管理。

注意: Bottles 及其所有相关内容已作为概念被废弃。对之前的热度感到抱歉!