Skip to main content
Version: 2.0.0

Common Minecraft Module (quipt-common)

The quipt-common module defines the shared Minecraft API layer implemented by quipt-paper, quipt-fabric, and quipt-velocity.

Core Abstractions​

classDiagram
    class MinecraftIntegration {
        <<interface>>
        +name() String
        +players() Collection
        +parties() PartyConfig
    }
    class MinecraftPlayer {
        <<abstract>>
        +uuid() UUID
        +name() String
        +teleport(MinecraftPlayer)
        +sendMessage(Component)
    }
    class CommonCommand {
        <<abstract>>
        +arguments(CommandBuilder)
    }
    class ResourcePackHandler {
        +sync()
        +start()
    }
    MinecraftIntegration <|-- QuiptPaper
    MinecraftIntegration <|-- QuiptFabric
    MinecraftPlayer <|-- PaperPlayer

Key Components​

1. MinecraftIntegration<T, K>​

Generic interface implemented by platform entrypoints. Handles platform-specific namespaced keys, data directories, and server listeners.

2. MinecraftPlayer​

Unified player representation providing:

  • UUID querying and validation.
  • Cross-platform message dispatch using Adventure Components.
  • Peer-to-peer teleportation (player.teleport(target)).

3. Location & ConfigLocation​

Cross-platform 3D coordinate model with yaw/pitch and world identifiers. Serializes seamlessly to and from JSON configuration files via ConfigLocationFactory.

4. CommandBuilder<S>​

Abstraction layer bridging platform command dispatchers (Bukkit, Fabric, Velocity) into standard Mojang Brigadier argument trees.