للمطوّرين والوكلاء

واجهة قابلة للتكرار تعمل على جهازك. تستخدم الأدوات المرئية الشيفرة نفسها.

JSON Schema · v1 · JSON examples · JSON result · ES module

طريقة الاستخدام

استورد وحدة ES العامة في المتصفح أو نزّل api.mjs وgenerators.mjs وlocales.mjs معًا لبيئة JavaScript تدعم Intl.Segmenter. لا يتطلب إنشاء لعبة مفتاحًا أو حسابًا أو ذكاءً اصطناعيًا مدفوعًا أو طلبًا إلى الخادم.

import {generate} from '/assets/api.mjs';
const result = generate({
  tool: 'word-search', language: 'en', seed: 'garden-42',
  settings: {text: 'GARDEN\nFLOWER\nTREE', size: 12,
    difficulty: 'easy', includeKey: true}
});
console.log(result.pack.grid, result.pack.placements);

المدخلات والمخرجات

tool: bingo أو tombala أو word-search أو cards. language: en أو es أو ar أو pt أو zh أو fr. seed: من ١ إلى ٦٤ محرفًا. settings: إعدادات اختيارية؛ راجع المخطط والأمثلة. يمكن كتابة الأعداد كأعداد JSON؛ القيم المنطقية true/false. الإعدادات الافتراضية مترجمة. تشمل النتيجة الإعدادات والمعرّف وpack: إما cards/caller أو grid/placements/words. يبدأ r وc من الصفر؛ dr وdc خطوتا الصف والعمود. يوفّر GameError حقلي code وdata. تفشل المدخلات غير الصالحة دون إسقاط كلمات.

التكرار والروابط الثابتة

تعطي الشيفرة v1 والبذرة واللغة والإعدادات نفسها النتيجة ذاتها. احفظ الإصدار والمدخلات؛ قد تختلف إصدارات لاحقة. تقبل الروابط seed والإعدادات البسيطة فقط. لا حاجة لوضع الكلمات الخاصة في عنوان URL. استخدم ملفات إعدادات JSON للمحتوى الخاص. تنطبق حدود النموذج نفسها.

BINGO · seed=paperoom-demo

تصدير PDF محليًا

في المتصفح استورد createPDF من /assets/pdf.mjs وlocales من /assets/locales.mjs. مرّر {pack:result.pack, current:{...result.settings,id:result.id}, tool:result.tool,t:locales[result.language]} ثم استدعِ doc.save("games.pdf"). تُحمّل الشيفرة والخطوط من هذا الموقع عند الحاجة، دون إرسال محتوى اللعبة. يعرض كل من الطباعة وPDF بيانات المجموعة نفسها.

جميع الألعاب القابلة للطباعة

تغطي الدالة generate() نفسها جميع الألعاب في الموقع. اقرأ tools للاطلاع على القائمة، وfields(tool) لإعدادات اللعبة، وtext(tool, language) لنصوصها. ولجميع الألعاب ما عدا المولّدات الأربعة الأصلية، تُعيد layout(result) صفحات متجهة بالمليمترات، وترسم toSVG(page) إحداها بصيغة SVG.

bingo, tombala, word-search, cards, alquerque, battleship, bulls-and-cows, checkers, crossword, dice-scores, dominoes, dots-and-boxes, exquisite-corpse, fortune-teller, gomoku, goose, hangman, hex, letter-grid, loteria, ludo, mancala, maze, memory, nine-mens-morris, nonogram, paper-dice, paper-soccer, raffle-tickets, royal-ur, scavenger-hunt, score-sheets, secret-code, snakes-and-ladders, stop, sudoku, telephone, tic-tac-toe, word-scramble, xiangqi

import {tools, fields, generate, layout, toSVG} from '/assets/api.mjs';
const result = generate({tool: 'sudoku', language: 'fr', seed: 'demo', settings: {size: 9, difficulty: 'hard'}});
const pages = layout(result);           // [{w, h, items}] in millimetres
document.body.innerHTML = toSVG(pages[0]);

يوجد كتالوج يمكن للآلات قراءته لجميع الألعاب، مع فئاتها ومناطقها وصفحاتها بست لغات، على المسار /api/games.json. وتوجد أدلة نصية عادية لنماذج اللغة على /llms.txt و/llms-full.txt، وتربط كل صفحة في رأسها بنسخة Markdown (index.md).

/api/games.json · /llms.txt · /llms-full.txt