BilliardsCore — 12 Playable Billiards Games for RPG Maker MZ

One plugin. Twelve cue-sport games. Zero extra files.

BilliardsCore turns any event into a working pool table. Your player walks up, presses the action button, and plays a full match against an NPC — with real ball physics, a Monte-Carlo opponent that actually plans its shots, and results that feed straight back into your events.

Part of the MZ Minigame Collection. This plugin is one of a growing library of themed minigames for RPG Maker MZ, from board games and puzzles to sports, casino and crafting. Mix and match to fill your world with things to do.

👉 See them all: https://itch.io/c/8090415/mz-minigame-collection

The games

Game — How you win

8-Ball  — Clear your group, then sink the 8 (race to N)
9-Ball  — Lowest ball first; pocket the 9
10-Ball  — 9-ball with a 10-ball triangle; no win on the break
Straight Pool (14.1)  — Any ball, any pocket; continuous re-racks to a point target
One Pocket  — Score only in your corner pocket
Cutthroat  — 3 players — sink your opponents’ balls, be the last standing
Snooker  — 15 reds, 6 colours, full-size table, one frame
Bank Pool — Every ball must touch a rail before it drops
3-Cushion Billiards — Pocketless carom: three cushions before the second ball
7-Ball  — Fast rotation; the 7 must fall on your side
Rotation (Chicago) — Lowest ball first; balls score their number, 61 wins
English Billiards — Three balls: cannons, pots and in-offs

For eventers (no code)

Give your pool-table event an Action Button trigger.
Add the plugin command Start Billiards Game — pick the game, opponent name, difficulty (Easy / Normal / Hard / Pro), gold wager, race-to target, who breaks, table theme.
Branch on the result variable: 1 = player won, 2 = lost, 3 = draw. Win/lose switches, score variables and a common event are set for you. Wagers pay out automatically.

Or use Choose Game & Play and let the player pick from an in-game menu of all twelve.

Feels like a real table

Deterministic physics: cushions, pockets, follow/draw, side english, banked-ball detection
Rendered cloth with vignette, wooden rails, leather pocket rims, five table themes
Rolling balls with shadows, pocket-drop animation, cue-strike animation, cue-ball trail
Pop-up banners (FOUL, +7, RACK WON!), screen flash, a little shake on the break
Aim assist with ghost ball and object-ball line (turns green when you’re lined up on a pocket)
Mouse, keyboard and gamepad; hold OK to fast-forward the opponent’s shots

An opponent worth beating

The NPC doesn’t cheat. It generates candidate shots (direct pots, banks, safeties, caroms), simulates each one on the same physics engine, judges the outcome with the game’s own rules, and then adds difficulty-scaled aiming error. Easy misses like a bar player; Pro runs racks.

Built for RPGs

Lifetime records saved with the save file: wins, losses, streak, best run, gold won — per game and overall. Read them with Get Player Record so NPCs can say “You’ve beaten me three times already.”
Opponent quips (six categories, one line each — write your own)
Optional table music that restores the map BGM afterwards
Tab opens an in-game rules & controls panel for whichever game is loaded

For developers

Every game is a small RuleSet subclass with a setupRack() and a pure judge(events) function. Add your own game with BilliardsCore.registerGame({…}) and the AI, HUD, menu and records support it automatically. Script access: BilliardsCore.start({ game:’nineball’, opponent:’Vic’, difficulty:’pro’, wager:100 }).

Compatibility

RPG Maker MZ (core scripts 1.0+). Single file, no dependencies, no image or audio assets required — it uses your project’s default SEs, all configurable.
Binds A / D and gamepad L2 / R2 to side spin inside the billiards scene only; if another plugin remaps those keys, they’ll take precedence.
Not designed for RPG Maker MV.

Terms of use

Free for commercial and non-commercial projects. Credit “BilliardsCore by [your name]” somewhere in your game. Please don’t redistribute or resell the plugin itself.

Version 1.1.0 — initial public release. Changelog and support in the community tab below; bug reports welcome.