Configuration Reference¶

Complete reference for all Ansible Crafting configuration options.

Accessing Configuration¶

Install Mod Menu and Cloth Config
Open the game menu → Mods → find Ansible Crafting → click the config button (⚙️)

Via Config File¶

Edit the JSON file directly:

<minecraft-directory>/config/ansiblecrafting.json

The file is created with defaults on first launch. Changes require a game restart or re-opening the config screen.

Configuration Categories¶

Scanning¶

Controls how the mod discovers nearby inventories.

Setting	Key	Default	Range	Description
Enable Mod	`enabled`	`true`	—	Master toggle. When disabled, the mod does nothing.
Scan Range	`scanRange`	`16`	1–64	Radius in blocks to scan for inventories around the player. Higher values scan more blocks but use more CPU.
Scan Interval	`scanInterval`	`20`	1–200	Ticks between inventory scans. 20 ticks = 1 second. Lower values give faster updates but higher CPU usage.
Max Inventories	`maxInventories`	`100`	1–500	Maximum number of inventories to include in a single scan. Prevents performance issues in areas with many containers.
Inventories Enabled by Default	`inventoriesEnabledByDefault`	`true`	—	Whether newly discovered inventories are automatically enabled for remote crafting. When `false`, you must manually enable each inventory.
Include Utility Blocks	`includeUtilityBlocks`	`true`	—	Include furnaces, brewing stands, hoppers, and similar blocks — not just storage containers.

Inventory Panel¶

Controls the side panel visibility, position, and size.

Setting	Key	Default	Options	Description
Show Panel by Default	`showPanelByDefault`	`true`	—	Whether the panel appears automatically when opening a crafting screen.
Show Panel in Containers	`showPanelInContainers`	`true`	—	Whether the panel appears when opening container GUIs (chests, barrels, etc.), not just crafting tables.
Panel Position	`panelPosition`	`Centered`	`Left`, `Right`, `Centered`	Where the panel is positioned relative to the crafting GUI. `Centered` places it below the GUI.
Panel Width	`panelWidth`	`200`	100–400	Width of the panel in pixels.
Panel Height	`panelHeight`	`135`	50–500	Height of the panel in pixels.

Panel Display¶

Controls how items are displayed within the panel.

Setting	Key	Default	Options	Description
Panel Display Mode	`panelDisplayMode`	`Grid`	`List`, `Grid`	How items are shown. `List` = text rows with names. `Grid` = item icons in a grid (like EMI/REI).
Show Item Count	`showItemCount`	`true`	—	Whether to display quantity numbers next to items in the panel.
Grid Cell Size	`gridCellSize`	`20`	18–28	Size of each grid cell in pixels. Higher values add more spacing between icons.
Grid Count Text Scale	`gridCountScale`	`75`	50–100	Font size of count labels on grid icons as a percentage (50% = half size, 100% = full size).
Compact Grid Counts	`compactGridCounts`	`true`	—	Abbreviate counts on grid icons (e.g. 1k instead of 1000). When disabled, raw numbers are shown.
Compact List Counts	`compactListCounts`	`false`	—	Abbreviate counts in list view (e.g. x1k instead of x1000).

Highlights¶

Controls the colored outlines shown on inventory blocks.

Setting	Key	Default	Range	Description
Highlight Inventories	`highlightInventories`	`true`	—	When clicking an item in the panel, highlight the blocks that contain it with a colored outline.
Highlight Duration	`highlightDuration`	`3`	1–30	How many seconds the highlight outlines remain visible.
Highlight Thickness	`highlightThickness`	`3`	1–10	Line thickness of the highlight outlines in pixels.

World Overlay¶

Controls the in-world wifi status icons on container blocks.

Setting	Key	Default	Range	Description
Show World Overlay	`showWorldOverlay`	`true`	—	Show wifi-style status icons on container blocks in the world to indicate enabled/disabled state.
Overlay Render Distance	`overlayRenderDistance`	`16`	1–64	Maximum distance in blocks at which overlay icons are rendered.
Overlay Face Mode	`overlayFaceMode`	`Nearest`	`Nearest`, `All`, `Top`	Which block face(s) to render the overlay icon on. `Nearest` = face closest to the player. `All` = all visible faces. `Top` = top face only.
Overlay Corner	`overlayCorner`	`Bottom Right`	`Top Left`, `Top Right`, `Bottom Left`, `Bottom Right`	Which corner of the block face to place the overlay icon.
Overlay Size	`overlaySize`	`15`	1–50	Size of the overlay icon as a percentage of the block face.
Overlay Opacity	`overlayOpacity`	`50`	10–100	Opacity of the in-world wifi status icons as a percentage.

Default Config File¶

When first launched, the mod creates this default configuration:

{
  "enabled": true,
  "scanRange": 16,
  "scanInterval": 20,
  "maxInventories": 100,
  "inventoriesEnabledByDefault": true,
  "includeUtilityBlocks": true,
  "showPanelByDefault": true,
  "showPanelInContainers": true,
  "panelPosition": "Centered",
  "panelDisplayMode": "Grid",
  "gridCellSize": 20,
  "gridCountScale": 75,
  "compactGridCounts": true,
  "compactListCounts": false,
  "panelWidth": 200,
  "panelHeight": 135,
  "showItemCount": true,
  "highlightInventories": true,
  "highlightDuration": 3,
  "highlightThickness": 3,
  "showWorldOverlay": true,
  "overlayRenderDistance": 16,
  "overlayOpacity": 50,
  "overlayFaceMode": "Nearest",
  "overlayCorner": "Bottom Right",
  "overlaySize": 15
}

Performance Tuning¶

If you experience lag, try these adjustments:

Symptom	Adjustment
Lag spikes every second	Increase `scanInterval` (e.g., 40 = scan every 2 seconds)
Constant low FPS	Reduce `scanRange` (e.g., 8 blocks)
Too many inventories	Lower `maxInventories` (e.g., 50)
Overlay rendering lag	Reduce `overlayRenderDistance` or disable `showWorldOverlay`

Config Validation¶

The mod validates all config values on load. Out-of-range values are clamped to their valid range:

scanRange < 1 → clamped to 1
scanRange > 64 → clamped to 64
null JSON fields → replaced with defaults

See ModConfig.java for the full validation logic.