What is included

• Sandbox API support with automatic extern type generation.
• Sandbox attribute support.
• Declarative UI markup directly in Haxe.
• Automatic `haxe` build with toast notifications.
• Hotloading.

Installation

HaxeBox settings

1. Build Server Port - port for haxe --wait/--connect.
2. Hotload - enables Haxe file watching and auto-build. Otherwise, build runs when the game starts in editor.
3. Haxe Path - path to haxe (if empty, haxe from PATH is used).
4. Libraries - Haxe libs for -lib (separators: ; or ,).
5. Source Path - folder with Haxe code (default: code).
6. Out Path - folder for generated C# code (default: code/__haxe__).
7. Exclude - exclusions for include(...) (separators: ; or ,).

1. Generate Externs - generates extern types from runtime.
2. Clear Output - deletes generated HaxeBox files.
3. Save - saves settings.

Build

UI markup in Haxe

• @:ui.markup(...) generates BuildRenderTree from markup expression(s).
• @:ui.stylesheet(...) auto-loads stylesheet(s) (StyleSheet.Load / Panel.StyleSheet.Load).
• @:ui.track(...) generates BuildHash so the panel updates when dependencies change.
• @:ui.attr (on field/property) marks it as a node attribute, so it can be set from markup (@MyPanel(name = "...")).

@:ui.stylesheet("styles/Profile.scss")
@:ui.track(name)
@:ui.markup({
	@label name;
})
class Profile extends sandbox.ui.Panel {
	@:ui.attr public var name:String;
}

@:ui.stylesheet("styles/Root.scss")
@:ui.markup({
	@Profile(name = "smoothie") {}
})
class Root extends sandbox.PanelComponent {
}

@:ui.stylesheet("styles/MyPanel.scss")
@:ui.track(name)
@:ui.markup({
	@button(~btn, -"button") @:text "b" + "t" + "n";

	for (i in 0...5) {
		var img = 'icon$i.png';
		@div(-"card", onclick = () -> onCardClick(i)) {
			@img(src = 'images/$img', alt = img) {}
			@label(-"title") '$name $i';
		}
	}
})
class MyPanel extends sandbox.ui.Panel {
	public var name:String = "player";
}

• nodes are opened with @*node type* (for example @div / @button / @img, etc.)
• node attributes are listed in parentheses right after node type: (*key* = *value*, ...).
• child nodes are taken from the next expression (or expression block for multiple child nodes).
• to insert text content into a node, wrap expression with @:text or @:content

• ~name - shortcut for element reference capture (@ref="name").
• -"cls-a cls-b" - shortcut for class =.
• Some simple expressions (strings, identifiers, arrays) become text content without wrapping in @:text or @:content.

Common problems

• haxe not found:

• set HaxePath in HaxeBox settings.

• HaxeBox and project paths are not defined:

• build was started with wrong build.hxml or without defines added by plugin.

• ui.* metadata is ignored because class is not Panel/PanelComponent:

• base class must be sandbox.ui.Panel or sandbox.PanelComponent.

• Empty/outdated extern type database:

• click Generate Externs and rebuild project.