Pumpkin-MC/Pumpkin · error · ChatError

sent a chat with an out of order timestamp

Error message

sent a chat with an out of order timestamp

What it means

ChatError variant raised when a chat message's timestamp is earlier than a previously processed message from the same player, violating Minecraft's chat ordering rules — typically a replayed or tampered packet.

Solutions

1. Kick the player with an out-of-order-chat reason
2. Track the last seen timestamp per player and reject regressions
3. Log the violation at warn level

When it happens

Trigger: Thrown at crates/pumpkin/src/net/java/play/mod.rs:136 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Pumpkin-MC/Pumpkin@8d4639e25a (2026-09-09). Data as JSON: /api/errors/f06012427d12a6b6. Report an issue: GitHub.

Appendix: source

Thrown at crates/pumpkin/src/net/java/play/mod.rs:136

            Self::InvalidBlockFace => Some("Invalid block face".into()),
            Self::InvalidHand => Some("Invalid hand".into()),
        }
    }
}

#[derive(Debug, Error)]
pub enum ChatError {
    #[error("sent an oversized message")]
    OversizedMessage,
    #[error("sent a message with illegal characters")]
    IllegalCharacters,
    #[error("sent a chat with invalid/no signature")]
    UnsignedChat,
    #[error("has too many unacknowledged chats queued")]
    TooManyPendingChats,
    #[error("sent a chat that couldn't be validated")]
    ChatValidationFailed,
    #[error("sent a chat with an out of order timestamp")]
    OutOfOrderChat,
    #[error("has an expired public key")]
    ExpiredPublicKey,
    #[error("attempted to initialize a session with an invalid public key")]
    InvalidPublicKey,
}

impl PumpkinError for ChatError {
    fn is_kick(&self) -> bool {
        true
    }

    fn severity(&self) -> Level {
        Level::WARN
    }

    fn client_kick_reason(&self) -> Option<String> {
        match self {

View on GitHub (pinned to 8d4639e25a)