QUIPT 
QUIPT 是一个面向 Minecraft 服务器和开发者的多模块工具包。它提供:
- Paper 和 Fabric 集成层
- 用于回调/资源的嵌入式 HTTP 服务器(Jetty)
- 通过 Webhook 自动更新资源包
- 带插件加载功能的 Discord 机器人集成
- 面向开发者的 API,涵盖事件、注册表、消息传递、占位符和临时进度
快速链接
- 概览:docs/OVERVIEW.md
- 安装:docs/INSTALLATION.md
- 配置参考:docs/CONFIGURATION.md
- 模块:docs/MODULES.md
- 开发者指南:docs/DEVELOPER.md
- 贡献指南:docs/CONTRIBUTING.md
开始使用(Paper)
- 从 Modrinth 或 GitHub 下载发行版,并将 JAR 文件放入 plugins/ 目录。
- 启动一次服务器以生成默认配置文件。
- 编辑 plugins/quipt-paper/ 下的配置文件(详见 docs/CONFIGURATION.md)。
- 重启服务器。如果已启用,QUIPT 将启动嵌入式 Web 服务器和 Discord 机器人。
服务器管理员功能
- 资源包管理:在 resources.json 中配置你的资源包仓库和服务器 IP。通过 /resourcepack update 命令或向 发送 Webhook 来触发更新。
- 传送管理:简单的点对点传送以及可配置的传送点/家园。
开发者功能
- 事件与监听器:开箱即用的监听器和用于钩入的事件系统。
- 临时进度:利用底层的 Bukkit 进度系统向玩家发送类似气泡提示的更新。
- 嵌入式 Web 服务器:在自定义路由上挂载你自己的处理器。
- Discord 集成:发布服务器状态并通过机器人插件进行扩展。
从源码构建
- 要求:Java 21, Git
- Windows PowerShell:.\gradlew.bat build
- 其他平台:./gradlew build
- 构建产物位于每个模块的 build/libs 目录下。
支持与社区
- Discord:
- Issue:
版本控制
- 请参阅 gradle.properties 中的 project_version 和 supported_minecraft_versions。
许可证
- Copyright © QuickScythe.
- 详情请参阅仓库中的许可证文件。
QUIPT 
QUIPT is a multi-module toolkit for Minecraft servers and developers. It provides:
- Paper and Fabric integration layers
- An embedded HTTP server (Jetty) for callbacks/resources
- Resource pack auto-updates via webhooks
- A Discord bot integration with plugin loading
- Developer APIs for events, registries, messaging, placeholders, and ephemeral advancements
Quick Links
- Overview: docs/OVERVIEW.md
- Installation: docs/INSTALLATION.md
- Configuration Reference: docs/CONFIGURATION.md
- Modules: docs/MODULES.md
- Developer Guide: docs/DEVELOPER.md
- Contributing: docs/CONTRIBUTING.md
Getting Started (Paper)
- Download a release from Modrinth or GitHub and place the JAR in plugins/.
- Start your server once to generate default configs.
- Edit configs under plugins/quipt-paper/ (see docs/CONFIGURATION.md).
- Restart the server. QUIPT will start the embedded web server and Discord bot if enabled.
Server Owner Features
- Resource Pack Management: Configure resources.json with your pack repo and server IP. Trigger updates via /resourcepack update or a webhook to
- Teleportation Management: Simple P2P teleports and configurable warps/homes.
Developer Features
- Events and Listeners: Ready-to-use listeners and an event system to hook into.
- Ephemeral Advancements: Send toast-like updates to players using Bukkit advancements under the hood.
- Embedded Web Server: Mount your own handlers at custom routes.
- Discord Integration: Post server status and extend via bot plugins.
Building From Source
- Requirements: Java 21, Git
- Windows PowerShell: .\gradlew.bat build
- Other platforms: ./gradlew build
- Artifacts are available under each module's build/libs directory.
Support and Community
- Discord:
- Issues:
Versioning
- See gradle.properties for project_version and supported_minecraft_versions.
License
- Copyright © QuickScythe.
- See repository license file for details.
下载 QUIPT
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 QUIPT
下载 QUIPT
下载 QUIPT
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 QUIPT
下载 QUIPT
下载 QUIPT
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 QUIPT
下载 QUIPT
下载 QUIPT
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
玩家数据与持久化
- 新增
PlayerConfig以表示持久化的玩家数据并提供默认玩家 ID。 - 重构 Paper 玩家注册逻辑,通过集成体的配置系统加载和保存玩家配置。
- 将玩家集合注册为配置值,以确保更改实际持久化。
- 引入玩家工厂,并重构
PlayerManager/PaperPlayers以集中管理玩家的创建与管理。 - 更新玩家查找逻辑,使用配置的玩家 ID,而非在
PaperPlayer上存储单独的 UUID。 - 新增对玩家模型及其元数据的 JSON 初始化支持。
- 通过在
PlayerManager中使用Optional改进 UUID 处理。
元数据与序列化
- 为
Metadata实现JsonSerializable。 - 在创建
MinecraftPlayer时初始化元数据,向消费者暴露该数据,并将其随玩家数据一起序列化。 - 在 Minecraft 和 Paper 玩家的 JSON 构造函数中新增元数据反序列化支持。
Paper 插件结构与修复
- 重构
QuiptPlugin以提供listeners()和commands()扩展点,并将PaperPlayers的初始化移至基础插件类中。 - 修复
ExtraLifePlatform中的队伍 ID 检查逻辑。 - 更新
PaperPlayers以使用集成配置,并明确其如何检索PlayerConfig。 - 将
PartyCommand注册到命令系统中。
测试
- 新增 Mockito 作为测试依赖项。
- 新增覆盖元数据序列化和 Paper 玩家生命周期的单元测试。
构建与发布
- 将项目构建号更新至 27。
- 改进 Modrinth 上传日志,在任务完成后包含版本详情。
- 更新上传 Webhook 的有效载荷结构。
- 整合 Jenkins 配置,并将 Discord 更新频道及令牌添加至流水线环境变量中。
玩家数据与持久化
- 新增
PlayerConfig以表示持久化的玩家数据并提供默认玩家 ID。 - 重构 Paper 玩家注册逻辑,通过集成体的配置系统加载和保存玩家配置。
- 将玩家集合注册为配置值,以确保更改实际持久化。
- 引入玩家工厂,并重构
PlayerManager/PaperPlayers以集中管理玩家的创建与管理。 - 更新玩家查找逻辑,使用配置的玩家 ID,而非在
PaperPlayer上存储单独的 UUID。 - 新增对玩家模型及其元数据的 JSON 初始化支持。
- 通过在
PlayerManager中使用Optional改进 UUID 处理。
元数据与序列化
- 为
Metadata实现JsonSerializable。 - 在创建
MinecraftPlayer时初始化元数据,向消费者暴露该数据,并将其随玩家数据一起序列化。 - 在 Minecraft 和 Paper 玩家的 JSON 构造函数中新增元数据反序列化支持。
Paper 插件结构与修复
- 重构
QuiptPlugin以提供listeners()和commands()扩展点,并将PaperPlayers的初始化移至基础插件类中。 - 修复
ExtraLifePlatform中的队伍 ID 检查逻辑。 - 更新
PaperPlayers以使用集成配置,并明确其如何检索PlayerConfig。 - 将
PartyCommand注册到命令系统中。
测试
- 新增 Mockito 作为测试依赖项。
- 新增覆盖元数据序列化和 Paper 玩家生命周期的单元测试。
构建与发布
- 将项目构建号更新至 27。
- 改进 Modrinth 上传日志,在任务完成后包含版本详情。
- 更新上传 Webhook 的有效载荷结构。
- 整合 Jenkins 配置,并将 Discord 更新频道及令牌添加至流水线环境变量中。
玩家数据与持久化
- 新增
PlayerConfig以表示持久化的玩家数据并提供默认玩家 ID。 - 重构 Paper 玩家注册逻辑,通过集成体的配置系统加载和保存玩家配置。
- 将玩家集合注册为配置值,以确保更改实际持久化。
- 引入玩家工厂,并重构
PlayerManager/PaperPlayers以集中管理玩家的创建与管理。 - 更新玩家查找逻辑,使用配置的玩家 ID,而非在
PaperPlayer上存储单独的 UUID。 - 新增对玩家模型及其元数据的 JSON 初始化支持。
- 通过在
PlayerManager中使用Optional改进 UUID 处理。
元数据与序列化
- 为
Metadata实现JsonSerializable。 - 在创建
MinecraftPlayer时初始化元数据,向消费者暴露该数据,并将其随玩家数据一起序列化。 - 在 Minecraft 和 Paper 玩家的 JSON 构造函数中新增元数据反序列化支持。
Paper 插件结构与修复
- 重构
QuiptPlugin以提供listeners()和commands()扩展点,并将PaperPlayers的初始化移至基础插件类中。 - 修复
ExtraLifePlatform中的队伍 ID 检查逻辑。 - 更新
PaperPlayers以使用集成配置,并明确其如何检索PlayerConfig。 - 将
PartyCommand注册到命令系统中。
测试
- 新增 Mockito 作为测试依赖项。
- 新增覆盖元数据序列化和 Paper 玩家生命周期的单元测试。
构建与发布
- 将项目构建号更新至 27。
- 改进 Modrinth 上传日志,在任务完成后包含版本详情。
- 更新上传 Webhook 的有效载荷结构。
- 整合 Jenkins 配置,并将 Discord 更新频道及令牌添加至流水线环境变量中。
未发布 (2025-09-28)
亮点
- NetworkUtils:通过带有
BodyHandlers.ofInputStream的通用 GET 请求添加了二进制下载支持,并新增了一个辅助方法将流写入磁盘。 - NetworkUtils:POST/PUT 方法现在对 JSON 正文进行了空值安全处理(传入 null 时会发送空正文)。这避免了
NullPointerException,并与常见的 API 预期保持一致。 - NetworkUtils:扩展了各方法的 Javadoc,更好地记录了配置、超时和正文处理的相关信息。
- QueueManager/Queue:作为实验性工具引入。这些是非功能性的桩代码,仅供预览使用;API 不稳定且可能会发生变化。
实施指南(如何更新您的代码)
- 下载图像/文件(推荐):
// 如有需要,使用自定义 HttpConfig HttpConfig config = HttpConfig.config(Duration.ofSeconds(10), 3000, false, false, "image/png", "UTF-8"); HttpResponse<InputStream> resp = NetworkUtils.get(config, "https://example.com/image.png", HttpResponse.BodyHandlers.ofInputStream()); NetworkUtils.save(resp, new File("./image.png")); // 或者,使用默认配置 HttpResponse<InputStream> resp2 = NetworkUtils.get(NetworkUtils.DEFAULT, "https://example.com/file.bin", HttpResponse.BodyHandlers.ofInputStream()); NetworkUtils.save(resp2, new File("./file.bin")); - 现有的 GET/POST 用法无需更改即可继续工作。如果您之前仅处理 String 响应,可以继续使用
BodyHandlers.ofString()来处理。仅在需要二进制数据时才添加 InputStream 处理器。 - 带有可选正文的 POST/PUT:
// body 可能为 null – 将发送空的请求正文,而不是抛出异常 HttpResponse<String> r = NetworkUtils.post(NetworkUtils.DEFAULT, "https://api.example.com/endpoint", null); - QueueManager/Queue(实验性):
- 这些组件是桩代码,目前尚不可用。
- 此时无需进行迁移或代码更改。
- 请勿在生产环境中依赖它们;API 可能会更改或被移除。
兼容性
- 此更新不会破坏 API。所有现有的公共方法均保留其签名和行为;二进制下载模式是通过 BodyHandlers 以非破坏性方式添加的。
- 可安全向后移植:这些更改可以应用于上一发行版分支之上,而不会破坏现有集成。
版本 1.0.8-MC1.21.8-alpha.1-SS.5
构建日志
BUILD 1-SS.5
Embeds
Webhook Embeds 现在必须使用 Embed.Builder 类来构建。旧的 Embed 类已修改,移除了其构造函数,并改为提供一个返回新 Embed.Builder 实例的静态 builder 方法。
BEFORE:
Embed embed = new Embed()
.title("Title")
.description("Description")
.color(0xFF0000);
AFTER:
Embed embed = Embed.builder()
.title("Title")
.description("Description")
.color(0xFF0000)
.build();
Embeds 现在接受 java.awt.Color 对象用于设置颜色。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