Repository navigation
Home
M3rcena edited this page Nov 5, 2026
·
5 revisions
Welcome to the definitive documentation wiki for @m3rcena/weky (v14.28.1).
@m3rcena/weky is the blazingly fast, modern minigames and arcade engine for Discord.js v14 bots and web applications. It features 17 fully playable minigames, native Discord Components V2 support, Rust-powered canvas image generation (@napi-rs/canvas), intelligent AI opponents, automated tournaments, and decoupled headless engines.
- ๐ฎ 17 Complete Minigames: From classics like 2048, Snake, and Tic-Tac-Toe to RPG combat, Hangman, and party dilemmas.
- โก Discord Components V2 Native: Built using modern
ContainerBuildercontainers, visual accent borders, and zero deprecations. - ๐ฆ Rust-Powered Canvas (
@napi-rs/canvas): Renders photorealistic, high-resolution game boards and score cards in under 15ms. - ๐ค Intelligent Minimax AI & RPG Bosses: Play solo against smart algorithmic computer opponents and multi-phase dungeon bosses.
- ๐ Automated Tournament Engine: Run 4-player, 8-player, or 16-player tournaments with live rendered bracket posters.
- ๐น๏ธ Arcade Hub Launcher: Centralized interactive menu to browse, customize, and launch all 17 minigames from a single message.
- ๐ Headless & Decoupled: Run games inside Discord OR headlessly for web dashboards (React, Vue, Next.js) via REST & WebSockets.
- ๐ Zero External Bloat: Zero database requirements, sub-millisecond execution, and 100% TypeScript type safety.
-
Installation & Setup โ Package installation, Node
>= 22requirements, and Discord client intents. -
Weky Overview & Core Manager โ
WekyManagerinitialization, Components V2,ContextAdapter, and lifecycle events.
- All 17 Minigames Catalog โ Exhaustive guide, options tables, and examples for every minigame.
- Next-Gen Arcade Suite โ Arcade Hub, Tournaments & Brackets, AI Opponents & Bosses, Soundboard, ELO Leaderboards, and Gamer Share Cards.
-
Headless Engine & Canvas Card APIs โ Headless game engines, REST endpoints (
/api/weky/games), and on-demand canvas card generator (/api/weky/cards/render).
-
Database & Storage Handlers โ Zero-dependency native SQLite (
node:sqlite), Prisma ORM auto-migration, JSON files, and custom storage adapters. -
Weky <-> Economy Connector โ Automated win payouts, loss penalties, solo score multipliers, win streak bonuses, PvP wager bets, and tournament prize pools with
@m3rcena/eco. -
Connecting to Dashboard Bridge โ How to bridge
@m3rcena/wekywith web dashboards for live crossplay.
import { Client, GatewayIntentBits } from "discord.js";
import { WekyManager, Game2048 } from "@m3rcena/weky";
const client = new Client({
intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages],
});
export const weky = new WekyManager(client, {
embedColor: "#5865F2",
defaultTimeout: 120_000,
});
client.on("interactionCreate", async (interaction) => {
if (interaction.isChatInputCommand() && interaction.commandName === "play2048") {
await new Game2048(weky, { context: interaction }).start();
}
});
client.login(process.env.DISCORD_TOKEN);
Built with โค๏ธ by M3rcena Development โข @m3rcena/weky v14.28.1 โข Licensed under Apache-2.0
GitHub: M3rcena/m3rcena-weky โข NPM: @m3rcena/weky
GitHub: M3rcena/m3rcena-weky โข NPM: @m3rcena/weky