skills.rest
ImproperSubset
ImproperSubsetCOMMUNITY
Explore all skills by this author →
GitHub

fvtt-chat-messages

Create and configure Foundry VTT chat messages with speakers, whispers, and roll results.

1|Updated Jan 4, 2026
Search Tags:#rendering#hooks#foundry-vtt#chat-messages#roll-messages#speakers#whispers
One-click install
npx skills add https://github.com/ImproperSubset/hh-agentics --skill fvtt-chat-messages
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fvtt-chat-messages
Source: https://github.com/ImproperSubset/hh-agentics/tree/main/fvtt-dev/skills/fvtt-chat-messages
Command: npx skills add https://github.com/ImproperSubset/hh-agentics --skill fvtt-chat-messages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Foundry VTT chat messages are central to gameplay and UX, but building and rendering messages consistently across modules can be error-prone. This Skill guides developers in programmatically creating, configuring, and rendering chat messages, including speaker assignment, whispers, roll results, and custom rendering hooks.

Core Features & Use Cases

  • Create ChatMessage instances with content, speaker, whisper, and rolls data
  • Configure speakers, whisper recipients, and roll modes to control visibility and presentation
  • Integrate with renderChatMessageHTML and other hooks to customize message appearance and behavior across modules

Quick Start

To send a basic message: await ChatMessage.create({ content: "Hello, world!" }); To send a message with a specific speaker: await ChatMessage.create({ content: "Attack!", speaker: ChatMessage.getSpeaker({ actor: myActor }) });

Frequently Asked Questions about fvtt-chat-messages

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I programmatically create a Foundry VTT chat message?▼

To create a Foundry VTT chat message, call ChatMessage.create with content, speaker, whisper, and rolls data. You can specify content directly and configure visibility through whisper recipients and roll modes.

How do I assign an actor as the speaker for a chat message in Foundry VTT?▼

Assigning a speaker in Foundry VTT uses ChatMessage.getSpeaker with an actor reference. Pass the actor object into getSpeaker to generate the correct speaker data for your ChatMessage creation call.

Can I customize chat message appearance using render hooks in Foundry VTT?▼

Customizing chat message appearance in Foundry VTT uses render hooks like renderChatMessageHTML. Integrating with these hooks allows modules to modify message behavior and presentation across the interface.

How do I send whispers and control content visibility for Foundry VTT roll messages?▼

Control visibility for Foundry VTT roll messages by configuring whisper recipients and roll modes during ChatMessage creation. Specify whisper target users and set roll modes to manage who sees the message content.

Does this approach to Foundry VTT chat messages require external dependencies?▼

Creating and customizing Foundry VTT chat messages requires no external dependencies. It relies entirely on built-in ChatMessage APIs, speaker helpers, and rendering hooks available within the Foundry VTT framework.

What is the best way to handle message flags when creating Foundry VTT chat messages?▼

Handling message flags when creating Foundry VTT chat messages involves setting flag data during the ChatMessage creation process. This ensures custom module data persists consistently across messages and rendering hooks.

Related Skills

Explore More Software Engineering Skills→
ImproperSubsetImproperSubset
1

fvtt-hooks

Register and manage Foundry VTT hooks with Hooks.on, once, call, and callAll.

Community
Basic
mattwoodcomattwoodco
3

ai-reasoning

Toggle chain-of-thought reasoning in a collapsible UI for Claude models.

Community
Intermediate
ImproperSubsetImproperSubset
1

fvtt-dice-rolls

Automate Foundry VTT dice rolls with Roll class evaluation and chat output.

Community
Advanced
ImproperSubsetImproperSubset
1

fvtt-sheets

Build and migrate Foundry VTT ActorSheet and ItemSheet components across V1 and V2 APIs.

Community
Advanced