GM Approval

GM approval turns character creation into a request. When it is on, a player who finishes a character does not create it outright. The submission goes into a review queue, and you decide what happens to it.

This is optional. With approval off, finishing a character creates it immediately (see the Quick Start).

Turning it on

You enable the workflow with the Require GM Approval setting. With it on, player characters are queued for review instead of being created directly. You bypass the queue: a character you build is created right away.

See Settings for where this lives and the related Archive Submissions toggle.

What players see

Submitting

When approval is required, the button that normally creates the character instead submits it for review. After submitting, the player sees a confirmation that the character was sent for GM review.

Waiting

While a submission is pending, the creation window is locked. A banner reads:

Your character is awaiting GM review. The form is read-only until the GM approves or rejects.

Nothing can be changed during this time. The player waits for you to act on the queue.

On approval

When you approve, creation runs on the player’s side automatically. The character is built from the submission and the sheet opens. If you made edits before approving, the player is told the character was approved with edits.

Note

If creation fails to replay for any reason, the player is told approval was received but creation did not complete, and to check the console for details.

On rejection

A rejected player gets a notice titled Submission Rejected. It explains that you declined the submission and shows the reason you gave, or that no reason was provided. Two choices follow:

• Restore from submission reopens the character exactly as submitted. It can be edited and sent again.
• Start over discards it and begins a fresh character.

What the Gamemaster sees

The pending banner

When submissions are waiting, a floating banner appears with a count of pending characters and an Open queue action.

The Pending Approvals queue

The queue is the review screen. Open it from the Pending Approvals Queue entry in module settings, or through the API (openPendingApprovals). It lists each submission with the character, who submitted it, and when.

From a row, you can:

• Review the full submission before deciding.
• Approve as submitted to quick-approve without opening it.
• Reject the submission, with an optional reason. The prompt notes the submitter will see whatever is entered.

Approving runs creation on the player’s side. Rejecting sends the player the rejection notice with the reason attached.

Archiving resolved submissions

By default, a submission is removed once it is approved or rejected. Turn on Archive Submissions to keep approved and rejected entries in a journal instead. With archiving on, the queue offers a View archive view alongside the pending list, and a Clear archive action to delete archived entries.

Approval events in chat

Approval activity posts to chat:

• A submission posts that a player submitted a character for review, with a Review action for you.
• An approval posts that the character was approved.
• A rejection posts that the character was rejected.

For developers

The approval workflow is also reachable from the API:

• openPendingApprovals opens the GM queue.
• submitForApproval queues a character for review.
• getPendingSubmissions returns the submissions currently waiting.

See the API Reference for full details.