黑板

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）

指令	作用
/blackboard generate	让注视的黑板重新出题
/blackboard settype <类型>	切换注视黑板的题库（如 blackboard:linear_algebra）
/blackboard difficulty <0-10> | clear	设置 / 清除该黑板难度
/blackboard reload	热重载所有题目生成器

为你所用 — KubeJS & API

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

版本与依赖

平台	Minecraft	加载器
Forge	1.20.1	Forge 47.4.4+
NeoForge	1.21.1	NeoForge 21.1.234+

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

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