Augury - Generated Oracle Deck, Weighted Readings & Card Album for RPG Maker MZ

Your game already has a fortune-teller. This is the deck she reads from.

Augury generates a complete 78-card arcana — 22 trumps and four suits of fourteen — from 46 hand-authored motifs, drawn as vector geometry while your game runs. Nothing ships as an image file. The package is four JavaScript files, a Readme and a licence: 41 KB, no atlas, no icon sheet, no PNG.

Then it deals with them.

A reading is a mechanic, not a cutscene

One plugin command lays a spread on a drawn card table, turning each card with a flip. When it finishes it writes what it dealt back into your switches and variables:

• the first card’s id (0–77) and its trump number
• whether it came up reversed
• how many cards were laid

So if variable 21 == 16 is “the Tower came up”, and everything after that is an ordinary event page. The card ids are stable and documented, so a future version will not renumber them under your saves.

The playthrough bends the deck

Omen rules make a card likelier — or impossible — when your game state says so.

major:tower, switch 12 ON, weight 20 → twenty times as likely
major:sun, variable 8 at least 3, weight 0 → cannot be drawn at all

Measured over 20,000 draws per arm: a ×20 rule took the Tower from 1.31% (an even deck is 1.28%) to 20.77%; a ×0 rule took the Sun to exactly 0.00%. It is arithmetic, not decoration. And if you zero every card the deck deals evenly instead of dealing nothing, and says so in the console.

Bind the cards to your own world

Name a card in the Plugin Manager and the name is struck into its cartouche. The Emperor becomes Aldric, the Winter King. The Tower becomes The Fall of Vantre. A reading is then about this playthrough rather than about tarot.

A deck the player fills

Every card drawn is remembered. The album shows what has been met and what is still face down, with a completion count and a per-card tally of how often each has come up reversed.

COMPATIBILITY

Tested alongside VisuStella MZ Core Engine and the stock RPG Maker MZ scripts.

Import order in the Plugin Manager — all four, in this order:
1. AuguryArcana.js 2. AuguryDeck.js 3. AuguryCard.js 4. Augury.js
Each file checks the ones before it and says so plainly if they are missing.

Three core methods EXTENDED with their originals saved and called. ZERO clobbered — measured by scanning the shipped source against the real MZ runtime, not claimed: Game_System.initialize, Window_MenuCommand.addOriginalCommands, Scene_Menu.createCommandWindow. Turn the menu command off and the last two do nothing at all.

It is built to sit BESIDE a card-battle plugin, not against one. If you use MythAtelier’s Card Game Combat, Undermax’s Card Duel System or a Triple Triad plugin, Augury does the other job: those resolve duels, this deals readings.

The scenes extend Scene_Base, not Scene_MenuBase, so they bring none of the stock menu chrome.

What it does not do

Augury draws the cards; it does not write their meanings for your game. Every card ships with its traditional title so a reading is legible immediately, but a story that turns on “the Hanged Man means X in THIS world” is yours to write in the event that branches on it. You get the deck, the draw and the branch — not the script.

Verified

• 413 headless checks across four suites, each run in its own process
• 43 checks in the real RPG Maker MZ engine, including a save round-trip and every one of the 78 faces measured for real ink and proven distinct
• Zero stock windows, zero stock buttons, zero img/system art in either scene — against a detector first proven to find 53 of them on a stock MZ menu
• Frame gate: 2 draw calls per frame against a budget of 60, 0 windows drawn, no display-list growth
• Deterministic: the same seed deals the same reading, and the seed is printed on the table

What ships

• AuguryArcana.js — 46 authored motifs (22 trumps · 4 suits · 10 pip arrangements · 4 court postures · 6 frames) and 8 colourways
• AuguryDeck.js — the 78-card model, seeded RNG, weighting, four spreads, records
• AuguryCard.js — the renderer
• Augury.js — two scenes, four plugin commands, the parameters
• Readme_for_Users.md and LICENSE.txt

Raw, readable, unminified JavaScript.

More from Core Systems Asset Factory

• Sigil Core — every spell generates its own animated seal
• Asterism — a constellation skill tree that draws its own stars
• Niello — every weapon and armour draws its own engraved plate
• Formulary — every recipe draws its own alchemical plate
• Herbarium — every reagent mounts as a botanical plate
• Armorial — a coat of arms generated from what the playthrough did
• Chronicle Core — branching quests, faction reputation and world state