Skip to main content
Version: 2.0.0

Welcome to QUIPT

QUIPT is a multi-module runtime framework, server enhancement suite, and developer toolkit engineered for modern Minecraft networks and developers. Designed from the ground up for high reliability, minimal overhead, and cross-platform flexibility, QUIPT bridges the gap between Minecraft servers (Paper, Fabric), proxy networks (Velocity), embedded web services, and Discord communication.

graph TD
    Core[quipt-core<br/>Runtime, Configs, Registries, Jetty Server, Events]
    Common[quipt-common<br/>Shared Minecraft Abstractions, Commands, Resource Packs]
    Paper[quipt-paper<br/>Paper / Bukkit Plugin Layer]
    Fabric[quipt-fabric<br/>Fabric Server & Client Mod Layer]
    Velocity[quipt-velocity<br/>Velocity Proxy Plugin Layer]
    Bot[quipt-bot<br/>JDA Discord Bot & Plugin Loader]

    Core --> Common
    Common --> Paper
    Common --> Fabric
    Common --> Velocity
    Core --> Bot

Core Value & Key Capabilities​

QUIPT delivers a comprehensive suite of utilities that maximize operational efficiency for server owners and streamline development for programmers:

1. Platform-Agnostic Core Runtime​

  • Modular Integration Lifecycle: Centralized initialization and safe, multi-threaded shutdown coordination preventing orphaned background threads.
  • Dynamic Configuration Engine: Reflection-driven, type-safe configuration system supporting JSON, YAML, TOML, and QPT formats with automated schema synchronization.
  • Embedded Web Server (Jetty): In-process HTTP/HTTPS servlet container for webhooks, health checks, and dynamic asset hosting without requiring external web servers.
  • Asynchronous Event Bus: Decoupled, cancellable, prioritized event dispatching across modules.
  • Centralized Registries: Type-safe registration and discovery mechanism for integrations, commands, charity platforms, and custom data types.

2. Minecraft Ecosystem Enhancements​

  • Paper & Fabric Parity: Unified command registration, player models, and messaging across Paper and Fabric server platforms.
  • Velocity Proxy Support: Cross-network coordination and command execution at the proxy tier.
  • Git-Integrated Resource Pack Server: Automated cloning, pulling, SHA-1 checksumming, compression, and HTTP distribution of server resource packs triggered via VCS webhooks or in-game commands.
  • Brigadier Command System: Unified, cross-platform command framework with fluent argument builders, permission handling, and dynamic auto-completions.
  • Advanced Text & Messaging Utilities: Adventure-backed message formatting, serializable tokens, and runtime placeholder substitution.
  • Party & Social Framework: Persistent, serializable grouping system for multiplayer networks.

3. Discord & External Integrations​

  • Standalone & Embedded Discord Bot: Built on JDA with a dynamic runtime plugin system (BotPluginLoader) for modular bot extensions.
  • Discord Webhook Manager: Thread-safe webhook dispatch with fluent Embed builders, automatic batching, and error recovery.
  • Charity Campaign Tracking: Real-time polling and synchronization for charity fundraising platforms (ExtraLife and Tiltify) with ETag caching and pagination support.

Multi-Module Breakdown​

ModuleTarget EnvironmentPrimary Responsibilities
modules/corePlatform AgnosticBase integration lifecycle, configuration manager, embedded Jetty server, task scheduler, heartbeat, registries, event system, charity integrations, Discord webhooks.
modules/commonMinecraft SharedShared Minecraft models (MinecraftPlayer, Location), Brigadier command abstractions, ResourcePackHandler, chat and placeholder utilities, Party system.
modules/paperPaper / Purpur / BukkitPaper plugin entrypoint (QuiptPaper), PaperPlayers management, VoidChunkGenerator, Bukkit command execution bridge.
modules/fabricFabric (Server / Client)Fabric mod entrypoint (QuiptFabric), lifecycle listeners, block/item registry hooks, particle systems, client datagen, plugin messaging.
modules/velocityVelocity ProxyVelocity proxy plugin (QuiptVelocity), proxy command bridges, network-level coordination.
modules/botDiscord RuntimeStandalone Discord bot application (QuiptBot), JDA wrapper (QDA), dynamic BotPluginLoader.

Next Steps​

To begin using or developing with QUIPT, explore the following sections: