AppleyAppley Docs
Docs/Release Notes

Version 2.5

The biggest engine expansion yet — 50+ new scripting commands, a Roblox-style Toolbox, fully improved AI, and advanced GUI panels.

8 min read Beginner Updated 2026-09-05 v2.5 ~20 min to complete

Introduction

Version 2.5 is the largest single update to the Appley engine since launch. This update adds over 50 new scripting commands (available in both FluxScript and Node Scripting), a Roblox Studio-style Toolbox panel, comprehensive AI improvements for both game generation and the in-editor assistant, and multiple new GUI panels. Every new command is fully wired into the runtime — they actually execute, not just autocomplete.

V2.5 Overview

Major Highlights

50+ new engine commands, Roblox-style Toolbox, improved AI (generation + assistant), Tweening system, Status Effects, Cutscenes, Procedural Generation, Extended Math/String/Array/Dict APIs, Device input (vibration, accelerometer), Data Persistence, and 10 new event types.

The V2.5 update follows Appley's unified registry architecture: every command is defined once in the Engine API registry and automatically appears in FluxScript, Node Scripting, the AI vocabulary, autocomplete, and the auto-generated documentation. This means the 50+ new commands are immediately available everywhere — no separate registration needed.

50+ New Scripting Commands

V2.5 introduces over 50 new engine commands across 13 categories. Each command works in both FluxScript (text) and Node Scripting (visual) — they compile to the same runtime.

Tweening & Animation (5)

Smooth interpolated transitions for positions, rotations, scales, colors, and camera FOV. Tweens run over a duration with optional easing.

Tweening Examples
# Tween the player's position smoothly over 2 seconds
Tween Position Self to 10 0 5 over 2 Seconds

# Tween an object's color
Tween Color Enemy to #ff0000 over 1 Seconds

# Tween the camera FOV for a zoom effect
Tween Camera FOV to 30 over 3 Seconds

Pathfinding & Navigation (5)

Advanced navigation control — set navigation speed, check path status, get remaining distance, and configure obstacle avoidance.

Navigation Examples
# Set an enemy's navigation speed
Set Navigation Speed Enemy to 8

# Check if an AI is currently pathfinding
if Enemy Is Pathfinding {
    Show Text "Enemy is moving..."
}

Audio Mixing (5)

Professional audio mixing with master, SFX, and music volume channels, plus fade in/out controls.

Audio Mixing Examples
# Set master volume to 80%
Set Master Volume to 0.8

# Fade out music over 2 seconds
Fade Music Out over 2 Seconds

# Set SFX volume
Set SFX Volume to 1.0

Skills & Progression (5)

Full RPG progression system — add XP, manage levels, award skill points. Fires the On Level Up event when a player levels up.

Skills & Progression Examples
# Award XP when an enemy dies
When Enemy Died {
    Add XP 50
}

# Check player level for gated content
if Get Level >= 10 {
    Show Text "Expert area unlocked!"
}

Status Effects (5)

Apply status effects like poison, stun, burn, freeze. Check if an effect is active and get its remaining duration.

Status Effect Examples
# Apply poison to an enemy
Add Status Effect Enemy Poison for 5 Seconds

# Check if the player is stunned
if Player Has Status Effect Stun {
    Show Text "You are stunned!"
}

Cutscenes & Cinematics (5)

Full cutscene system — start/stop cutscenes, play camera paths, set camera targets, and freeze the player during cinematic sequences.

Cutscene Examples
# Start a cutscene when a boss appears
When Trigger Entered {
    Start Cutscene "Boss Reveal"
    Freeze Player
    Play Camera Path "BossCamera"
}

# End the cutscene
When Cutscene End {
    Stop Cutscene
}

Procedural Generation (5)

Generate dungeons, mazes, noise patterns, and loot tables at runtime. Scatter objects procedurally across terrain.

Procedural Generation Examples
# Generate a dungeon when the game starts
When Game Starts {
    Generate Dungeon 10 10
    Scatter Objects Tree 50
}

# Generate a loot table for a chest
When Trigger Entered {
    Generate Loot Table "Chest" 3
}

UI Enhancements (5)

Show/hide tooltips, minimaps, and custom cursors. Build richer UI experiences.

UI Enhancement Examples
# Show a tooltip when hovering an object
When Collision Started {
    Show Tooltip "Press E to interact"
}

# Show the minimap in an open-world game
When Game Starts {
    Show Minimap
}

Extended Math (10)

Tan, Sqrt, Pow, Floor, Ceil, Min, Max, Atan2, Distance, and Lerp Angle — the math toolkit is now complete.

Extended Math Examples
# Calculate distance between player and enemy
Set Variable dist = Distance Player Enemy

# Use min/max for clamping without clamp
Set Variable result = Min 100 Max 0

# Square root for damage calculation
Set Variable dmg = Sqrt 16

Extended Strings (5)

Replace, Trim, Starts With, Ends With, and To Number — full string manipulation toolkit.

String Examples
# Replace text in a string
Set Variable msg = Replace "Hello World" "World" "Appley"

