Blanc Engine Documentation

1. Creating a Project & Importing Assets

Launch blanc_editor (or run cargo run -p blanc_editor from source), create a new project or open an existing .blanc manifest, and organize your media in the Asset Manager:

2. Writing in Story Setup

In Story Setup, draft your script using Blanc Engine's screenplay syntax, then click Convert to Scenes to generate .bscene files automatically.

[Scene: Classroom_Afternoon]
[BGM: peaceful_day]

Alice (Happy): "Hello! Welcome to Blanc Engine."
Narrator: The afternoon sun streamed through the classroom windows.

[Choice: What do you want to do?]
- Go to the rooftop -> Rooftop_Scene
- Stay in the classroom -> Classroom_Evening

3. Editing Scenes & Story Flow

• Scene Editor: Fine-tune vertical action blocks including backgrounds, character positioning and expressions, dialogue, narration, choices, wait timers, and screen effects (FadeIn, FadeOut, FlashWhite, Shake).
• Story Flow: Visually wire Main Menu, Scene nodes, Choice pins, Pause, Settings, and Ending nodes on an interactive canvas.

4. Customizing UI (UI Designer)

Use UI Designer with live preview to customize the Title Screen (logo, background, button layout and textures), Gameplay HUD (dialogue box, nameplate, Q.Save, Q.Load, Auto, Skip, History, Hide UI, Menu), and Pause / Settings / Save-Load / Backlog screens.

5. Multi-Language Support (Localization)

1. Open the Localization tab and confirm your Source / Default Language (such as en or id).
2. Under Add Language, enter a language code (e.g., ja, ko, fr) and display name, then click + Add Language.
3. Click Sync Strings whenever you add new dialogues or choices in your scenes.
4. Translate directly in the editor or use Export CSV / Import CSV (key,context,source,translation) to edit in Excel or Google Sheets.
5. Players can switch languages anytime from Settings → Language in the exported game.

6. Exporting & Distributing Your Game

7. Runtime Keyboard Shortcuts