Core Concepts

Syntax Fundamentals

Learn the basic structure and syntax rules that make vScript both expressive and minimal.

Command Structure

Basic command formvscript
1
2
3
4
5
6
7
8
// Basic command form
vS.commandName(params);
// With targeting and tagging
vS.notify@design#update("ready");
// Soft execution
vS.plan.

All vScript commands follow the pattern: vS.commandNamefollowed by optional parameters, targeting, and punctuation modifiers.

Data Types

Strings
Text content in double quotes or raw blocks
1
2
3
vS.inject("Hello, world");
vS.inject{Multi-line
raw content};
Numbers & Booleans
Standard numeric and boolean values
1
2
3
vS.setState(level: 42);
vS.unlock(force: true);
vS.adjust(ratio: 0.75);
Lists & Records
Collections and structured data
1
2
vS.process([1, 2, 3]);
vS.configure({ mode: "creative", level: 3 });

Naming Conventions

Commands & Keys

Use lowerCamelCase for commands and parameter keys

1
vS.setState(currentMode: "explorer");

Constants

UPPER_SNAKE_CASE allowed for constants

1
vS.configure(MAX_RETRIES: 5);

Comments

1
2
3
4
5
6
// Single line comment
vS.enter(mode: "creative");
/* Multi-line comment
for longer explanations */
vS.inject("content");

Whitespace & Formatting

Whitespace is significant for readability but not semantic. Commands can be chained or separated for clarity.

Formatting examplesvscript
1
2
3
4
5
6
7
8
// Chained execution
vS.unlock(); vS.enter(); vS.setState("wild"); vS.run(full);
// Separated for clarity
vS.unlock();
vS.enter(mode: "creative");
vS.setState("focused");
vS.run(full);