# Check if a string starts with a prefix
if "HelloAppley" Starts With "Hello" {
    Show Text "Greeting detected"
}

Extended Arrays (5)

Find, Filter, Sort, Reverse, and Shuffle — full array manipulation.

Array Examples
# Shuffle an array of cards
Set Variable deck = Shuffle Array "cards"

# Sort a leaderboard
Set Variable sorted = Sort Array "scores"

Extended Dictionaries (4)

Merge, Values, Size, and Remove — complete dictionary operations.

Dictionary Examples
# Merge two dictionaries
Set Variable combined = Merge Dict "config1" "config2"

# Get the size of a dictionary
Set Variable count = Dict Size "inventory"

Device Input & Social (5)

Vibrate the device, read the accelerometer, get device orientation, take screenshots, and share the game.

Device Input Examples
# Vibrate on damage (mobile)
When Player Take 10 Damage {
    Vibrate Device 0.5
}

# Take a screenshot on victory
When Game Win {
    Take Screenshot
}

Data Persistence (3)

Set, get, and delete arbitrary player data — perfect for RPG inventories, settings, and progression.

Data Persistence Examples
# Save player data
Set Player Data "lastLevel" "3"

# Read it back
Set Variable lvl = Get Player Data "lastLevel"

New Visual Scripting Nodes

All 50+ new commands are automatically available as visual scripting nodes in the Node Editor. They appear in their respective categories with proper exec/data ports and configurable fields. The registry synthesizer generates node definitions for every command, so you can drag them into your graph immediately.

Unified Registry

Every new command appears as a node automatically — no manual node definition needed. The registry synthesizer builds the node from the command's parameter list, category, and label.

New FluxScript Keywords

All 50+ new commands are available as FluxScript keywords with full autocomplete. Type the subject and press Ctrl+Space to see matching commands. The AI vocabulary is also updated automatically, so the AI assistant can generate scripts using the new commands.

10 New Event Types

V2.5 adds 10 new event types: On Player Death, On Level Up, On Status Effect Added, On Cutscene End, On Day/Night Change, On Weather Change, On Score Threshold, On Currency Change, On Craft Complete, and On Skill Unlocked.

Roblox-Style Toolbox Panel

The new Toolbox panel brings the Roblox Studio experience to Appley. It provides a searchable, categorized library of built-in models, decals, meshes, audio, plugins, and marketplace items. Click any item to insert it directly into your scene.

Features include:

1

Search bar

Live-filter all toolbox items by name. Results update as you type.

2

Category tabs

Switch between Models, Decals, Meshes, Audio, Plugins, and Marketplace.

3

Grid/List views

Toggle between a visual grid of thumbnails and a compact list view.

4

Favorites

Star items to pin them. Access your favorites with one click. Favorites persist across sessions.

5

Recent

Recently inserted items appear in the Recent tab for quick re-access.

6

Click-to-insert

Click any item to insert it into the scene at the origin. The item is added to your recent list automatically.

AI Improvements

V2.5 improves both the AI game generation pipeline and the in-editor AI assistant.

In-Editor AI Assistant

The AI assistant has been significantly improved:

1

Always acts, never asks

The assistant now defaults to acting on your request with reasonable assumptions instead of asking clarifying questions. It only asks when the request is truly impossible to interpret.

2

Error diagnosis

When you report an error (e.g. "consumeFlag is not a function"), the assistant diagnoses the root cause and provides the exact fix in a code snippet.

3

Concrete output

The assistant provides ready-to-use FluxScript code, node graph JSON, or configuration — not vague descriptions or plans.

4

Registry-aware

The assistant's vocabulary is automatically derived from the Engine API registry, so it knows every command available in V2.5 — including all 50+ new ones.

Game Generation Pipeline

The game generation AI benefits from the expanded command vocabulary. Generated games can now use tweening, status effects, cutscenes, procedural generation, and all the new math/string/array operations. The AI's knowledge base is derived from the registry, so it automatically uses V2.5 commands when appropriate.

New GUI Panels

V2.5 adds the Roblox-style Toolbox panel to Creator Studio. Access it from the panel tabs at the top of the editor. The Toolbox provides a categorized, searchable library of objects you can insert into your scene with a single click.

Bug Fixes

V2.5 fixes several critical bugs:

consumeFlag is not a function

GraphRuntime now implements consumeFlag() (returns false for node graphs). The 3D runtime always wraps bridges in a CompositeBridge, preventing raw GraphRuntime from being called directly.

AI assistant stuck in question loops

The assistant system prompt now explicitly instructs it to act rather than ask clarifying questions. It only asks when the request is completely uninterpretable.

Smoke test fallback bridge missing methods

The 2D smoke test fallback bridge now includes consumeFlag and hasListener, preventing false failures.

Migration Guide

V2.5 is fully backward-compatible. No breaking changes. Existing projects will continue to work without modification. The new commands are additive — they don't replace or rename any existing commands.

No Migration Required

V2.5 adds new capabilities without removing or renaming anything. Your existing games will work exactly as before. You can start using the new commands in any project immediately.

Explore these related documentation pages: