概述

本模组为咒法学添加了一套指令，用于将一套（以注册名为主的）自定义代码解析为法术列表，以及反向解析。解析功能需要手中持有核心。

同时添加了用于给代码段添加换行与注释的新 iota 类型。

（是 KubeJS 版本 的移植）

示例代码	示例解析后核心（启用彩色配对括号）

（图中所示示例代码使用了此处的 VSCode 插件以支持基本的文本高亮，需要手动放置于“%USERPROFILE%\.vscode\extensions\hexParse_highlight”目录生效）

内容介绍

添加指令

• /hexParse <代码文本> [重命名]：直接解析输入的代码至手持核心；若提供了“重命名”可选参数则会同时重命名核心；

• /hexParse clipboard [重命名]：读取玩家剪贴板内容，将其作为代码解析至核心；“重命名”可选参数同上；

• /hexParse clipboard_angles [重命名]：同上，但只会解析其中形如“wedsaq”的笔划序列段，并将其逐个转为图案；

• /hexParse (macro/dialect) ...：管理存储于客户端的别名（dialect，不以#开头的1对1文本映射）和宏（以#开头，映射为不定长代码段）

• ... list：列出所有保存的宏/别名

• ... define <key> <value>：定义一组宏/别名，可以为新定义或覆盖已有

• macro define_clipboard <key>：同上，但仅对宏可用，读取剪贴板作为宏内容

• ... remove <key>：移除一个保存的宏/别名（若存在）

• /hexParse read：读取玩家手中的核心，将其内容解析为代码输出至聊天窗口；

• /hexParse read_hexbug：同上，但会尝试将格式翻译以适配Discord内HexBug的`/patterns hex`命令；注：非图案常量、部分HexBug内过时注册名等仍需手动处理

• /hexParse share：（实验性质）同上，但同时广播核心原始内容与解析后代码至服务器内所有玩家。

• /hexParse donate [数量]：向自然捐赠等价于指定数量紫水晶粉的媒质，没有然后了_(:з」∠)_

• /hexParse lehmer [...数字列表]：Lehmer Code计算器，用于计算使用于骗徒之策略的数字
  

以下指令需OP权限使用

• /hexParse unlock_great (unlockAll|lockAll|unlock <pattern id>)：配置当前世界的卓越法术解锁状态，子指令分别用于全部解锁、全部锁定与按ID解锁特定；该指令仅在卓越法术解析配置为 BY_SCROLL 时启用。
  

添加图案

• 编码之策略：解析手中核心为代码并输出于聊天栏（等价于指令/hexParse read）；出于安全考虑仅能运行于法杖绘制环境中；

• 解码之策略：将剪贴板内容解析至手持核心内（等价于指令/hexParse clipboard）；出于安全考虑仅能运行于法杖绘制环境中；

• 内化卓越法术：读取并学习手持物品内的卓越法术；

• 压缩注释之纯化：清除输入列表内各层级的所有注释。
  

详见指导书内图案章节的“HexParse新增图案”栏目

添加 iota 类型：CommentIota

用于显示换行与注释等的 iota 类型，代码执行时会视为不做任何动作的图案

支持的格式

详见此文件

其它功能

在书中图案页，按下shift后将显示对应图案的注册id，可用于代码编写

配置列表

可配置的限制解析卓越法术功能

在解析到受限的卓越法术时，一个特殊占位注释将会取代实际的图案iota输出，该占位符也支持反向解析回原始输入。

示例

配置中的 ParseGreatSpells 项指定了该部分功能的具体行为。

注：解析包含卓越法术的核心为代码的功能始终不受限

普通模式（默认），配置：BY_SCROLL

卓越法术一开始解析受限，但可以通过获取包含卓越法术的道具（远古卷轴、核心、施法道具等）并使用特定图案读取学习其内容。

（当然也可以指令直接解锁）

简单模式（0.7版本之前的默认），配置：ALL

可以不受限地直接解析任意卓越法术。

困难模式，配置：DISABLED

禁用正向解析卓越法术的功能。

其它配置