Scripted Vision

Scripted Vision

Scripted Vision is a NeoForge 1.21.1 mod made for mapmakers, scripted modpacks, and server events. It adds a set of commands that help you control the player's attention: cinematic cameras, entity-tracking cameras, screen fades, flashes, and atmospheric text prompts.

The mod is especially useful for cutscenes, horror maps, story-driven servers, minigames, interactive arenas, and any project where you want a more cinematic presentation without relying on complicated third-party systems.

Features

• Cinematic camera — place the camera at specific coordinates and set its view direction.
• Target camera — place the camera at specific coordinates and make it look at an entity.
• Direct mode — the camera instantly looks at the current target position.
• Follow mode — the camera looks at the entity's movement trail, creating a smooth delayed tracking effect.
• Zoom — smoothly zoom the camera in.
• Cinema bars — add black letterbox bars for a cutscene feel.
• Fade — smoothly fade the screen in or out with a color.
• Flash — trigger a quick colored screen flash.
• Prompt — display text prompts over the screen.
• Command block friendly — effects can be triggered through selectors, command blocks, scripts, and map logic.

Good for

• story maps;
• cutscenes;
• horror scenes;
• tutorial maps;
• minigames;
• boss fights;
• server events;
• interactive cinematic sequences.

Base syntax

/scriptedvision [target] <subcommand> ...
/sv [target] <subcommand> ...

/sv is a shorter alias for /scriptedvision.

[target] is the player or player selector that will receive the effect. If no target is provided, the command applies to the executor, or to all online players when used from the console or a command block.

Target examples:

@p
@a
Steve

Subcommands

Fade

Runs a full screen fade cycle: transparent → selected color → hold → transparent.

/scriptedvision [target] fade <color> <in_speed> <duration> <out_speed>

Parameters:

• <color> — color in #RRGGBB or RRGGBB format.
• <in_speed> — time to fade from transparent to full color.
• <duration> — how long the full color is held.
• <out_speed> — time to fade back from full color to transparent.

Example:

/scriptedvision @a fade #000000 1.5 3 1

Flash

Triggers a quick colored screen flash.

/scriptedvision [target] flash <color> <peak_speed> <fade_out_speed>

Parameters:

• <color> — flash color in #RRGGBB or RRGGBB format.
• <peak_speed> — how quickly the flash appears.
• <fade_out_speed> — how quickly the flash disappears.

Example:

/scriptedvision @p flash #FFFFFF 0.1 1.5

Prompt

Displays a text prompt over the screen.

/scriptedvision [target] prompt <speed_in> <duration> <speed_out> <text...>

Parameters:

• <speed_in> — prompt fade-in speed.
• <duration> — how long the text stays visible.
• <speed_out> — prompt fade-out speed.
• <text...> — prompt text.

Example:

/scriptedvision @a prompt 0.5 3 0.5 Welcome to the laboratory.

Camera

Places a cinematic camera at fixed coordinates and points it in a chosen direction.

/scriptedvision [target] camera <x> <y> <z> <yaw> <pitch> <zoom> <zoom_time> <duration> [cinema_bars]

Parameters:

• <x> <y> <z> — camera position.
• <yaw> — horizontal camera rotation.
• <pitch> — vertical camera rotation.
• <zoom> — zoom strength from 0 to 100.
• <zoom_time> — smooth zoom-in time.
• <duration> — how long the camera is held.
• [cinema_bars] — true or false; enables black letterbox bars.

Example:

/scriptedvision @a camera 10 65 -20 90 15 45 1 5 true

Target Camera

Places a camera at fixed coordinates and makes it look at a selected entity.

/scriptedvision [target] target_camera <x> <y> <z> <target_mob> <zoom> <zoom_time> <duration> <cinema_bars> <direct|follow>

Parameters:

• <x> <y> <z> — fixed camera position.
• <target_mob> — entity the camera looks at.
• <zoom> — zoom strength from 0 to 100.
• <zoom_time> — smooth zoom-in time.
• <duration> — how long the camera watches the entity.
• <cinema_bars> — true or false; enables black letterbox bars.
• <direct|follow> — tracking mode:
  • direct — instantly look at the entity's current position;
  • follow — look at the entity's movement trail, creating a smooth delayed tracking effect.

target_mob must resolve to exactly one entity. For respawning entities, a tag with a selector limit is recommended:

@e[tag=boss_camera,limit=1,sort=nearest]

Example:

/scriptedvision @a target_camera 10 65 -20 @e[tag=boss_camera,limit=1,sort=nearest] 60 1 5 true follow

Requirements

• Minecraft: 1.21.1
• Loader: NeoForge

Status

The mod is in active development. The main visual effects and camera tools are already working, and more cinematic features may be added later.