HexParse mod

Provides a pair of patterns and a set of commands to convert custom code into (pattern or literal) list iota; requires player to have a focus item in hand.

Online HexBook

(Old KubeJS version HERE)

Example Code	Example Iota	Example Iota (Colorful Nested)

The highlight VSCode extension has only basic functions, and needs to be put into "%USERPROFILE%\.vscode\extensions\hexParse_highlight" manually.

• HexParse mod
  • Supported IO Item Types
  • Commands added
    • Reading & Writing
    • Configs
    • Misc. & Helpers
    • OP-Only Commands
  • Patterns added
  • Supported expressions
  • Misc. Features
  • Available Configs
    • Limited great pattern parsing
      • Normal Mode (by default): BY_SCROLL
      • Easy Mode (by default before ver.0.7): ALL
      • Hard Mode: DISABLED
    • Other configs
  • New iota: CommentIota
  • Future plans

Supported IO Item Types

• Focuses
• Spell Books
• (1.20) Thought Knots

Commands added

Reading & Writing

• /hexParse <code string> [rename]: parse input code into supported held item; optional rename argument to rename the item.
• /hexParse read: read handheld item's iota, parse into code and show in chat window; the result will be copied when clicked.
• /hexParse clipboard [rename]: read client clipboard text and parse into supported held item; optional rename argument to rename the item.
• /hexParse clipboard_angles [rename]: same as clipboard, but only accept patterns input with raw angle string like "wedsaq".
• /hexParse share: (experimental) same as read but broadcasts iota's raw content and click-copy-able parsed code to every player in the server.
• /hexParse read_hexbug: same as read but translates the result to the format used by discord HexBug's /patterns hex command. note: non-pattern constants and some old registry names still need to be handled manually
• /hexParse mind_stack ...: read/write iota from player's mind (staff casting VM)
  • ... peek: read the last iota inside mind stack; gets null if stack is empty
  • ... push <code>: parse code and push into mind stack
  • ... push_clipboard: same as above, but code comes from clipboard
• /hexParse property ...: (Hexcellular interop) get/set data for PropertyIota; used property names all force-added leading _ for security reason
  • ... read <propName>: read and parse from certain property
  • ... write <propName> <code>: write code into certain property
  • ... clipboard <propName>: same as above, but code comes from clipboard

Configs

• /hexParse (macro/dialect) ...: edit client-saved code dialects (1-on-1 mapping, not starting with #) and macros ( mapped to code segments, starting with #)
  • ... list: list all saved macros/dialects.
  • ... define <key> <value>: define a macro/dialect mapping; could be fresh-new or overriding existed one.
  • macro define_clipboard <key>: same as above, but only for macros, and reads player's clipboard
  • ... remove <key>: remove mapping entry with given key (if exists)
• /hexParse conflict: conflict resolver for multiple patterns with same short name (ID path)
  • only enables in physical client (singleplayer, local multiplayer) or with OP permission
  • ... or ... list: list all short names pointed by multiple long IDs
  • ... list <short_name>: list all conflicting IDs under certain short name
  • ... set <short_name> <long_ID>: redirect certain short name to input pattern ID

Misc. & Helpers

• /hexParse donate [amount]: donate custom amount of media to the nature. Pay if you feel guilty using this mod ::)
• /hexParse lehmer [...nums]: calculate lehmer code for given permutation (from ascending, e.g. 0 1 2 3 4); input should be separated with space; the result number can be used for Swindler's Gambit.

OP-Only Commands

• /hexParse unlock_great (unlockAll|lockAll|unlock <pattern id>|lock <pattern id>): controls great pattern unlocking process of current world by locking/unlocking all at once, or a single great pattern each execution.

Patterns added

• code2focus: Equivalent to /hexParse clipboard (now not only focuses).
• focus2code: Equivalent to /hexParse read.
• remove_comments: Clears comment iotas from a (nested) list input.
• learn_patterns: Read handheld items and learns great pattern(s) inside.
• (great spell) compile: takes in a MoreIotas string iota, and parses it into a code list.

Introduction also written in HexParse Patterns section inside the book.

Supported expressions

see this file for all available symbols.

Misc. Features

• At each pattern's page, press Shift to display the pattern's registry ID

Available Configs

Limited great pattern parsing

When failing to parse restricted great spells from code to iota, the parser leaves a placeholder comment in-place, which can be read as original input later.

Example

The config entry ParseGreatSpells determines the mode this mod deals with great patterns.
Parsing iota with great patterns to code is not limited.

Normal Mode (by default): BY_SCROLL

All great patterns are restricted at first, and have to be unlocked by a Learn Great Patterns pattern after acquiring certain items containing great patterns.

Easy Mode (by default before ver.0.7): ALL

Parsing is not limited, and great patterns can be used freely regardless of world exploration and looting progress.

Hard Mode: DISABLED

Parsing is not limited.

Other configs

Entry	Type	Description
CommentParsingMode	enum	how comments get parsed into iotas ALL: including comment_%ss and /* */s & //s; MANUAL(default): only comment_%ss; DISABLED: no comments at all
IndentParsingMode	enum	how indents get parsed into iotas ALL(default): coding indents will be auto-converted into tab_%d; MANUAL: only tab_%ds accepted; DISABLED: no indents at all
MaxBlankLineCount	int	how many continuous blank lines are allowed in parsed spell; excess ones will be ignored
ParserBaseCost	int	Base cost for each iota (except comments/tabs)
ShowColorfulNested	bool	Whether to colorize nested list (and intro/retros in 1.20)

New iota: CommentIota

CommentIota displays string inside, and parses into a null iota (with id: "hexparse:comment") which executes doing nothing.
Comment iotas includes text comments, line-breaks & indents, and unknown great spell placeholders.
When player holds Shift key, all comments will be hidden.

Future plans

• more complex tokenizer to replace simple regex queues
• legal number pattern generator