Blackboard

Blackboard

Place a blackboard. It shows a problem. Answer in chat to win rewards.

Blackboard is a highly extensible educational / puzzle mod. Drop a blackboard block and it instantly renders a question on its surface — from grade-school arithmetic to calculus, linear algebra, and boolean logic. Answer in chat to earn rewards. Question banks, board behavior, rewards, and selection strategy are all open for extension via registries, events, and KubeJS.

Core Gameplay

• Place and play — take a Blackboard from the creative tab and place it; it generates a question immediately.
• Rendered on the board — questions appear right on the blackboard, with formulas and matrices typeset as crisp LaTeX (pure Java, no browser). A unique board ID shows in the top-left.
• Answer in chat — !ans <boardId> <your answer> (prefix is case-insensitive).
• Solve to win — correct answers grant loot defined by the board type.

Builtin Question Types

• Arithmetic — addition, subtraction, multiplication, division, squares
• True / false
• Calculus — derivative at a point, definite integrals, limits, differentiation, indefinite integrals (symbolic answers checked by numeric sampling; +C tolerated)
• Linear algebra — vector dot product, solving Ax=b, matrix-vector product, matrix inverse, singular values (SVD)
• Boolean logic — truth-value evaluation, expression simplification

Each category is its own tag-based "bank" you can bind to a board or add to the default pool.

Answer in Your Own Notation

• Numeric — just type the number.
• Calculus (symbolic) — expressions with + - * / ^, implicit multiplication (2x, (x+1)(x-1)), sin cos tan exp ln sqrt, pi e, plus a LaTeX subset (\frac{}{}, \sqrt{}, \cdot, x^{}). Equivalent forms are accepted.
• Matrix / vector — use [[1,2],[3,4]], or LaTeX \begin{pmatrix}1 & 2 \\ 3 & 4\end{pmatrix} (bmatrix etc. too).

Adjustable Difficulty

Three tiers: global config base + per-type modifier + per-board override (/blackboard difficulty <0-10>). Higher difficulty means bigger numbers, larger matrices, and more complex problems.

Admin Commands (permission level 2)

Command	Action
/blackboard generate	Regenerate the question on the board you're looking at
/blackboard settype <type>	Switch the board's bank (e.g. blackboard:linear_algebra)
/blackboard difficulty <0-10> | clear	Set / clear that board's difficulty
/blackboard reload	Hot-reload all question generators

Make It Your Own — KubeJS & API

• KubeJS scripts — add/remove generators, define custom banks and localization, and create boards bound to your own types.
• Java / Kotlin API — open QuestionGenerator / BlackboardType registries and a full event bus (generation, validation, selection, rewards, answer formats).
• Tags are banks + /blackboard reload — change content at runtime, no restart.

Versions & Dependencies

Platform	Minecraft	Loader
Forge	1.20.1	Forge 47.4.4+
NeoForge	1.21.1	NeoForge 21.1.234+

• Required: KotlinLangForge (KLF) — Kotlin language loader.
• Optional: ApricityUI — enables the on-board visual question rendering (the mod still works via chat without it).
• Optional: KubeJS — enables script-based bank extension.

For Examples and Details: https://github.com/Tonywww2/Blackboard/blob/main/README.md

Blackboard（黑板）

放下一块黑板，它出一道题；在聊天里作答，答对就有奖励。

Blackboard 是一个高度可扩展的教育 / 益智模组。放置一块黑板方块，它会立刻在板面上渲染一道题目——从小学算术到微积分、线性代数、布尔逻辑，应有尽有。玩家在聊天中作答，答对即可领取奖励。题库、黑板行为、奖励与选题策略全部通过注册表 / 事件 / KubeJS 开放扩展。

核心玩法

• 即放即出题：从创造物品栏取出「黑板」放置，自动出题。
• 板面实时渲染：题目直接显示在黑板上，公式与矩阵经 LaTeX 排版渲染为清晰图像（纯 Java，无需浏览器）；左上角显示黑板专属 ID。
• 聊天作答：!ans <黑板ID> <你的答案>（前缀大小写不敏感）。
• 答对领奖：按黑板类型发放战利品，方块消耗。

内置题型

• 算术：加、减、乘、除、平方
• 判断题：真 / 假
• 微积分：某点导数、定积分、极限、求导、不定积分（符号题按数值抽样判等，容忍 +C）
• 线性代数：向量点积、解线性方程组 Ax=b、矩阵-向量积、逆矩阵、奇异值 (SVD)
• 布尔逻辑：真值求值、逻辑化简

每类题都是独立「题库」（标签），可绑定到黑板或放入默认池。

用你熟悉的记法作答

• 数值题：直接输数字。
• 微积分符号题：输入表达式，支持 + - * / ^、隐式乘法（2x、(x+1)(x-1)）、sin cos tan exp ln sqrt、pi e，以及 LaTeX 子集（\frac{}{}、\sqrt{}、\cdot、x^{} 等）。等价写法都算对。
• 矩阵 / 向量题：用 [[1,2],[3,4]]，或直接用 LaTeX \begin{pmatrix}1 & 2 \\ 3 & 4\end{pmatrix}（bmatrix 等亦可）。

难度可调

三级难度：全局配置基线 + 每种黑板类型偏移 + 每块黑板覆盖（/blackboard difficulty <0-10>）。难度越高，数字越大、矩阵越大、题目越复杂。

管理指令（权限等级 2）

为你所用 —— KubeJS & API

• KubeJS 脚本：几行 JS 增删题目生成器、自定义题库与本地化、创建绑定专属类型的黑板。
• Java / Kotlin API：开放 QuestionGenerator / BlackboardType 注册表与完整事件总线（出题、判题、选题、奖励、作答格式全可自定义）。
• 标签即题库 + /blackboard reload 热重载，改题免重启。

版本与依赖

• 必需：KotlinLangForge (KLF) —— Kotlin 语言加载器。
• 必需：ApricityUI（晴雪UI） —— 启用黑板板面的可视化题目渲染（未安装时仍可通过聊天正常游玩）。
• 可选：KubeJS —— 启用脚本化扩展题库。

案例和详情： https://github.com/Tonywww2/Blackboard/blob/main/README.md