A network interceptor that gives flexible control over the chat feature of the game. This also allows for custom commands to be added.
Example
const chat = new VOXELIZE.Chat();
// Listen to incoming chat messages.
chat.onChat = (chat: ChatMessage) => {
console.log(chat);
};
// Sending a chat message.
chat.send({
type: "CLIENT",
sender: "Mr. Robot",
body: "Hello world!",
});
// Register to the network.
network.register(chat);
Type parameters
| Name | Type |
|---|---|
T | extends ChatProtocol = ChatProtocol |
Implements
Constructors
constructor
• new Chat<T>(): Chat<T>
Type parameters
| Name | Type |
|---|---|
T | extends ChatProtocol = ChatProtocol |
Returns
Chat<T>
Properties
onChat
• onChat: (chat: T) => void
Type declaration
▸ (chat): void
Parameters
| Name | Type |
|---|---|
chat | T |
Returns
void
Accessors
commandSymbol
• get commandSymbol(): string
The symbol that is used to trigger commands.
Returns
string
commandSymbolCode
• get commandSymbolCode(): string
Returns
string
Methods
addCommand
▸ addCommand<T>(trigger, process, options): () => void
Add a command to the chat system. Commands are case sensitive.
Type parameters
| Name | Type |
|---|---|
T | extends ZodObject<Record<string, ZodTypeAny>, UnknownKeysParam, ZodTypeAny, , > = ZodObject<Record<string, never>, UnknownKeysParam, ZodTypeAny, , > |
Parameters
| Name | Type | Description |
|---|---|---|
trigger | string | The text to trigger the command, needs to be one single word without spaces. |
process | (args: TypeOf<T>) => void | The process run when this command is triggered, receives parsed typed args. |
options | CommandOptions<T> | Configuration for the command including Zod schema for args. |
Returns
fn
▸ (): void
Returns
void
getAllCommands
▸ getAllCommands(): { aliases: string[] ; args: ArgMetadata[] ; category?: string ; description: string ; flags: string[] ; trigger: string }[]
Get all registered commands with their documentation. This filters out aliases and returns only the primary command triggers.
Returns
{ aliases: string[] ; args: ArgMetadata[] ; category?: string ; description: string ; flags: string[] ; trigger: string }[]
An array of command triggers with their descriptions, categories, aliases, and arg schemas.
removeCommand
▸ removeCommand(trigger): boolean
Remove a command from the chat system. Case sensitive.
Parameters
| Name | Type | Description |
|---|---|---|
trigger | string | The trigger to remove. |
Returns
boolean
send
▸ send(chat): void
Send a chat to the server.
Parameters
| Name | Type | Description |
|---|---|---|
chat | T | The chat message to send. |
Returns
void
setFallbackCommand
▸ setFallbackCommand(fallback): void
Set a fallback command to be executed when no matching command is found.
Parameters
| Name | Type | Description |
|---|---|---|
fallback | (rest: string) => void | The fallback command processor. |
Returns
void